Guía de Configuración: WhatsApp Business API

Verificar que el número telefónico esté activo

Antes de hacer cualquier otra cosa, confirmar que el número está activo y funcional con estas 3 pruebas:

1. Llamada entrante: Llamar al número desde otro teléfono — verificar que suena y se puede contestar. Si es PBX, verificar que se puede contestar sin marcar una extensión (Meta no soporta extensiones)
2. Llamada saliente: Hacer una llamada desde el número — confirmar que puede hacer llamadas. Si no, la línea puede estar suspendida o desactivada
3. Recarga / saldo: Si es un número prepago, verificar que se pueda agregar saldo. Si la compañía ya no permite recargas, el número puede haber sido reciclado o desactivado permanentemente

Verificar prerrequisitos

Antes de continuar, asegurarse de contar con:

• Acceso al correo electrónico asociado a la cuenta de Meta / Facebook Business
• Acceso como administrador a Meta Business Suite
• Acceso a Meta for Developers con la misma cuenta
• El número telefónico confirmado como activo (Paso 0.1)
• Una tarjeta de crédito para registrar como método de pago en Meta
• Documentos de la empresa para verificación del negocio (acta constitutiva, constancia de situación fiscal o similar)

Crear una App en Meta for Developers

1. Ir a Meta for Developers - Apps
2. Clic en Create App
3. En "¿Qué deseas que haga tu app?", seleccionar Other
4. Seleccionar tipo de app: Business
5. Ingresar nombre de la app (ej: "MiEmpresa WhatsApp")
6. Seleccionar el Business Portfolio de la empresa
7. Clic en Create App

Obtener App ID y App Secret

1. Ir a App Settings > Basic
2. Anotar el App ID (se muestra en la barra superior)
3. Clic en Show junto a App Secret y anotarlo

Agregar producto WhatsApp a la App

1. En el Dashboard de la App, ir a Add products to your app
2. Buscar WhatsApp y clic en Set up
3. Se abrirá la sección de WhatsApp con la pantalla de inicio rápido

Identificar el WhatsApp Business Account (WABA) ID

1. En la sección WhatsApp > API Setup, ubicar el WABA ID
2. Anotar el WhatsApp Business Account ID

Verificación del negocio

Meta requiere verificar la identidad del negocio antes de aprobar la cuenta de WhatsApp Business API:

1. Ir a Meta Business Suite > Settings > Business security and integrity
2. En la sección Business verification, clic en Start verification
3. In the selector "Select your verification use case", choose:
   "The app requires access to permissions in Meta for Developers"
4. Seguir el proceso: subir documentos de la empresa (acta constitutiva, constancia de situación fiscal, comprobante de domicilio, etc.)
5. Enviar y esperar la revisión de Meta (aproximadamente 2 días hábiles)

Agregar método de pago

Meta requiere un método de pago activo para la cuenta de WhatsApp Business API:

1. Ir a Meta Business Suite > Billing and payments
2. Agregar una tarjeta de crédito como método de pago
3. Verificar que la tarjeta esté asociada a la cuenta de WhatsApp Business

Confirmar aprobación — Luz verde

Antes de proceder a la siguiente fase, verificar que todas las luces estén en verde:

1. Ir a Meta Business Suite > Settings > WhatsApp Accounts
2. Seleccionar la cuenta de WhatsApp Business
3. En la pestaña Overview, confirmar:

Crear un System User en Meta Business Suite

1. Ir a Meta Business Suite > Settings > System Users
2. Clic en Add
3. Nombre: algo descriptivo (ej: "Odoo Integration")
4. Rol: Admin
5. Click Create system user

Asignar activos al System User

1. Seleccionar el System User recién creado
2. Clic en Add assets
3. En la sección Apps, seleccionar la App creada en la Fase 1 y asignar Full control
4. En la sección WhatsApp Accounts, seleccionar el WABA y asignar Full control

Generar token permanente

1. Con el System User seleccionado, clic en Generate token
2. Seleccionar la App creada en la Fase 1
3. Seleccionar permisos:
   • whatsapp_business_management
   • whatsapp_business_messaging
4. Click Generate token
5. Copiar y guardar el token — solo se mostrará una vez

Agregar número telefónico en Meta Developer Portal

1. En la App de Meta, ir a WhatsApp > API Setup
2. Click Add phone number
3. Ingresar datos del perfil:
   • Nombre para mostrar (nombre que verán los clientes)
   • Categoría del negocio
4. Ingresar el número telefónico con código de país (+52 para México)
5. Seleccionar método de verificación: SMS o Llamada telefónica

Verificar el número e ingresar el código

1. Recibir el código de verificación por SMS o llamada
2. Ingresarlo en el portal de Meta
3. Esperar la confirmación de verificación exitosa

Anotar el Phone Number ID

1. Seleccionar el número recién registrado en el dropdown de API Setup
2. Anotar el Phone Number ID debajo del selector

Activar verificación en dos pasos

1. Ir a Meta Business Suite > WhatsApp Manager > Números de teléfono
2. Seleccionar el número registrado
3. Ir a la pestaña Verificación en dos pasos
4. Clic en Activar
5. Ingresar un PIN de 6 dígitos a elección
6. Confirmar el PIN

Configurar Webhook en Meta Developer Portal

1. En la App de Meta, ir a WhatsApp > Configuration
2. Ingresar la Callback URL proporcionada por Agilezip
3. Ingresar el Verify Token
4. Click Verify and save

Suscribirse a eventos del Webhook

Activar la suscripción a los siguientes campos:

Confirmar recepción del mensaje

El destinatario confirma que recibió el mensaje de WhatsApp correctamente, con el formato y contenido esperado.