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

# Conecta

> Despliega tu agente por canales, integraciones externas y API para que los usuarios hablen con él donde ya están.

<Info>
  Antes de conectar tu agente, asegúrate de tener listas **Identidad**, **Conocimiento** y **Habilidades**.\
  Un agente bien configurado da mejores respuestas desde la primera conversación.
</Info>

## Conecta tu agente con usuarios reales

La página **Conecta** se organiza en dos pestañas:

* **Canales** — conecta y administra los canales donde tu agente habla con los usuarios.
* **Comportamiento de Mensajería** — configura cómo tu agente maneja los mensajes en cada canal conectado.

Este paso convierte tu agente de «configurado» a «en producción».

***

## Pestaña de Canales

La pestaña de Canales se organiza en tres bloques:

* **Canales** — publica tu agente en canales propios y externos (burbuja web, chat externo, WhatsApp y otros; en la interfaz algunos nombres pueden aparecer en inglés).
* **Integraciones** — conecta herramientas o servicios externos de tu operación.
* **API** — envía y recibe mensajes desde tus propios sistemas.

### Chat externo (salida más rápida)

El **chat externo** te da una URL compartible para lanzar en minutos (en consola puede mostrarse como *External chat*).

<Steps>
  <Step title="Ve a Conecta > Canales">
    Abre tu agente y entra a la página **Conecta**.
  </Step>

  <Step title="Abre el chat externo">
    Selecciona la tarjeta de chat externo / *External chat*.
  </Step>

  <Step title="Copia la URL pública">
    En la pestaña **Domain setup**, busca la tarjeta **Default URL** y haz clic en el botón de copiar para copiar el enlace generado.
  </Step>

  <Step title="Prueba como usuario final">
    Abre el enlace en una ventana privada y valida casos de uso reales.
  </Step>
</Steps>

<Tip>
  También puedes conectar un **dominio personalizado** para que los usuarios accedan a tu Chat Externo desde una URL de marca como `chat.ejemplo.com/ai-agent`. Consulta la página de [Chat Externo](/channels/es/web) para ver todos los detalles de la pestaña de configuración de dominio.
</Tip>

### Burbuja web (embebido en tu sitio)

Usa la **burbuja web** cuando quieras el agente dentro de tu propia web (en consola puede aparecer como *Web bubble* / *Bubble*).

<Steps>
  <Step title="Abre el canal de burbuja">
    En **Conecta > Canales**, abre la tarjeta de burbuja web.
  </Step>

  <Step title="Genera credenciales y fragmentos de código">
    La consola muestra el fragmento (*snippet*) y las claves para la integración.
  </Step>

  <Step title="Añade el fragmento al sitio">
    Pega el script donde tu equipo implementa el código web.
  </Step>

  <Step title="Personaliza la experiencia">
    Ajusta marca, botón de apertura y mensaje de bienvenida.
  </Step>
</Steps>

### Canales de Meta (WhatsApp, Messenger, Instagram)

La página de Conecta siempre muestra una sección de **Meta** con tres tarjetas de canal:

| Canal         | Descripción                               |
| ------------- | ----------------------------------------- |
| **WhatsApp**  | Canal de WhatsApp Business vía Meta       |
| **Messenger** | Canal de Facebook Messenger vía Meta      |
| **Instagram** | Canal de mensajería de Instagram vía Meta |

Cada tarjeta muestra un botón **Conectar** que abre el flujo de configuración de ese canal específico. No necesitas configurar la integración de Meta primero — las tarjetas siempre están visibles para que puedas iniciar el proceso de conexión en cualquier momento.

<Tip>
  Para un paso a paso detallado del proceso de conexión de WhatsApp, consulta la guía [Cómo integrar WhatsApp](/integration-guides/es/como-integrar-whatsapp).
</Tip>

#### Estado de registro de WhatsApp

Después de conectar un canal de WhatsApp, aparece una **insignia de estado de registro** junto al nombre del canal. La insignia te indica en qué punto del proceso de registro con Meta se encuentra el número:

| Estado                     | Significado                                                                                            |
| -------------------------- | ------------------------------------------------------------------------------------------------------ |
| **Registrado**             | El número está completamente registrado y listo para enviar/recibir mensajes.                          |
| **No registrado**          | El número aún no ha sido registrado con Meta.                                                          |
| **Verificación necesaria** | El número debe completar la verificación por SMS o llamada de voz con Meta antes de poder registrarse. |
| Otros estados              | Estados intermedios reportados por Meta (ej. registro en progreso).                                    |

Puedes hacer clic en el ícono de **refrescar** junto a la insignia en cualquier momento para consultar de nuevo el estado actual desde Meta.

##### Verificar un número de teléfono

Cuando el estado es **Verificación necesaria**, aparece un botón **Verificar** junto a la insignia de estado. Esto significa que Meta requiere que confirmes la titularidad del número antes de que pueda ser registrado.

<Steps>
  <Step title="Haz clic en Verificar">
    Haz clic en el botón **Verificar** (ícono de escudo) junto al estado de registro. Se abrirá un popover.
  </Step>

  <Step title="Solicita un código de verificación">
    Elige cómo deseas recibir el código:

    * **Enviar SMS** — Meta envía un código de 6 dígitos por mensaje de texto al número de teléfono.
    * **Llamada de voz** — Meta entrega el código a través de una llamada telefónica automatizada.
  </Step>

  <Step title="Ingresa el código">
    Una vez que recibas el código de 6 dígitos, escríbelo en el campo de entrada del popover.
  </Step>

  <Step title="Enviar">
    Haz clic en **Verificar** para enviar el código. Si la verificación es exitosa, el estado de registro se actualizará automáticamente.
  </Step>
</Steps>

<Note>
  Después de una verificación exitosa, es posible que aún necesites **registrar** el número (usando el flujo de registro/reintento con tu PIN de 6 dígitos). La verificación confirma la titularidad; el registro activa el número en la API de WhatsApp Business.
</Note>

##### Registrar (o re-registrar) un número

Cuando el estado es diferente a **Registrado** o **Verificación necesaria**, aparece un botón **Registrar**. Al hacer clic se abre un popover donde ingresas el **PIN de 6 dígitos** que deseas asociar con el número, y luego envías la solicitud de registro a Meta.

<Warning>
  Recuerda tu PIN — lo necesitarás para cualquier re-registro futuro del mismo número.
</Warning>

***

## Pestaña de Comportamiento de Mensajería

La pestaña **Comportamiento de Mensajería** te permite ajustar cómo tu agente procesa los mensajes entrantes en cada canal. Las configuraciones aquí controlan cosas como el retraso de respuesta, el comportamiento de saludo y cómo se manejan los adjuntos.

<Tip>
  Comienza con los valores predeterminados y ajusta una vez que veas patrones reales de conversación en el panel de **Conversaciones**.
</Tip>
