Skip to main content

Introdução

O canal personalizado permite que seu aplicativo (web, mobile ou backend) execute fluxos publicados no Brain Studio via webhook e API REST, sem depender de WhatsApp ou Meta. A Jelou recebe as interações do seu app, processa o fluxo de forma assíncrona e entrega as respostas do bot na URL que você configurar.

Pré-requisitos

Antes de ativar o canal, certifique-se de ter:
  • Uma conta ativa na Jelou e acesso à seção Canais
  • Um endpoint público na sua infraestrutura para receber as respostas do agente

Ativar o canal

1

Abrir a seção Canais

Faça login na Jelou, acesse Canais e selecione a opção personalizado.

Seletor de canais com a opção personalizado

2

Nomear o canal

Atribua um nome descritivo, por exemplo, App móvel - Produção. O nome deve ter entre 4 e 50 caracteres.
3

Preencher o modal de configuração

No modal informe:
  • A URL do webhook onde a Jelou entregará as respostas do agente (campo obrigatório).
  • O tipo de autenticação opcional (api_key, bearer ou basic) e o respectivo valor, se o seu endpoint exigir.
  • A signing key (HMAC), obrigatória. Use-a para assinar suas solicitações à API da Jelou e verificar as respostas que chegam ao seu sistema.

Modal de configuração do canal personalizado

Os segredos são criptografados em repouso e não são exibidos em texto claro depois de salvar. Se perder um valor, gere um novo e atualize a configuração.
4

Salvar e conectar

Salve a configuração e confirme que o canal está conectado ao projeto correspondente.
5

Construir a lógica no Brain Studio

Abra o projeto no Brain Studio, selecione o canal personalizado na lista de workflows e comece a construir com a Jelou.

Canvas do Brain Studio com o canal personalizado selecionado

Entrega de respostas

Quando o agente responde, a Jelou faz POST no seu webhook. A entrega tem um limite total de 20 segundos que cobre até 3 tentativas, repetidas em 5xx, 429, conexão recusada e sockets resetados. Timeouts e falhas de DNS não são repetidos. Cada tentativa leva o mesmo messageId, então seu endpoint deve deduplicar por ele e responder de forma idempotente. Ver Entrega e novas tentativas.

Limitações do canal

No builder, alguns nós e ferramentas não estão disponíveis no canal personalizado porque dependem do WhatsApp ou de outras integrações.

Nós e blocos indisponíveis

  • Template HSM
  • WhatsApp Flows
  • CTA URL
  • Sticker
  • Carrossel
  • Lista numerada
  • Webview
  • Pagamentos
  • Connect (assessor)
  • Biometria
  • Transferência para humano (HubSpot, Genesys ou outros)
Além disso, nós exclusivos do WhatsApp como Input e a solicitação de localização não aparecem neste canal.

Ferramentas do Agente de IA indisponíveis

  • Call to action (send_call_to_action)
  • Transferir para agente (transfer_to_agent)
  • Jelou Shop

Próximo passo para desenvolvedores

Para enviar interações, verificar assinaturas HMAC e consultar o status da sessão, consulte a referência de API:

API Canal personalizado

Introdução, endpoints, formatos de resposta e assinatura HMAC.