API oficial

Errores que parecen baneo pero no son: el diagnóstico de cinco minutos

Por VeyloCRM · · 3 min de lectura

El mensaje no se envía, aparece un error en pantalla y la conclusión es rápida: fuimos baneados. En gran parte de los casos, no fue así — es configuración, ventana cerrada, plantilla pausada o factura vencida. Problemas de minutos que se convierten en crisis por falta de diagnóstico.

No todo envío detenido es baneo

El mensaje no se envía, aparece un error en pantalla y la conclusión es rápida: fuimos baneados. En gran parte de los casos, no fue así. Es configuración, es ventana cerrada, es plantilla no aprobada, es forma de pago vencida — problemas de minutos que se convierten en crisis por falta de diagnóstico.

El costo de confundir ambos es alto en los dos sentidos: quien trata un error de configuración como baneo crea número nuevo sin necesidad, y quien trata un baneo como error técnico pierde días insistiendo.

Lectura liberada

Continúa leyendo gratis

Completa una vez y desbloquea este y todos los demás artículos del blog. No cobramos nada — solo queremos saber para quién estamos escribiendo.

Toma 20 segundos. ¿Prefieres hablar directo por WhatsApp?

Ventana de atención cerrada

El error más común de todos. Pasadas las horas desde el último mensaje del cliente, solo es posible retomar con plantilla aprobada. El mensaje escrito en el momento simplemente no se envía — y esto no tiene nada que ver con la salud del número.

Plantilla no aprobada o pausada

Modelo en análisis, rechazado o pausado no envía. El error suele señalar la plantilla, no el número, pero el equipo lee "fallo en el envío" y presume lo peor.

Cobro pendiente o límite de gasto

Factura pendiente o techo de gasto alcanzado interrumpen el envío incluso con el número perfectamente saludable. Es el caso que más engaña, porque el disparo comienza bien y se traba a mitad.

Webhook mal configurado

Aquí el síntoma es el inverso: el envío funciona y las respuestas no llegan. El equipo concluye que los clientes dejaron de responder, cuando en realidad la plataforma está entregando los eventos a una dirección que ya no existe.

Permiso y token

Token expirado, permiso revocado, número desvinculado de la aplicación. Todos producen fallo de envío con mensaje de no autorizado — que es muy diferente de cuenta restringida.

Y existe lo simple: el número del cliente

Teléfono digitado incorrectamente, sin WhatsApp, o que bloqueó a tu empresa. Fallo individual no es problema de cuenta, y ver diez fallos seguidos en una lista mala no significa ninguna restricción.

Cómo diferenciar en un minuto

Abre el panel y mira el estado del número y de la cuenta. Si todo está normal, el problema es de configuración o de contenido, no de baneo. Luego lee el código del error: separa ventana, plantilla, permiso, pago y restricción — y cada uno tiene tratamiento diferente.

Por dónde empezar

Antes de concluir cualquier cosa, revisa en este orden: estado de la cuenta, estado del número, situación de cobro, estado de la plantilla y el código del error. Cinco revisiones de un minuto que evitan crear número nuevo por un problema que se resolvía en diez.

Preguntas frecuentes

¿Cómo saber si el envío se detuvo por baneo o por error de configuración?

Revisa en este orden: estado de la cuenta, estado del número, situación de cobro, estado de la plantilla y el código del error. Si cuenta y número están normales, no fue baneo. Las cinco causas más comunes son ventana de atención cerrada (solo plantilla retoma), plantilla rechazada o pausada, factura pendiente o techo de gasto alcanzado, webhook apuntando a una dirección que ya no existe (el envío funciona, la respuesta no llega) y token expirado o permiso revocado. Cada uno tiene tratamiento propio, y ninguno se resuelve creando número nuevo.

Error de configuración y restricción de cuenta se parecen en pantalla y no se parecen en nada en la práctica.

VeyloCRM muestra el estado de la cuenta, del número y de la plantilla en la misma pantalla, y traduce el código del error al español — el diagnóstico sale antes del pánico.