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

<Steps>
  <Step title="Abrir la sección Canales">
    Inicia sesión en Jelou, ve a **Canales** y selecciona la opción **personalizado**.

    <Frame caption="Selector de canales con la opción personalizado">
      <img src="https://mintcdn.com/jelouai/_5gMw8RDlLWxYYHc/assets/images/channels/custom-selector-es.png?fit=max&auto=format&n=_5gMw8RDlLWxYYHc&q=85&s=cf6b8f0cf1bc5d5f23da655249942789" alt="Sección Canales de Jelou con la opción personalizado destacada" width="3838" height="1936" data-path="assets/images/channels/custom-selector-es.png" />
    </Frame>
  </Step>

  <Step title="Nombrar el canal">
    Asigna un nombre descriptivo, por ejemplo `App móvil - Producción`. El nombre debe tener entre 4 y 50 caracteres.
  </Step>

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

    <Frame caption="Modal de configuración del canal personalizado">
      <img src="https://mintcdn.com/jelouai/_5gMw8RDlLWxYYHc/assets/images/channels/custom-modal-es.png?fit=max&auto=format&n=_5gMw8RDlLWxYYHc&q=85&s=003b2af1be460c4b36bd2b4b352c353e" alt="Modal de configuración del canal personalizado con webhook, autenticación y signing key" width="1099" height="1175" data-path="assets/images/channels/custom-modal-es.png" />
    </Frame>

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

  <Step title="Guardar y conectar">
    Guarda la configuración y asegúrate de que el canal quede conectado al proyecto correspondiente.
  </Step>

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

    <Frame caption="Canvas de Brain Studio con el canal personalizado seleccionado">
      <img src="https://mintcdn.com/jelouai/_5gMw8RDlLWxYYHc/assets/images/channels/custom-canvas-es.png?fit=max&auto=format&n=_5gMw8RDlLWxYYHc&q=85&s=79573bfd587efeef900650acf8a0cfa8" alt="Brain Studio con el canal personalizado seleccionado en el listado de workflows y el nodo Inicio en el canvas" width="2775" height="1931" data-path="assets/images/channels/custom-canvas-es.png" />
    </Frame>
  </Step>
</Steps>

## Entrega de respuestas

Cuando el agente responde, Jelou hace `POST` a tu webhook. La entrega tiene un timeout de 20 segundos y un solo intento (sin reintentos automáticos). Tu endpoint debe responder rápido y de forma confiable.

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

<Card title="API Canal personalizado" icon="code" href="/api/canal-personalizado/introduccion">
  Introducción, endpoints, formatos de respuesta y firma HMAC.
</Card>