Códigos de error whatsapp api: qué significan y qué hacer
Te explicamos los códigos de error whatsapp api que más aparecen al enviar mensajes, qué significa cada uno y qué revisar antes de escribirle a soporte.
Por qué aparecen estos códigos
Cuando un mensaje no sale como debería por WhatsApp Cloud API, la plataforma no tira un error genérico: devuelve un código numérico específico, pensado para que quien programó la integración sepa exactamente qué pasó. El problema es que esos códigos están en inglés técnico y, si no trabajás todos los días con la API, es difícil entender qué significan o si hay que preocuparse.
La mayoría de estos errores no son una falla del sistema: son una regla de WhatsApp que no se cumplió -una plantilla mal armada, un mensaje fuera de horario permitido, una ventana de conversación vencida-. Entender los más comunes ayuda a diferenciar un problema pasajero de algo que hay que corregir de fondo.
Los códigos que más se repiten
| Código | Qué significa en criollo | Qué suele solucionarlo |
|---|---|---|
| 131047 | Se intentó mandar un mensaje libre fuera de la ventana de 24 horas desde el último mensaje del cliente | Enviar una plantilla aprobada en vez de un mensaje de texto libre |
| 131026 | El mensaje no se pudo entregar al destinatario | Verificar que el número esté activo en WhatsApp y bien formateado |
| 132000 / 132001 | Problema con los parámetros o el estado de la plantilla usada | Revisar que la plantilla esté aprobada y que las variables coincidan |
| 190 | El token de acceso venció o es inválido | Renovar la credencial de conexión con la cuenta |
| 368 | La cuenta quedó restringida por una posible violación de políticas | Revisar el uso reciente del número y, si hace falta, apelar ante Meta |
Un código de error no siempre significa que algo esté roto. La mayoría son reglas de WhatsApp que se aplican automáticamente -como la ventana de 24 horas-, y se resuelven ajustando cómo y cuándo se envía el mensaje, no arreglando ningún sistema.
Errores de plantilla: la causa más común
Buena parte de los errores que ve un negocio chico tienen que ver con plantillas: una plantilla que todavía no fue aprobada por Meta, una que se usó con una variable vacía, o una que se mandó con un formato distinto al que fue aprobado originalmente. Meta es estricta con esto porque las plantillas son la única forma permitida de iniciar una conversación fuera de la ventana de 24 horas, así que cualquier discrepancia frena el envío.
Cuando el problema no es un código, es la ventana de 24 horas
El error más común de todos ni siquiera es un código raro: es intentar responderle a un cliente con un mensaje de texto normal después de que pasaron más de 24 horas desde su último mensaje. WhatsApp bloquea eso por diseño, para evitar spam, y ahí es donde entra la plantilla aprobada como único camino para retomar la conversación.
Qué hacer antes de escribirle a soporte
Antes de asumir que hay un problema grave, conviene revisar tres cosas: si el mensaje se mandó dentro de la ventana de 24 horas o con una plantilla aprobada, si el número del cliente está bien escrito y activo en WhatsApp, y si el token de acceso de la cuenta sigue vigente. Estos tres puntos explican la gran mayoría de los errores que aparecen en el día a día.
Cómo lo hace agenteala
agenteala monitorea estos errores por vos: si una plantilla falla, si un token vence o si la cuenta recibe alguna restricción, el equipo lo detecta y lo resuelve sin que tengas que interpretar ningún código ni escribirle a soporte de Meta por tu cuenta.
Preguntas frecuentes
Preguntas frecuentes
¿Qué significa el código de error 131047?
Que se intentó mandar un mensaje libre fuera de la ventana de 24 horas desde el último mensaje del cliente; hay que usar una plantilla aprobada.
¿Un código de error significa que mi WhatsApp se rompió?
En la mayoría de los casos no: son reglas de WhatsApp que se aplican automáticamente, como la ventana de 24 horas o una plantilla mal usada.
¿Qué hago si me aparece el error 190?
Indica que el token de acceso venció o es inválido; hay que renovar la credencial de conexión de la cuenta.
¿Por qué me rechazan un mensaje aunque la plantilla esté aprobada?
Puede ser que alguna variable se haya mandado vacía o con un formato distinto al aprobado originalmente; conviene revisar que coincida exactamente.
¿Tengo que revisar estos códigos yo mismo?
No si trabajás con agenteala: el equipo monitorea estos errores y los resuelve sin que tengas que interpretarlos.
Probá el agente antes de decidir
agenteala arma y mantiene el agente a la medida de tu negocio — no es un bot genérico: atiende, gestiona y vende por tu WhatsApp. Probalo en 2 minutos o hablá con un asesor.
Seguinos en Instagram @agenteala