Webhooks - Message

This page is dedicated to providing you with comprehensive details about the Message webhook.

The Message webhook is a powerful tool that enables real-time, programmatic responses to messages received on your Dexatel sender IDs. Whether you aim to integrate seamless communication workflows into your applications or respond automatically to customer inquiries, this webhook ensures you can efficiently manage and react to incoming messages.

Here, you'll find information on webhook configuration, expected payloads, and practical examples to help you effectively leverage this feature in your communication strategies.

Signature Header

Dexatel signs every webhook request message sent to the user. The signature of each message is computed using the HMAC_SHA256 hashing algorithm, which takes the payload of the webhook, signs with the secret, and sends the computed hash code in the X-Dexatel-Signature header of the request.

NameTypeDescription
X-Dexatel-SignaturestringX-Dexatel-Signature header

Request Body

POST request payload sent in data property in JSON format

NameTypeDescription
account_idstringUnique identifier of the account to which the message was sent
eventstringMessage
fromstringThe phone number that sent the message
tostringSenderID that received the inbound message.
textstringText of the message
channelnumberMessaging channel to which the contact belongs.
Possible Values:
• SMS
• VIBER,
• WHATSAPP
timestampstringThe timestamp value of the inbound message

Request Body Example

POST: {configured url}
X-Dexatel-Key: 94d2f2f2884848bca861264ad86d8ace
Content-Type: application/json
{
    "data": {
        "account_id": "72e47e47-95b9-41c2-bdcd-55dd9bb04e14",
        "event": "message",
        "from": "1222444444",
        "to": "1222333333",
        "text": "sign me in please",
        "channel": "SMS",
        "timestamp": "2022-03-01 13:00:00"
    }
}