> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Canal personalizado

> Conecte seu próprio aplicativo aos fluxos do Brain Studio via webhook e API REST

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](/pt/guias/ativacao-canais/personalizado#limitacoes-do-canal).

***

## Processo de integração

<Steps>
  <Step title="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 →](/pt/guias/ativacao-canais/personalizado)
  </Step>

  <Step title="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 →](/pt/api/custom-channel/assinatura-hmac)
  </Step>

  <Step title="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 →](/pt/api/custom-channel/enviar-interacao)
  </Step>

  <Step title="Receber respostas">
    A Jelou faz `POST` no seu webhook com a mensagem do bot. Consulte os formatos por tipo de bolha.

    [Formato da resposta →](/pt/api/custom-channel/formato-resposta)
  </Step>

  <Step title="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 →](/pt/api/custom-channel/consultar-estado)
  </Step>
</Steps>

<Warning>
  A entrega de saída faz **uma única tentativa** (timeout de 20s, sem retry nem backoff). Seu endpoint deve responder rápido e de forma confiável.
</Warning>