Códigos de error de WhatsApp - EngageLab | WhatsApp API REST Español

En esta página se recogen los códigos de error que pueden producirse durante el envío y la entrega de un mensaje de WhatsApp, junto con el significado de cada código y la forma de resolverlo.

Los códigos de error proceden de dos orígenes. Identifica primero cuál corresponde y consulta después la sección correspondiente:

Origen	Numeración
Códigos de error oficiales de Meta	Idénticos a los códigos oficiales de Meta
Códigos de error de la plataforma EngageLab	Definidos por EngageLab

Alcance: Esta página cubre únicamente el envío y la entrega de mensajes. Para los códigos de error a nivel de llamada a la API, consulta la sección «Códigos de error» de la documentación de la API de envío de mensajes y de la API de gestión de plantillas.

Códigos de error oficiales de Meta

Los siguientes códigos de error están definidos por Meta y su numeración es idéntica a la oficial de Meta. Para más información, consulta la documentación oficial de Meta.

Límites de frecuencia y rendimiento

Estos errores indican que se ha alcanzado un límite de velocidad o de volumen de envío. El mensaje en sí no tiene ningún problema: el envío se reanuda si esperas y vuelves a intentarlo.

Código	Error	Descripción	Acción recomendada
4	Límite de llamadas a la API alcanzado	La aplicación ha alcanzado su límite de frecuencia de llamadas a la API.	Reduce la frecuencia de las llamadas o inténtalo de nuevo más tarde.
80007	Límite de frecuencia de la cuenta alcanzado	La cuenta de WhatsApp Business (WABA) ha alcanzado su límite de frecuencia de envío.	Reduce el ritmo de envío y vuelve a intentarlo más tarde. En campañas masivas, envía por lotes a un ritmo uniforme.
130429	Límite de rendimiento de mensajes alcanzado	Se ha alcanzado el número máximo de mensajes que pueden enviarse por unidad de tiempo.	Reduce el número de envíos simultáneos y vuelve a intentarlo. Si tu negocio necesita un rendimiento mayor, ponte en contacto con el soporte técnico de EngageLab para evaluar una ampliación.
131048	Límite por tasa de spam alcanzado	Muchos de los mensajes recientes de este número emisor han sido bloqueados o denunciados como spam, lo que ha activado una restricción de envío.	Consulta la calificación de calidad del número en WhatsApp Manager y mejora el contenido y la precisión de la segmentación antes de volver a enviar.
131056	Demasiados mensajes al mismo destinatario	Se han enviado demasiados mensajes al mismo destinatario en poco tiempo.	Amplía el intervalo entre mensajes al mismo usuario. El envío a otros destinatarios no se ve afectado.
131064	Límite de mensajes alcanzado (clasificación de plantilla)	La cuenta ha alcanzado su límite de mensajes porque las categorías de plantilla (marketing / utilidad / autenticación) se han utilizado de forma incorrecta. Se ven afectados tanto los mensajes de plantilla como los mensajes normales.	Comprueba que las categorías de plantilla se corresponden con su uso real. La restricción se levanta automáticamente al finalizar el periodo de sanción.

Cuenta y permisos

Estos errores están relacionados con el estado de la cuenta, la configuración de la integración o sanciones por incumplimiento. Reintentar no los resuelve.

Código	Error	Descripción	Acción recomendada
0	Error de autenticación	El token de acceso utilizado para conectar con Meta ha dejado de ser válido.	Es un problema del lado de la integración de la plataforma. Ponte en contacto con el soporte técnico de EngageLab.
3	Función o permiso insuficiente	Falta la función o el permiso que requiere este endpoint.	Ponte en contacto con el soporte técnico de EngageLab para que active el permiso necesario.
10	Permiso denegado	El permiso no se ha concedido o se ha retirado.	Ponte en contacto con el soporte técnico de EngageLab para que revise los permisos.
190	Token de acceso caducado	El token de acceso utilizado para conectar con Meta ha caducado.	Es un problema del lado de la integración de la plataforma. Ponte en contacto con el soporte técnico de EngageLab para renovarlo.
200	No se ha proporcionado un token de acceso	La solicitud no incluía un token de acceso válido.	Es un problema de configuración de la integración. Ponte en contacto con el soporte técnico de EngageLab.
368	Bloqueado temporalmente por incumplimiento de políticas	La cuenta de WhatsApp Business ha sido restringida o desactivada por incumplir una política de la plataforma.	Revisa si el contenido y las plantillas enviadas recientemente cumplen las políticas. Puedes consultar los detalles de la sanción y presentar una apelación en Meta Business Manager. La restricción se levanta automáticamente al finalizar el periodo de sanción.
130497	Restringido para enviar mensajes a usuarios de determinados países	La cuenta de WhatsApp Business tiene restringido el envío de mensajes a usuarios de determinados países o regiones.	Comprueba si el país o la región del destinatario está permitido. Consulta los detalles en la Política de mensajería de WhatsApp Business.
131005	Acceso denegado	El permiso que requiere este endpoint no se ha concedido o se ha retirado.	Ponte en contacto con el soporte técnico de EngageLab para que revise los permisos.
131031	Cuenta bloqueada	La cuenta de WhatsApp Business ha sido restringida o desactivada por incumplir una política de la plataforma.	Ponte en contacto con el soporte técnico de EngageLab para que revise el estado de la cuenta. También puedes consultar el estado de salud de la cuenta en Meta Business Manager.
131042	Problema de pago	Hay un problema con el método de pago o la línea de crédito: por ejemplo, no hay una cuenta de pago asociada, la línea de crédito ha superado su límite o no está activa, o no se ha configurado la zona horaria y la moneda.	Comprueba en Meta Business Manager que la cuenta de pago, la línea de crédito, la zona horaria y la moneda estén configuradas correctamente.
131057	Cuenta de empresa en modo de mantenimiento	La cuenta de WhatsApp Business está en mantenimiento o actualizándose.	Inténtalo de nuevo más tarde.
131063	Plantillas de marketing desactivadas en la Cloud API	La plantilla está clasificada como de marketing, pero las plantillas de marketing están desactivadas en la configuración de la Cloud API de la cuenta.	Vuelve a activar los mensajes de marketing de la cuenta o utiliza una plantilla de utilidad o de autenticación.
134011	Condiciones de WhatsApp Payments no aceptadas	La cuenta de WhatsApp Business aún no ha aceptado las condiciones del servicio de WhatsApp Payments.	Acepta las condiciones mediante el enlace incluido en el mensaje de error y vuelve a intentarlo.

Envío y destinatarios

Estos errores están relacionados con el contenido de la solicitud, el estado del destinatario o la ventana de conversación.

Código	Error	Descripción	Acción recomendada
1	Solicitud no válida o error del servidor	La solicitud tiene un formato incorrecto o se ha producido un error en el servidor de Meta.	Comprueba el formato de la solicitud con la documentación de la API. Si el formato es correcto, inténtalo de nuevo más tarde.
2	Interrupción temporal o sobrecarga	El servicio de Meta no está disponible temporalmente por una caída o sobrecarga.	Inténtalo de nuevo más tarde.
100	Parámetro no válido o mal escrito	La solicitud incluía uno o varios parámetros no admitidos, mal escritos o que superan el límite de longitud.	Comprueba los nombres, los valores y los límites de longitud de los parámetros con la documentación de la API.
130403	La empresa ha bloqueado al usuario en WhatsApp	Tu número de empresa ha bloqueado a este destinatario en WhatsApp.	No lo reintentes. Desbloquea primero al usuario en WhatsApp Manager y vuelve a enviar el mensaje.
130472	Mensaje no enviado por formar parte de un experimento	El destinatario se ha incluido en un experimento de mensajes de marketing de Meta (grupo de control), por lo que el mensaje no se ha enviado según las reglas del experimento.	No requiere ninguna acción. No indica un problema con tu mensaje ni con tu cuenta.
131000	Error desconocido	El mensaje no se ha podido enviar por un error desconocido.	Inténtalo de nuevo más tarde. Si sigue fallando, ponte en contacto con el soporte técnico de EngageLab.
131008	Falta un parámetro obligatorio	Falta un parámetro obligatorio en la solicitud.	Añade los parámetros obligatorios indicados en la documentación de la API y vuelve a enviar.
131009	Valor de parámetro no válido	Uno o varios valores de parámetros no son válidos.	Consulta en la documentación de la API los valores y formatos admitidos para cada parámetro.
131016	Servicio temporalmente no disponible	Un servicio del lado de Meta no está disponible temporalmente.	Inténtalo de nuevo más tarde.
131021	El remitente y el destinatario son el mismo	El número del destinatario es el mismo que el del remitente.	Envía el mensaje a otro número de destinatario.
131026	No se puede entregar al destinatario	El destinatario no es usuario de WhatsApp, no ha aceptado las últimas Condiciones del servicio o utiliza una versión obsoleta del cliente.	Comprueba que el número esté registrado en WhatsApp. A través de otro canal, pide al destinatario que acepte las últimas condiciones y actualice WhatsApp.
131037	Sin nombre visible aprobado	El número emisor no tiene un nombre visible aprobado.	Consigue primero la aprobación del nombre visible y envía después.
131045	Error de registro del número de teléfono	El mensaje ha fallado por un problema de registro del número emisor.	Comprueba que el número emisor esté completamente registrado. Si hay algún problema, vuelve a registrar el número.
131047	Fuera de la ventana de mensajería de 24 horas	Han pasado más de 24 horas desde la última respuesta del destinatario, por lo que ya no pueden enviarse mensajes de formato libre.	Utiliza un mensaje de plantilla aprobado. La ventana de 24 horas se reabre cuando el usuario responde.
131049	Mensaje no entregado para mantener una interacción saludable del ecosistema	El destinatario ha alcanzado el límite de mensajes de plantilla de marketing que puede recibir en un periodo determinado.	Espera al menos 24 horas antes de reenviar y controla la frecuencia y la relevancia de tus mensajes de marketing.
131050	El usuario ha cancelado la suscripción al marketing	El destinatario ha decidido dejar de recibir mensajes de marketing de tu empresa.	No lo reintentes. Elimina al usuario de tu lista de marketing y envíale únicamente los mensajes de utilidad imprescindibles.
131051	Tipo de mensaje no admitido	Se ha utilizado un tipo de mensaje no admitido.	Utiliza un tipo de mensaje admitido según la documentación de la API de envío de mensajes.
131052	Error al descargar el contenido multimedia	No se ha podido descargar el contenido multimedia enviado por el usuario.	Pide al usuario que te facilite el archivo por otro canal.
131053	Error al subir el contenido multimedia	No se ha podido subir el archivo multimedia incluido en el mensaje.	Comprueba que el formato y el tamaño del archivo cumplan los requisitos y vuelve a intentarlo.

Plantillas y Flows

Estos errores están relacionados con el estado, el contenido o los parámetros de la plantilla.

Código	Error	Descripción	Acción recomendada
132000	El número de parámetros de la plantilla no coincide	El número de variables enviadas no coincide con el definido en la plantilla.	Añade o elimina parámetros hasta que coincidan con el número real de variables de la plantilla y vuelve a enviar.
132001	La plantilla no existe o no está aprobada	La plantilla no existe en el idioma indicado o todavía no ha sido aprobada.	Comprueba que el nombre de la plantilla y el código de idioma coincidan exactamente (incluidas mayúsculas, minúsculas y guiones bajos) y que el estado de la plantilla sea «Aprobada».
132005	Texto traducido demasiado largo	La traducción de la plantilla para ese idioma supera el límite de longitud.	Acorta el texto de la plantilla en el idioma correspondiente.
132007	El contenido de la plantilla incumple las políticas	El contenido de la plantilla incumple una política de WhatsApp.	Modifica el contenido siguiendo las directrices de revisión de plantillas y vuelve a enviarlo a revisión.
132012	Formato de parámetro de plantilla no válido	El formato de los valores de las variables no coincide con el definido en la plantilla.	Introduce las variables con el formato definido en la plantilla.
132015	Plantilla pausada por baja calidad	La plantilla se ha pausado por una calificación de calidad baja y no puede enviarse.	Edita la plantilla para mejorar su calidad y vuelve a usarla cuando se apruebe de nuevo. Mientras tanto, utiliza otra plantilla aprobada.
132016	Plantilla desactivada permanentemente (baja calidad)	La plantilla se ha pausado demasiadas veces por baja calidad y ahora está desactivada de forma permanente.	La plantilla no puede recuperarse. Crea una nueva plantilla con contenido diferente.
132018	Error de validación de los parámetros de la plantilla	Los parámetros de la plantilla no han superado la validación.	Corrige la configuración de los parámetros según el mensaje de error y vuelve a enviar.
132068	Flow bloqueado	El Flow utilizado se encuentra en estado bloqueado.	Revisa y corrige la configuración del Flow, o llega al usuario por otra vía.
132069	Flow limitado	Ya se han enviado 10 mensajes con este Flow en la última hora, lo que ha activado la limitación.	Espera a que finalice la ventana de limitación antes de volver a enviar.

Registro y verificación del número

Código	Error	Descripción	Acción recomendada
133000	Baja no completada	Un intento de baja anterior no se completó, por lo que el número no puede registrarse de nuevo.	Vuelve a dar de baja el número y regístralo después.
133004	Servidor temporalmente no disponible	El servidor de Meta no está disponible temporalmente.	Inténtalo de nuevo más tarde.
133005	PIN de verificación en dos pasos incorrecto	El PIN de verificación en dos pasos de la solicitud no es correcto.	Comprueba el PIN. Si lo has olvidado, desactiva la verificación en dos pasos y establece un PIN nuevo.
133006	Se necesita volver a verificar el número de teléfono	El número debe verificarse antes de poder registrarse.	Verifica primero el número y regístralo después.
133008	Demasiados intentos de PIN	Se ha introducido el PIN incorrectamente demasiadas veces y está bloqueado temporalmente.	Espera a que se levante el bloqueo y vuelve a intentarlo.
133009	PIN introducido demasiado rápido	El PIN se ha enviado con demasiada frecuencia.	Inténtalo de nuevo más tarde.
133010	Número de teléfono no registrado	El número no está registrado en la plataforma de WhatsApp Business.	Registra el número antes de enviar.
135000	Error desconocido en los parámetros de la solicitud	Hay un error desconocido en los parámetros de la solicitud.	Comprueba la sintaxis y los parámetros de la solicitud con la documentación de la API. Si el error persiste, ponte en contacto con el soporte técnico de EngageLab.

Estado del número emisor

Código	Error	Descripción	Acción recomendada
33	El número de teléfono de empresa ha sido eliminado	El número de teléfono de empresa utilizado para el envío ha sido eliminado.	Comprueba el número emisor. Si se ha eliminado, utiliza otro número emisor válido o vuelve a registrarlo.
133015	Número de teléfono eliminado recientemente; la eliminación aún no ha finalizado	El número se eliminó recientemente y el proceso de eliminación aún no ha finalizado.	Espera unos 5 minutos y vuelve a intentarlo.
133016	Demasiados intentos de registro o baja; número bloqueado temporalmente	Ha habido demasiados intentos de registro o baja de este número en poco tiempo y el número está bloqueado temporalmente.	Espera a que se levante el bloqueo antes de volver a intentarlo y evita los intentos repetidos mientras tanto.

Códigos de error de la plataforma EngageLab

Código	Error	Descripción	Acción recomendada
1	Número de destinatario no válido	El formato del número del destinatario no es válido y no ha superado la validación.	Comprueba que el número contenga solo dígitos, incluya el código de país y no tenga `+`, espacios ni guiones, corrígelo y vuelve a enviar.
5000	Tiempo de espera de envío agotado	Se ha agotado el tiempo de espera al enviar el mensaje a Meta y el mensaje no se ha enviado.	Inténtalo de nuevo más tarde.
5001	Saldo insuficiente; mensaje no enviado	El saldo de la cuenta es insuficiente, por lo que el mensaje no se ha enviado.	Recarga tu cuenta en la consola y vuelve a enviar el mensaje. Te recomendamos activar las alertas de saldo.