Referencia Técnica

Runbook orientado a desarrolladores para integraciones reales: endpoint, payload, respuesta y comportamiento operacional.

TL;DR de integración

Base URL: https://server.sendeasy.pro
Auth: Authorization: Bearer <token>
Formatos: application/json y multipart/form-data
Muchos flujos se encolan de forma asíncrona
Trata error como contrato estable de máquina

Endpoint principal de envío

POST /api/messages/send

curl --location 'https://server.sendeasy.pro/api/messages/send' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer CHANNEL_TOKEN' \
  --data '{
    "number": "5511999999999",
    "body": "Hola desde la integración"
  }'

Respuesta típica:

{
  "message": "Message queued successfully"
}

Referencia rápida WABA

Prefijo:

/api/v1/waba/:whatsappId

Ejemplos:

GET /templates
POST /send
POST /send-text
POST /send-image
POST /send-document
POST /marketing-lite/send

Referencia rápida de webhooks

Forma del payload enviado a tu URL de webhook:

{ event, channel, data, channelId }

Ejemplo:

{
  "event": "messages.upsert",
  "channel": "whatsapp",
  "data": {},
  "channelId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Estrategia de error

function normalizeApiError(status, body) {
  return {
    status,
    code: body?.error || 'UNKNOWN_ERROR',
    message: body?.message || null,
  }
}

Para detalles completos por endpoint, continúa con las páginas de esta sección server (API Pública, Integraciones, WABA, Webhooks y Traducciones de Errores).