Documentación de la API de Notificaciones
La API de Systemsmx Notificaciones permite el envío asíncrono y de alta velocidad de mensajes por WhatsApp hacia tus clientes y usuarios. Funciona sobre una arquitectura desacoplada respaldada por colas de Azure Storage Queue, garantizando una respuesta ultrarrápida (< 100ms) y cero pérdida de mensajes.
Autenticación (API Tokens)
Todas las peticiones a la API requieren un token de autorización. Puedes generar múltiples API Tokens desde tu consola de administración de Systemsmx. Cada token representa un inquilino (*tenant*) con su propia sesión de WhatsApp y su propia cola de mensajes.
También se admite la cabecera alternativa X-API-Token: wa_token_tu_sistema_aqui.
URL Base
Encola un mensaje de texto para ser despachado inmediatamente por WhatsApp.
Parámetros del Cuerpo (JSON)
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| targetNumber | string | Sí | Número de teléfono con código de país. Si envías 10 dígitos (ej. 3311620660), se antepone automáticamente +521. |
| textBody | string | Sí | Contenido en texto plano del mensaje de WhatsApp. |
Respuesta de Éxito (`HTTP 202 Accepted`)
Ejemplos en Múltiples Lenguajes
Selecciona tu lenguaje favorito para ver el código listo para usar en tu proyecto:
curl -X POST https://notificaciones.systemsmx.com/api/v1/send-message \
-H "Authorization: Bearer wa_token_tu_sistema_aqui" \
-H "Content-Type: application/json" \
-d '{
"targetNumber": "5215512345678",
"textBody": "Hola! Tu pedido #1042 ha sido enviado 🚚"
}'
Códigos de Respuesta HTTP
Encolado Exitoso
El mensaje fue validado e insertado en Azure Queue. Se enviará de inmediato.
Token Inválido
Falta la cabecera Authorization o el API Token ha sido revocado.
Payload Incorrecto
Falta el parámetro targetNumber o textBody en el JSON enviado.