# Conecta tu Agente con WhatsApp

### Requisitos previos

Antes de comenzar, asegúrate de tener lo siguiente:

* **Un Agente de Texto de Dapta** ya creado y configurado.
* **Un número de teléfono** que **no** esté registrado con otra cuenta de WhatsApp.
* **Acceso al número de teléfono** para recibir un código de verificación por SMS.
* **Ventanas emergentes permitidas** en tu navegador para el sitio de Dapta.
* **Una URL válida de sitio web o perfil comercial de Instagram** — Meta lo requiere para evitar bloqueos en tu Cuenta de WhatsApp Business.

{% hint style="warning" %}
El número de teléfono que utilices **no debe estar vinculado a una cuenta de WhatsApp existente**. Si lo está, deberás desvincularlo de WhatsApp antes de conectarlo a Dapta.
{% endhint %}

***

### Guía paso a paso

**Paso 1:** Ve a **Agentes de texto** en la barra lateral izquierda y haz clic en el agente que deseas conectar a WhatsApp.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2FXXK0RcRXitt8Q9fJ0fcO%2Fimage.png?alt=media&#x26;token=bac3d93e-a16f-4fd2-8d56-5913a35e5aeb" alt=""><figcaption></figcaption></figure>

***

**Paso 2:** Dentro del agente, haz clic en la pestaña **Canales** en la parte superior de la página. Verás dos opciones de canal: **WhatsApp Business** y **Dapta Widget**.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2FPAYD4XnFJU5la4lJ2Exa%2Fimage.png?alt=media&#x26;token=20fbbb80-a0b8-4d8b-8f14-9c8914d5e465" alt=""><figcaption></figcaption></figure>

***

**Paso 3:** Haz clic en el botón **Conectar** en la tarjeta de **WhatsApp Business**. Aparecerá un modal con los requisitos.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2F6rjBvYkIDANeyMYigEqQ%2Fimage.png?alt=media&#x26;token=357b8788-fbd6-41b2-9816-07b2e2fa5743" alt=""><figcaption></figcaption></figure>

Revisa la lista de requisitos:

* Permitir ventanas emergentes para este sitio.
* Tener acceso al número de teléfono para recibir el código de verificación.
* El número no debe estar registrado con otra cuenta de WhatsApp.
* Tu negocio debe tener un sitio web válido o una URL de perfil comercial de Instagram.

Marca la casilla de confirmación y haz clic en **Conectar**.

***

**Paso 4:** En el modal de **Conexión de WhatsApp Business**, completa:

* **Número de Teléfono** — Selecciona tu código de país del menú desplegable e ingresa tu número de teléfono.
* **Nombre visible** — Este es el nombre que tus clientes verán en WhatsApp. Viene prellenado con el nombre de tu agente, pero puedes cambiarlo (máximo 64 caracteres).

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2F6b9pUN0ps0NMKKf0bOUb%2Fimage.png?alt=media&#x26;token=329c1868-9b20-49cb-b74d-9851af803c55" alt=""><figcaption></figcaption></figure>

Haz clic en **Conectar** para continuar.

***

**Paso 5:** Se abrirá una ventana emergente de **Meta Embedded Signup** en una nueva ventana del navegador. Sigue los pasos en la ventana emergente para:

1. Iniciar sesión en tu cuenta de Facebook/Meta.
2. Crear o seleccionar una **Cuenta de Meta Business**.
3. Crear o seleccionar una **Cuenta de WhatsApp Business (WABA)**.
4. Registrar tu número de teléfono.

{% hint style="info" %}
Si la ventana emergente no aparece, asegúrate de que las ventanas emergentes estén permitidas para este sitio en la configuración de tu navegador.
{% endhint %}

***

**Paso 6:** Una vez completado el registro en Meta, la ventana emergente se cerrará automáticamente y Dapta registrará tu remitente de WhatsApp. Verás una **pantalla de éxito** confirmando tu conexión con el número de teléfono mostrado.

Haz clic en **Listo** para finalizar.

***

### Después de conectar

Una vez conectado, la tarjeta de WhatsApp Business en la pestaña **Canales** mostrará:

* Una **insignia de estado** (por ejemplo, `ONLINE`, `CREATING`, `OFFLINE`) en la esquina superior derecha de la tarjeta.
* Un botón **Ver conexión** en lugar del botón Conectar.

Al hacer clic en **Ver conexión** se abre un panel de detalles donde puedes ver:

| Campo                       | Descripción                                                           |
| --------------------------- | --------------------------------------------------------------------- |
| **Número de Teléfono**      | El número de WhatsApp conectado                                       |
| **Estado**                  | Estado actual de la conexión (Online, Offline, etc.)                  |
| **WABA ID**                 | Tu ID de Cuenta de WhatsApp Business                                  |
| **Calificación de calidad** | La calificación de calidad de Meta para tu número (Alta, Media, Baja) |
| **Límite de mensajes**      | Tu nivel actual de mensajería                                         |
| **Sender ID**               | El identificador del remitente de Twilio                              |

{% hint style="info" %}
Tu agente comenzará a responder mensajes de WhatsApp automáticamente una vez que el estado muestre **ONLINE**. Puede tomar unos momentos después de conectar para que el estado se actualice.
{% endhint %}

***

### Conectar con una Cuenta de WhatsApp Business existente

Si tu cuenta de Dapta ya tiene una **Cuenta de WhatsApp Business (WABA)** vinculada de una conexión anterior, el proceso es ligeramente diferente:

1. Sigue los **Pasos 1 a 4** como se describió anteriormente.
2. En lugar de la ventana emergente de Meta, recibirás un **código de verificación de 6 dígitos** por SMS al número de teléfono que ingresaste.
3. Ingresa el código en el **modal de verificación** y haz clic en **Verificar**.
4. Dapta registrará el remitente y mostrará la pantalla de éxito una vez completado.

> **Tip:** Si no recibes el código de verificación, haz clic en **Reenviar código** para que se envíe nuevamente.

***

### Solución de problemas

| Problema                                    | Solución                                                                                                                  |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| La ventana emergente de Meta está bloqueada | Permite las ventanas emergentes para `app.dapta.ai` en la configuración de tu navegador e inténtalo de nuevo              |
| El número de teléfono ya está registrado    | Desvincula el número de tu cuenta de WhatsApp existente primero                                                           |
| No se recibió el código de verificación     | Haz clic en **Reenviar código** y verifica que tengas señal en el número de teléfono                                      |
| La conexión se queda en "Creating"          | Espera unos minutos — el registro puede tardar hasta 60 segundos. Si persiste, intenta desconectar y reconectar           |
| Meta requiere verificación del negocio      | Asegúrate de que tu Cuenta de Meta Business tenga una URL de sitio web o perfil comercial de Instagram válido configurado |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/conecta-tu-agente-con-whatsapp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.