Conectar mediante la WhatsApp Cloud API oficial (Meta)
Cómo conectar un número usando la API oficial de Meta en Zapini, con credenciales y PIN de registro, y cuándo usar la Coexistencia.
Actualizado el
Qué es la conexión Cloud API
La WhatsApp Cloud API es la conexión oficial de Meta. En lugar de escanear un código QR, usas credenciales generadas en el panel de Meta. Es la opción recomendada para empresas que buscan estabilidad oficial, verificación y mayor volumen de mensajes.
Para usar este método necesitas una cuenta en Meta for Developers con el producto WhatsApp configurado.
Lo que vas a necesitar
- El Phone Number ID del número en Meta.
- El WhatsApp Business Account ID (WABA ID).
- Un token de acceso válido.
- El PIN de registro de 6 dígitos del número.
Paso a paso
- En el menú, abre Instancias y haz clic en Nueva instancia.
- En tipo de conexión, elige WhatsApp Cloud API (Meta).
- Pega el Phone Number ID, el WABA ID y el token de acceso en los campos correspondientes.
- Ingresa el PIN de registro de 6 dígitos. Zapini usa ese PIN para registrar oficialmente el número en Meta.
- Guarda. Zapini valida las credenciales automáticamente.
Si las credenciales son correctas y el registro se completa, el estado cambia a connected y el número queda listo para enviar y recibir mensajes.
💡 Consejo: guarda el PIN de registro en un lugar seguro. Puede que lo necesites de nuevo si cambias el número de proveedor o si rehaces el registro.
Modo Coexistencia (app + Cloud API)
La Coexistencia permite usar el mismo número en la aplicación de WhatsApp Business y en la Cloud API al mismo tiempo. Es útil cuando el equipo todavía atiende desde el celular, pero quieres que la IA y la automatización de Zapini también trabajen en ese número.
En la Coexistencia, la activación ocurre durante el registro integrado de Meta (Embedded Signup) con la opción de app habilitada — en este modo no se ingresa un PIN de registro. Los mensajes enviados desde el celular también aparecen en el historial de Zapini.
Verificar la conexión
- El estado debe aparecer como connected.
- El número entra en el selector global de instancias, junto a cualquier número por código QR.
- Envía un mensaje de prueba en Mensajes para confirmar el flujo.
Si la validación falla, revisa las credenciales y el PIN — la mayoría de los errores vienen de un token vencido o de un Phone Number ID incorrecto.
Preguntas frecuentes
¿Te resultó útil este artículo?
¡Gracias por tus comentarios!