Introducción

Para poder enviar y recibir mensajes de WhatsApp desde la plataforma wolkvox —ya sea mediante flujos automáticos, campañas, bots o interacción con agentes— es necesario configurar un conector de WhatsApp. Este conector sirve como puente entre WhatsApp Business API (o métodos alternativos) y tu operación en wolkvox. En esta guía te explicamos paso a paso cómo realizar dicha integración desde wolkvox Manager, con sus distintas opciones (API oficial Cloud, móvil no oficial, etc.), según el tipo de conector que elijas.

Accede al panel de configuración de conectores de WhatsApp

1. En wolkvox Manager, haz clic en el ícono de “⚙️ Configuración” en la parte superior derecha. 
2. Luego navega a la pestaña “Omni Channel”. 
3. Dentro de esta pestaña, selecciona la sub-pestaña “WhatsApp”. 
4. Haz clic en el botón “+ AGREGAR CUENTA WHATSAPP”. 

Selecciona el tipo de conector

Aparecerá un formulario para seleccionar el tipo de conector. Dependiendo de tu caso, puedes elegir entre varias opciones:

• Integración Oficial (Meta Cloud API): Esta categoría garantiza la conexión directa con los servidores de Meta, ofreciendo la máxima estabilidad, alto volumen de mensajes y soporte oficial. Se subdivide en tres tipos según la modalidad de configuración:
  • WhatsApp Oficial: Requiere el ingreso manual de claves (Token, WABA ID, Phone ID).
  • WhatsApp Oficial Directo: Utiliza el asistente guiado de Meta (Login con Facebook) para la configuración más sencilla.
  • WhatsApp Oficial Directo App Cliente: Requiere ingresar el ID y Secret de la aplicación, además de las claves, para clientes que poseen su propia App de Meta Developers.
  • Requisito Crítico: Todos los conectores oficiales requieren tener un método de pago activo en el Meta Business Manager para operar sin restricciones.
• Integración Móvil (No Oficial): Este método no utiliza la API de Meta y se basa en la emulación de una sesión de WhatsApp Web mediante un dispositivo móvil físico y un código QR. Es ideal para operaciones pequeñas, pero conlleva riesgos inherentes (probabilidad media de bloqueo, ausencia de SLA y límite de 6.000 mensajes diarios).

Si elegiste “WhatsApp oficial”

Este conector permite vincular su operación de wolkvox con WhatsApp a través de la API Oficial de Meta (Cloud API) usando el proceso de Registro Integrado (Embedded Signup). Este método es el recomendado por su estabilidad y facilidad de configuración.

Requisitos previos

Para que la configuración funcione correctamente con la API oficial de WhatsApp Business (WhatsApp Cloud API / Business API), debes cumplir con lo siguiente:

• Tener una cuenta empresarial (WABA) verificada en Meta / Business Manager. 
• Tener un número de teléfono exclusivo para la API (no asociado previamente a WhatsApp personal o Business App). 
• Haber configurado correctamente la aplicación de Meta con el producto WhatsApp habilitado (app ID, secret key, permisos, etc.).

Ventajas

• Capacidad de enviar y recibir mensajes de forma programática, desde flujos automáticos, bots, CRM o sistemas integrados. 
• Escalabilidad y confiabilidad: la infraestructura está alojada por Meta, lo que evita necesidad de servidores propios. 
• Compatibilidad con múltiples agentes, chatbots, automatizaciones, mensajes masivos, integraciones con CRM/plataformas externas. 
• Cumplimiento de las políticas oficiales de WhatsApp Business, lo cual minimiza riesgos de bloqueo, suspensión o problemas de entrega.

Configuración

Cuando seleccionas como tipo de conector “WhatsApp oficial”, se muestra un formulario con los siguientes campos. A continuación se describen los campos y lo que representa cada uno:

• Name (Opcional): Nombre interno que deseas asignar a esta configuración del conector. Sirve para identificar el conector dentro de wolkvox (útil si gestionas varios números / cuentas).
• Routing Point – ChatBot: Selecciona el routing point de tipo Chat / Bot al que se enrutarán los mensajes entrantes desde este número. Es obligatorio.
• wolkvox Token: Token que usa wolkvox para autenticar la conexión con la API oficial; actúa como credencial interna entre wolkvox y WhatsApp vía API.
• wolkvox URL: URL que identifica el endpoint de integración para este conector dentro de wolkvox — usualmente usada para recibir webhooks o manejar la comunicación entre wolkvox y meta/servidores.

• wolkvox Key or name app: Nombre interno de la aplicación o clave pública/secreta de la aplicación de Meta asociada. Este campo es necesario para que wolkvox identifique tu cuenta de Business en Meta.
• WABA name: Nombre visible de la cuenta de WhatsApp Business (WABA) que estás configurando. Puede servir para distinguir diferentes cuentas o contextos de negocio.
• wolkvox Phone number: Número telefónico asociado a la cuenta WhatsApp Business. Debe incluir código de país + código de área + número, en formato internacional. Este será el número que tus clientes verán y desde el cual se enviarán/recibirán mensajes.
• Una vez completes todos los campos requeridos, presiona el botón “Add whatsapp configuration” para guardar y activar el conector.

Si elegiste “WhatsApp oficial directo App cliente (Cloud API)”

Este tipo de conector está diseñado para clientes que desean utilizar las capacidades de la API Cloud de WhatsApp, pero ya poseen y administran su propia Aplicación (App) dentro del portal de desarrolladores de Meta.

Permite una conexión de control total sobre la configuración de la App de Meta, requiriendo el ingreso manual de todas las credenciales generadas en el portal de desarrolladores.

Configuración

Cuando seleccionas como tipo de conector “WhatsApp oficial directo App cliente (Cloud API)”, se despliega un formulario con los siguientes campos:

• Identificador de la app: Es el App ID de la aplicación creada en la plataforma de desarrolladores de Meta/WhatsApp. Permite identificar la aplicación de cliente que usará la API.
• Clave secreta de la app: Es el App Secret asociado a la App ID, usada para autenticar las peticiones desde wolkvox hacia la API oficial.
• Botón “Continuar”: Una vez ingresados los datos, este botón inicia la validación / asociación de credenciales.
• Luego de esta configuración inicial deberás establecer: 
  • Name (Nombre): Nombre interno asignado a esta configuración para identificar la línea.
  • Routing Point – ChatBot: Menú desplegable para asociar la línea con el Routing Point (flujo de Chatbot) de wolkvox Studio. Es el punto de enrutamiento (Chat/Bot) dentro de wolkvox al que llegarán los mensajes entrantes desde WhatsApp. 

Si elegiste “WhatsApp oficial directo (Cloud API)”

Este conector permite la integración con la API Cloud de Meta de forma manual, mediante el ingreso directo de las credenciales de la cuenta. A diferencia de la integración "App Cliente", este conector se utiliza generalmente cuando se requiere un control específico sobre el Token y el WABA ID, o cuando la App de Meta es gestionada por un tercero (como un Partner de wolkvox).

Luego de esta configuración inicial deberás establecer: 

• Name (Nombre): Nombre interno asignado a esta configuración para identificar la línea.
• Routing Point – ChatBot: Menú desplegable para asociar la línea con el Routing Point (flujo de Chatbot) de wolkvox Studio. Es el punto de enrutamiento (Chat/Bot) dentro de wolkvox al que llegarán los mensajes entrantes desde WhatsApp. 

Si elegiste “WhatsApp móvil (No oficial)”

Esta modalidad usa una “API no oficial” o método alternativo para conectar WhatsApp a wolkvox: usualmente se basa en replicar la sesión de la app móvil / WhatsApp Web, no en la API oficial de Meta.

Es una opción que puede ser rápida de configurar, con pocos requisitos técnicos (una línea móvil activa, SIM, conexión a Internet). Eso permite a pequeñas empresas o implementaciones simples usar WhatsApp en wolkvox sin necesidad de infraestructura compleja. 

Este conector permite utilizar una línea de WhatsApp convencional (asociada a un dispositivo móvil y tarjeta SIM) integrándola a wolkvox mediante un proceso similar al de Dispositivos Vinculados de WhatsApp Web.

Términos y condiciones de uso

Debido a que este conector no utiliza la API oficial de Meta, su uso está sujeto a los siguientes términos. Es obligatorio que el usuario o compañía comprenda y acepte estas condiciones antes de su implementación:

1. La API no pertenece al portafolio oficial de APIs de Meta.
2. Aunque es estable, el servicio podría dejar de estar disponible en cualquier momento.
3. La probabilidad de bloqueo del servicio es media.
4. El costo de la operación es bajo (comparado con la API Cloud).
5. Límite de envío: Hasta 6.000 mensajes diarios.
6. La API es compatible con varios dispositivos.
7. Límite de archivos: Es posible compartir archivos que alcancen hasta 2MB.
8. La velocidad de respuesta es aceptable.
9. Cuenta con soporte por correo.
10. No incluye API para envíos masivos.
11. No cuenta con conversaciones gratuitas.
12. El conector no posee Acuerdos de Nivel de Servicio (SLA).
13. Para usar el conector debe tener un equipo móvil y SIM Card.

Configuración

Al seleccionar “WhatsApp móvil (No oficial)” aparece un formulario con los siguientes campos:

• Name (Nombre): Nombre interno asignado a esta configuración para identificar la línea.
• Routing Point – ChatBot: Menú desplegable para asociar la línea con el Routing Point (flujo de Chatbot) de wolkvox Studio. Es el punto de enrutamiento (Chat/Bot) dentro de wolkvox al que llegarán los mensajes entrantes desde WhatsApp. 
• wolkvox Phone number: El número de teléfono móvil real que se desea asociar a la plataforma (incluyendo código de país).
• Luego de llenar los campos, da clic en el botón "Register phone number".

Escaneo del Código QR

• Da clic en el botón "Get QR Code" para generar la imagen de código QR en pantalla.
• Toma el dispositivo móvil asociado al número registrado.
• Abre la aplicación de WhatsApp y navega a Configuración > Dispositivos vinculados > Vincular un dispositivo.
• Escanea el código QR generado en wolkvox Manager para asociar la cuenta.
• La línea pasará a estado "Conectado" una vez que el escaneo sea exitoso y el dispositivo físico mantenga una conexión a Internet.

Solución de Problemas: Reiniciar la Vinculación Móvil

En caso de errores de conexión o desvinculación de este tipo de conector, puedes restablecer la cuenta sin necesidad de borrar toda la configuración:

• Ingresa al listado de cuentas y selecciona la opción de edición del conector móvil.
• Da clic en el ícono de opciones (tres puntos alineados verticalmente).
• Selecciona la opción "Factory reset" para restablecer la configuración de la cuenta.
• Vuelve al menú de tres puntos y selecciona "Logout phone" para desvincular la sesión actual del dispositivo móvil.
• Finalmente, selecciona "QR Code" para generar un nuevo código y escanea con el dispositivo móvil para volver a vincular la línea.