Enviar interação

Descrição

Seu aplicativo envia uma interação ao agente. A Jelou valida a assinatura HMAC, responde imediatamente com 202 e um executionId, e processa o fluxo de forma assíncrona. As respostas do agente chegam depois no seu webhookUrl.

Endpoint

POST https://chatbot.jelou.ai/v1/custom-channel/{botId}

Parâmetros de rota

string

obrigatório

Identificador do agente com canal personalizado habilitado.

Parâmetros do corpo

string

obrigatório

Identificador estável do usuário no seu sistema. Usado como userId nas entregas de saída e para consultar o status da sessão.

object

obrigatório

Payload da mensagem encaminhado ao fluxo do agente. Um exemplo típico de texto é { "type": "TEXT", "text": "Olá" }.

Autenticação / assinatura

Inclua o header obrigatório:

X-Jelou-Signature: sha256=<HMAC_HEX>

A assinatura é calculada sobre o raw body exato da requisição (HMAC-SHA256). Detalhes em Assinatura HMAC. A autenticação credentials.auth do canal não é exigida neste endpoint: aplica-se apenas às chamadas de saída da Jelou para o seu webhook.

Exemplo de solicitação

cURL

curl --request POST \
  --url https://chatbot.jelou.ai/v1/custom-channel/BOT_ID \
  --header 'Content-Type: application/json' \
  --header 'X-Jelou-Signature: sha256=HMAC_HEX' \
  --data '{
    "referenceId": "user-123",
    "message": {
      "type": "TEXT",
      "text": "Olá"
    }
  }'

Respostas

Código	Status	Descrição
202	Accepted	Interação aceita. O fluxo é processado em segundo plano.
400	Bad Request	Falta `referenceId` ou está vazio.
401	Unauthorized	Assinatura inválida, ausente ou chave não resolvida.
500	Internal Server Error	Erro interno (por exemplo, canal não resolvido).

Exemplo de resposta

{
  "executionId": "EXECUTION_ID"
}

Um 202 não garante que o fluxo terminou com sucesso. Use consultar status e/ou aguarde a entrega no seu webhook.

⌘I

Referência de API

Enviar Mensagens

Campanhas

Conversações

Métricas

Usuários

Recursos

Widget

Datum

Painel de Atendimento Externo

Canal Personalizado

Gestão de Memória

Descrição

Endpoint

Parâmetros de rota

Parâmetros do corpo

Autenticação / assinatura

Exemplo de solicitação

Respostas

Exemplo de resposta

​Descrição

​Endpoint

​Parâmetros de rota

​Parâmetros do corpo

​Autenticação / assinatura

​Exemplo de solicitação

​Respostas

​Exemplo de resposta

Descrição

Endpoint

Parâmetros de rota

Parâmetros do corpo

Autenticação / assinatura

Exemplo de solicitação

Respostas

Exemplo de resposta