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.
Seção Canais da Jelou com a opção personalizado destacada

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 com webhook, autenticação e signing key

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.
Brain Studio com o canal personalizado selecionado na lista de workflows e o nó Início no canvas

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 timeout de 20 segundos e uma única tentativa (sem retries automáticos). Seu endpoint deve responder rápido e de forma confiável.

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.