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

> Activa y configura el canal personalizado para conectar tu propia aplicación a Brain Studio.

## Introducción

El canal **personalizado** permite que tu aplicación (web, móvil u otro backend) ejecute flujos publicados en Brain Studio mediante webhook y API REST, sin depender de WhatsApp ni Meta.

Jelou recibe las interacciones de tu app, procesa el flujo de forma asíncrona y entrega las respuestas del bot a la URL que configures.

## Requisitos previos

Antes de activar el canal, asegúrate de tener:

* Una cuenta activa en Jelou y acceso a la sección **Canales**
* Un endpoint público en tu infraestructura para recibir las respuestas del agente

## Activar el canal

**1. Abrir la sección Canales**

Inicia sesión en Jelou, ve a **Canales** y selecciona la opción **personalizado**.

![Sección Canales de Jelou con la opción personalizado destacada](https://mintcdn.com/jelouai/gJH8RLsyTV3C4rxe/assets/images/channels/custom-selector-es.png?fit=max\&auto=format\&n=gJH8RLsyTV3C4rxe\&q=85\&s=34e34825595f0152b61cdec0115f71ee)

Selector de canales con la opción personalizado

**2. Nombrar el canal**

Asigna un nombre descriptivo, por ejemplo `App móvil - Producción`. El nombre debe tener entre 4 y 50 caracteres.

**3. Completar el modal de configuración**

En el modal indica:

* La **URL del webhook** donde Jelou entregará las respuestas del agente (campo obligatorio).
* El **tipo de autenticación** opcional (`api_key`, `bearer` o `basic`) y su valor, si tu endpoint lo requiere.
* La **signing key** (HMAC), **obligatoria**. Úsala para firmar tus solicitudes a la API de Jelou y verificar las respuestas que llegan a tu sistema.

![Modal de configuración del canal personalizado con webhook, autenticación y signing key](https://mintcdn.com/jelouai/gJH8RLsyTV3C4rxe/assets/images/channels/custom-modal-es.png?fit=max\&auto=format\&n=gJH8RLsyTV3C4rxe\&q=85\&s=3dc97cdf7650f0c632cff17e03c002c4)

Modal de configuración del canal personalizado

> [!NOTE]
>
> Los secretos se cifran en reposo y no se muestran en texto plano después de guardar. Si pierdes un valor, genera uno nuevo y actualiza la configuración.

**4. Guardar y conectar**

Guarda la configuración y asegúrate de que el canal quede conectado al proyecto correspondiente.

**5. Construir la lógica en Brain Studio**

Abre el proyecto en Brain Studio, selecciona el canal **personalizado** en el listado de workflows y comienza a construir con Jelou.

![Brain Studio con el canal personalizado seleccionado en el listado de workflows y el nodo Inicio en el canvas](https://mintcdn.com/jelouai/gJH8RLsyTV3C4rxe/assets/images/channels/custom-canvas-es.png?fit=max\&auto=format\&n=gJH8RLsyTV3C4rxe\&q=85\&s=b15b17b9693c7b06da3e4c5af8d371bc)

Canvas de Brain Studio con el canal personalizado seleccionado

## Entrega de respuestas

Cuando el agente responde, Jelou hace `POST` a tu webhook. La entrega tiene un límite total de 20 segundos que cubre hasta 3 intentos, reintentados ante 5xx, 429, conexión rechazada y sockets reseteados. Los timeouts y los fallos de DNS **no** se reintentan. Cada intento lleva el mismo `messageId`, así que tu endpoint debe deduplicar por él y responder de forma idempotente. Ver [Entrega y reintentos](https://docs.jelou.ai/api/canal-personalizado/formato-respuesta.md#entrega-y-reintentos).

## Limitaciones del canal

En el builder, algunos nodos y herramientas no están disponibles en el canal **personalizado** porque dependen de WhatsApp u otras integraciones.

### Nodos y bloques no disponibles

* Plantilla HSM
* WhatsApp Flows
* CTA URL
* Sticker
* Carrusel
* Lista numerada
* Webview
* Pagos
* Connect (asesor)
* Biometría
* Transferencia a humano (HubSpot, Genesys u otros)

Además, nodos exclusivos de WhatsApp como **Input** y la solicitud de ubicación no aparecen en este canal.

### Herramientas del Agente IA no disponibles

* Call to action (`send_call_to_action`)
* Transferir a agente (`transfer_to_agent`)
* Jelou Shop

## Siguiente paso para desarrolladores

Para enviar interacciones, verificar firmas HMAC y consultar el estado de la sesión, consulta la referencia de API:

> **[API Canal personalizado](https://docs.jelou.ai/api/canal-personalizado/introduccion.md)**
>
> Introducción, endpoints, formatos de respuesta y firma HMAC.


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