Conectar WhatsApp a la API no falla de mil maneras distintas. Falla casi siempre de cinco, y cuatro de ellas se resuelven sin ayuda de nadie si sabes qué estás mirando.
Cada sección de abajo arranca con el síntoma tal como se ve en pantalla, sigue con la causa real —que casi nunca es la que uno supone— y termina con la salida concreta.
Lo que vas a entender
- 1
Por qué tu número aparece en gris y cómo liberarlo
- 2
Qué hacer cuando el código de verificación no llega
- 3
Cómo pasar el paso del QR sin poder escanearlo
- 4
Por qué el historial de chats no apareció y hasta cuándo se puede rescatar
- 5
Qué hacer si cerraste la ventana a mitad del proceso
1. El número sale en gris y no se deja seleccionar
"Este número no se puede compartir con esta aplicación" · "No cumple los requisitos"
Es, de lejos, el error más frecuente. Y el que peor se explica.
La causa es casi siempre la misma: ese número ya pertenece a una cuenta de WhatsApp Business dentro de algún portafolio de Meta. Un número solo puede estar en una, y la coexistencia exige que no esté en ninguna. Como ya está ocupado, Meta ni siquiera te lo ofrece.
Lo desconcertante es que casi nadie recuerda haber creado esa cuenta. No hace falta: Meta la crea sola en varias situaciones.
- 1
Verificaste la empresa para poner anuncios
Al vincular el número del negocio al portafolio para la verificación o para campañas con clic a WhatsApp, Meta crea la cuenta por su cuenta.
- 2
Activaste Meta Verified
El mismo efecto: el número queda enganchado a una cuenta dentro del portafolio.
- 3
Una conexión anterior quedó a medias
Probaste otro proveedor, cerraste la ventana antes de terminar y tu plataforma nunca recibió nada. Pero la cuenta ya había nacido en Meta y el número quedó dentro.
- 4
Una agencia lo conectó y ya no trabajas con ella
El número sigue en el portafolio de ellos o en una cuenta que ellos crearon.
Desconectar desde tu plataforma no lo arregla
El botón de desconectar de un proveedor quita el número de su lado. No borra ni libera nada en Meta. Por eso reintentar diez veces da el mismo resultado: el problema está del lado de Meta y hay que resolverlo ahí.
La salida es quitar el número de esa cuenta en Meta:
Si el portafolio no es tuyo
Cuando la cuenta está en el portafolio de una agencia, tú no puedes tocarla: tienen que hacerlo ellos. Pedirles acceso de socio a esa cuenta te da permisos para mandar mensajes, pero no rearma la coexistencia: el historial y la sincronización con la app no vuelven. Si quieres coexistencia, el número tiene que quedar libre de verdad.
Hay dos causas menos comunes del mismo badge que conviene descartar: que el número lleve muy poco tiempo de uso real en la app de WhatsApp Business, y que acabes de liberarlo de otra cuenta y todavía esté en periodo de espera. En los dos casos la solución es la misma: esperar.
2. No llega el código de verificación
Antes de pedir un reenvío por cuarta vez, revisa estas tres cosas en orden.
- 1
Si el número está en WhatsApp Business, el código llega dentro de la app
No como SMS del operador. Mucha gente lo busca en la bandeja de mensajes de texto y está en el chat de WhatsApp.
- 2
Cambia a llamada telefónica
Con líneas corporativas, planes empresariales y números virtuales el SMS a veces no llega nunca. La llamada sí entra, y dicta el código.
- 3
Deja de reintentar
Meta limita cuántos códigos manda seguidos. Pasado cierto número de intentos bloquea el envío por un rato, y seguir pidiendo solo alarga la espera.
Caso aparte: si el número es de otro país del que elegiste en el desplegable, el código nunca va a llegar porque se está mandando a un número que no existe. Revisa el indicativo antes que nada.
3. El código QR no avanza
El paso del QR es el único del proceso que pasa por el celular, y por eso concentra sus propios problemas.
4. Los chats y los contactos nunca llegaron
El error con fecha de vencimiento.
Revisa en este orden, porque las dos primeras causas no tienen arreglo posterior y la tercera solo es cuestión de esperar.
- 1
En el celular se eligió "No compartir chats"
Es una pantalla fácil de pasar de largo. Si se marcó eso, no hay nada en camino y nunca lo habrá para esta conexión.
- 2
Pasaron más de 24 horas desde que terminó el proceso
La importación del historial se pide dentro de las 24 horas siguientes al onboarding. Vencido ese plazo, Meta ya no la entrega.
- 3
Todavía está llegando
El historial no entra de golpe: llega en bloques y puede tardar minutos, a veces más si son muchos contactos. Si acabas de conectar, espera antes de concluir nada.
Si venció el plazo, la única salida es repetir
Desconectar el número de la plataforma, volver a conectarlo con el proceso completo, y esta vez marcar Compartir chats en el celular. No hay forma de pedirle a Meta el historial de una conexión que ya pasó su ventana.
Y una vez lleguen, no te asustes con lo que vas a ver: solo viajan las conversaciones individuales de hasta seis meses. Los grupos, los estados y los archivos de los chats no se importan.
5. Cerré la ventana a mitad del proceso
Por sí solo no es grave: se vuelve a abrir la conexión desde la plataforma y se empieza otra vez. El problema es lo que pudo quedar a medio hacer del lado de Meta.
Si cerraste antes del portafolio
3 pasos- No alcanzó a crearse nada
- Reintenta sin más
- El número sigue disponible
Y todo eso lo hiciste tú.
Si cerraste después del portafolio
3 pasos- La cuenta de WhatsApp ya pudo nacer
- Tu plataforma no recibió nada
- Al reintentar, el número sale en gris
Listo. El resto lo hizo él.
Si caíste en el segundo caso, no es un error nuevo: es el primero de esta guía. Vuelve a esa sección y libera el número.
6. El nombre quedó rechazado o pendiente
El nombre que escribiste en la penúltima pantalla no se aprueba automáticamente: Meta lo revisa. Mientras tanto el número envía y recibe con normalidad, pero tus clientes ven el número en vez del nombre del negocio.
- Nada de WA, FB, IG, Messenger ni variantes: es la causa de rechazo más común y está escrita en la propia pantalla.
- Nada de mayúsculas sostenidas ni emojis.
- Nada de meter el número de teléfono dentro del nombre.
- Que se parezca al negocio real: un nombre genérico como "Ventas" o "Asesor" se rechaza.
- No uses marcas que no sean tuyas.
Se corrige desde el Administrador de WhatsApp de tu portafolio, editando el nombre para mostrar y enviándolo de nuevo a revisión. No hay que repetir la conexión.
Dos cosas que no son errores pero lo parecen
La IA empezó a contestar sola
No es un fallo de la conexión: es lo esperable. Un agente activo responde en cuanto tiene por dónde hacerlo, y conectar la línea es exactamente eso. Por eso el agente se deja en modo piloto —contestando solo a tu número y al de tu equipo— hasta que hayas revisado cómo responde, y se abre al público después.
Le escribió a cientos de contactos viejos
Tampoco es un fallo. Los contactos importados llegan con la fecha real de su último mensaje, que puede ser de hace semanas, así que cualquier seguimiento por inactividad los ve a todos vencidos a la vez. Se evita apagando esos seguimientos antes de conectar y reactivándolos cuando los contactos ya estén clasificados.
Preguntas frecuentes
¿Por qué mi número de WhatsApp aparece en gris al conectarlo a la API?
Porque ese número ya pertenece a una cuenta de WhatsApp Business dentro de un portafolio de Meta, y la conexión exige que no pertenezca a ninguna. Suele venir de una verificación de empresa, de Meta Verified, de una conexión anterior que quedó a medias o de una agencia que lo conectó antes. Se resuelve quitando el número de esa cuenta en Configuración del negocio, y no reintentando la conexión.
¿Desconectar WhatsApp desde mi plataforma libera el número en Meta?
No. El botón de desconectar de un proveedor solo corta la conexión de su lado: la cuenta de WhatsApp Business y el número siguen igual dentro del portafolio de Meta. Para liberar el número de verdad hay que entrar a Configuración del negocio en business.facebook.com y quitarlo de esa cuenta, o eliminar la cuenta si no tiene nada más.
¿Qué hago si no me llega el código de verificación de WhatsApp Business?
Si el número está en la app de WhatsApp Business, revisa dentro de la app: el código llega ahí y no como SMS del operador. Si no, cambia la opción a llamada telefónica, que funciona con líneas corporativas y números virtuales donde el SMS no entra. Y deja de pedir reenvíos: Meta limita los intentos seguidos y seguir insistiendo alarga la espera.
¿Cómo conecto WhatsApp Business si no puedo escanear el código QR?
Usa el enlace "Usar código de acceso" que aparece bajo las instrucciones del QR en el computador. Te da un código escrito. En la app de WhatsApp Business, en la pantalla de la cámara, toca "Ingresa el código de acceso" y escríbelo. Es el mismo paso y sirve igual, que es la salida cuando haces todo desde un solo celular.
¿Por qué no me llegó el historial de chats al conectar la coexistencia?
Por una de tres razones. Que en el celular se eligiera "No compartir chats", en cuyo caso no hay nada en camino. Que hayan pasado más de 24 horas desde que terminó el proceso, porque la importación se pide dentro de ese plazo y después Meta ya no la entrega. O que todavía esté llegando, porque entra en bloques y puede tardar minutos. Si venció el plazo, la única salida es desconectar y repetir la conexión.
¿Por qué Meta rechazó el nombre de mi cuenta de WhatsApp Business?
Las causas más comunes son usar acrónimos de Meta como WA, FB, IG o Messenger, escribir en mayúsculas sostenidas, incluir emojis o el número de teléfono, usar un nombre genérico que no identifica al negocio, o usar una marca que no es tuya. Se corrige editando el nombre para mostrar en el Administrador de WhatsApp y enviándolo de nuevo a revisión, sin repetir la conexión.
Para recordar
- El número en gris casi siempre significa que ya pertenece a una cuenta de WhatsApp Business en Meta. Hay que liberarlo ahí, no reintentar.
- Desconectar desde tu plataforma no libera nada del lado de Meta.
- Si el número está en la app de WhatsApp Business, el código de verificación llega dentro de la app.
- El paso del QR siempre se puede hacer con el código de acceso escrito.
- El historial se pide dentro de las 24 horas siguientes al proceso. Vencido el plazo, toca repetir todo.
- El nombre rechazado se corrige en el Administrador de WhatsApp, sin repetir la conexión.