Errores Comunes y Soluciones - WhatsApp
Esta guía recopila los errores más comunes que pueden ocurrir al trabajar con WhatsApp Cloud API en Botinfy y sus respectivas soluciones. Los errores están organizados por categorías para facilitar su búsqueda.
Errores de Creación de Cuenta de Business Manager
Ocurrió un error al procesar esta solicitud. Por favor, inténtalo de nuevo más tarde.
Problema: Este es el error más poco claro que necesita asistencia adicional. La creación de la cuenta comercial podría haber fallado por varias razones.
Solución:
- Usa una cuenta de Facebook activa o contacta con Soporte para resolver el problema.
- Verifica que tu cuenta de Facebook no tenga restricciones.
- Intenta nuevamente después de unos minutos.
Has alcanzado el límite para el número de Negocios que puedes crear en este momento.
Problema: Hay un límite en el número de Cuentas Comerciales que puedes crear.
Solución:
- Usa una Cuenta Comercial existente o elimina/cierra Cuentas Comerciales no utilizadas.
- Contacta con el soporte de Meta Business Manager si necesitas aumentar tu límite.
Tu cuenta de Facebook es demasiado nueva para crear una cuenta comercial. Inténtalo de nuevo en una hora.
Problema: Las cuentas nuevas de Facebook tienen que esperar un tiempo para crear una cuenta de Business Manager.
Solución:
- Usa una cuenta de Facebook activa existente o espera unas horas antes de usar tu nueva cuenta.
- Verifica que tu cuenta de Facebook esté completamente configurada con información de perfil.
Errores de Verificación de Número
Este número está registrado en una cuenta de WhatsApp existente. Para usar este número, desconéctalo de la cuenta existente.
Problema: El número de teléfono ya estaba registrado en nuestra plataforma (es decir, WhatsApp Messenger, WhatsApp Business App o WhatsApp Business API).
Solución:
- Ve a la configuración de "WhatsApp Cloud" en Botinfy y desregistra el número si deseas usarlo.
- O registra un nuevo número que no esté asociado a ninguna cuenta de WhatsApp.
- Si el número está en WhatsApp Business App, puedes usar el modo de coexistencia en lugar de crear una nueva cuenta.
Tu número de teléfono no parece ser válido. Por favor, verifícalo o inténtalo de nuevo después de 5 minutos.
Problema: Se ingresó un número de teléfono incorrecto o no admitimos números de este formato.
Solución:
- Asegúrate de que el número sea operativo y verificado por un proveedor de telecomunicaciones.
- Verifica que el número esté en formato internacional correcto (incluyendo código de país).
- Revisa que el número no tenga espacios o caracteres especiales.
- Intenta nuevamente después de 5 minutos si el problema persiste.
Has adivinado demasiadas veces.
Problema: Para bloquear el spam, el sistema solo permite un número limitado de intentos de verificación.
Solución:
- Tienes que esperar aproximadamente 12 horas antes de volver a intentar.
- Verifica que tengas acceso al número antes de intentar nuevamente.
- Si es posible, usa el método de verificación alternativo (SMS si intentaste llamada de voz, o viceversa).
Errores del Modo Coexistencia
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.
- Asegúrate de escanear el código QR dentro del tiempo de expiración indicado.
- Verifica que tengas una conexión a internet estable durante el proceso.
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.
- Asegúrate de que la cámara de tu dispositivo tenga los permisos necesarios.
- Verifica que el código QR esté completamente visible en la pantalla.
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 de conexión.
- Asegúrate de haber escaneado el código QR correctamente.
- Verifica que tu Meta Business Manager tenga los permisos necesarios.
- Contacta con el soporte de Botinfy si el problema persiste después de verificar los pasos anteriores.
Los mensajes no se sincronizan
Problema: Los mensajes enviados desde la aplicación móvil no aparecen en Botinfy, o viceversa.
Solución:
- Verifica que la conexión esté activa en Botinfy.
- Asegúrate de tener una conexión a internet estable tanto en tu dispositivo móvil como en la computadora.
- Espera unos minutos, ya que puede haber un pequeño retraso en la sincronización.
- Verifica que no haya restricciones de red o firewall bloqueando la conexión.
- Intenta reiniciar la conexión desde Botinfy si el problema persiste.
Errores de Conexión que Requieren Reconexión
Error de conexión que se soluciona desconectando y reconectando
Problema: Este es un error común que puede aparecer tanto al conectar WhatsApp API (nueva cuenta) como en el modo Coexistencia. Se manifiesta cuando hay problemas en la sincronización entre Botinfy y WhatsApp Cloud API, o cuando el proceso de vinculación no se completó correctamente. Puedes darte cuenta Verificando la salud de la conexión. Puede que durante este problema no puedas recibir ni enviar mensajes desde el Live Chat de la app de Botinfy.
Síntomas comunes:
- El número no aparece como conectado aunque hayas completado todos los pasos
- Los mensajes no se están recibiendo o enviando correctamente
- La conexión aparece como activa pero no funciona
- Errores de sincronización persistentes
Solución:
- Ve a la configuración de "WhatsApp Cloud" en Botinfy.
- Localiza el número que presenta el problema.
- Haz clic en el botón "Desconectar" para desconectar el número.
- Espera unos segundos para que la desconexión se complete.
- Haz clic nuevamente en "Conectar WhatsApp Cloud" (para nueva cuenta) o "Conectar con WhatsApp Business Existente" (para modo Coexistencia).
- Vuelve a realizar todo el proceso de vinculación desde el principio:
- Para WhatsApp API (Nueva Cuenta): Completa los pasos de creación de Business Manager, verificación de número, etc.
- Para Modo Coexistencia: Escanea nuevamente el código QR con tu aplicación de WhatsApp Business.
- Verifica que la conexión se haya establecido correctamente.
NOTE
Este proceso de desconectar y reconectar suele resolver la mayoría de los problemas de conexión que no tienen una causa específica identificable.
Errores de Configuración y Facturación
No puedo enviar mensajes de plantilla
Problema: Los mensajes de plantilla no se están enviando o recibes un error al intentar enviarlos.
Solución:
- Verifica que hayas configurado un método de pago válido en WhatsApp Manager (Mastercard o Visa).
- Asegúrate de que las plantillas estén aprobadas por Meta.
- Verifica que el número esté en estado "Conectado" o "Activo" en Botinfy.
- Revisa que la plantilla tenga el formato correcto según las políticas de WhatsApp.
- Consulta la sección de facturación en WhatsApp Manager para verificar que no haya problemas de pago.
El número aparece como "Pendiente" en WhatsApp Manager
Problema: El número no se está sincronizando correctamente entre Botinfy y WhatsApp Manager.
Solución:
- Haz clic en el botón "Sincronizar Números" en Botinfy.
- En Botinfy, ve a "Configuración" → "Registrar número" e ingresa los primeros 6 dígitos del número (ej: 584241).
- Espera unos minutos para que la sincronización se complete.
- Verifica que tengas permisos de administrador en el Meta Business Manager.
- Si el problema persiste, contacta con el soporte de Botinfy.
Errores de Conectividad
La conexión se pierde frecuentemente
Problema: La conexión con WhatsApp Cloud API se interrumpe regularmente.
Solución:
- Verifica que tengas una conexión a internet estable.
- Revisa que no haya restricciones de firewall o proxy bloqueando la conexión.
- Asegúrate de que tu Meta Business Manager esté verificado.
- Verifica que el número no tenga restricciones en WhatsApp Manager.
- Contacta con el soporte técnico si el problema continúa.
No puedo acceder a WhatsApp Cloud en Botinfy
Problema: La sección de WhatsApp Cloud no carga o muestra un error.
Solución:
- Actualiza la página del navegador (Ctrl + R o Cmd + R).
- Limpia la caché del navegador y vuelve a intentar.
- Verifica que tengas permisos de administrador en el workspace de Botinfy.
- Prueba en un navegador diferente o en modo incógnito.
- Verifica que no haya problemas de conectividad con el servidor de Botinfy.
Cuando Contactar con Soporte
Si has intentado todas las soluciones sugeridas y el problema persiste, es recomendable contactar con el soporte de Botinfy proporcionando la siguiente información:
- Descripción detallada del problema
- Capturas de pantalla del error (si es posible)
- Pasos que realizaste antes de que ocurriera el error
- Información del workspace (nombre del workspace en Botinfy)
- Número de teléfono afectado (si aplica)
- Tipo de conexión (Nueva cuenta o Modo Coexistencia)
- Navegador y versión que estás usando
- Hora aproximada en que ocurrió el error
Recursos Adicionales
Para más información sobre la configuración de WhatsApp, consulta: