Conectar WhatsApp Cloud API con Botinfy (Modo Coexistencia)
Esta guía te ayudará a conectar WhatsApp Cloud API con la plataforma Botinfy cuando ya tienes un número registrado en la aplicación de WhatsApp Business y deseas mantenerlo activo mientras lo integras con la API.
El modo de coexistencia (Coexistence Mode) es una solución que te permite conectar tu aplicación existente de WhatsApp Business a la plataforma de API en la nube de Botinfy sin perder datos ni necesidad de volver a registrar tu número de teléfono.
¿Qué es el Modo Coexistencia?
El modo de coexistencia permite que tu número de WhatsApp Business funcione simultáneamente en:
- La aplicación móvil de WhatsApp Business (tu dispositivo)
- La plataforma Botinfy a través de WhatsApp Cloud API
Esto significa que puedes seguir usando la aplicación móvil mientras también aprovechas las capacidades de automatización y gestión avanzada de Botinfy.
Prerrequisitos
Antes de poder usar el modo de coexistencia, necesitarás lo siguiente:
- Un número de teléfono activo en la aplicación de WhatsApp Business desde hace al menos 6 meses.
- Una cuenta de Facebook. Debe ser una cuenta activa y sin restricciones.
- Acceso de administrador a tu cuenta de Meta Business Manager. Si no tienes una cuenta de Meta Business Manager, puedes crear una durante el proceso de conexión.
- Tarjeta de crédito (Mastercard / Visa → No American Express!) para configurar la facturación en WhatsApp Manager.
- Acceso al dispositivo móvil donde está instalada la aplicación de WhatsApp Business para escanear el código QR.
IMPORTANT
Tu número debe estar activo en WhatsApp Business App desde hace al menos 6 meses para poder usar el modo de coexistencia.
Instrucciones Paso a Paso
Paso 1: Acceder a la Configuración de WhatsApp Cloud en Botinfy
- Inicia sesión en la plataforma Botinfy.
- Navega al Dashboard desde la barra lateral izquierda.
- Haz clic en "WhatsApp Cloud".
- Busca la opción "Conectar con WhatsApp Business Existente" o "Modo Coexistencia" y haz clic en ella.
Paso 2: Iniciar sesión con Facebook
En la ventana emergente, inicia sesión con tu cuenta de Facebook o selecciona la cuenta con la que ya has iniciado sesión en tu navegador. Esta cuenta debe tener permisos de administrador en el Meta Business Manager que utilizarás.
Paso 3: Seleccionar o Crear Meta Business Manager
Puedes seleccionar una cuenta de Meta Business Manager existente en la que tengas permisos de administrador o crear una nueva cuenta de Meta Business Manager.
Si creas una nueva cuenta, necesitarás preparar la siguiente información:
- Nombre legal del negocio
- Número de teléfono del negocio
- Sitio web del negocio
- Dirección de correo electrónica del negocio
- País
- Dirección corporativa
- Ciudad
- Estado/provincia/región
Paso 4: Escanear el Código QR
- Botinfy te mostrará un código QR único para conectar tu número existente.
- Abre la aplicación de WhatsApp Business en tu dispositivo móvil.
- Ve a Configuración → Dispositivos vinculados → Conectar un dispositivo.
- Escanea el código QR que se muestra en la pantalla de Botinfy con tu dispositivo móvil.
NOTE
El código QR tiene un tiempo de expiración limitado. Si expira, puedes generar uno nuevo desde Botinfy.
Paso 5: Importar Historial de Chats (Opcional)
Durante el proceso de conexión, se te preguntará si deseas importar el historial de chats existente. Tienes dos opciones:
- Sí, importar historial: .
- No, comenzar desde cero: .
TIP
Se recomienda NO importar el historial para acortar el tiempo del proceso.
Paso 6: Confirmar la Conexión
Una vez que hayas escaneado el código QR y completado los pasos anteriores:
- Verifica que la conexión se haya establecido correctamente en Botinfy.
- El estado de tu número debería cambiar a "Conectado" o "Activo".
- Verifica que puedas ver tu número en la lista de números conectados en Botinfy.
Paso 7: Verificar la Conexión
Para verificar que todo funciona correctamente:
- Desde la aplicación móvil: Envía un mensaje de prueba desde tu aplicación de WhatsApp Business. Deberías poder verlo reflejado en Botinfy.
- Desde Botinfy: Crea un flujo simple y publícalo. Envía un mensaje de prueba desde tu número personal de WhatsApp al número conectado. Deberías recibir la respuesta automática configurada en Botinfy.
IMPORTANT
Con el modo de coexistencia, los mensajes pueden llegar tanto a la aplicación móvil como a Botinfy. Asegúrate de configurar tus flujos correctamente para evitar respuestas duplicadas.
Configuración Adicional
Configurar Método de Pago
Es importante configurar un método de pago válido en WhatsApp Manager:
- Ve a WhatsApp Manager en tu Meta Business Manager.
- Navega a la sección de Facturación.
- Agrega una tarjeta de crédito válida (Mastercard o Visa).
Esto es necesario para enviar mensajes de plantilla y evitar restricciones.
Verificar Meta Business Manager
Se recomienda verificar tu Meta Business Manager para evitar restricciones:
- Ve a Business Manager → Configuración de Seguridad.
- Inicia el proceso de verificación del negocio.
- Proporciona los documentos requeridos.
Sincronizar Plantillas de Mensajes
- En Botinfy, ve a "Contenido" → "Plantillas de Mensajes".
- Haz clic en el botón "Sincronizar" para importar las plantillas existentes desde WhatsApp Manager.
- También puedes crear nuevas plantillas directamente desde Botinfy haciendo clic en "+ Nueva Plantilla".
Configurar Flujos en Botinfy
Una vez conectado, puedes comenzar a crear flujos automatizados:
- Ve a "Flujos" en Botinfy.
- Crea tu flujo principal que se ejecutará cuando los usuarios escriban.
- Configura nodos de acción, condiciones y respuestas automáticas.
- Publica el flujo para activarlo.
Ventajas del Modo Coexistencia
- ✅ Sin pérdida de datos: Mantienes todo tu historial de conversaciones.
- ✅ Uso simultáneo: Puedes seguir usando la aplicación móvil mientras Botinfy gestiona las conversaciones.
- ✅ Migración gradual: Puedes migrar gradualmente a la automatización completa.
- ✅ Sin interrupciones: No hay tiempo de inactividad durante la conexión.
- ✅ Flexibilidad: Puedes responder manualmente desde la app cuando sea necesario.
Limitaciones y Consideraciones
Mensajes Duplicados
Con el modo de coexistencia, los mensajes pueden llegar tanto a la aplicación móvil como a Botinfy. Es importante:
- Configurar tus flujos para evitar respuestas automáticas cuando respondes manualmente desde la app.
- Establecer reglas claras sobre cuándo usar la automatización y cuándo responder manualmente.
Sincronización
- Los mensajes enviados desde la aplicación móvil aparecerán en Botinfy después de un breve retraso.
- Los mensajes enviados desde Botinfy aparecerán en la aplicación móvil casi instantáneamente.
Límites de Mensajes
Los límites de mensajes de WhatsApp Cloud API siguen aplicándose. Consulta la documentación de Meta para conocer los límites actuales.
Errores Comunes y Soluciones
El código QR ha expirado
Problema: El código QR que intentas escanear ya no es válido.
- Solución: Genera un nuevo código QR desde Botinfy y escanéalo nuevamente.
No puedo escanear el código QR
Problema: La aplicación de WhatsApp Business no reconoce el código QR.
- Solución:
- Asegúrate de estar usando la aplicación oficial de WhatsApp Business (no WhatsApp regular).
- Verifica que tu número tenga al menos 6 meses de antigüedad en WhatsApp Business.
- Intenta cerrar y abrir la aplicación antes de escanear nuevamente.
El número no aparece como conectado
Problema: Después de escanear el código QR, el número no aparece como conectado en Botinfy.
- Solución:
- Espera unos minutos y actualiza la página.
- Verifica que hayas completado todos los pasos del proceso.
- Contacta con el soporte de Botinfy si el problema persiste.
Los mensajes no se sincronizan
Problema: Los mensajes enviados desde la aplicación móvil no aparecen en Botinfy.
- Solución:
- Verifica que la conexión esté activa en Botinfy.
- Asegúrate de tener una conexión a internet estable.
- Espera unos minutos, ya que puede haber un pequeño retraso en la sincronización.
Migración Completa (Opcional)
Si en el futuro decides migrar completamente a Botinfy y dejar de usar la aplicación móvil:
- Ve a la configuración de WhatsApp Cloud en Botinfy.
- Busca la opción de "Desconectar aplicación móvil" o "Migrar completamente".
- Sigue las instrucciones para completar la migración.
WARNING
La migración completa desconectará tu número de la aplicación móvil. Asegúrate de tener una copia de seguridad de tus conversaciones importantes antes de proceder.
Próximos Pasos
Una vez que hayas completado la conexión en modo coexistencia:
- Configura tu flujo principal en Botinfy para automatizar respuestas comunes.
- Crea plantillas de mensajes para comunicaciones iniciadas por el negocio.
- Configura reglas para determinar cuándo usar automatización y cuándo responder manualmente.
- Verifica tu Meta Business Manager para evitar restricciones.
- Configura un método de pago válido en WhatsApp Manager.
- Prueba tus flujos con mensajes de prueba antes de ponerlos en producción.