Pular para o conteúdo principal
Com um canal personalizado, seu app (web, mobile ou backend) pode executar fluxos publicados no Brain Studio sem depender de WhatsApp ou Meta. Seu sistema envia interações para a Jelou, o agente processa o fluxo de forma assíncrona e a Jelou entrega as respostas a um webhookUrl que você controla. Alguns nós e ferramentas do builder não estão disponíveis neste canal. Consulte as limitações do canal.

Processo de integração

1

Ativar o canal no builder

Habilite personalizado, defina o webhook, sua autenticação e a chave de assinatura HMAC (obrigatória) pela interface.Guia de ativação →
2

Assinar as requisições

Assine o corpo de cada requisição de entrada (interação e consulta de status) e verifique a assinatura de cada entrega de saída.Assinatura HMAC →
3

Enviar interações

Envie mensagens ou ações do usuário para POST /v1/custom-channel/:botId. A Jelou responde imediatamente com um executionId e processa o fluxo em segundo plano.Enviar interação →
4

Receber respostas

A Jelou faz POST no seu webhook com a mensagem do bot. Consulte os formatos por tipo de bolha.Formato da resposta →
5

Consultar o status

Use POST /v1/custom-channel/:botId/status com assinatura HMAC para saber se a sessão está em execução, aguardando input ou idle.Consultar status →
A entrega de saída tem até 3 tentativas no total, dentro de um limite de 20s em falhas rápidas (5xx, 429, conexão recusada ou resetada). As novas tentativas levam o mesmo messageId, então seu endpoint deve deduplicar por ele e responder de forma idempotente. Um timeout nunca é repetido. Seu endpoint deve responder rápido e de forma confiável.Entrega e novas tentativas →