¿Cómo conecto WhatsApp mediante la API Cloud de Meta?

Para conectar tu cuenta de WhatsApp mediante la API Cloud de Meta en Moonflow, sigue estos pasos. Esta integración permite que puedas enviar y recibir mensajes de WhatsApp de manera automática desde la plataforma, sin necesidad de servidores propios.

Requisitos previos

Antes de comenzar, asegúrate de cumplir estos requisitos:

  • Tener una empresa verificada en Meta Business Manager.
    (Sin verificación de empresa no podrás agregar números a la API.)
  • Contar con acceso de administrador a la cuenta de Meta Business Manager y al Administrador de WhatsApp.
  • Disponer de un número de teléfono activo que no esté registrado actualmente en la app de WhatsApp ni en WhatsApp Business. Si el número ya está en uso, deberás eliminar la cuenta desde la app.👉
  • Tener una cuenta creada en Meta for Developers.
  • El número debe poder recibir llamadas o SMS para completar la verificación.

Para configurar correctamente la integración, necesitas reunir y enviar a help@moonflow.ai los siguientes datos:

  • Account ID: Identificador del número telefónico (Phone Number ID).
  • Identificador de la cuenta de WhatsApp Business (WABA ID).
  • Access Token: Código que permite a Moonflow comunicarse con tu WhatsApp Business API.
  • Webhook configurado correctamente.

Pasos para conectar WhatsApp mediante la API Cloud de Meta

1. Ingresar a la cuenta de WhatsApp Business

Accede a Meta Business Settings - WhatsApp Account

Selecciona la cuenta de WhatsApp correspondiente.

2. Obtener los identificadores

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
3. Configurar el Webhook

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.

4. Generar un Access Token permanente

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.

Agregar o identificar un número nuevo

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.
Finalización

Una vez que tengas:

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

📧 Envía esta información a help@moonflow.ai para completar la conexión de tu cuenta de WhatsApp Business API con Moonflow.

 

Si necesitas más información o tienes alguna consulta, te brindamos más recursos a continuación:

Documentación oficial recomendada +
¿Por qué no puedo usar un número que ya está configurado en una aplicación de WhatsApp o WhatsApp Business? +

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.

Preguntas frecuentes +
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.

 

💡 ¿Quieres saber más sobre este tema? Puedes acceder al siguiente recurso:

🚀 Artículo: WhatsApp Business vs. WhatsApp Business API: ¿Cuál es la mejor opción para tu negocio?