Cargando...
Conexión de WhatsApp 3 min de lectura También disponible en: PT EN

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

  1. En el menú, abre Instancias y haz clic en Nueva instancia.
  2. En tipo de conexión, elige WhatsApp Cloud API (Meta).
  3. Pega el Phone Number ID, el WABA ID y el token de acceso en los campos correspondientes.
  4. Ingresa el PIN de registro de 6 dígitos. Zapini usa ese PIN para registrar oficialmente el número en Meta.
  5. Guarda. Zapini valida las credenciales automáticamente.
📷 Imagen: formulario de Zapini con los campos de Cloud API y el campo de PIN

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.

📷 Imagen: opción de Coexistencia destacada en la pantalla de conexión

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

No. La Cloud API usa credenciales de Meta (Phone Number ID, WABA ID, token y PIN de registro) en lugar de un código QR.
La Cloud API oficial usa el número solo a través de la API; la Coexistencia permite usar el mismo número en la app de WhatsApp Business y en la Cloud API a la vez, sin PIN de registro.
El PIN de 6 dígitos se define en el panel de Meta al configurar el número. Zapini lo usa para registrar oficialmente el número.

¡Gracias por tus comentarios!

Artículos relacionados