REST API v1

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.

// Cabecera HTTP obligatoria en cada petición:
Authorization: Bearer wa_token_tu_sistema_aqui

También se admite la cabecera alternativa X-API-Token: wa_token_tu_sistema_aqui.

URL Base

https://notificaciones.systemsmx.com/api/v1
POST /api/v1/send-message

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`)

{ "success": true, "message": "Mensaje encolado con éxito", "messageId": "ca00b96d-06f6-40df-9900-aff2f138087c", "insertedOn": "2026-08-10T18:55:00.000Z" }

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

202 Accepted

Encolado Exitoso

El mensaje fue validado e insertado en Azure Queue. Se enviará de inmediato.

401 Unauthorized

Token Inválido

Falta la cabecera Authorization o el API Token ha sido revocado.

400 Bad Request

Payload Incorrecto

Falta el parámetro targetNumber o textBody en el JSON enviado.