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

**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](https://mintcdn.com/jelouai/gJH8RLsyTV3C4rxe/assets/images/channels/custom-selector-pt.png?fit=max\&auto=format\&n=gJH8RLsyTV3C4rxe\&q=85\&s=799a2c0896c36dc8e055fcf766df93c4)

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](https://mintcdn.com/jelouai/gJH8RLsyTV3C4rxe/assets/images/channels/custom-modal-pt.png?fit=max\&auto=format\&n=gJH8RLsyTV3C4rxe\&q=85\&s=2f167b1c54b540dada8a68e71b4bdc15)

Modal de configuração do canal personalizado

> [!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.

**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](https://mintcdn.com/jelouai/gJH8RLsyTV3C4rxe/assets/images/channels/custom-canvas-pt.png?fit=max\&auto=format\&n=gJH8RLsyTV3C4rxe\&q=85\&s=da26187dad21acc4078423aa58a5beba)

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](https://docs.jelou.ai/pt/api/custom-channel/formato-resposta.md#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](https://docs.jelou.ai/pt/api/custom-channel/introducao.md)**
>
> Introdução, endpoints, formatos de resposta e assinatura HMAC.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.