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

# Canales

> Conectar WhatsApp, personalizar el Chat Web e integrar Telegram, Slack y Messenger.

<Info>Espacios → nodo **Canales** (hub) para conectar nuevos · clic en un canal ya conectado para configurarlo</Info>

Cada canal es un nodo del lienzo. El nodo **Canales** (hub) despliega los que puedes conectar; los canales ya conectados muestran *Activo* (o *Sin configurar*, en el caso del Chat Web recién creado).

El número de canales que puedes conectar depende del plan. Al llegar al límite, cualquier canal nuevo abre la comparativa de planes con el detalle *N de M canales — tu plan está completo*. WhatsApp requiere plan *Growth* o superior.

## WhatsApp

<Steps>
  <Step title="Ten a mano">
    Acceso a la cuenta de **Meta Business** de la empresa y un **número de teléfono** que no esté registrado en la app de WhatsApp (o que estés dispuesto a migrar). El número recibirá un código de verificación por SMS o llamada.
  </Step>

  <Step title="Conectar">
    Nodo **Canales** → **WhatsApp**. Verás *Serás redirigido a WhatsApp Business para conectar tu número* y se abrirá una pestaña con el asistente de Meta: inicia sesión, elige o crea la cuenta de WhatsApp Business (WABA), registra el número y verifica el código.
  </Step>

  <Step title="Confirmar">
    Al terminar, la pestaña vuelve a Sofia Chat con *WhatsApp conectado exitosamente* y el canal aparece en el lienzo como **WhatsApp · Activo**. Escribe un mensaje al número desde tu celular: el agente debe responder.
  </Step>
</Steps>

<Warning>
  **Método de pago en Meta.** Para que WhatsApp **entregue mensajes salientes** (respuestas fuera de la ventana de 24 h, plantillas, campañas), la cuenta de WhatsApp Business necesita un método de pago válido en Meta Business Suite → Configuración → Pagos. Sin él, los mensajes fallan con el error *131042: Business eligibility payment issue*. Las respuestas dentro de la ventana de 24 h sí funcionan.
</Warning>

Un canal de WhatsApp conectado no tiene panel de configuración: su nombre visible, foto y descripción se gestionan en Meta Business. Desde Sofia Chat solo puedes **Eliminar canal**.

## Chat Web

El widget de chat para tu sitio web. Se crea solo al configurar el departamento; haz clic en el nodo **Chat Web** para abrir su panel, con tres pestañas.

### Scripts

| Sección        | Qué hacer                                                                                                                                                                                                              |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Dominios**   | Lista de sitios autorizados a mostrar el chat (`https://tu-dominio.com`). Si está vacía, el chat funciona en cualquier página donde pegues el código. Por seguridad, añade tus dominios en cuanto salgas a producción. |
| **Ver script** | Muestra el código `<script src="…/CI{id}.js"></script>`. **Copiar** y pegarlo una sola vez dentro de `<head>` de tu sitio. El chat aparece solo.                                                                       |

### Config

| Grupo             | Campo                               | Notas                                                                  |
| ----------------- | ----------------------------------- | ---------------------------------------------------------------------- |
| Apariencia        | **Avatar**                          | PNG o JPG; se recorta cuadrado. **Quitar imagen** vuelve a la inicial. |
| Textos            | **Nombre del chat**                 | Título de la ventana (*Atención al cliente*).                          |
|                   | **Nombre del agente**               | Cómo se presenta el asistente dentro del chat (*Sofía*).               |
|                   | **CTA**                             | Frase de invitación bajo el nombre (*¿En qué te ayudo?*).              |
|                   | **Descripción**                     | Una línea de bienvenida al abrir el chat.                              |
| Mensaje proactivo | **Mensaje proactivo** (interruptor) | El chat se abre solo con un saludo tras unos segundos en la página.    |
|                   | **Mensaje**                         | El saludo (*¡Hola! ¿En qué te podemos ayudar?*).                       |
|                   | **Delay**                           | Segundos de espera, de 3 a 60 (10 por defecto).                        |
| —                 | **Vista previa**                    | Abre un simulador interactivo del widget con la configuración actual.  |

### Diseño

Colores por zona (**Burbuja flotante**: botón e icono · **Header del widget**: fondo y texto · **Área de chat**: fondo, globos del agente, globos del usuario, texto y timestamps), radios de **ventana** y **mensajes** (0–24), y **Temas rápidos**: seis combinaciones prediseñadas que aplican todos los colores de una vez.

Pulsa **Guardar** al terminar (el panel avisa *Sin guardar* mientras haya cambios).

<Tip>
  Un mensaje proactivo a los 10 segundos multiplica las conversaciones iniciadas, pero en páginas de lectura larga (blog, términos) puede molestar. Si tu sitio tiene ambos tipos de página, súbelo a 30–45 segundos.
</Tip>

## Telegram

1. En Telegram, habla con **@BotFather**, crea un bot (`/newbot`) y copia el **token**.
2. Nodo **Canales** → **Telegram**. Se abre el panel: pega el token en **Token del bot** y pulsa **Conectar**.
3. El estado pasa a **Conectado** y muestra el usuario del bot y su enlace directo `t.me/…`.

**Desconectar** detiene el bot sin eliminar el canal.

## Slack

Nodo **Canales** → **Slack** abre la autorización de Slack en una ventana emergente; elige el espacio de trabajo y acepta los permisos. El canal queda activo y el agente responde a mensajes directos y menciones. Con el lápiz (**Editar integración Slack**) cambias el nombre del canal.

## Messenger

Nodo **Canales** → **Facebook Messenger** crea el canal; luego **Configurar Messenger** (engranaje) abre su configuración:

1. Copia el **Webhook de integración** y el **Código de webhook** y regístralos en la app de Meta for Developers de tu página (Webhooks → Messenger).
2. Pega el **Identificador de página** y el **token** de acceso de la página.
3. **Guardar**. El badge del código pasa a **Validado** cuando Meta confirma el webhook.

## Eliminar un canal

Clic en el canal → **Eliminar canal** → confirmar. Dejarás de enviar y recibir mensajes por ahí; las conversaciones anteriores se conservan y puedes volver a conectarlo más tarde. El Chat Web no se elimina, solo se reconfigura.
