Skip to main content
La Evolution API v2 permite integrar su aplicación con la Cloud API oficial de WhatsApp para gestionar mensajes, contactos y otras funcionalidades directamente a través de la API. A continuación, se detallan los prerrequisitos y el proceso de integración.

​
Prerrequisitos

Antes de iniciar la integración con la Cloud API de WhatsApp, debe asegurarse de que los siguientes pasos se hayan completado:

​
1. Creación del Business Manager (BM) y Aprobación

Para utilizar la Cloud API oficial de WhatsApp, necesita un Business Manager (BM) aprobado. Este proceso implica:
  • Crear una cuenta en Facebook Business Manager.
  • Seguir los pasos para la verificación de su empresa.
  • Esperar la aprobación de su cuenta.

​
2. Creación de la App en Facebook Developers

Después de la aprobación de su BM, necesita crear una aplicación en la plataforma Facebook Developers:
  • Acceda a su cuenta de Facebook Developers y haga clic en Mis Apps.
  • Haga clic en Crear App y siga las instrucciones para configurar una nueva aplicación.
  • Asegúrese de agregar la API de WhatsApp a su aplicación.

​
3. Configuración del Número en la Aplicación

Después de crear la aplicación, necesita configurar el número de WhatsApp:
  • En el panel de su aplicación en Facebook Developers, vaya a la sección WhatsApp.
  • Agregue y verifique el número de teléfono que desea usar con la Cloud API.
  • Anote el Number ID proporcionado.

​
4. Crear un Token Permanente

Para evitar que el token de acceso expire, cree un token permanente para el usuario administrador de su BM:
  • Vaya a la sección Tokens de Acceso en Facebook Developers.
  • Genere un token con los permisos necesarios para la API de WhatsApp.
  • Asegúrese de que este token sea permanente, para no necesitar renovarlo periódicamente.

​
Configuración en la Evolution API v2

Ahora que ha completado los prerrequisitos, siga los pasos a continuación para configurar la integración con la Evolution API v2.

​
1. Creación de la Instancia

Para crear una instancia que utilice la Cloud API de WhatsApp, necesitará acceder a la ruta /instance/create de la Evolution API v2 con el siguiente cuerpo de solicitud:

​
Parámetros del Cuerpo de la Solicitud:

  • instanceName: Nombre de la instancia que está creando.
  • token: Token permanente generado para el usuario administrador de su BM.
  • number: Number ID de WhatsApp que configuró en la aplicación de Facebook Developers.
  • businessId: ID de la cuenta de negocios asociada a WhatsApp.
  • qrcode: Defina como false ya que la integración está basada en token, y no en QR Code.
  • integration: Use "WHATSAPP-BUSINESS" para especificar que esta integración es con la API oficial de WhatsApp Business.

​
Ejemplo de Solicitud:

​
2. Configuración del Webhook

Después de crear la instancia, es necesario configurar el webhook en la aplicación de Meta para recibir eventos y mensajes de WhatsApp.

​
URL del Webhook

En el panel de su aplicación en Facebook Developers, configure el webhook con la siguiente URL:

​
Token del Webhook

El token para validar el webhook debe configurarse en la variable WA_BUSINESS_TOKEN_WEBHOOK en su archivo .env:
Este token será usado por Meta para validar las solicitudes enviadas a su webhook.

​
Conclusión

Con la instancia creada y el webhook configurado, su Evolution API v2 está lista para operar con la Cloud API oficial de WhatsApp. Todos los mensajes y eventos relacionados con el número configurado serán gestionados automáticamente por la Evolution API. Esta documentación proporciona una visión clara y detallada de cómo integrar la Cloud API de WhatsApp con la Evolution API v2, desde la preparación necesaria hasta la configuración final. Si sigue todas las etapas, estará preparado para utilizar las funcionalidades de WhatsApp en su aplicación a través de la Evolution API v2.