troubleshooting-a-connection | Un número dejó de funcionar: cómo averiguar por qué
Cuando un número conectado deja de funcionar, la causa casi nunca es el código. Recórrelo en orden de frecuencia: un token vencido, un override de webhook perdido en una reconexión, una desconexión por catorce días de inactividad, una caída de calidad, y después una restricción de cuenta.
Causas que explican casi toda falla silenciosa.
El error que devuelve un token vencido, que parece un número inexistente.
El evento que reporta una desconexión de forma definitiva.
¿Por qué nada se ve mal en el teléfono?
Porque la app de WhatsApp Business y la API son superficies separadas sobre el mismo número, y casi toda falla afecta solo a una de ellas.
Un token vence y la app queda intacta. Un override de webhook se desinstala y la app queda intacta. La calidad cae y la app queda intacta. En todos los casos el negocio sigue atendiendo a los clientes, ve un comportamiento normal, y no tiene ningún motivo para reportar nada.
Ese es el argumento completo a favor del monitoreo, y no de un panel que alguien revisa. Las fallas son reales, son silenciosas, y las personas más cercanas al número son las menos propensas a notarlas.
¿En qué orden hay que revisar?
Empieza por el token, porque es el más común y el más barato de arreglar. Una credencial vencida o invalidada hace que cada llamada falle igual, lo que se parece exactamente a que el número hubiera sido eliminado. Tener una segunda credencial contra la misma cuenta es lo que distingue una cosa de la otra.
Luego el override de webhook. Si hubo una reconexión, el destino se desinstaló junto con la app, así que el envío y el monitoreo funcionan mientras la entrega a tu servidor, en silencio, no.
Luego una desconexión: un evento account_update con PARTNER_REMOVED y un motivo, donde PRIMARY_INACTIVITY significa que la app quedó sin abrirse durante unos catorce días y reconectar lo arregla.
Luego la calidad, que se consulta por polling en lugar de empujarse, y por último una restricción, que es una sanción a nivel de cuenta que ningún proveedor puede levantar.
¿Qué casi nunca es la causa?
Tu código, si ayer funcionaba y no se desplegó nada.
La Cloud API es estable y sus formas de petición no cambian por debajo de ti. Cuando una integración que corrió durante meses se detiene, la probabilidad abrumadora es una credencial, un cambio de enrutamiento o un evento a nivel de cuenta, y nada de eso depende de que alguien toque un repositorio.
La excepción que vale nombrar es una plantilla que fue editada. Cambiar la cantidad de variables de una plantilla cambia el contrato para cada remitente, en silencio, y eso sí parece una falla de código siendo un cambio de contenido hecho en WhatsApp Manager por otra persona.
Errores comunes
- Reconectar el número primero. Si un token venció, eso le pide al dueño del negocio un trabajo que nunca hizo falta.
- Suponer que el código se rompió. Una API estable sumada a ningún despliegue apunta a otro lado.
- Buscar síntomas en el teléfono. La app sigue funcionando en casi todos estos casos.
EasyCoexistence revisa los cinco de forma continua y registra cada uno en la línea de tiempo de la conexión, así que el diagnóstico arranca desde un evento con fecha y no desde una suposición.
Preguntas frecuentes
El número funciona en el teléfono pero no se envía nada. ¿Por dónde empiezo?
Por el token de acceso. Es la causa más común y la que más se parece a un número eliminado.
Reconecté y los mensajes siguen sin llegar a mi servidor.
El override de webhook se desinstaló junto con la app. Hay que volver a aplicarlo; nosotros lo hacemos de forma automática.
¿Cómo sé si fue la regla de catorce días?
La desconexión llega con el motivo PRIMARY_INACTIVITY en el evento account_update.
¿La edición de una plantilla puede romper mis envíos?
Sí, y es la única causa que se parece a una falla de código. Cambiar la cantidad de variables cambia el contrato para cada remitente.
Sigue leyendo
¿Listo para empezar?
Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.
Empezar prueba gratisVerificado el