Webhook Request & Response
Get Started with Sample Request & Response
Webhook Trigger Methods
JSON Method Query String Method
JSON Method
In this method you will get data as JSON , you need to specify to push the data in JSON method while setting up Webhook URL
POST https://yourdomain.com/webhook
Receiving Message with Text & Media
{
"number": "963587413",
"message-in": "test",
"type": "2",
"application": "1",
"unique-id": "5642",
"project-id": "27",
"media-url": "https://upload.wikimedia.org/wikipedia/commons/5/57/PT05_ubt.jpeg",
"custom-variable": "test"
}Receiving Message with Multiple Contacts
Not Support in Phone Automation
{
"number":"963587413",
"type":"7",
"application":"8",
"unique-id":"5642",
"project-id":"27",
"contact":[
{
"city":null,
"country":"USA",
"country_code":"in",
"state":"Kerala",
"street":null,
"address_type":"Home",
"zip":null,
"email":"[email protected]",
"first_name":"Test",
"last_name":"User",
"phone":"+91 99s999 00111",
"phone_type":"Mobile",
"contact_image":""
},
{
"city":null,
"country":"India",
"country_code":"in",
"state":"Kerala",
"street":null,
"address_type":"Home",
"zip":null,
"email":"[email protected]",
"first_name":"User",
"last_name":"Test",
"phone":"+91 9888d8 00222",
"phone_type":"Mobile",
"contact_image":""
}
]
}Receiving Message with Location
Not Supported in Phone Automation
{
"number":"96343587413",
"type":"7",
"application":"8",
"unique-id":"5642",
"project-id":"27",
"Location":{
"lat":81.5094267351303,
"long":6.969892978668,
"name":"Tourism Maldives",
"address":"Tourism Maldives Magazine, USA",
"url":"http://pickyassist.com/"
}
}Receiving Quoted Reply Messages In WhatsApp Interactive Buttons
Not Supported in Phone Automation
{
"number": "91940055074",
"message-in": "Not+Sure",
"message_in_raw": "Not Sure",
"type": 9,
"application": "8",
"unique-id": "52363299",
"project-id": "10129",
"direction": 0,
"name": "Picky",
"context-msg-id": "30486936",
"payload": "confirmbutton"
}Receiving List Message & Button Clicks
Supported only in WhatsApp Official
{
"number":"93436707768",
"message-in":"choice1",
"message_in_raw":"choice1",
"type":1,
"application":8,
"unique-id":"70946012",
"project-id":"14192",
"direction":0,
"context-msg-id":"41668446",
"interactive":{
"type":1,
"id":"ref1",
"description":"choice description1"
}
}Receiving Message With Referral Details
Supported only in WhatsApp Official, you will receive referral details in "referral" array when a user clicks the "WhatsApp"" call to action buttons and sends a messages, this helps you to identify the source of the referral and measure the effectiveness of the engagement ratio
{
"number": "919446XXXXXX",
"message-in": "test",
"message_in_raw": "test",
"type": 1,
"application": 8,
"unique-id": "70946012",
"project-id": "14192",
"direction": 0,
"referral": {
"headline":”Our new product”,
"body": "Test message",
"source_type": "ad",
"source_id":”3432324XXXXXXXX”,
"source_url": "http://pickyassist.com",
"image": "https://fb/image"
}
}
JSON Sample Response for Text Messages
{
"message-out": "Test Instant Reply Back",
"delay": "0",
"type": "1",
"reference_number": "Your Internal Reference Number",
}JSON Sample Response With Media Files
For phone automation sending media file takes longer time and make use of Auto Click method, so please make use of the media sending feature only if needed
{
"message-out": "Test Instant Reply Back",
"delay": "0",
"media-url": "https://upload.wikimedia.org/wikipedia/commons/5/57/PT05_ubt.jpeg",
"application": "0",
"type": "2"
}JSON Sample Response With Multiple Contacts
Not supported in phone automation, multiple contacts must pass as an array.
{
"type":"7",
"application":"8",
"contact":[
{
"city":null,
"country":"USA",
"country_code":"us",
"state":"Deleware",
"street":null,
"address_type":"Home",
"zip":null,
"email":"[email protected]",
"first_name":"Test",
"last_name":"User",
"phone":"+1 129999 00111",
"phone_type":"Mobile",
"contact_image":""
},
{
"city":null,
"country":"India",
"country_code":"in",
"state":"Kerala",
"street":null,
"address_type":"Home",
"zip":null,
"email":"[email protected]",
"first_name":"User",
"last_name":"Test",
"phone":"+91 98888 00222",
"phone_type":"Mobile",
"contact_image":""
}
]
}JSON Sample Response With Location
Not supported in phone automation, locations values need to pass in array
{
"type":"5",
"application":"8",
"location":{
"lat":18.5094267351303,
"long":76.969892978668,
"name":"Tourism Maldives",
"address":"Tourism Maldives Magazine, Delaware"
}
}The response must be in JSON format else reply will not sent to the user and no need to url encode the message-out variable.
Query String Method (deprecated)
In this method data will be posted as query parameter through URL as shown below, this is the default method
Query String method is deprecated on 30 March 2020 and no new updates will be pushed to this method.
POST -> https://yourdomain.com/webhook?number=963587413&message-in=test&type=1&application=1&unique-id=5672&project-id=27&media-url="https://upload.wikimedia.org/wikipedia/commons/5/57/PT05_ubt.jpeg&custom-variable=test
JSON Sample Response for Text Messages
{
"message-out": "Test Instant Reply Back;",
"delay": "0"
}JSON Sample Response With Media Files
{
"message-out": "Test Instant Reply Back;",
"delay": 0,
"media-url": " https://upload.wikimedia.org/wikipedia/commons/5/57/PT05_ubt.jpeg ",
"application": "0"
}The response must be in JSON format else reply will not sent to the user and no need to url encode the message-out variable.
Last updated
Was this helpful?