Create a Webhook task

Procedure

1. Go to Workspace > User Marketing > Reach Marketing > Webhook. In the upper-right corner, click Create Sending Task.

2. On the task creation page, configure the following parameters:

   Parameter	Description
   Task name	Enter a name for the task.
   Associated sub-campaign	Select a main campaign, and then select a sub-campaign under it. Independent sub-campaigns are displayed under - at the end of the main campaign list. Associate the marketing task with one or more sub-campaigns. For more information about campaigns, see the Marketing Campaign document.
   Target audience	Specify the audience. You can use one of two methods: Select audience: Click Select Audience and choose an audience. Manual upload: Upload a CSV or TXT file that contains a list of audience IDs.
   Select Webhook	After you select an audience, select a Webhook from the drop-down list. The available Webhooks support ID types that match the ID type of the selected audience.
   Parameters (displayed as their actual names in the UI)	Set values for the Webhook parameters. These values replace the parameter names during sending. For example, if the message content set in your first-party system is "Discount event at {address}", {address} is a parameter that you must specify a value for. For text-based parameters, if you selected an audience that uses tag filtering, you can insert variables into the parameter values. This lets you use tag values from the corresponding user tag dataset. The message content then changes for each user based on their tag value. Perform the following steps: For text-based parameters, an Insert Variable button appears below the text box. Click the button to display the variable configuration area. Select the user tag dataset and the corresponding tag to use. Enter a name for the variable. The name can be the same as the tag name. Variable names must be unique within the same parameter. Set how to handle empty tag values: Do not send: If a tag value is empty, no message is sent to the corresponding user. Replace: If a tag value is empty, replace it with the fixed text on the right. In the text box, click where you want to insert the variable, and then click Insert. The variable is automatically inserted into the text box in the format `${variable_name}`, as shown in the following figure.
   Available sending ID type	Displays the ID type of the audience.
   Scheduled sending	If you enable this option, you can specify a time to send the message.

3. Click Test Send. In the dialog box that appears, enter a test ID and click Confirm. The system calls your first-party or third-party system through the Webhook to send a message to the test ID.

   Note

   You can skip this step if the test send in Webhook Management was successful.

   

   The dialog box shows whether the test send was successful.

   • Test send successful: Verify that your first-party or third-party system received the Webhook request and that the test ID received the message. If not, click Download Log in the dialog box to troubleshoot the issue.

   • Test send failed: Click Download Log in the dialog box to troubleshoot the issue.

4. After the test send is successful, click Submit Sending Task to create the task.