¿Cómo conecto WhatsApp Business API?

1. Accede a Meta Business Settings - WhatsApp Account

2. Selecciona la cuenta de WhatsApp correspondiente.

1. Ve a Aplicaciones y selecciona la Appⓘ utilizada.

2. Haz clic en los tres puntos y selecciona Abrir en el panel de aplicaciones.

3. En el menú lateral, ve a WhatsApp > Configuración de la API.

4. Copia los siguientes datos:

• Identificador de número telefónico
• Identificador de cuenta de WhatsApp Business

1. Desde el menú lateral de la app, accede a WhatsApp > Configuración.

2. Registra estos datos:

• URL del Webhook: https://msprd.moonflow.ai/communication-api/webhook/events/whatsappbusinessdata
• Token de verificación: WAMO

3. Activa los siguientes eventos (obligatorios para el funcionamiento con Moonflow):

• business_status_update
• flows
• message_template_quality_update
• messaging_handovers

✅ Importante: asegúrate de que la URL del webhook sea pública y accesible por internet. No se necesita configurar seguridad adicional, ya que Meta utiliza HTTPS por defecto.

1. Vuelve a Meta Business Settings - WhatsApp Account

2. Ve a Usuarios del sistema y haz clic en Añadir.

3. Crea un nuevo usuario asignando un nombre y un rol (puede ser cualquiera).

4. Una vez creado, haz clic en ese usuario > Generar identificador.

5. Elige la aplicación donde está configurado WhatsApp.

6. En la opción de expiración, selecciona Nunca.

7. Asigna los siguientes permisos obligatorios:

• whatsapp_business_messaging
• whatsapp_business_management

8. Se generará un token de acceso permanente.

📩 Envía este token a Moonflow junto con los demás datos.

1. Entra a la cuenta de WhatsApp creada y haz clic en Asignar personas.

2. Selecciona el usuario de sistema y en sus permisos, en la sección de Control total, activa la opción Administrar cuentas de WhatsApp Business.

3. Para finalizar, haz clic en Asignar personas.

Si necesitas agregar un nuevo número:

Desde Administrador de WhatsApp, verifica si tienes habilitada la opción de "Agregar nuevo número".

Sigue el proceso guiado para registrar el número.

Nota: También necesitaremos el ID del número de WhatsApp para configurar el envío de mensajes.

Pasos para obtenerlo:

1. Accede a developers.facebook.com/apps.

2. Selecciona la aplicación correspondiente.

3. Abre el menú WhatsApp y entra a Configuración de la API.

4. Copia:

• El ID de Número Telefónico.
• El ID de la Cuenta.

Una vez que tengas:

• El Phone Number ID
• El WABA ID
• El Access Token
• El Webhook configurado correctamente

📧 Envíanos esta información para completar la conexión de tu cuenta de WhatsApp Business API con Moonflow.

Inicio rápido con la Cloud API de Meta

Configuración de Webhooks

Gestión de plantillas de mensajes

Verificación de empresa en Business Manager

Porque esos números están configurados para funcionar en un celular. La API necesita un número que no esté vinculado a ninguna app. 👉 Solo debes eliminar tu cuenta en la app para poder usar ese número en la API.

Pregunta	Respuesta
¿Qué pasa si mi empresa no está verificada?	No podrás usar WhatsApp Business API. Debes completar la verificación desde Business Manager.
¿Dónde genero el token?	En "Usuarios del sistema" dentro de Business Manager. Debes crear un usuario y generar el token desde allí.
¿Qué permisos debo asignar al token?	whatsapp_business_messaging y whatsapp_business_management. Sin ellos, Moonflow no podrá enviar ni recibir mensajes.
¿Dónde configuro el Webhook?	En la app desde developers.facebook.com, en la sección WhatsApp > Configuración de la API.
¿Puedo cambiar el token de verificación?	No. Usa exactamente el token WAMO que te proporciona Moonflow.
¿Debo configurar seguridad especial para el webhook?	No. La API Cloud ya usa HTTPS. Solo asegúrate de que la URL esté pública y accesible.

1. Entra a https://business.facebook.com/latest/settings/apps

2. Da clic en Añadir.

3. Da clic en "Crear un identificador de la aplicación".

4. Pon el nombre de la app Moonflow y continúa.

5. Selecciona la opción "Otro" y sigue.

6. Selecciona "Business" y sigue.

7. Revisa que sea el portafolio correcto donde la vas a crear y da clic en Crear aplicación.

Configurar la app Moonflow

• Entra a https://business.facebook.com/latest/settings/app y selecciona la app creada Moonflow.

• Da clic en el menú con los 3 puntos y luego en "Abrir en el panel de aplicaciones".

• Ve al menú WhatsApp -> Configuración.

• En el campo URL de devolución de llamada, pega:
https://msprd.moonflow.ai/communication-api/webhook/events/whatsappbusinessdata

• En el campo Identificador de verificación, pega:
WAMO

• Da clic en Verificar y guardar.

• Luego, debajo, da clic en Suscribir a todos los campos de webhooks que se listen. Es posible que alguno no se pueda suscribir; no hay problema.

Configurar número telefónico emisor de WhatsApps

• En la misma pantalla, entra al menú WhatsApp -> Configuración de la API.

• En el selector, da clic en Agregar número de teléfono.

• Pon el nombre que verán tus clientes, la zona horaria y la categoría. Luego sigue todos los pasos para registrar tu número telefónico.

• Una vez agregado el número de teléfono, envía a Moonflow el Identificador del número de teléfono y el Identificador de la cuenta de WhatsApp Business. Estos los puedes encontrar debajo del número seleccionado, como está en la imagen.

Crear token permanente

• Entra a https://business.facebook.com/latest/settings/system_users

• Da clic en Añadir.

• Escribe como nombre Moonflow y como rol Employee. Da clic en Crear usuario.

• Una vez creado, entra al usuario y da clic en Generar identificador.

• Selecciona la app que creaste previamente y sigue.

• Da clic en Nunca y sigue.

• En Asignar permisos, selecciona los que correspondan a WhatsApp, como en la imagen.

• Da clic en Generar identificador. Esto te mostrará un texto que debes copiar y enviar a Moonflow.