Skip to main content
Importante: Después de migrar un número de teléfono a WhatsApp Business Platform, ese número no se puede utilizar simultáneamente en la aplicación WhatsApp Business estándar. Debe estar dedicado exclusivamente a una plataforma.

​
🔢 Tabla de contenidos

  1. Create a Meta Business Account
  2. Create a Meta App and Enable WhatsApp
  3. Create a System User in Business Manager
  4. Generate a System User Access Token
  5. Register and Verify Your Phone Number
  6. Configure Webhooks in the Meta App
  7. Connect Your Meta App to ZappWay
  8. Scan the QR Code to Pair Your Number
  9. Final Checks and Monitoring

​
1. Cree una cuenta metaempresarial

  1. Navigate to https://business.facebook.com.
  2. Click “Create Account.”
  3. Fill out the required information:
  • Nombre de la empresa
    • Tu nombre completo
    • Correo electrónico del trabajo
  1. Continúe siguiendo las indicaciones para finalizar la configuración. Cuando se le solicite:
  • Agrega una Página de Facebook (puede ser una página temporal o de prueba).
    • Agregue un Método de pago si lo solicita.
    • Complete la Verificación comercial enviando los documentos necesarios (por ejemplo, registro de la empresa, comprobante de domicilio).
Consejo: Meta puede limitar ciertas funciones en cuentas nuevas hasta que completes el proceso de verificación. Siga todas las instrucciones que aparecen en pantalla y proporcione los documentos adicionales solicitados.

​
2. Cree una metaaplicación y habilite WhatsApp

  1. Go to https://developers.facebook.com/apps.
  2. Click “Create App.”
  3. When prompted “What do you want your app to do?”, select “Other.”
  4. Choose “Business” as your app type.
  5. Complete the form by providing:
  • Nombre de la aplicación (por ejemplo, “Integración de WhatsApp de ZappWay”)
    • Correo electrónico de contacto
    • Enlace a la Cuenta Meta Business que creó en el Paso 1.
  1. Haga clic en “Crear aplicación”.
  2. Dentro del panel de su aplicación recién creada, ubique la sección “Productos”.
  3. Seleccione “+ Agregar producto”.
  4. Busque “WhatsApp” en la lista y haga clic en “Configurar”.
Nota:
  • Si Meta solicita verificación comercial adicional en esta etapa, complete ese proceso antes de continuar.
  • Si no ve WhatsApp en la lista, asegúrese de estar trabajando con la cuenta de Business Manager correcta.

​
3. Cree un usuario del sistema en Business Manager

Para administrar tokens de larga duración y asignar los permisos necesarios, debe crear un Usuario del sistema dentro de Business Manager.
  1. In Business Manager, navigate to Business Settings → Users → System Users.
  2. Click “Add” (or “Add System User”).
  3. Enter a descriptive name (for example, “ZappWay WhatsApp Bot”) and choose “Admin” as the role.
  4. Confirm by clicking “Create.”
  5. Select the newly created System User from the list.
  6. Click “Add Assets.”
  • Para Tipo de activo, elija “Aplicaciones”.
    • Seleccione la Aplicación de WhatsApp que creó en el Paso 2.
    • Otorgar permiso “Administrar aplicación”.
  1. Haga clic en “Asignar”.
Verificar:
  • El usuario del sistema ahora debería tener “Administrar aplicación” en la lista de permisos de su aplicación.
  • Esto garantiza que el usuario pueda generar tokens y configurar el producto WhatsApp.

​
4. Generar un token de acceso de usuario al sistema

Este token se utilizará para autenticar su integración desde ZappWay.
  1. Still in Business Settings → System Users, select the System User you created.
  2. Click “Generate New Token.”
  3. Choose the WhatsApp App you linked in Step 3.
  4. Select all of the following permissions:
  • whatsapp_business_mensajería
    • whatsapp_business_management
    • negocio_gestión
  1. Haga clic en “Generar token”.
  2. Copie el token que aparece y guárdelo de forma segura (por ejemplo, en un administrador de contraseñas o una variable de entorno).
  • Si solo generó un token de corta duración, puede extenderlo haciendo clic en “Generar token de larga duración”.
    • Los tokens de larga duración duran hasta 60 días antes de que deban renovarse.
Consejo de seguridad:
  • Nunca codifique este token en su repositorio de código.
  • Utilice variables de entorno o un administrador de secretos en producción.

​
5. Regístrese y verifique su número de teléfono

Para enviar y recibir mensajes a través de la API, necesita un número de teléfono activo y verificado.
  1. In your Meta App’s WhatsApp dashboard (navigate to developers.facebook.com/apps/<YOUR_APP_ID>/whatsapp-business/wa-dev-console), find the “Numbers” section.
  2. Click “Add Phone Number.”
  3. You have two options:
  • Utilice un número de prueba proporcionado por Meta (solo para desarrollo).
    • Registre su número real ingresando sus dígitos (incluido el código de país, por ejemplo, +5511987654321).
  1. Haga clic en “Registrarse”.
  2. Meta enviará un código de verificación mediante SMS o llamada de voz a ese número.
  3. Ingrese el código de verificación en el mensaje para confirmar y activar el número.
  4. Una vez verificado, tu número aparecerá como “Activo” y verás:
  • ID del número de teléfono: un identificador único para ese número.
    • ID de cuenta empresarial de WhatsApp: identifica qué cuenta empresarial controla este número.
Tome nota de:
  • Formato de ID de número de teléfono: normalmente una cadena numérica larga.
  • ID de cuenta comercial: también una cadena numérica que puede necesitar más adelante.

​
6. Configurar webhooks en la metaaplicación

Para permitir que ZappWay reciba eventos de mensajes entrantes, debe configurar un webhook.
  1. In your Meta App’s WhatsApp settings (go to developers.facebook.com/apps/<YOUR_APP_ID>/whatsapp-business/wa-settings), locate the “Webhooks” section.
  2. In “Callback URL,” enter the URL provided by ZappWay, which will look like:
  • <SERVICE_PROVIDER_ID>: el ID único generado por ZappWay cuando creas la integración (lo obtendrás en el Paso 7).
  1. En “Verificar token”, ingrese el token de verificación que ZappWay crea para usted. Este token será visible en la interfaz de ZappWay durante la configuración de la integración.
  2. En “Campos de webhook” asegúrese de seleccionar al menos “mensajes”. Esto permite que ZappWay reciba mensajes de texto entrantes.
  3. Haga clic en “Guardar” o “Continuar”. Una vez guardado, Meta enviará un desafío a su URL de devolución de llamada para verificarlo. Si ZappWay está configurado correctamente, responderá automáticamente con el valor de desafío esperado.
Lista de verificación de validación:
  • Confirme que mensajes esté marcado en Campos de webhook.
  • Si Meta devuelve un error de desafío (HTTP 403 o 404), verifique que su URL de devolución de llamada y su token de verificación coincidan exactamente con lo que proporcionó ZappWay.

​
7. Conecte su metaaplicación a ZappWay

Siga estos pasos dentro del panel de ZappWay para completar la integración.
  1. Log in to your ZappWay dashboard.
  2. In the sidebar, navigate to Integrations → WhatsApp.
  3. Click “Add WhatsApp Integration.” This will open a guided four-step setup wizard.

​
Paso 1: Requisitos

  • Verá una breve descripción general y un enlace a la documentación completa de integración de ZappWay.
  • Haga clic en “Continuar” para pasar al siguiente paso.

​
Paso 2: Token de acceso de usuario al sistema

  • Copie el token de acceso de larga duración que generó en el Paso 4.
  • Péguelo en el campo “Token de usuario del sistema”.
  • Haga clic en “Continuar”.
  • ZappWay validará su token realizando una solicitud al punto final de depuración del token de Meta.
    • Si el token ha caducado o le faltan los permisos requeridos, verá un error y deberá generar un nuevo token.

​
Paso 3: ID del número de teléfono

  • Ingrese el Número de teléfono ID que obtuvo en el Paso 5.
  • Haga clic en “Continuar”.
  • ZappWay llamará a la API Graph de Meta para verificar que el ID del número de teléfono pertenece al token.
    • Si es válido, ZappWay registrará automáticamente el número de teléfono formateado y finalizará este paso.

​
Paso 4: Configuración del webhook

  • ZappWay mostrará dos campos de solo lectura:
    1. Callback URL (e.g., https://app.zappway.ai/api/integrations/whatsapp/webhook?service_provider_id=abcdef123456)
    2. Verification Token (a unique string generated by ZappWay)
  • Copy each of these values. You will enter them in your Meta App’s Webhook settings (refer back to Step 6).
  • Confirm that you have selected “messages” under Webhook Fields in the Meta dashboard.
  • Click “Save.”
Una vez que hace clic en “Guardar”, ZappWay considera la integración configurada. Esperará a que Meta entregue eventos de webhook a la URL de devolución de llamada que proporcionó.

​
8. Escanee el código QR para vincular su número

Ahora que la integración backend está configurada, debe vincular (emparejar) su número de WhatsApp Business con ZappWay escaneando un código QR.
  1. In the ZappWay dashboard under Integrations → WhatsApp, locate your newly created integration entry.
  2. If it is not already connected, you will see a button labeled “Scan QR Code.” Click it to display the QR code.
  3. On your mobile device, open the WhatsApp Business App.
  4. Tap the three‐dot menu (⋮) in the top right → “Linked Devices” (or “Linked Devices”).
  5. Tap “Link a Device” (or “Pair a Device”).
  6. Use your phone’s camera to scan the QR code shown in ZappWay.
  7. After successfully scanning, you will see a confirmation message in the phone app, and ZappWay will update its status to “Connected.”
Consejos para solucionar problemas:
  • Si el código QR no aparece, asegúrese de que su navegador no esté bloqueando ventanas emergentes o que su sesión en ZappWay no haya expirado.
  • Si el emparejamiento falla repetidamente, verifique que no existan otras sesiones activas para el mismo número. Es posible que primero tengas que cerrar sesión en otros dispositivos vinculados.

​
9. Controles finales y seguimiento

Después del emparejamiento, realice estas verificaciones finales para garantizar que su integración sea completamente funcional.

​
9.1 Verificar el estado de la conexión

  • En ZappWay, la integración ahora debería mostrar un indicador de estado “Conectado” (normalmente verde).
  • Si muestra “Error” o “Desconectado”, haga clic en “Desconectar” para borrar la sesión existente, luego repita el Paso 8 para escanear el código QR nuevamente.

​
9.2 Flujo de mensajes de prueba

  1. Send a test message from any WhatsApp account to your newly integrated WhatsApp Business number.
  2. Confirm that the message appears in ZappWay’s Inbox interface.
  3. If you have configured any auto-response rules or AI workflows, verify that the AI Employee replies as expected.
Si los mensajes no llegan:
  • Confirme que se pueda acceder a la URL de devolución de llamada del webhook (sin bloqueo de firewall, certificado SSL válido).
  • Verifique los registros del webhook de ZappWay para ver si Meta está entregando los eventos.
  • Asegúrese de que “mensajes” permanezca seleccionado en Campos de webhook en la configuración de su metaaplicación.

​
9.3 Monitorear errores comunes

  • Token de acceso caducado (401 no autorizado):
  • Si su token de usuario del sistema caduca, ZappWay mostrará errores de autorización en los registros.
    • Genere un nuevo token de larga duración en Business Manager y péguelo nuevamente en el campo “Token de usuario del sistema”.
  • Errores de verificación de webhook (403/404):
  • Indica que la solicitud de desafío de Meta no recibió el token de verificación esperado.
    • Vuelva a verificar que la URL de devolución de llamada y el token de verificación que ingresó en Meta coincidan exactamente con lo que proporcionó ZappWay.
  • Error de sesión (flujo:error 515):
  • Significa que no se pudo mantener la sesión de WhatsApp.
    • Confirma que no haya otra sesión de WhatsApp iniciada con el mismo número y que tu servidor tenga una conexión de red estable.
    • Si es necesario, use la función “Desconectar” de ZappWay para borrar la sesión e intente escanear el código QR nuevamente.

​
9.4 Calendario de renovación de tokens

  • Los tokens de larga duración son válidos hasta por 60 días.
  • Antes de que un token caduque, repita el Paso 4 para generar un nuevo token y luego regrese a Integraciones → WhatsApp en ZappWay para reemplazar el token antiguo por el nuevo.

​
✅ Notas finales

  • Verificación de cuenta comercial: Una metacuenta comercial completamente verificada desbloquea límites de mensajería más altos y garantiza un acceso API ininterrumpido.
  • Límites de mensajes: Las nuevas cuentas de WhatsApp Business suelen comenzar con cuotas de mensajería más bajas. Participa activamente y sigue las pautas de Meta para aumentar gradualmente tu límite.
  • Confiabilidad del webhook: Asegúrese de que el punto final del webhook de su servidor esté siempre en línea y pueda responder a las solicitudes entrantes de manera oportuna.
  • Mejores prácticas de seguridad: Almacene tokens en bóvedas seguras o variables de entorno. Gírelos periódicamente para mantener la seguridad.
Si sigue estos pasos cuidadosamente, tendrá una integración sólida y completamente funcional de WhatsApp en ZappWay, lo que permitirá a su empleado de IA manejar las interacciones con los clientes sin problemas.
Enlaces útiles: Siga estas instrucciones exactamente y su integración se configurará exitosamente.