Saltar al contenido principal

Configuración

Después de instalar y activar el módulo WhatsApp Cloud API Chat & Marketing, necesitas configurar la conexión entre Perfex CRM y la Meta WhatsApp Cloud API. Esto implica configurar una Aplicación Meta, generar credenciales de API, configurar webhooks y ajustar las opciones del módulo.

Configuración de la Aplicación Meta​

Se accede a la WhatsApp Cloud API a través de una App de Meta (Facebook). Si aún no has creado una, sigue estos pasos.

Paso 1 — Crear una Cuenta de Facebook Developers​

  1. Ve a developers.facebook.com.
  2. Inicia sesión con tu cuenta de Facebook.
  3. Si se te solicita, regístrate como desarrollador aceptando los términos y verificando tu cuenta.

Paso 2 — Crear una App de Meta​

  1. En el panel de Facebook Developers, haz clic en Create App.
  2. Selecciona Business como tipo de aplicación (o Other si Business no está disponible para tu tipo de cuenta).
  3. Ingresa un App Name (por ejemplo, "Perfex CRM WhatsApp") y tu correo electrónico de contacto.
  4. Selecciona tu Business Account (o crea una si es necesario).
  5. Haz clic en Create App.

Paso 3 — Agregar WhatsApp a Tu App​

  1. En el panel de tu nueva app, busca WhatsApp en la lista de productos y haz clic en Set Up.
  2. Sigue la configuración guiada para vincular una WhatsApp Business Account.
  3. Se proporciona automáticamente un número de teléfono de prueba para desarrollo. Puedes agregar tu propio número de teléfono comercial verificado más adelante.
info

El número de teléfono de prueba te permite enviar mensajes a hasta 5 números preregistrados. Para uso en producción, agrega y verifica tu propio número de teléfono comercial en la configuración de la WhatsApp Business Account.

Paso 4 — Generar un Token de Acceso Permanente​

El token temporal predeterminado expira después de 24 horas. Para producción, genera un token permanente de System User:

  1. Ve a business.facebook.com y navega a Business Settings > System Users.
  2. Crea un nuevo System User (o usa uno existente) con acceso de Admin.
  3. Haz clic en Generate New Token, selecciona tu app de WhatsApp y otorga los siguientes permisos:
    • whatsapp_business_messaging
    • whatsapp_business_management
  4. Copia el token generado — este es tu token de acceso permanente.
aviso

El token permanente se muestra solo una vez. Guárdalo de forma segura. Si lo pierdes, necesitarás generar uno nuevo y actualizar la configuración de tu módulo.

Configuración de Webhook​

Los webhooks permiten que WhatsApp notifique a tu instancia de Perfex CRM sobre mensajes entrantes, confirmaciones de entrega y actualizaciones de estado en tiempo real.

Configurar el Webhook​

  1. En el panel de Facebook Developers, ve a la página WhatsApp > Configuration de tu app.
  2. En Webhook, haz clic en Edit.
  3. Ingresa la Callback URL proporcionada por el módulo (que se encuentra en WhatsApp Module > Settings en Perfex CRM). Generalmente sigue este formato: 
    https://your-perfex-domain.com/whatsapp_cloud_api/webhook
  4. Ingresa el Verify Token que se muestra en la configuración del módulo.
  5. Haz clic en Verify and Save.
  6. Suscríbete a los siguientes campos de webhook:
    • messages
    • message_template_status_update
tip

Tu instalación de Perfex CRM debe estar servida sobre HTTPS con un certificado SSL válido. Meta rechazará las URLs de webhook que usen HTTP o tengan certificados inválidos/autofirmados.

Configuración del Módulo​

Después de completar la configuración de la App de Meta, configura el módulo dentro de Perfex CRM.

  1. Navega al módulo WhatsApp Cloud API en la barra lateral de Perfex CRM.
  2. Ve a Settings e ingresa lo siguiente:
ConfiguraciónDescripción
Access TokenEl token permanente de System User generado anteriormente
Phone Number IDSe encuentra en la página WhatsApp > Getting Started de tu App de Meta
WhatsApp Business Account IDSe encuentra en la configuración de WhatsApp de tu App de Meta
Webhook Verify TokenUna cadena personalizada que tú defines — debe coincidir con lo que ingresaste en la configuración del webhook de Meta
App IDEl ID de tu App de Meta (se encuentra en el panel de la app)
  1. Haz clic en Save Settings.
  2. Usa el botón Test Connection para verificar que el módulo pueda comunicarse con la WhatsApp Cloud API.

Configuración de Incrustación​

Para configuraciones avanzadas, el módulo soporta la incrustación del widget de chat de WhatsApp en páginas externas o portales de clientes. Navega a WhatsApp Module > Settings > Embed para generar un fragmento de código de incrustación y personalizar la apariencia del widget (colores, posición, mensaje de bienvenida).

Verificación Empresarial​

Para desbloquear la capacidad completa de mensajería y acceso a todas las categorías de plantillas, completa tu verificación empresarial de Meta:

  1. Ve a business.facebook.com > Business Settings > Security Center.
  2. Haz clic en Start Verification y sigue el proceso guiado.
  3. Envía los documentos de tu empresa según lo solicitado por Meta.
  4. La verificación generalmente toma de 2 a 5 días hábiles.
info

Sin la verificación empresarial, tu mensajería está limitada a 250 destinatarios únicos por ventana de 24 horas. Después de la verificación, los límites aumentan progresivamente según la calidad y el volumen de los mensajes.

¿Qué Sigue?​

  • Guía de Uso — aprende a usar la interfaz de chat, ejecutar campañas, configurar bots y administrar plantillas
  • Registros de WhatsApp — consulta registros completos de todas las interacciones automatizadas