Referencia de codigos de error de WhatsApp

Cuando un mensaje de WhatsApp falla, Meta devuelve un codigo de error numerico. Nexor muestra este codigo en la linea de tiempo del lead, los health checks y las respuestas de la API. Usa la tabla a continuacion para identificar la causa y tomar la accion correcta.

Puedes revisar el estado de tu cuenta y tus numeros directamente en Meta: WhatsApp phone numbers y WhatsApp account settings.

Codigo	Que significa	Que hacer
131042	Meta no puede procesar la facturacion del envio. Falta un metodo de pago, fue rechazado o tiene saldo pendiente. El mensaje “Currency is not configured” suele indicar que la linea de credito no esta asociada a la WABA.	Abre Facturacion y pagos en Meta Business Manager y corrige el metodo de pago o el saldo. No necesitas hacer nada mas en Nexor. Nexor revisa el estado de facturacion de Meta aproximadamente cada hora. Cuando Meta muestra el problema resuelto, Nexor prueba la siguiente plantilla de inmediato, y una plantilla entregada reanuda los envios. Un saldo pendiente no aparece en ese estado, asi que durante la pausa se resuelve con la prueba diaria o cuando se entrega una plantilla.
131047	La ventana de atencion de 24 horas esta cerrada. No se permite texto libre fuera de esta ventana.	Envia una plantilla aprobada. La ventana se reabre cuando el destinatario responde.
131049	Meta bloqueo un mensaje de Marketing para proteger el engagement del destinatario. Nexor no puede anular esto.	Nexor deja de reintentar Marketing hacia ese lead durante 14 dias e intenta una plantilla Utility si hay una disponible y es apropiada. Si ninguna funciona, el agente pasa a llamada o email. Revisa la calidad de tu audiencia si esto ocurre frecuentemente.
131026	WhatsApp no pudo entregar el mensaje a este destinatario. Es un fallo de entrega generico y terminal para el canal de WhatsApp de ese lead.	Nexor marca al lead como no contactable por WhatsApp, cancela las tareas de WhatsApp pendientes para ese lead e intenta llamada y luego email. Solo un mensaje entrante real del lead rehabilita WhatsApp. Si ves muchos errores 131026 de una misma importacion, el problema suele estar en los datos de origen (codigos de pais faltantes, formato incorrecto).
131031	La cuenta de WhatsApp Business esta bloqueada por Meta.	Revisa el aviso de politica en Meta Business Manager y completa lo que Meta solicite. No sigas enviando desde una cuenta bloqueada.
131032	La cuenta de WhatsApp Business tiene una restriccion.	Revisa el motivo en Meta, pausa los envios afectados y corrige la causa. Si el motivo no es visible, otorga Control Total del Portafolio de negocios a tu account manager de Nexor para ayudar en la revision.
131033	Meta ha deshabilitado la cuenta de WhatsApp Business.	Confirma el estado en Meta. Prepara una nueva cuenta de WhatsApp Business con el cliente. No sigas enviando desde una cuenta deshabilitada.
130497	La cuenta no tiene permitido enviar mensajes a usuarios de ese pais.	Revisa las restricciones de pais del Portafolio de negocios en Meta y habilita el pais de destino.
132001	El nombre de la plantilla no existe o no esta disponible.	Revisa el nombre, idioma y estado de aprobacion de la plantilla en Meta. Usa una plantilla aprobada que coincida exactamente.
132012	El contenido del mensaje no coincide con el formato aprobado de la plantilla.	Compara texto, orden de campos, botones y adjuntos con la version aprobada. Completa todos los campos requeridos.
131000	Meta reporto un error general temporal.	Espera unos minutos y reintenta una sola vez. Si continua, guarda el codigo de error, la hora y el resultado del health check.
130472	Meta aplico una restriccion experimental de envio.	Pausa el envio afectado. Intenta una alternativa apropiada como un mensaje Utility cuando realmente sea operativo. No reclasifiques promociones como Utility.
Subcode 3835016	La cuenta tiene una restriccion para crear plantillas nuevas.	Revisa la calidad y restricciones en Meta, elimina plantillas sin uso si alcanzaste el limite y solicita revision a Meta desde su area de soporte.

Que hace Nexor automaticamente

Cuando un mensaje falla por error de facturacion (131042), Nexor mantiene la cadencia del lead activa e intenta llamada o email cuando corresponda, sin reintentar ese envio por WhatsApp. La excepcion es un primer contacto que Meta acepto y luego rechazo: se reintenta despues de unos 15 minutos. Si Meta acepto la plantilla y luego la rechazo, un reintento inmediato no se bloquea como duplicado.
- Nexor pausa las plantillas nuevas en la cuenta de WhatsApp Business y envia por email el enlace de facturacion cuando tres leads distintos fallan en 24 horas sin una entrega pagada desde entonces. Tambien lo hace tras un solo fallo si Meta indica que la moneda o el metodo de pago no estan configurados, el estado de Meta confirma el problema de facturacion y la cuenta no entrego ninguna plantilla en los ultimos 7 dias. Las cuentas cuya facturacion administra Nexor no reciben email.
- Durante la pausa, los primeros contactos esperan en WhatsApp. Nexor prueba una plantilla por numero aproximadamente una vez al dia, antes si Meta acaba de reportar la solucion o si la pausa empezo por un solo fallo. Nexor no puede prometer cuanto tarda Meta en aplicar una solucion.
Cuando un mensaje de Marketing es bloqueado (131049), Nexor deja de intentar Marketing hacia ese lead durante 14 dias. Si hay una plantilla Utility disponible y es apropiada para el contexto, la envia.
Cuando la entrega falla de forma terminal (131026), Nexor marca al lead como no contactable por WhatsApp, cancela las tareas solo de WhatsApp e intenta el siguiente canal disponible. Solo un mensaje entrante real del lead rehabilita WhatsApp para esa persona.
Cuando Meta bloquea un mensaje por un experimento (130472), Nexor deja de enviar Marketing a ese numero de destinatario especifico e intenta Utility si es apropiado.

Empieza aquí

Quickstart

Referencia API

Configura y lanza

WhatsApp

Canales

Agentes

Reuniones

Integraciones

Cuenta

Bandeja de entrada

Métricas

Herramientas para desarrolladores

Referencia de soporte

Referencia de codigos de error de WhatsApp

Que hace Nexor automaticamente

Siguientes pasos

Entrega y calidad

Solucion de problemas