How to use Comm100 Task Bot Webhook

Comm100’s Task Bot allows your customers to interact with a Task Bot to receive information about products or services quickly and efficiently.

However, you may need to extend the capabilities of our Task Bot by connecting it to your own database for more personalized and dedicated service.

Now, with the latest update, our Task Bot can send data to your own web application using a “Webhook”. A Webhook is a custom web callback using HTTP POST query used to provide real-time information.

To set up these new personalized questions, you can supply Task Bot with a URL of the web application to receive the Webhook data and return the relevant information to our Task Bot service.

Step by Step Instructions

1. Log in to your Comm100 account.
2. From the left navigation menu, go to Bot > Task Bot.
3. Select a Task Bot to edit.
4. Drag the Trigger a webhook action card to the flow builder area.
   

Webhook Settings

You can click the Show all settings link on the Trigger a webhook card to further customize the webhook settings. The Webhook drawer appears where you can do the following:

1. Add webhook URL.
2. Add webhook header.
3. Add Additional Post Body JSON.
4. Add variable to save the webhook response.
5. Input response code to action.
6. Click OK.
   

Data Sent to Your Web Application

Through the designated URL, your web application will receive the variables and their values from the chat sessions. The data that will be passed to your web application will include the “Fields” in the Pre-chat Window, Custom Variables, Variable of Visitors, Last Message from Visitors, and Matched Intents.

Your web application will then process the received data, generate and send us the result.
Your Additional Post Body JSON will append to post object.

Below is an example of the data in JSON format that will be sent to your server with your Additional Post Body :

  {
	"event": "questionAsked",
	"question": "Continue",
	"chatId": "f16dde4f-ec6a-4102-badb-09ed7bb5725e",
	"botId": "cdf2da6b-2cc4-4c1d-a3c3-83d5dc8fc7f2",
	"visitorId": "5e6567ae-1e2d-46da-bd68-43139ee9316f",
	"campaignId": "c30464bc-73c7-41fb-8a65-42d2d650a722",
	"visitorInfo": {
		"visitorGuid": "5e6567ae-1e2d-46da-bd68-43139ee9316f",
		"longitude": 0.0,
		"latitude": 0.0,
		"pageViews": 1,
		"browser": "Firefox 102.0",
		"chats": 12,
		"city": "",
		"company": "",
		"country": "Hong Kong",
		"currentBrowsing": "https://dash11.comm100.io/frontEnd/assets/livechat/previewpage/?campaignId=c30464bc-73c7-41fb-8a65-42d2d650a722&siteId=10100749&lang=en",
		"customFields": [],
		"customVariables": [],
		"department": "00000001-0000-0000-0000-000000000001",
		"email": "",
		"firstVisitTime": "2022-07-20T06:57:14.585Z",
		"flashVersion": "",
		"ip": "45.123.194.216",
		"keywords": "",
		"landingPage": "https://dash11.comm100.io/frontEnd/assets/livechat/previewpage/?campaignId=c30464bc-73c7-41fb-8a65-42d2d650a722&siteId=10100749&lang=en",
		"language": "en-GB",
		"name": "SSOUser_elia",
		"operatingSystem": "Windows 10",
		"phone": "",
		"productService": "",
		"ticketId": "",
		"referrerUrl": "",
		"screenResolution": "1920x1080",
		"searchEngine": "",
		"state": "",
		"status": 2,
		"timeZone": "GMT +08:00",
		"visitTime": "2022-07-20T06:57:13.8698464Z",
		"visits": 1,
		"ssoId": "elia",
		"chatRequestingPageUrl": "https://dash11.comm100.io/frontEnd/assets/livechat/previewpage/?campaignId=c30464bc-73c7-41fb-8a65-42d2d650a722&siteId=10100749&lang=en",
		"segments": [],
		"campaignId": "c30464bc-73c7-41fb-8a65-42d2d650a722",
		"channelAccountId": "00000000-0000-0000-0000-000000000000",
		"timeOnWebSite": 3073,
		"timeOnCurrentPage": 1911,
		"isAgentOnline": false
	},
	"variables": {
		"{!Variable.Name}": "Cici.",
        "{!Custom Variable.Color}": "Red",
        "{!Pre-Chat.Email}": "abc@sina.com"
	},
    "key1": "Value1", --from your additional Post Body JSON
    "key2": "Value2", --from your additional Post Body JSON
}

Save Your Response to Variable

You can save the response to Variable, and the Variable can be used after the webhook called.
For example
Your response is

{	
    "code": 1, 
    "result": ["SAP Option1","SAP Option2","SAP Option3"]
}

You can save the "result" to Variable "sap_options"

You can use the Variable "sap_options" like this to show the options:

If your response structure is complex ，For example your response is

{
    "result": 
     {	
        "code": 1, 
        "data": ["SAP Option1","SAP Option2","SAP Option3"]
    }
}

You can use "result.data" to get the array value, and save it to Variable like this: