> ## 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

> Ative e configure o canal personalizado para conectar seu próprio aplicativo ao Brain Studio.

## 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

<Steps>
  <Step title="Abrir a seção Canais">
    Faça login na Jelou, acesse **Canais** e selecione a opção **personalizado**.

    <Frame caption="Seletor de canais com a opção personalizado">
      <img src="https://mintcdn.com/jelouai/_5gMw8RDlLWxYYHc/assets/images/channels/custom-selector-pt.png?fit=max&auto=format&n=_5gMw8RDlLWxYYHc&q=85&s=4964d667a34cc87760121402e58be160" alt="Seção Canais da Jelou com a opção personalizado destacada" width="3837" height="1938" data-path="assets/images/channels/custom-selector-pt.png" />
    </Frame>
  </Step>

  <Step title="Nomear o canal">
    Atribua um nome descritivo, por exemplo, `App móvel - Produção`. O nome deve ter entre 4 e 50 caracteres.
  </Step>

  <Step title="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.

    <Frame caption="Modal de configuração do canal personalizado">
      <img src="https://mintcdn.com/jelouai/_5gMw8RDlLWxYYHc/assets/images/channels/custom-modal-pt.png?fit=max&auto=format&n=_5gMw8RDlLWxYYHc&q=85&s=a6739ef3487ca78a85383d25fdd93aed" alt="Modal de configuração do canal personalizado com webhook, autenticação e signing key" width="1099" height="1175" data-path="assets/images/channels/custom-modal-pt.png" />
    </Frame>

    <Note>
      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.
    </Note>
  </Step>

  <Step title="Salvar e conectar">
    Salve a configuração e confirme que o canal está conectado ao projeto correspondente.
  </Step>

  <Step title="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.

    <Frame caption="Canvas do Brain Studio com o canal personalizado selecionado">
      <img src="https://mintcdn.com/jelouai/_5gMw8RDlLWxYYHc/assets/images/channels/custom-canvas-pt.png?fit=max&auto=format&n=_5gMw8RDlLWxYYHc&q=85&s=db2eefb24150eaacbf11091fe5e37427" alt="Brain Studio com o canal personalizado selecionado na lista de workflows e o nó Início no canvas" width="2775" height="1931" data-path="assets/images/channels/custom-canvas-pt.png" />
    </Frame>
  </Step>
</Steps>

## 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:

<Card title="API Canal personalizado" icon="code" href="/pt/api/custom-channel/introducao">
  Introdução, endpoints, formatos de resposta e assinatura HMAC.
</Card>