> For the complete documentation index, see [llms.txt](https://aizy.gitbook.io/aizy-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aizy.gitbook.io/aizy-docs/aizy-docs-es/channels/whatsapp.md). # WhatsApp ## 1. Descripción En este apartado conectas tu cuenta de WhatsApp Business a Aizy Agents con el flujo embebido de Meta, seleccionas tu WABA y guardas el número que usará el agente. Puedes hacerlo con un número nuevo de WhatsApp Cloud API o con el número que ya usas en la app de WhatsApp Business del móvil (coexistencia). ## 2. Antes de empezar Antes de configurar WhatsApp en Aizy Agents, prepara lo siguiente: * WhatsApp contratado para el bot en **Mi suscripción**; si no lo está, al guardar Aizy te avisa de que esa capacidad no está activa. * Acceso a una cuenta de **Meta Business** con permisos de administración. * Una cuenta de **WhatsApp Business (WABA)** que quieras conectar. * Un número que puedas verificar por SMS o llamada. * Si tu número tiene verificación en dos pasos, el PIN de ese número. * Solo para el alta con la app de WhatsApp Business: la app instalada en el móvil, versión 2.24.17 o superior, y poder escanear un código QR. Referencias oficiales: * Cloud API (inicio): * Embedded Signup: * Webhooks de WhatsApp Cloud API: ## 3. Apartados de WhatsApp | Subapartado | Qué haces en este subapartado | | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- | | `Embedded Signup (Meta)` | Inicias la conexión guiada con Meta. | | `Conectar con WhatsApp` | Abres la ventana de Meta para autorizar la conexión de tu cuenta con un número de WhatsApp Cloud API. | | `Usar el número de mi app de WhatsApp Business` | Abres la ventana de Meta para conectar el número que ya usas en la app de WhatsApp Business y seguir usándola en el móvil. | | `Sincronización con la app de WhatsApp Business` | Solo aparece si el número está conectado con la app de WhatsApp Business. Consultas el estado del historial y puedes reintentar (apartado 6). | | `Paso 1: Seleccionar WABA` | Cargas las cuentas y eliges la WABA que usarás. | | `Cargar WABAs` | Traes las WABAs disponibles desde Meta. | | `Selecciona un WABA` | Seleccionas la cuenta concreta que quieres vincular. | | `WABA ID guardado` | Compruebas qué WABA quedó guardado. | | `Paso 2: Guardar número` | Eliges el número de teléfono que usará el canal. | | `Cargar números` | Traes los números de la WABA seleccionada. | | `Selecciona un número` | Seleccionas el número que usará el agente. | | `Registrar` | Completas el alta del número (con PIN si aplica). Solo se ofrece si el número aún no está conectado. | | `Estado del número` | Compruebas si está `Pendiente`, `Conectado` o `Sin estado`. | | `Número guardado` | Verificas qué número quedó vinculado. | | `Abrir conversación` | Abres WhatsApp con el número guardado para probar el canal. | | `Desconectar número` | Sueltas el número del bot (apartado 7). Solo aparece si hay un número guardado. | | `Guardar` | Confirma la selección final de WABA y número. Es el botón de la parte superior de Canales. | ## 4. Conectar un número 1. Pulsa **Conectar con WhatsApp** y completa el flujo en la ventana de Meta. 2. Al volver a Aizy, la WABA y el número que elegiste en Meta aparecen ya seleccionados. Si no aparecen, pulsa **Cargar WABAs** y **Cargar números** y elígelos a mano. 3. Revisa el número. Si su estado ya es `Conectado`, no hace falta registrarlo: **Registrar** y el PIN no se muestran. Si no lo está, pulsa **Registrar** (el PIN es opcional y solo hace falta si tu número tiene verificación en dos pasos). 4. Pulsa **Guardar**. Hasta ese momento el número no queda vinculado al bot; después de volver de Meta, **Guardar** aparece resaltado para recordártelo. Al guardar, Aizy también suscribe su app a tu WABA para recibir los mensajes. Un número solo puede estar conectado a un bot. Si ya lo está en otro, Aizy no guarda nada y te indica en qué bot está: desconéctalo allí primero. Si la ventana de Meta no se abre, recarga la página y vuelve a intentarlo. ## 5. Conectar con la app de WhatsApp Business (coexistencia) Pulsa **Usar el número de mi app de WhatsApp Business** y sigue la ventana de Meta (te pedirá escanear un código QR desde la app del móvil). Al volver, revisa el número y pulsa **Guardar**. Este número no se registra: no hay botón **Registrar** ni PIN. Con este tipo de alta: * Sigues usando WhatsApp Business en el móvil. Si respondes a un cliente desde la app, el agente deja de contestar a ese cliente durante 12 horas desde tu respuesta. Sus mensajes se siguen guardando, pero Aizy no guarda el contenido de tus respuestas desde la app. * Meta exige sincronizar el historial de chats en las primeras 24 horas desde la conexión. ## 6. Sincronización con la app de WhatsApp Business Aizy pide el historial por ti, pero no lo guarda: tus conversaciones en Aizy empiezan desde la conexión. En la tarjeta **Sincronización con la app de WhatsApp Business** ves el estado del `Historial`, junto al plazo (`Quedan N h` o `Plazo vencido`): | Estado | Significado | | ------------------------ | --------------------------------------------------------------------------------------------------------- | | `Sin solicitar` | Aún no se ha pedido el historial. | | `Solicitada` | Aizy ya lo ha pedido a Meta. | | `En curso` | Meta está sincronizando. | | `Completada` | La sincronización ha terminado. | | `No compartido` | No compartiste el historial al conectar; no hace falta hacer nada. | | `Sincronización fallida` | Meta no ha aceptado la petición; se muestra el motivo. Si estás dentro del plazo, aparece **Reintentar**. | ## 7. Desconectar un número y aviso «Desconectado» * **Desconectar número**: pide confirmación y deja al bot sin recibir ni enviar mensajes por WhatsApp hasta que conectes un número de nuevo. Quita el acceso, la WABA, el número y el webhook del bot, y libera el número para conectarlo en otro bot. No cambia tu cuenta de WhatsApp Business en Meta. * Si es Meta quien desconecta el número (por ejemplo, al retirar el acceso de Aizy desde Meta), la tarjeta muestra un aviso con la fecha: el agente no recibe ni envía mensajes por WhatsApp. Para volver a conectarlo, repite el alta con Meta y pulsa **Guardar**. Si el número estaba conectado con la app de WhatsApp Business, Aizy además avisa por correo a los propietarios del environment.