> For the complete documentation index, see [llms.txt](https://docs.1millionbot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.1millionbot.com/es/chatbot/channels/whatsapp-cloud-api.md). # WhatsApp Cloud API ## Configuración > Meta actualiza y rediseña con frecuencia su consola de desarrolladores, por lo que los pasos y nombres de menú de esta guía pueden quedar desactualizados. Si algo no coincide con lo que ves en pantalla, consulta la documentación oficial y siempre actualizada de Meta: [WhatsApp Cloud API – Get Started](https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started). Para configurar la integración de tu agente en WhatsApp Cloud API, necesitarás lo siguiente: * Una cuenta de Meta registrada como desarrollador en la [consola para desarrolladores](https://developers.facebook.com/). * Una cartera empresarial (Business Portfolio) en Meta Business: puede crearse durante la creación de la aplicación si aún no dispones de una. * Un número de teléfono disponible. ### Crear una aplicación de Meta > Meta rediseñó el flujo de creación de aplicaciones alrededor de "casos de uso" (use cases). Ya no se crea una app genérica de tipo 'Otro' > 'Empresa' para luego buscar el módulo de WhatsApp en el Panel: WhatsApp se selecciona directamente como caso de uso durante la creación. 1. Accede a la [consola para desarrolladores de Meta](https://developers.facebook.com/apps/). 2. Haz clic en 'Crear aplicación'. 3. Introduce el nombre de la aplicación y un correo de contacto. 4. En la selección de caso de uso, elige **'Conectar con los clientes a través de WhatsApp'** ('Connect with customers through WhatsApp') y haz clic en 'Siguiente'. 5. Selecciona una cartera empresarial (Business Portfolio) existente vinculada a tu Meta Business, o crea una nueva. 6. Revisa los requisitos de publicación (pueden aparecer vacíos en este punto) y haz clic en 'Crear aplicación' para finalizar. Al finalizar, la aplicación se abre directamente en la vista del caso de uso de WhatsApp (ya no es necesario localizar el módulo desde el 'Panel' general). ### Añade tu número de teléfono 1. En el menú lateral de la aplicación, accede a **Personalizar caso de uso** > **Conectar en WhatsApp** > **Primeros pasos** (Quickstart). 2. Haz clic en 'Comenzar a usar la API' ('Start using the API'). 3. Vincula una cuenta de WhatsApp Business existente o crea una nueva desde el mismo asistente. 4. Selecciona un número de teléfono disponible o haz clic en 'Add a phone number' (Añadir número de teléfono), completa los datos y valida la vinculación con la cuenta de WhatsApp Business API a través del SMS o llamada de confirmación. ### Genera un Token de Acceso Permanente 1. Navega a [Facebook Business](https://business.facebook.com/). 2. En el menú lateral, selecciona **Usuarios** > **Usuarios del sistema**. 3. Agrega un nuevo usuario con privilegios de administrador. 4. En el menú lateral, ve a **Cuentas** > **Cuentas de WhatsApp**. 5. Concede permisos de control total al nuevo usuario creado. 6. Regresa a la sección **Usuarios del sistema** y haz clic en **Asignar activos**. 7. Elige la aplicación deseada y asigna permisos de administrador. 8. Una vez guardado, haz clic en **Generar nuevo token**. 9. Selecciona la aplicación, establece la caducidad en **Nunca** y habilita los permisos de WhatsApp. 10. Copia el token de autenticación generado para uso futuro. ### Obten el identificador del número de teléfono 1. Navega a la [consola para desarrolladores de Meta](https://developers.facebook.com/apps/). 2. Accede a la aplicación creada. 3. Ve a la sección **Personalizar caso de uso** > **Conectar en WhatsApp** > **Primeros pasos** (o **API Setup**). 4. Selecciona el teléfono vinculado y copia el ID que aparece debajo de él (ID del número de teléfono). ### Obten la clave secreta de la aplicación 1. Navega a la [consola para desarrolladores de Meta](https://developers.facebook.com/apps/). 2. Accede a la aplicación creada. 3. Ve a la sección del menú **Configuración** > **Información básica**. 4. Haz clic en mostrar y copia la clave secreta de la aplicación. ### Conecta tu aplicación con tu agente #### Activar integración en la plataforma 1millionbot 1. Ve a la sección **Canales** en la plataforma. 2. Activa WhatsApp y haz clic en Configuración. 3. Ingresa los datos obtenidos previamente: Clave secreta de la aplicación, Token de acceso permanente e ID del número de teléfono. 4. Haz clic en Guardar.\ ![](https://412644269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeKvXVjARdFac9a58oDAB%2Fuploads%2FRXSmE31hVyLPtJrLU84F%2FWS_7.png?alt=media\&token=63cc994a-7e2c-4664-93e3-a9c2bdb83706) #### Activar integración en Meta **Obtener Callback URL** 1. Ve a la plataforma de 1millionbot y haz clic en el botón 'Info' en el canal de WhatsApp Cloud para obtener la URL.\ ![](https://412644269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeKvXVjARdFac9a58oDAB%2Fuploads%2FUP6uCbLqoaCwJEqk8fxx%2FWS_8.png?alt=media\&token=78b77a13-b313-4c60-ba54-8a403eec753e) **Configurar el Webhook de Meta** 1. En la sección **Personalizar caso de uso** > **Conectar en WhatsApp** > **Configuración** de la consola de desarrolladores de Meta, haz clic en 'Editar' en la sección **Webhook**. 2. Pega la URL obtenida de la plataforma de 1millionbot e ingresa el Token de Autenticación Permanente. 3. Haz clic en 'Guardar' para aplicar los cambios. ### Configurar permisos 1. En la misma sección **Configuración**, haz clic en 'Administrar' (junto al Webhook) para activar los campos de suscripción necesarios:\ \- *messages* 2. Haz clic en 'Guardar' para aplicar los cambios. ### Publicar la aplicación de Meta 1. Actualmente, tu aplicación está en modo de desarrollo, por lo que puedes probar el funcionamiento del agente siempre que el número de teléfono que uses para interactuar con el agente pertenezca a uno de los usuarios con acceso a la aplicación (hasta 5 números de prueba). 2. Para publicar el agente para interacción pública, cambia el modo de desarrollo a producción y proporciona toda la información necesaria (que se encuentra en la parte superior de la consola de desarrolladores de Meta). 3. Completa la **Verificación de negocio** (Business Verification) de tu Meta Business. No es obligatoria para publicar, pero es necesaria para superar el límite inicial de conversaciones y aumentar el tier de mensajería (ver Limitaciones). 4. ¡Listo! Ahora puedes interactuar con tu agente en el número configurado a través de WhatsApp. 🎉 > ⚠️ **Importante:** si más adelante cambias el **nombre de perfil visible (Display Name)** de tu número y Meta aprueba el cambio, el número queda automáticamente **sin registrar** y deja de poder enviar o recibir mensajes hasta que se vuelva a registrar. Meta indica explícitamente que este re-registro **no puede hacerse con botones desde la consola o WhatsApp Manager**: solo es posible mediante una llamada directa a la API. #### Cómo volver a registrar el número tras un cambio de Display Name 1. Localiza o restablece tu **PIN de verificación en dos pasos** (6 dígitos) en WhatsApp Manager: **Configuración** > **Cuentas de WhatsApp** > tu cuenta > **Configuración** > **WhatsApp Manager** > selecciona el número > **Configuración** > **Verificación en dos pasos** > **Cambiar PIN**. 2. Haz una petición `POST` al endpoint de registro de Meta con tu Token de Acceso Permanente, el ID del número de teléfono y ese PIN: ``` curl -X POST \ 'https://graph.facebook.com/v23.0/{ID_DEL_NUMERO}/register' \ -H 'Authorization: Bearer {TOKEN_DE_ACCESO_PERMANENTE}' \ -H 'Content-Type: application/json' \ -d '{"messaging_product": "whatsapp", "pin": "{TU_PIN}"}' ``` 3. Si no dispones de una herramienta para hacer esta petición (Postman, cURL...) o de un desarrollador que te ayude, contacta con el soporte de 1millionbot para completar el registro por ti. Meta limita esta llamada a 10 peticiones por número cada 72 horas (error `133016` si se supera). ## Limitaciones * Límite inicial de 250 conversaciones iniciadas por el negocio cada 24 h para números nuevos. El límite escala automáticamente a 1.000, 10.000, 100.000 o ilimitado según el volumen de uso sostenido y la Verificación de negocio ([+ info](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits)). * Máximo 3 botones de respuesta rápida por mensaje. * Cada botón de respuesta rápida puede tener un máximo de 20 caracteres.