Webhooks Message API Overview and Guide

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.

Name	Type	Description
X-Dexatel-Signature	string	X-Dexatel-Signature header

Request Body

POST request payload sent in data property in JSON format

Name	Type	Description
account_id	string	Unique identifier of the account to which the message was sent
message_id	string	Unique identifier of the message
event	string	Message
from	string	The phone number that sent the message
to	string	SenderID that received the inbound message.
text	string	Text of the message
channel	number	Messaging channel to which the contact belongs. Possible Values: • SMS • VIBER, • WHATSAPP
timestamp	string	The timestamp value of the inbound message

Request Body Example

POST: {configured url}
X-Dexatel-Signature: tfohtYVSauiKc7jJncqDJ4I4RL6A2AKbCUQL6BfuMtk=
Content-Type: application/json
{
    "data": {
        "account_id": "72e47e47-95b9-41c2-bdcd-55dd9bb04e14",
        "message_id":"8cd2ac02-0cf6-4842-88a9-1b577ff97242",
        "event": "message",
        "from": "1222444444",
        "to": "1222333333",
        "text": "sign me in please",
        "channel": "SMS",
        "timestamp": "2022-03-01 13:00:00"
    }
}