Formato da resposta

​

Descrição

​

Envelope

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

​

Headers da entrega

• Content-Type: application/json
• Auth conforme credentials.auth (se configurada):
  • api_key → header configurável (padrão X-Api-Key)
  • bearer → Authorization: Bearer <value>
  • basic → value é a string completa username:password antes do Base64; o header é Authorization: Basic <base64(username:password)>
• X-Jelou-Signature: sha256=<hmac> calculado sobre os bytes exatos do body HTTP bruto (sempre presente; a signing key é obrigatória). Verifique com esse raw body antes de fazer o parse como JSON; não serialize novamente o objeto parseado.

​

Tipos de mensagem (message)

​

Exemplos

{
  "event": "message",
  "botId": "BOT_ID",
  "userId": "user-123",
  "message": {
    "messageId": "msg-1",
    "type": "TEXT",
    "text": "Como podemos ajudar?"
  }
}

{
  "event": "message",
  "botId": "BOT_ID",
  "userId": "user-123",
  "message": {
    "messageId": "msg-2",
    "type": "BUTTONS",
    "text": "Escolha uma opção",
    "title": "Menu",
    "options": [
      { "title": "Suporte", "description": "" },
      { "title": "Vendas", "description": "" }
    ]
  }
}

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