How to Connect Webhooks with Woorise

If you need to send your form data from your Woorise site to an external API the Webhooks integration allows you to do exactly that. Easily pass information such as form submissions, payment data, and more to the 3rd-party service of your choice.

Creating a Webhooks feed

1. In your Woorise dashboard click on Integrations from the main menu and activate Webhooks.
2. Select the campaign you want and click on Form tab.
3. From the Settings click on Webhooks.
4. Click Add New to create a new feed.

Webhooks feed settings

• Name
  A feed Name is required. It is only used for identification and will not be shown anywhere other than your feed listing.
• Request URL
  Enter the URL this request should be sent to. This setting also supports merge tags.
• Request Method
  Select the HTTP method which is to be used when performing request. The supported methods are GET, POST, PUT, PATCH, and DELETE.
• Request Format
  Select the format for the webhook request. The supported formats are FORM and JSON.
• Request Headers
  Here you can configure one or more HTTP headers to be sent with the request.
• Request Body
  Here is where you will define what data is sent with the request. You can select from the following options:
  • All Fields: This will send the entire unformatted entry.
  • Select Fields: This will display the Fields Values setting.
• Webhook Condition
  To use conditional logic, select the Enable Condition checkbox and then configure the rules which should be met for this request to be sent.

The Content-Type header is automatically set to application/json during feed processing when the Request Format is set to JSON and the Request Method is set to POST or PUT.

Field values

Only displayed when Request Body is set to Select Fields. This dynamic setting allows you to define the keys and values to be sent in the request body. For the values, you can select from the form fields, entry meta, or Add Custom Value which will display a text input that supports merge tags.

To add array data in the value field please use the following format:

[ key1:value1, key2:value2, key3:value3 ]

You can test your Webhook using the webhook.site

Webhook example

In this example we will use Woorise Webhooks to create a contact on GetResponce. Woorise has already a native GetResponce integration and its recommend to use that. However, this webhook example will help you to understand how webhooks works.

Also there are cases where you want to use both, the GetResponce integration and the Webhooks to send data to multiple GetResponce accounts.

1. The first step is the check the GetResponce API on how to create a contact in GetResponce.
2. In the Request URL we set the GetResponce URL to create the contact.
   https://api.getresponse.com/v3/contacts
3. Next we set the Request Method to POST and the Request Format to JSON
4. In the Request Headers we set the following headers. These headers are used for authentication. You have to use the API key provided by GetResponce.
   • Name: Content-Type, Value: application/json
   • Name: X-Auth-Token, Value: api-key abcdef123
5. Next in the Request Body we enter the values we want to send in the GetResponce. As per their documentation campaign and email fields are required. We will check the Select Fields option and we will set the following fields. Please note that the campaign key accepts an array and you have to use the format as explained before in the Webhook Settings.
   • Key: name, Value: We are selecting the Name field from the Woorise form
   • Key: email, Value: We are selecting the Email field from the Woorise form
   • Key: campaign, Value: [ campaignId:abcde ]
6. That’s it! Now, you can submit a test entry in your form and check your GetResponce account to see if a new contact has created.