Seguridad
Al configurar puntos finales de webhook, puede proteger su aplicación contra solicitudes no deseadas configurando el secreto del webhook. Cada firma de solicitud se crea utilizando el algoritmo hash HMAC_SHA256. El algoritmo firma la carga útil del webhook con el secreto que usted proporcionó. El hash resultante se incluye en el encabezado de la firma de la solicitud en el siguiente formato:
X-TopMessage-Signature: {TOPMESSAGE_HMAC_SIGNATURE}
Administre sus puntos finales de webhook
aquí
Ejemplos de casos de uso
Los siguientes son algunos ejemplos de casos de uso para la API TopMessage:
Parámetros de solicitud completos
Nombre | Amable | Descripción |
---|---|---|
data | object | Contiene información del mensaje. |
Data Object
Nombre | Amable | Descripción |
---|---|---|
id | string | Identificador único de su mensaje. |
request_id | string | Identificador único de solicitud generada por usted para rastrear solicitudes. Por defecto: NULL |
channel | string | El canal de comunicación envía su mensaje. Valores posibles: SMS y WHATSAPP |
status | string | Estado inicial de su mensaje. Valores posibles: PENDING , FAILED , DELIVERED , SEEN |
type | string | Tipo de evento relacionado con el mensaje. |
POST
https://{tu_dominio}/tu_webhook/ruta
X-Topmessage-Signature: {TOPMESSAGE_HMAC_SIGNATURE}
Content-Type: application/json
Solicitar muestra
Payload
Java
Python
PHP
Node.js
C#
{
"data": {
"id": "b04fc4d3-f232-46b7-b66b-538c0d4b3404",
"request_id": "b04fc4d3-f232-46b7-b66b-538c0d4b3404",
"channel": "SMS",
"status": "DELIVERED",
"type": "STATUS"
}
}
Muestra de respuesta
200 OK