> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/canales/conecta-tu-agente-con-whatsapp.md).
# Conecta tu Agente con WhatsApp
Conecta un número de WhatsApp a tu Agente de Texto, paso a paso: desde Números de WhatsApp en Dapta hasta la ventana de Meta, y después elige el agente, confirma que un cliente real recibe respuesta y
Este es el paso en el que tu agente deja de ser una demo y empieza a responderle a gente real. Toma unos cinco minutos: unas pocas pantallas en Dapta y luego la ventana de Meta, donde eliges tu negocio y tu número.
## Antes de empezar
Ten esto listo. A la mayoría de las conexiones que fallan les falta una de estas cosas.
* **Un Agente de Texto que ya probaste.**
* **Las ventanas emergentes permitidas para `app.dapta.ai`.** La ventana de Meta se abre como ventana emergente.
* **Acceso de administrador a tu negocio en Meta.** Inicias sesión con la cuenta de Facebook que administra tu portafolio comercial.
* **Un sitio web o la URL de tu perfil comercial de Instagram.** Meta la pide para evitar bloqueos del número.
* **El teléfono con el número.** Si el número ya está en la aplicación de WhatsApp Business, escaneas un código QR con él. Si no, recibes en él un código de verificación por SMS o llamada.
{% hint style="info" %}
**¿Compraste un número con Dapta?** Nuestro equipo lo conecta contigo. En **Números de WhatsApp**, haz clic en **Agendar sesión con Dapta** (o en **Agenda una sesión** dentro del diálogo **Antes de conectar**) y elige un horario.
{% endhint %}
{% content-ref url="/pages/C3dSaL46bIZAUBNEca5I" %}
[Prepara tu cuenta de Meta](/dapta-docs-es/agentes-de-texto/canales/prepara-tu-cuenta-de-meta.md)
{% endcontent-ref %}
## Conecta la línea
### En Dapta
**Paso 1:** Entra en **Agentes de Texto → Canales** y, en la tarjeta **WhatsApp**, haz clic en **Ver conexiones**. Se abre **Números de WhatsApp**.
***
**Paso 2:** Empieza la conexión.
* **Tu primer número:** la página te muestra los tres pasos, **Conecta con Meta**, **Elige tu agente** y **Pruébalo**, y **Lo que necesitas**. Haz clic en **Continuar con Meta**.
* **Otro número:** haz clic en **Conectar número**. El diálogo **Antes de conectar** te recuerda que debes ser administrador del negocio en Meta y te muestra los dos tipos de número que puedes elegir en la ventana de Meta. Haz clic en **Continuar**.
| En Meta eliges | Qué significa |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Número nuevo** | Aún no está en WhatsApp. Funciona solo en Dapta y lo verificas con un SMS o una llamada. |
| **Número de WhatsApp Business** | El que ya usas en la app. Sigues usándola en tu celular y tu agente responde por el mismo número. Escaneas un código QR. |
Se abre la ventana de Meta, y Dapta muestra **Conectando tu número** mientras trabajas en ella. No cierres la pestaña de Dapta. Si no ves la ventana de Meta, revisa el bloqueador de ventanas emergentes.
### En la ventana de Meta
**Paso 3:** Elige tu **Portafolio comercial**. En **Cuenta de WhatsApp Business**, elige **Conecta una app de WhatsApp Business** para seguir usando la aplicación en tu teléfono, o **Crear una cuenta de WhatsApp Business** para un número que todavía no está en WhatsApp. Haz clic en **Siguiente**.
***
**Paso 4:** Selecciona el país e ingresa tu número de teléfono. Haz clic en **Siguiente**.
***
**Paso 5:** Si el número está en la aplicación de WhatsApp Business, Meta explica qué significa conectarlo: tu equipo conserva el acceso total a la aplicación, y parte de la información de la cuenta se comparte con Dapta. Haz clic en **Siguiente**.
***
**Paso 6:** Abre la **aplicación de WhatsApp Business** en el teléfono y escanea el código QR.
1. En la aplicación, busca un mensaje de la cuenta oficial de Facebook Business y toca **Conectar**. Si no lo ves, entra en **Menú** o **Configuración → Cuenta → Business Platform**.
2. Elige si quieres compartir tu historial de chats. Meta puede traer tus contactos y hasta seis meses de conversaciones.
3. Si no puedes escanear, usa **Usar código de acceso** en la ventana de Meta y escribe el código que te muestra la aplicación.
El código QR vence a los pocos minutos. Si vence, haz clic en **Haz clic para volver a cargar el código QR**.
***
**Paso 7:** Confirma el **Nombre de la cuenta de WhatsApp Business**, elige tu **Zona horaria** y haz clic en **Siguiente**.
***
**Paso 8:** Revisa lo que Dapta podrá hacer (administrar tus cuentas de WhatsApp y sus conversaciones) y haz clic en **Confirmar**.
***
**Paso 9:** Espera el mensaje **Tu cuenta está conectada a Dapta**. Meta revisa tu negocio según su Política de comercio y te avisa en un plazo de 24 horas si hay algún problema.
Haz clic en **Agregar método de pago** para configurar cómo te cobra Meta la entrega de tus mensajes, y luego en **Finalizar**. Sin un método de pago en la cuenta de WhatsApp Business, tu agente no puede responder. Mira [Agrega un método de pago a WhatsApp](/dapta-docs-es/agentes-de-texto/canales/agrega-un-metodo-de-pago-a-whatsapp.md).
### De vuelta en Dapta
**Paso 10:** Espera **Listo para usar**. Dapta verifica el número con Meta y luego lo abre para que elijas el agente que responde.
Si Dapta dice **Ya casi**, Meta aún está terminando la configuración. Verifica el número de nuevo en unos minutos.
{% hint style="info" %}
Dapta cobra el agente, en créditos. Meta cobra la entrega de cada mensaje en WhatsApp, al método de pago de tu propia cuenta de Meta. Mira [Facturación de WhatsApp y cargos de Meta](/dapta-docs-es/agentes-de-texto/canales/facturacion-de-whatsapp-lineas-legacy-y-directas.md).
{% endhint %}
{% hint style="warning" %}
No elimines tu cuenta de WhatsApp ni quites el número de Meta para que una conexión funcione. Destruye tu historial de chats y casi nunca arregla nada. Si rechazan un número, pregúntale primero a soporte cuál es el motivo real.
{% endhint %}
## Asigna el agente
Una línea conectada no le responde a nadie hasta que tenga un agente asignado. Son dos pasos distintos, y olvidar el segundo es el motivo más común de que una línea nueva se quede muda.
Justo después de conectar se abren los detalles del número. En **Agente**, elige el Agente de Texto en **Elige un agente**. Se guarda en cuanto lo eliges. Para cambiarlo después, haz clic en el número en la lista.
Reasignar después cambia quién responde las conversaciones **nuevas**. No mueve el historial existente y no necesariamente cambia el agente de las conversaciones que ya están en curso.
## Comprueba que de verdad funciona
Conectada, asignada y entregando de verdad son tres cosas distintas. Haz las cuatro comprobaciones antes de poner el número en tu sitio web.
| Comprobación | Cómo |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **El número correcto, el espacio correcto** | Confirma que es la línea a la que escribirán tus clientes, en el espacio de trabajo que querías. |
| **Registro terminado** | En la lista, **Respuestas del agente** muestra **Activas**. **Configuración incompleta** no está lista. |
| **Hay un agente asignado** | **Responde** muestra el agente que elegiste. |
| **Llega una respuesta real** | Abre el número y usa **Prueba este número**: escanea el código QR con otro teléfono, o haz clic en **Abrir WhatsApp**, y envía un mensaje. Busca la conversación en la [Bandeja de entrada](/dapta-docs-es/agentes-de-texto/operar-conversaciones.md) y confirma que la respuesta vuelve a ese teléfono. |
Si conservaste la aplicación de WhatsApp Business, tu equipo puede seguir respondiendo desde el teléfono. Esos números llevan la etiqueta **App Business** en la lista. Los mensajes que tu equipo envía desde el teléfono aparecen en la Bandeja de entrada junto a los del agente, como mensajes sincronizados y no como algo que escribió el agente.
## Qué pueden enviar tus clientes y cómo responde tu equipo
Tus clientes pueden enviar texto, fotos, notas de voz, videos, documentos y stickers. Todo llega a la conversación en la [Bandeja de entrada](/dapta-docs-es/agentes-de-texto/operar-conversaciones.md).
* El agente ve las fotos y entiende las notas de voz cuando su modelo las maneja. [Dapta Auto](/dapta-docs-es/agentes-de-texto/dapta-auto.md) lo hace.
* De un video o un documento, el agente lee el texto que el cliente escribió con él, no el archivo.
* Tu equipo puede tomar una conversación y responder desde la Bandeja de entrada, con texto o archivos adjuntos, dentro de la ventana de 24 horas de WhatsApp.
## Tus números de un vistazo
**Números de WhatsApp** responde dos preguntas por cada número: si tu agente responde en él y si puedes escribirles primero a tus clientes. Cada fila muestra el **Número**, quién **Responde** y dos estados, **Respuestas del agente** e **Iniciadas por la empresa**. Cuando algo falla, la fila ofrece un botón que lo resuelve, y el estado explica el motivo al pasar el cursor por encima. Cuando tienes más de cinco números, puedes buscarlos y filtrarlos.
**Respuestas del agente**
| Estado | Qué significa | Qué hacer |
| ---------------------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Activas** | Tu agente responde a los clientes en este número. | Nada. |
| **Sin agente** | Ningún agente responde todavía, o el agente asignado está apagado. | **Elegir agente** |
| **Configuración incompleta** | La conexión con Meta no terminó. | **Continuar configuración** |
| **En pausa** | Pausaste las respuestas del agente. | **Verificar y reanudar** |
| **Apagadas** | El número está apagado en Dapta. | **Verificar y encender** |
| **Requiere reconexión** | Dapta perdió el acceso al número en Meta, o Meta lo desconectó. | **Reconectar** |
| **Por verificar** | Dapta aún no verifica el número con Meta, o la última verificación falló. | **Verificar ahora** |
| **Falta método de pago** | La cuenta de WhatsApp Business no tiene método de pago. | **Agregar método de pago**, en el aviso sobre la lista. Mira [Agrega un método de pago a WhatsApp](/dapta-docs-es/agentes-de-texto/canales/agrega-un-metodo-de-pago-a-whatsapp.md). |
| **Bloqueadas por Meta** | Meta no está dejando que el número envíe mensajes. | **Resolver en Meta** abre WhatsApp Manager. |
**Iniciadas por la empresa**
| Estado | Qué significa |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Activas** | Puedes escribirles primero a tus clientes con plantillas, desde Secuencias o la Bandeja de entrada. |
| **En riesgo** | La calidad está bajando en Meta. Revisa tus plantillas. |
| **Bloqueadas** | Un problema de pago en la cuenta de WhatsApp Business, calidad baja en Meta, o Meta está limitando las conversaciones que inicias. |
| **No disponibles** | Primero soluciona las respuestas del agente. |
### Los detalles del número
Haz clic en un número para abrir sus detalles:
* **Termina la configuración**: una lista de pasos que aparece hasta que el número está conectado, tiene agente y recibió su primer mensaje. Mientras la cuenta de WhatsApp Business no tenga método de pago, **Agrega un método de pago a la cuenta de WhatsApp Business** es uno de los pasos.
* **Agente**: **Elige un agente**, **Abrir agente**, **Quitar agente** y **Pausar respuestas del agente**.
* **Prueba este número**: un código QR y **Abrir WhatsApp**, cuando las respuestas del agente ya funcionan.
* **Calidad en Meta**: **Alta**, **Media**, **Baja** o **Sin calificar aún**, según los bloqueos y reportes de clientes en los últimos 7 días. Empieza baja en un número nuevo y sube a medida que envías bien.
* **Actividad**: el último mensaje recibido, la última respuesta entregada y cuándo se conectó el número.
* **Detalles avanzados**: la cuenta de WhatsApp Business, el tipo de conexión y **Abrir WhatsApp Manager**.
* **Quitar de Dapta**.
## Cambiar o retirar una línea
Antes de mover o retirar una línea: pausa las [Secuencias](/dapta-docs-es/agentes-de-texto/campanas.md) que la usen, resuelve las conversaciones que esperan respuesta y avísale a quien vigila la Bandeja de entrada.
* **Para detener el agente un tiempo**, abre el número y haz clic en **Pausar respuestas del agente**. Tu agente deja de responder en este número hasta que lo reanudes con **Verificar y reanudar**, que primero verifica el número con Meta.
* **Para cambiar el agente**, elige otro en **Elige un agente**.
* **Para quitar el número**, ábrelo y haz clic en **Quitar**, en **Quitar de Dapta**. Tu agente deja de responder en el número y tus secuencias no podrán usarlo. Las conversaciones se conservan y no cambia nada en Meta ni en la app de WhatsApp. Si hay secuencias activas usando el número, termínalas o cancélalas primero.
Retirar una línea en Dapta y eliminar el registro en Meta no son lo mismo: nunca hagas lo segundo para conseguir lo primero.
## Si algo no funciona
| Qué ves | Qué intentar |
| ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| La ventana de Meta nunca abre | Permite las ventanas emergentes para `app.dapta.ai` y empieza de nuevo desde **Continuar con Meta** o **Conectar número**. |
| El código QR venció | Haz clic en **Haz clic para volver a cargar el código QR**, o usa **Usar código de acceso**. |
| "El número ya está registrado" | El número está conectado a WhatsApp en otro lado. Consúltalo con soporte antes de cambiar nada. |
| **Ya casi**, o **Configuración incompleta** | Meta aún está terminando la configuración. Verifica el número de nuevo en unos minutos, o haz clic en **Continuar configuración**. Si sigue igual, envía a soporte el número, la hora y el estado mostrado. |
| Conectada, pero no responde | Revisa **Respuestas del agente** para ese número: su estado y su botón te dicen qué falta. Revisa también que el agente esté publicado, que una persona no haya tomado la conversación en la Bandeja de entrada, y que estés escribiendo desde un número distinto al conectado. |
| Las respuestas salen, pero los mensajes que inicias tú no | Revisa **Iniciadas por la empresa** para ese número. También necesitas una plantilla aprobada para esa línea. Mira [qué tipo de plantilla necesitas](/dapta-docs-es/agentes-de-texto/canales/tipos-de-plantilla.md). |
| **Las respuestas del agente están bloqueadas: agrega un método de pago** | La cuenta de WhatsApp Business no tiene método de pago. Haz clic en **Agregar método de pago**, o sigue [Agrega un método de pago a WhatsApp](/dapta-docs-es/agentes-de-texto/canales/agrega-un-metodo-de-pago-a-whatsapp.md). |
| Los mensajes se detienen de golpe | Revisa primero los estados del número en **Números de WhatsApp**. Si se ven bien, revisa tu límite de mensajería en WhatsApp Manager. |
No reconectes una y otra vez para esquivar una restricción de calidad, pago, verificación o plantillas: no las levanta y pone el número en riesgo.
{% content-ref url="/pages/i5LUY4IOhshW2gR85abZ" %}
[Qué tipo de plantilla necesitas](/dapta-docs-es/agentes-de-texto/canales/tipos-de-plantilla.md)
{% endcontent-ref %}
{% content-ref url="/pages/AIWldqiSZkL3mYV7mwLk" %}
[Facturación de WhatsApp](/dapta-docs-es/agentes-de-texto/canales/facturacion-de-whatsapp-lineas-legacy-y-directas.md)
{% endcontent-ref %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/canales/conecta-tu-agente-con-whatsapp.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
