Keyword (Webhook WhatsApp)
In this section we are going to show the data that is sent from the platform to your webhook URL, which must be configured to handle the contents provided in the JSON payload. That is, the webhook allows you to forward data to your application for further processing.
The payload sent to the webhook URL varies depending on the message type received from the end user.
NOTE
These JSON payloads will be sent to the Webhook URL if you opt for WhatsApp as delivery channel when creating and setting as Live a keyword campaign.
For example, when the end user sends any of the following message types, the JSON payload will vary.
- Send a simple text with emojis and line breaks
{
"owner": "[email protected]",
"date": "2023-12-12T18:58:44.819365532Z",
"processId": 2222,
"origin": "5500000000",
"externalId": "[email protected]_111",
"callback": "https://webhook/111",
"id": "1122334455",
"text": "We are pleased to present our new product: \nThe Amplifier 480xAr 😀",
"user": "525511111111",
"extraInfo": {
"SAMWELL_WEBHOOK_NAME": "Webhook Orders",
"MSGI_SOURCE_CAMPAIGN": "SKC",
"contacts": [
{
"profile": {
"name": "Alex Smith"
},
"wa_id": "525511111111"
}
]
}
}
| Parameter | Description |
|---|---|
| owner | Interactive Campaign owner. |
| date | Date when the API receives the WhatsApp message status. The date is represented with date in UTC Zulu format: (yyyy-mm-dd-Thh:mm:ss.ssZ). |
| processId | Unique identifier of the process (event). |
| origin | Phone number used to originate and send the whatsApp message. |
| externalId | Alphanumeric identifier used to identify your whatsApp messages uniquely for reporting purposes. |
| callback | Webhook URL to notify about the events of the whatsApp message. |
| id | Unique identifier provided by META |
| text | Content of the WhatsApp message sent by the end user. In case the sent message does not support META, it will display the following message value: "text": "The message type is not currently supported by META" |
| user | Phone number of the end user. |
| extraInfo | Additional information sent by the end user from the WhatsApp application. |
| extraInfo.SAMWELL_WEBHOOK_NAME | Webhook name you typed when setting up the Keyword campaign. |
| extraInfo.MSGI_SOURCE_CAMPAIGN | Type of interactive campaign from which the message is received. - "SKC": Keyword interactive campaign |
| extraInfo.contacts | End user information. |
| extraInfo.contacts.profile | End user profile |
| extraInfo.contacts.profile.name | Name of the end user. |
| extraInfo.contacts.wa_id | Phone number of the end user. |
- Send a Sticker
{
"owner": "[email protected]",
"date": "2023-12-12T18:58:44.819365532Z",
"processId": 2222,
"origin": "5500000000",
"externalId": "[email protected]_111",
"callback": "https://webhook/111",
"id": "1122334455",
"text": "",
"user": "525511111111",
"extraInfo": {
"SAMWELL_WEBHOOK_NAME": "Webhook Orders",
"MSGI_SOURCE_CAMPAIGN": "SKC",
"sticker": {
"fileName": "121212_File.webp",
"shaData": "234567898765434567",
"url": "https://whatsapp-mo-attachments.awsDomain.com/121212_File",
"caption": ""
},
"contacts": [
{
"profile": {
"name": "Alex Smith"
},
"wa_id": "525511111111"
}
]
}
}
| Parameter | Description |
|---|---|
| owner | Interactive Campaign owner. |
| date | Date when the API receives the WhatsApp message status. The date is represented with date in UTC Zulu format: (yyyy-mm-dd-Thh:mm:ss.ssZ). |
| processId | Unique identifier of the process (event). |
| origin | Phone number used to originate and send the whatsApp message. |
| externalId | Alphanumeric identifier used to identify your whatsApp messages uniquely for reporting purposes. |
| callback | Webhook URL to notify about the events of the whatsApp message. |
| id | Unique identifier provided by META |
| text | Content of the WhatsApp message sent by the end user. In case the sent message does not support META, it will display the following message value: "text": "The message type is not currently supported by META" |
| user | Phone number of the end user. |
| extraInfo | Additional information sent by the end user from the WhatsApp application. |
| extraInfo.SAMWELL_WEBHOOK_NAME | Webhook name you typed when setting up the Keyword campaign. |
| extraInfo.MSGI_SOURCE_CAMPAIGN | Type of interactive campaign from which the message is received. - "SKC": Keyword interactive campaign |
| extraInfo.sticker | Sticker information |
| extraInfo.sticker.fileName | Name of the sticker |
| extraInfo.sticker.shaData | Optional. Verify if the sticker is secure according to Secure Hash Algorithms (SHA). |
| extraInfo.sticker.url | URL of a sticker sent in a WhatsApp message. |
| extraInfo.contacts | End user information. |
| extraInfo.contacts.profile | End user profile |
| extraInfo.contacts.profile.name | Name of the end user. |
| extraInfo.contacts.wa_id | Phone number of the end user. |
- Attach an Image or PDF file
{
"owner": "[email protected]",
"date": "2023-12-12T18:58:44.819365532Z",
"processId": 2222,
"origin": "5500000000",
"externalId": "[email protected]_111",
"callback": "https://webhook/111",
"id": "1122334455",
"text": "",
"user": "525511111111",
"extraInfo": {
"SAMWELL_WEBHOOK_NAME": "Webhook Orders",
"MSGI_SOURCE_CAMPAIGN": "SKC",
"attachments": [
{
"fileName": "14444_File.pdf",
"shaData": "234567898765434567",
"url": "https://whatsapp-mo-attachments.awsDomain.com/14444_File",
"caption": ""
}
],
"contacts": [
{
"profile": {
"name": "Alex Smith"
},
"wa_id": "525511111111"
}
]
}
}
| Parameter | Description |
|---|---|
| owner | Interactive Campaign owner. |
| date | Date when the API receives the WhatsApp message status. The date is represented with date in UTC Zulu format: (yyyy-mm-dd-Thh:mm:ss.ssZ). |
| processId | Unique identifier of the process (event). |
| origin | Phone number used to originate and send the whatsApp message. |
| externalId | Alphanumeric identifier used to identify your whatsApp messages uniquely for reporting purposes. |
| callback | Webhook URL to notify about the events of the whatsApp message. |
| id | Unique identifier provided by META |
| text | Content of the WhatsApp message sent by the end user. In case the sent message does not support META, it will display the following message value: "text": "The message type is not currently supported by META" |
| user | Phone number of the end user. |
| extraInfo | Additional information sent by the end user from the WhatsApp application. |
| extraInfo.SAMWELL_WEBHOOK_NAME | Webhook name you typed when setting up the Keyword campaign. |
| extraInfo.MSGI_SOURCE_CAMPAIGN | Type of interactive campaign from which the message is received. - "SKC": Keyword interactive campaign |
| extraInfo.attachments | Attachment files information. |
| extraInfo.attachments.fileName | File name and type. |
| extraInfo.attachments.shaData | Optional. Verify if the file is secure according to Secure Hash Algorithms (SHA). |
| extraInfo.attachments.url | URL of the image or pdf file sent in a WhatsApp message. |
| extraInfo.contacts | End user information. |
| extraInfo.contacts.profile | End user profile |
| extraInfo.contacts.profile.name | Name of the end user. |
| extraInfo.contacts.wa_id | Phone number of the end user. |
- Send a Location
{
"owner": "[email protected]",
"date": "2023-12-12T18:58:44.819365532Z",
"processId": 2222,
"origin": "5500000000",
"externalId": "[email protected]_111",
"callback": "https://webhook/111",
"id": "1122334455",
"text": "",
"user": "525511111111",
"extraInfo": {
"SAMWELL_WEBHOOK_NAME": "Webhook Orders",
"MSGI_SOURCE_CAMPAIGN": "SKC",
"location": {
"longitude": "-99.140907",
"latitude": "19.435156",
"name": null,
"address": null
},
"contacts": [
{
"profile": {
"name": "Alex Smith"
},
"wa_id": "525511111111"
}
]
}
}
| Parameter | Description |
|---|---|
| owner | Interactive Campaign owner. |
| date | Date when the API receives the WhatsApp message status. The date is represented with date in UTC Zulu format: (yyyy-mm-dd-Thh:mm:ss.ssZ). |
| processId | Unique identifier of the process (event). |
| origin | Phone number used to originate and send the whatsApp message. |
| externalId | Alphanumeric identifier used to identify your whatsApp messages uniquely for reporting purposes. |
| callback | Webhook URL to notify about the events of the whatsApp message. |
| id | Unique identifier provided by META |
| text | Content of the WhatsApp message sent by the end user. In case the sent message does not support META, it will display the following message value: "text": "The message type is not currently supported by META" |
| user | Phone number of the end user. |
| extraInfo | Additional information sent by the end user from the WhatsApp application. |
| extraInfo.SAMWELL_WEBHOOK_NAME | Webhook name you typed when setting up the Keyword campaign. |
| extraInfo.MSGI_SOURCE_CAMPAIGN | Type of interactive campaign from which the message is received. - "SKC": Keyword interactive campaign |
| extraInfo.location | Location information. |
| extraInfo.location.longitude | Longitude of the location. |
| extraInfo.location.latitude | Latitude of the location. |
| extraInfo.location.name | Name of the location. |
| extraInfo.location.adress | Address of the location. |
| extraInfo.contacts | End user information. |
| extraInfo.contacts.profile | End user profile |
| extraInfo.contacts.profile.name | Name of the end user. |
| extraInfo.contacts.wa_id | Phone number of the end user. |
- Send the information of a Contact.
{
"owner": "[email protected]",
"date": "2023-12-12T18:58:44.819365532Z",
"processId": 2222,
"origin": "5500000000",
"externalId": "[email protected]_111",
"callback": "https://webhook/111",
"id": "1122334455",
"text": "",
"user": "525511111111",
"extraInfo": {
"SAMWELL_WEBHOOK_NAME": "Webhook Orders",
"MSGI_SOURCE_CAMPAIGN": "SKC",
"contact": [
{
"name": {
"first_name": "Julian",
"middle_name": "Doe",
"last_name": "Miller",
"formatted_name": ""
},
"phones": [
{
"phone": "+525533333333",
"type": "Celular",
"wa_id": "525533333333"
}
]
}
],
"contacts": [
{
"profile": {
"name": "Alex Smith"
},
"wa_id": "525511111111"
}
]
}
}
| Parameter | Description |
|---|---|
| owner | Interactive Campaign owner. |
| date | Date when the API receives the WhatsApp message status. The date is represented with date in UTC Zulu format: (yyyy-mm-dd-Thh:mm:ss.ssZ). |
| processId | Unique identifier of the process (event). |
| origin | Phone number used to originate and send the whatsApp message. |
| externalId | Alphanumeric identifier used to identify your whatsApp messages uniquely for reporting purposes. |
| callback | Webhook URL to notify about the events of the whatsApp message. |
| id | Unique identifier provided by META |
| text | Content of the WhatsApp message sent by the end user. In case the sent message does not support META, it will display the following message value: "text": "The message type is not currently supported by META" |
| user | Phone number of the end user. |
| extraInfo | Additional information sent by the end user from the WhatsApp application. |
| extraInfo.SAMWELL_WEBHOOK_NAME | Webhook name you typed when setting up the Keyword campaign. |
| extraInfo.MSGI_SOURCE_CAMPAIGN | Type of interactive campaign from which the message is received. - "SKC": Keyword interactive campaign |
| extraInfo.contact | Contact information. |
| extraInfo.contact.name | Array containing contact information. |
| extraInfo.contact.name.first_name | First name of the contact. |
| extraInfo.contact.name.middle_name | Middle name of the contact. |
| extraInfo.contact.name.last_name | Last name of the contact. |
| extraInfo.contact.name.formatted_name | |
| extraInfo.contact.phones | Phone number information of the contact. |
| extraInfo.contact.phones.phone | Phone number of the contact. |
| extraInfo.contact.phones.type | Type of phone number |
| extraInfo.contact.phones.wa_id | Phone number of the contact. |
| extraInfo.contacts | End user information. |
| extraInfo.contacts.profile | End user profile |
| extraInfo.contacts.profile.name | Name of the end user. |
| extraInfo.contacts.wa_id | Phone number of the end user. |
Updated 4 months ago