Si ves un error durante la configuración o tu número de teléfono no se puede conectar, esta guía explica las causas más comunes y cómo resolverlas.
Antes de comenzar
Antes de conectar tu canal de la API de WhatsApp Business, confirma los siguientes requisitos previos. Estas verificaciones pueden ayudar a prevenir problemas de conexión comunes durante la configuración.
- Usa los datos legales exactos de tu empresa
El nombre legal y la dirección de tu empresa ingresados en la sección Información de la empresa de tu Portafolio comercial de Meta deben coincidir exactamente con tus documentos oficiales de registro comercial. Incluso pequeñas diferencias de ortografía o puntuación pueden retrasar la verificación.
- Usa una cuenta de Facebook establecida
Las cuentas de Facebook creadas recientemente tienen más probabilidades de ser restringidas por Meta durante la creación del Portafolio comercial. Te recomendamos usar una cuenta que haya estado activa durante al menos un mes.
- Asegúrate de tener los permisos de administrador correctos
La cuenta usada durante la configuración debe tener acceso de “Control total” al Portafolio comercial de Meta en el Administrador comercial de Meta.
- Activa la autenticación de dos factores (2FA)
Es posible que Meta exija a los administradores activar la 2FA antes de poder completar ciertos pasos de configuración de WhatsApp.
- Completa primero la información de tu empresa en Meta
Si a tu Portafolio comercial de Meta le faltan datos comerciales obligatorios, el proceso de configuración de WhatsApp podría fallar o impedirte reclamar un número de teléfono.
⚠️ Nota:
La siguiente lista abarca los problemas más comunes que ocurren al conectar un número de teléfono a la API de WhatsApp Business a través de SleekFlow.
Algunos errores pueden originarse en el proceso de configuración de Meta o en restricciones de la cuenta, lo que puede requerir acciones en el Administrador comercial de Meta o en el Administrador de WhatsApp.
Si el problema persiste después de seguir los pasos a continuación, comunícate con nuestro equipo de soporte con una captura de pantalla del mensaje de error.
Problemas de conexión comunes al conectar la API de WhatsApp Business
Problemas |
Descripción |
Posible causa y solución sugerida |
|---|---|---|
No se recibió el OTP |
No se recibió el código de verificación necesario para registrar tu número de teléfono. |
Confirma que el número de teléfono pueda recibir SMS o llamadas de voz y, luego, vuelve a solicitar el código de verificación. Evita solicitar el código repetidamente en un período corto, ya que Meta podría bloquear temporalmente el flujo de registro después de demasiados intentos. Si ya lo intentaste varias veces, espera de 24 a 48 horas antes de volver a intentarlo.
Consejo: Si el código de verificación por SMS no llega, intenta solicitar el código por llamada telefónica. |
El problema del IVR |
La llamada de verificación no puede comunicarse directamente con el número de teléfono. |
Si el número tiene un sistema IVR o de respuesta automática (por ejemplo, “Presiona 1 para Ventas”), el sistema de verificación de Meta no puede navegar por él.
Desactiva temporalmente el IVR para que la llamada llegue directamente a una persona o al correo de voz. |
Se seleccionó el Portafolio comercial incorrecto |
Se seleccionó el Portafolio comercial de Meta incorrecto. |
Reinicia el proceso de conexión y asegúrate de seleccionar el Portafolio comercial de Meta correcto durante la configuración. Verifica el nombre del portafolio antes de confirmar la conexión. |
El número de teléfono todavía está vinculado a la aplicación WhatsApp Business |
Un número de teléfono no se puede usar en la aplicación WhatsApp Business y en la API de WhatsApp Business al mismo tiempo. |
Si deseas migrar el número a la API, primero elimina la cuenta de WhatsApp desde la aplicación WhatsApp Business.
Ve a Configuración → Cuenta → Eliminar mi cuenta, y luego reinicia el proceso de configuración en SleekFlow. |
No se puede agregar el número de teléfono |
El número de teléfono no se puede registrar durante la configuración. |
Esto puede ocurrir si Meta restringió o inhabilitó la cuenta de WhatsApp Business. Revisa el panel de Calidad de la cuenta en el Administrador comercial de Meta y envía una apelación si es necesario. |
Se alcanzó el límite de WABA |
Tu cuenta comercial alcanzó su límite de números de teléfono. |
Actualmente, los Business Managers no verificados están limitados a dos números de teléfono.
Verifica tu Business Manager (BM) para aumentar tu límite y tus niveles de mensajería. Si es necesario, también puedes crear un nuevo Business Manager. |
Falla la verificación de migración |
No se puede completar la migración del número de teléfono desde otro proveedor de la API de WhatsApp Business. |
Es posible que el proveedor anterior todavía tenga habilitada la verificación en dos pasos (PIN) para el número de teléfono. Desactiva la verificación en dos pasos con el proveedor actual antes de iniciar la migración.
Si el PIN se cambió recientemente, es posible que Meta exija un período de espera antes de continuar con la migración. Además, confirma que el número pueda recibir SMS o llamadas de voz durante el proceso de migración. |
Problemas de conexión comunes al conectar mediante Coexistencia de WhatsApp
Problemas |
Descripción |
Posible causa y solución sugerida |
|---|---|---|
Error de límite de frecuencia o error de conexión genérico |
Ocurre un error durante el proceso de conexión, como un límite de frecuencia o una falla de conexión genérica. |
Esto puede deberse a inestabilidad temporal de la plataforma, limitaciones de proveedores externos o restricciones de conexión durante la configuración. |
Los chats existentes no se sincronizan por completo |
No todas las conversaciones anteriores de WhatsApp aparecen en SleekFlow después de conectar la Coexistencia de WhatsApp. |
La Coexistencia tiene limitaciones de sincronización, por lo que solo se pueden importar ciertas conversaciones. |
La conexión se desconecta por inactividad |
La conexión entre SleekFlow y la aplicación WhatsApp Business queda inactiva. |
Meta exige que la aplicación WhatsApp Business permanezca activa cuando se usa la Coexistencia. Para mantener la conexión, abre la aplicación WhatsApp Business en el teléfono vinculado al menos una vez cada 13 días. |
El flujo estándar de Coexistencia es demasiado limitado para tu volumen |
Algunas empresas pueden experimentar limitaciones operativas al usar una configuración conectada a la aplicación. |
La Coexistencia está diseñada para integraciones ligeras y podría no admitir grandes volúmenes de mensajería ni necesidades de automatización avanzadas. |
El número de teléfono no es elegible |
El número de teléfono no se puede usar para la configuración de Coexistencia. |
Meta exige que el número esté activo en la aplicación WhatsApp Business durante al menos 7 días antes de ser elegible. Es posible que los números recién registrados o con poca actividad no califiquen de inmediato. |
Tipo de mensaje no compatible o mensaje no disponible |
Algunos mensajes aparecen como “mensaje no disponible” en la plataforma. |
Esto puede ocurrir cuando los mensajes se envían desde dispositivos o entornos no compatibles que no activan eventos de webhook. Es posible que estos mensajes no estén disponibles en SleekFlow. En ese caso, consulta el mensaje directamente en la aplicación WhatsApp Business. |
Preguntas frecuentes
P: Quiero usar un número de teléfono que ya está registrado
Para usar un número de teléfono que ya está registrado en WhatsApp:
- Si está registrado con WhatsApp o la aplicación WhatsApp Business
Elimina la cuenta de WhatsApp para que el número de teléfono quede disponible para la plataforma WhatsApp Business con SleekFlow. - Si está registrado con otra plataforma WhatsApp Business
En el Administrador de WhatsApp, desactiva la autenticación de dos factores (2FA) para el número en la plataforma WhatsApp Business. Luego, registra el número de teléfono en SleekFlow. Comunícate con tu Socio de soluciones si no puedes desactivar la 2FA por tu cuenta.
Obtén más información sobre cómo migrar una cuenta existente de la API de WhatsApp Business a SleekFlow.
P: ¿Por qué falló la conexión incluso después de completar los pasos en Meta?
La conexión puede seguir fallando si la configuración no se completó totalmente en Meta. Esto puede ocurrir si el número de teléfono no se registró por completo o si la cuenta de WhatsApp Business todavía está pendiente de revisión o verificación. Verifica que hayas completado todos los pasos en Meta y, luego, vuelve a intentar la conexión.
P: ¿Por qué no puedo completar el registro del número de teléfono?
El registro del número de teléfono puede fallar si:
- El número ya está vinculado a otra configuración de WhatsApp
- La cuenta de WhatsApp Business seleccionada no está disponible
- Meta restringió el número de teléfono o la WABA
El número no puede recibir SMS ni llamadas de voz para la verificación
Confirma que el número no se use en otro lugar y revisa la Calidad de la cuenta de Meta para detectar restricciones antes de volver a intentarlo.
P: ¿Por qué no recibí el código de verificación?
Los códigos de verificación se envían por SMS o llamada de voz durante el registro del número de teléfono.
Si no recibiste el código:
- Confirma que el número de teléfono pueda recibir SMS o llamadas de voz internacionales. Verifica que el formato del número esté ingresado correctamente
- Evita solicitar varios códigos en un período corto, ya que Meta podría bloquear temporalmente las solicitudes adicionales
- Si la verificación por SMS falla, intenta solicitar el código por llamada telefónica
Si ya lo intentaste varias veces, espera de 24 a 48 horas antes de volver a intentarlo
P: ¿Puedo verificar un número de teléfono fijo?
Sí. Los números de teléfono fijo pueden recibir el código de verificación mediante una llamada de voz.
Sin embargo, la verificación puede fallar si el número usa un sistema IVR o de respuesta automática. Si es posible, desactiva temporalmente el IVR para que la llamada de verificación llegue directamente a una persona o al correo de voz.
P: ¿Puedo conectar un número de teléfono que todavía está activo en la aplicación WhatsApp Business?
No. Un número de teléfono no se puede usar en la aplicación WhatsApp Business y en la API de WhatsApp Business al mismo tiempo.
Para migrar el número a la API:
- Abre la aplicación WhatsApp Business
- Ve a Configuración → Cuenta
- Selecciona Eliminar mi cuenta
Después de eliminar la cuenta, reinicia el proceso de conexión a la API.
P: ¿Por qué no encuentro mi portafolio comercial después de iniciar sesión?
Si no encuentras tu portafolio comercial durante la configuración, es posible que hayas iniciado sesión con la cuenta de Meta incorrecta, que no tengas el acceso necesario a ese portafolio o que el portafolio todavía esté en proceso de configuración o verificación. Si tienes varios portafolios, asegúrate de haber seleccionado el correcto en Meta Business Suite. Luego, confirma que tu cuenta tenga los permisos necesarios y vuelve a intentar la conexión.
P: ¿Por qué el nombre legal y la dirección de mi empresa deben coincidir con mis documentos oficiales?
Meta verifica tu empresa mediante los datos de la sección Información de la empresa en tu Portafolio comercial de Meta.
Incluso pequeñas diferencias de ortografía, puntuación o formato de dirección pueden retrasar o impedir la verificación. Asegúrate de que el nombre y la dirección de la empresa coincidan exactamente con tus documentos oficiales de registro.
P: ¿Por qué debo usar una cuenta de Facebook establecida al crear un Portafolio comercial de Meta?
Las cuentas de Facebook creadas recientemente tienen más probabilidades de activar las verificaciones de confianza y seguridad de Meta.
Usar una cuenta que haya estado activa durante algún tiempo reduce la probabilidad de restricciones al crear un portafolio comercial o conectar WhatsApp.
P: ¿Qué pasa si mi Portafolio comercial de Meta no está verificado?
Es posible que igual puedas iniciar el proceso de configuración, pero:
- Tus límites de números de teléfono y niveles de mensajería podrían seguir restringidos
- La cuenta podría tener un mayor riesgo de ser restringida o inhabilitada
Completar la verificación empresarial en el Administrador comercial de Meta desbloquea límites de mensajería más altos y mejora la estabilidad de la cuenta.
P: ¿Por qué no funciona el código QR?
El paso del código QR puede fallar si el teléfono no tiene la última versión de la aplicación WhatsApp Business, o si la sesión del código QR expiró y debe reiniciarse.
P: ¿Por qué veo un error de límite de frecuencia o un error de conexión genérico?
Si ves un error de límite de frecuencia o una falla de conexión genérica durante la configuración, el problema podría ser temporal o estar causado por limitaciones en el flujo de conexión actual. Toma una captura de pantalla del mensaje de error completo o del código de error y compártela con nuestro equipo de soporte para que podamos investigar más rápido.
P: ¿Qué debo hacer si el flujo de configuración actual me parece demasiado limitado o inestable?
Si el flujo de configuración estándar te parece demasiado restrictivo o no admite tu volumen de mensajería de manera confiable, es posible que quieras considerar cambiar a una integración directa con la API en la nube de WhatsApp. Esto puede ayudar a reducir la dependencia de las limitaciones de la configuración intermediaria y ofrecer una opción más estable para casos de uso de mayor volumen. Comunícate con nuestro equipo de soporte si deseas ayuda para evaluar esta opción.
Recursos relevantes
- Crear un portafolio comercial en Meta Business Suite
- Verificar tu empresa en Meta Business Suite
- Panel de Calidad de la cuenta de Meta
- Migrar un número de WhatsApp existente a una cuenta comercial
- Solicitar un código de verificación para un número de teléfono de WhatsApp Business
- Centro de ayuda de Meta Business