Webhooks in Workflows

Webhook workflows allow working with parameters from events and from the user’s profile in Reteno.

Webhooks in Workflows

This request uploads and sends the contact’s data from Reteno to other systems and contrariwise collects data into Reteno from external systems. Using this as a part of a workflow, you can:

  1. Address your own resource, which will process the request and return data for personalization (for example, a personal promo code or a token for authorization) in the message.
  2. Send data from an event or from the contact’s card (for example, order id, additional field “contact’s id in messenger” or “Birthday”) to an external resource.



Only the contact’s data (fields + additional fields) and the parameters from an event that triggered a workflow with a webhook can be sent through a webhook. In most cases, data transfer in webhooks is configured in JSON format, but XML and text formats are also available.

Creating a Webhook in a Workflow

  1. Go to Automation → Workflows and click the New workflow button.
Creating a new workflow
  1. Open the Other tab on the left panel, and select Webhook.
Other tab
  1. Click the Create webhook button on the Settings panel on the right side.
Create webhook
  1. The Create webhook window opens. Select the GET or POST request type from the drop-down menu.
Select the `GET` or` POST` request

Working with GET Request

Use this request type when you want to request data on an external resource using the link to use the data in a workflow and insert it inside the workflow. The data is transmitted to an URL as “name-value” pairs.

GET request type

In order to configure the webhook:

  1. Enter the webhook name using any symbols (required field) and description (optional field).
  2. Enter the resource’s URL through secured HTTPS protocol (if you enter HTTP the system does not save the link). Type in variables you want to return after the interrogation symbol. In this example, we transmit the email parameter’s value from an event triggering the workflow and address the EMAIL field related to the contact’s card on the resource to which we sent the GET request.
  3. If your resource reads parameters from headers, enable Pass parameters in headers slide button and enter corresponding variables and values you want to address.
  4. Enable Authentication slide button and select authentication connector. If you need to configure a new one, click the New connector button to open the Create connector window.
  5. In Create connector window enter the following details:
Creating connector
  • Connector name.
  • Authentication type from the drop-down list: Basic, Bearer token, API key.
  • Enter login and password/token/key.

Click the Done button to apply the new connector in the webhook automatically.

GET-request Testing

  1. Click the Send test button.
Click the Send test button
  1. Select a contact from the list or find it through the search and click Next.
Select a contact from the list

To find contacts in a segment, select Preview contacts from the selected segment.

Preview contacts from the selected segment
  1. Click Send request.
Send request
  1. In the testing window, you get the response:
Sending GET request

Click the Back arrow in the top left corner of the dialog window, and click the Done button.

Now the new webhook is available for selection in your workflow.

Created webhook



There are three fields in the Webhook block settings for identification of a contact by a parameter from an event: Contact ID, Phone and Email. It is sufficient to enter one of those three parameters for a workflow to identify which contact’s data shall be received/transmitted in a webhook. In our example, the workflow triggers an event with an email variable. Therefore, ${emailAddress} shall be indicated in the Webhook block for the Email field.

Now you can show the received data in a message using the expression in Velocity language. Go to MessagesMessagesNew Email or choose your template.

New Email

Insert the expression with the value of the received variable to output dynamic data into any text area.

Message variable

Example: $!mathTool.toInteger($data.contacts_get_by_email.get(0).id),

where contacts_get_by_email is the name of your webhook (here it plays the role of a data source),

get(0).id is a call to a variable in the source pointing to the required parameter. In this case that is contact id.

When testing, the contact ID is inserted into the message that has been found by the email from an event using the webhook.

Working with POST Requests

Let’s see the example of when it is necessary to send the data about the contact’s city to get a promo code for him/her from an external source.

Follow the steps below to configure a webhook with the POST request:

  1. In the webhook block settings, click the Create webhook button.
Create webhook
  1. In the Webhook configuration window, enter the webhook name and select the POST request type. Enter the URL of a resource using the secure HTTPS protocol. In this link, you can use variables calling event parameters or contact fields. In the example, we call TOWN – the standard contact field in Reteno.
POST Request
  1. If your application reads parameters from headers, enable the Pass parameters in headers slide button. Enter corresponding variables and their values
  1. Enable the Authentication slide button to configure authentication parameters. Select from existing connectors or create a new one.
Configure authentication parameters

If you need to configure a new one, click the New connector button to open the Create connector window.
In Create connector window:

  • Enter the Connector name.
  • Select Authentication type from the dropdown list: Basic, Bearer token, API key.
  • Enter login and password/token/key.

Click the Done button.

Create connector

In the body of the POST request, you can send a random amount of data. For that, enable the corresponding slide button, select the format of the data to be inserted and insert it below. Available formats: JSON, XML, text.

Available formats: JSON, XML, text

To access event parameters, use Apache Velocity, for example: "param": "$data.get('param')"

POST-request Testing

  1. Click the Send test button.
POST request type
  1. The system suggests where to take the data for testing – from the contact’s card or from an event. If the webhook URL is configured to address a parameter from an event, then during testing the system suggests choosing an event from the list of those received by the system at any time, or to enter the event’s body manually.
POST request parameters

Since in our example we indicate addressing to the contact field, then it is necessary to select a contact from the base in the Reteno account.

POST request dynamic data

You can choose another contact (1) or view the selected one (2).

Upon pressing the Next and Send request buttons you receive the response with Headers and Body:

Sending POST request

To show the promo code in the message, enter the following expression into the text area:
$data.get('WH5').get('promocode'), where

  • WH5 is the source name (webhook name).
  • promocode is the name of the variable containing the promo code value.
Promo code variable in the message

The result of a promo code inserted in the email:

Promo code inserted in the email

Webhook Management

Press Manage Webhook in the webhook block settings. The window containing the list of webhooks opens. There you can:

  • create a new webhook
  • edit existing webhooks
  • test webhooks
  • delete webhooks
  • view the list of deleted webhooks
Webhook management

In the start history of the workflow with a webhook, you will see the details of the request:

Details of the request