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 Request

POST https://yourdomain.com/webhook

The “message-in” variable data is URL encoded so you need to decode the same. Online Tools

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"
  }
}

Response JSON

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 Request

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

The “message-in” variable data is URL encoded so you need to decode the same. Online Tools

Response JSON