Formato de respuesta

​

Descripción

​

Envelope

{
  "event": "message",
  "botId": "BOT_ID",
  "userId": "user-123",
  "message": {
    "messageId": "msg-1",
    "type": "TEXT"
  }
}

​

Headers de la entrega

• Content-Type: application/json
• Auth según credentials.auth (si está configurada):
  • api_key → header configurable (default X-Api-Key)
  • bearer → Authorization: Bearer <value>
  • basic → value es la cadena completa username:password antes de Base64; el header es Authorization: Basic <base64(username:password)>
• X-Jelou-Signature: sha256=<hmac> calculado sobre los bytes exactos del body HTTP crudo (siempre presente; la signing key es obligatoria). Verifica con ese raw body antes de parsearlo como JSON; no vuelvas a serializar el objeto parseado.

​

Tipos de mensaje (message)

​

Ejemplos

{
  "event": "message",
  "botId": "BOT_ID",
  "userId": "user-123",
  "message": {
    "messageId": "msg-1",
    "type": "TEXT",
    "text": "¿En qué podemos ayudarte?"
  }
}

{
  "event": "message",
  "botId": "BOT_ID",
  "userId": "user-123",
  "message": {
    "messageId": "msg-2",
    "type": "BUTTONS",
    "text": "Elige una opción",
    "title": "Menú",
    "options": [
      { "title": "Soporte", "description": "" },
      { "title": "Ventas", "description": "" }
    ]
  }
}

{
  "event": "message",
  "botId": "BOT_ID",
  "userId": "user-123",
  "message": {
    "messageId": "msg-3",
    "type": "IMAGE",
    "mediaUrl": "https://cdn.example.com/foto.jpg",
    "caption": "Comprobante"
  }
}