¿Qué significa el triángulo rojo en las conversaciones?

Código de error

Causa (Descripción)

Posible solución

0

No fue posible autenticar al usuario

Verifica que tu token de acceso sea válido y no haya caducado.

1

API desconocida.

Revisa la URL y el endpoint al que se está haciendo la petición.

2

Servicio temporalmente no disponible

Problema en los servidores de Meta. Espera unos minutos y vuelve a intentarlo.

3

El app no tiene los permisos suficientes

Ingresa a Meta for Developers y asegúrate de otorgar los permisos necesarios a tu token/app.

4

Demasiadas solicitudes

Has alcanzado el límite de peticiones de la API. Reduce la velocidad de envío.

10

Permisos insuficientes para acceder al recurso

Valida que tu usuario o token tenga los roles administrativos adecuados.

33

El número de teléfono de la empresa ha sido eliminado.

Deberás registrar un nuevo número o apelar la eliminación en tu Administrador de WhatsApp.

100

La petición contiene parámetros inválidos

Revisa la estructura de los datos que estás enviando (faltan datos o el formato es incorrecto).

190

El token de acceso ha expirado

Genera un nuevo token de acceso permanente o renueva el temporal en Meta.

368

La cuenta comercial ha sido inhabilitada por violar las políticas de WhatsApp

Ingresa a la sección "Calidad de la cuenta" en tu Meta Business Suite para ver los detalles y apelar la decisión.

400

No se pudo descargar el contenido multimedia enviado por el remitente

Pídele al usuario que te vuelva a enviar el archivo o verifica que el formato esté soportado.

401

Clave API inválida.

Verifica que la clave de API configurada en tu conexión sea la correcta.

402

No se envió el mensaje porque hubo uno o más errores relacionados con el método de pago

Ingresa al Business Manager y actualiza o agrega una tarjeta de crédito válida.

403

El endpoint está bloqueado.

Contacta a nuestro equipo de Soporte Técnico para revisar la conexión de tu canal.

404

Contacto no existe

Verifica que el número de teléfono del cliente sea correcto y tenga WhatsApp instalado.

408

No se pudo enviar el mensaje porque estuvo pendiente durante demasiado tiempo

Error de latencia. Vuelve a intentar enviar el mensaje.

410

No se pudo enviar el mensaje durante su tiempo de vida

El sistema no pudo entregar el mensaje a tiempo. Reintenta el envío.

429

Limite de frecuencia alcanzado

Estás enviando mensajes demasiado rápido. Espera un momento y ralentiza el envío.

430

Se produjo un error relacionado con tu certificado

Revisa la configuración de tus webhooks y certificados de seguridad.

432

Se produjo un error relacionado con la firma de tu certificado

Valida la firma del certificado de seguridad en la configuración técnica.

433

Se produjo un error relacionado con la firma de tu certificado

Valida la firma del certificado de seguridad en la configuración técnica.

470

Han pasado mas de 24 horas desde el ultimo mensaje de cliente. Por favor utiliza una plantilla de mensaje

La ventana de atención se cerró. Usa una Plantilla de WhatsApp (HSM) para retomar el contacto.

471

Mensaje falló debido a restricciones de cantidad de mensajes para este número de teléfono

Alcanzaste el límite de envíos diarios (Tier). Revisa tu nivel de mensajería en WhatsApp Manager.

472

El mensaje no se pudo enviar porque el número de teléfono del usuario es parte de un experimento

Restricción temporal interna de Meta. No requiere acción por tu parte.

480

No se envió el mensaje porque es posible que el usuario al que pertenece este número de teléfono haya cambiado.

Revalida el contacto; es posible que la línea haya cambiado de dueño.

500

Error al enviar mensaje

Error interno y temporal. Inténtalo nuevamente más tarde.

1000

Formato no soportado o excede el tamaño máximo permitido

Comprime tu archivo (PDF, video o imagen) o envíalo en un formato aceptado.

1001

La longitud del mensaje supera los 4.096 caracteres

Acorta tu texto antes de enviarlo (WhatsApp no soporta mensajes tan largos).

1002

Tipo de destinatario no válido

Asegúrate de estar enviando el mensaje a un número de teléfono válido.

1004

Conflicto con la creación de archivo

Hubo un error al intentar subir o procesar tu multimedia. Reinténtalo.

1005

Acceso denegado

Verifica los permisos de acceso de tu integración técnica.

1006

No se encontró el archivo o el recurso

El archivo multimedia caducó o el ID proporcionado es incorrecto. Súbelo de nuevo.

1007

El destinatario no figura en la lista de autorizados

Si tu app está en modo de desarrollo, debes agregar este número a tu lista de prueba en Meta.

1008

Un parámetro necesario no se encuentra

Completa todos los campos obligatorios en el mensaje o plantilla que estás enviando.

1009

Valor de parámetro no válido

El tipo de dato que estás enviando no es el correcto (ej. enviaste texto en lugar de un número).

1010

El mensaje contiene un parámetro no requerido

Estás enviando información de más que la plantilla o API no ha solicitado.

1011

El servicio no está listo

El sistema se está inicializando. Espera unos segundos y reintenta.

1013

El número no posee una cuenta de WhatsApp válida

Pide a tu cliente que confirme si su número tiene la app de WhatsApp activa.

1014

Protocolo en URL desconocido

Asegúrate de usar http:// o https:// en tus enlaces.

1015

Se alcanzó el límite de frecuencia del cliente

Debes pausar los envíos temporalmente porque superaste el límite permitido por segundo.

1016

Sistema sobrecargado

Los servidores de Meta están saturados. Reintenta más tarde.

1021

No es posible enviar mensajes a ti mismo

Intenta enviar el mensaje a un número de cliente, no a tu propio número de empresa.

1022

URL de webhooks no configurada

Configura la URL de respuesta en tu panel de Meta for Developers.

1023

Error en la base de datos

Error temporal en Meta. Reintenta el envío más tarde.

1024

Debes cambiar la contraseña

Por razones de seguridad, debes actualizar las credenciales de tu cuenta de Meta.

1025

La solicitud no es válida.

Revisa que el código o estructura que estás enviando no tenga errores de sintaxis.

1026

Mensaje ha fallado ya que la version de Whatsapp del cliente no soporta este mensaje

El cliente utiliza una versión muy antigua de WhatsApp. Sugiérele actualizar la app.

1028

Enviaste un mensaje a un usuario de WhatsApp que posiblemente haya cambiado

Pide confirmación de identidad al usuario actual de esa línea.

2000

El número de parámetros proporcionados no coincide con el número de parámetros previsto

Revisa tu plantilla: si tiene 3 variables {{1}}, {{2}}, {{3}}, debes enviar exactamente 3 valores.

2001

No existe la plantilla para un idioma o región específico

Verifica que la plantilla esté aprobada en el idioma que estás intentando enviar.

2002

El receptor no pudo descargar la plantilla

Problema temporal de conectividad en el teléfono del cliente.

2003

No existen plantillas para un idioma o una región específicos

Debes ir a tu Administrador de WhatsApp y crear la traducción correspondiente.

2004

El parámetro es demasiado largo

El texto que introdujiste en una de las variables de tu plantilla excede el límite de caracteres.

2005

El texto traducido es demasiado largo

Simplifica y acorta el texto de tu plantilla en ese idioma específico.

2006

Se infringió la política de espacios en blanco de plantilla

Elimina los dobles espacios o saltos de línea innecesarios en tu plantilla.

2007

Se incumplió la política de caracteres de formato

Revisa que no haya caracteres prohibidos o símbolos extraños en tu mensaje.

2008

El formato de archivo multimedia no es compatible

Asegúrate de enviar imágenes/documentos en los formatos estándar aprobados por WhatsApp.

2009

Falta un componente obligatorio de la plantilla

Olvidaste agregar información en el encabezado, cuerpo o botones de la plantilla.

2010

La URL del componente del botón no es válida

Verifica que el enlace web colocado en tu botón funcione correctamente.

2011

El número de teléfono del componente del botón no es válido

Verifica el código de país y el formato del número configurado en el botón de llamada.

2012

El formato de parámetro no coincide con el formato de la plantilla creada

Asegúrate de no estar enviando texto donde la plantilla espera recibir una imagen, o viceversa.

2013

El receptor no admite estos botones

El cliente utiliza una versión desactualizada de WhatsApp o un dispositivo no compatible.

2014

Espacio de nombres previsto vacío

Revisa que el "Namespace" (espacio de nombres de la plantilla) esté configurado correctamente.

2015

La solicitud de mensaje contiene un número de secciones menor al mínimo o superior al máximo

Ajusta las opciones de tu menú interactivo o lista dinámica (el máximo permitido son 10 opciones).

2016

El número de filas no es válido

Verifica la estructura de las filas enviadas en tu mensaje de lista interactiva.

2017

Se incumplió con la política de caracteres de formato

Elimina caracteres de formato prohibidos en la plataforma.

2023

No hay productos para el objeto de sección o el recuento total de productos excedió el número máximo permitido

Agrega productos a tu catálogo o reduce la cantidad que intentas mostrar de una sola vez.

2024

El identificador de catálogo que proporcionaste no existe o no pertenece a tu cuenta de WhatsApp Business (WABA)

Verifica el ID del catálogo en tu Business Manager y asegúrate de tener acceso.

2025

El identificador de catálogo que proporcionaste no está conectado al número de teléfono que estás usando para enviar un mensaje

Entra al Administrador de WhatsApp y vincula correctamente el catálogo al número de teléfono.

2026

Algunos productos proporcionados en tu solicitud no se encontraron en el catálogo

Revisa que los ID de los artículos (SKUs) coincidan exactamente con los de tu inventario en Meta.

2027

No se encontraron productos en el catálogo que proporcionaste

El catálogo seleccionado está vacío. Sube tu inventario primero.

2028

Lista de productos individuales con información omitida o incompleta relativa a los requisitos para comercio electrónico

Revisa que tus productos tengan precio, imagen, nombre y descripción aprobados.

2029

Lista de productos multiples contienen información omitida o incompleta relativa a los requisitos para comercio electrónico

Completa la información obligatoria de comercio para todos los productos de la lista.

2030

Algunos productos multiples contienen información omitida o incompleta relativa a los requisitos para comercio electrónico

Completa la información faltante en tu catálogo para esos productos específicos.

2036

Estructura del encabezado no válida

Revisa si tu plantilla espera un encabezado de tipo TEXTO o IMAGEN y asegúrate de enviar el correcto.

2050

Ausencia de información sobre el cumplimiento de los requisitos

Verifica las políticas comerciales y requerimientos de e-commerce en tu cuenta de Meta.

2061

La plantilla esta pausada

Tu plantilla fue reportada por clientes y pausada por Meta. Mejora la calidad o espera a que se reactive.

2062

La plantilla se encuentra deshabilitada

WhatsApp bloqueó permanentemente esta plantilla. Deberás crear una nueva que respete sus políticas.

80007

La cuenta comercial de WhatsApp ha alcanzado su tasa limite de envío de mensajes.

Has superado tu límite de envíos diarios. Debes esperar a que pasen 24 horas para que el límite se reinicie.

130429

Se alcanzó el rendimiento de mensajes de Cloud API.

Estás enviando demasiados mensajes en un mismo segundo. Regula la velocidad (throttling).

130497

La cuenta de empresa no puede enviar mensajes a los usuarios de este país.

Existen bloqueos regionales, embargos o restricciones de Meta para enviar mensajes a ese país en específico.

2388019

Se ha superado el límite de plantillas para esta WABA

Has creado demasiadas plantillas. Elimina las antiguas o las que ya no uses.

131000

Algo salió mal. Por favor, contactate con Soporte Técnico.

Error no documentado por Meta. Escala un ticket a nuestro equipo técnico de Atom.

131005

La aplicación no tiene los permisos suficientes o ha sido eliminada

Revisa el estado de la conexión de tu App en Meta o renueva tu token de sistema.

131008

La petición no contiene parámetros que son requeridos

Faltan campos obligatorios en el envío de tu mensaje.

131009

Uno o más parámetros son inválidos

Valida los tipos de datos que estás enviando (ej. texto donde debería ir un enlace).

131031

La cuenta comercial ha sido inhabilitada por violar las políticas de WhatsApp

La cuenta está suspendida. Debes ir a la sección "Calidad de la cuenta" en Meta para resolverlo.

131016

Servicio temporalmente no disponible

Fallo en la nube de Meta. Vuelve a intentarlo en unos minutos.

131021

El número de teléfono del remitente y del destinatario es el mismo.

Para hacer pruebas, utiliza un número personal, no te envíes mensajes a ti mismo.

131026

El receptor no puede recibir este mensaje. Verifique si el número de WhatsApp es válido o si ha aceptado los nuevos Términos de Servicio de WhatsApp.

El cliente debe actualizar su aplicación y aceptar los términos de uso, o el número es incorrecto.

131037

El número necesita aprobación de nombre para mostrar.

El "Display Name" de tu empresa aún no es aprobado. Ingresa al Administrador de WhatsApp para revisar el estado.

134100

Sólo mensajes de Marketing son soportados por MMLite

Edita tu plantilla y asegúrate de que su categoría esté clasificada como "Marketing".

134101

Tu plantilla aún se está sincronizando con MM Lite. Por favor, inténtalo de nuevo en unos minutos.

Proceso interno de sincronización en Meta. Espera entre 5 y 15 minutos.

134102

Revisa el estado del onboarding de MM Lite y contacta a Soporte Técnico

Hubo un problema en el registro del canal. Contacta a Soporte para revisar la conexión.

131042

El mensaje no se pudo enviar debido a un error relacionado al método de pago.

Ingresa a tu panel de Meta y verifica que la tarjeta de crédito registrada no haya sido rechazada.

131045

El mensaje no se pudo enviar debido a un error en el registro de su número de teléfono.

El número quedó atrapado en el proceso de registro. Revisa el estado de la línea en Meta.

131047

Han transcurrido más de 24 horas desde que el destinatario respondió por última vez al número del remitente.

La conversación ha expirado. Obligatoriamente debes usar una Plantilla aprobada (HSM) para volver a escribirle.

131049

Meta decidió no entregar este mensaje para mantener una interacción adecuada en WhatsApp. Te recomendamos esperar 24 horas antes de volver a enviarlo.

Meta ha bloqueado temporalmente los envíos a este usuario por considerarlo spam. Espera un día entero.

131050

El usuario ha detenido la recepción de mensajes de marketing.

El cliente seleccionó la opción de "Dejar de recibir mensajes". Respeta su decisión y detén las campañas hacia esa línea.

131048

El mensaje no se pudo enviar porque hay restricciones en la cantidad de mensajes que se pueden enviar desde este número de teléfono.

Tu cuenta tiene restricciones activas por límite de calidad o límite diario de mensajes.

131051

Tipo de mensaje no soportado

Intenta enviar el contenido en un formato estándar (texto, imagen, video corto).

131052

No se puede descargar el archivo enviados por el usuario.

Dile al cliente que hubo un fallo de conexión y pídele que vuelva a enviar el archivo.

131053

El archivo no se pudo enviar porque el tamaño es demasiado grande o está dañado.

Comprime el archivo y asegúrate de no superar el peso máximo permitido (generalmente 16MB para WhatsApp).

131056

Demasiados mensajes han sido enviados a este número en un corto período de tiempo.

Frena la cantidad de notificaciones que le mandas a este usuario específico; el sistema lo ha pausado por prevención.

132000

El numero de parámetros proporcionados no coincide con el numero de parámetros previsto

Estás dejando campos de plantilla (como {{1}}) sin rellenar, o estás enviando de más.

132001

La plantilla no existe

Asegúrate de haber escrito el nombre de la plantilla de forma idéntica a como fue aprobada.

132005

La plantilla excede el tamaño permitido

El contenido es muy largo, ajusta el diseño desde tu Administrador de Plantillas.

132012

Los parámetros de la plantilla no coinciden con el formato de la plantilla

Verifica que las variables coincidan exactamente con lo que el mensaje espera (texto en texto, imagen en imagen).

132015

La plantilla esta pausada debido a la baja calidad.

La plantilla ha sido pausada temporalmente por recibir reportes de clientes o bloqueos.

132016

La plantilla ha sido inhabilitada por WhatsApp

La plantilla fue dada de baja definitivamente por violar políticas comerciales. Deberás crear otra.

133000

El intento de deregistro ha fallado

Contacta al área de soporte técnico para verificar por qué el número no se puede dar de baja.

133004

El servidor de Whatsapp no está disponible temporalmente

Falla general de Meta. Solo queda esperar a que restablezcan el servicio.

133005

La verificación de dos pasos del número de teléfono ha fallado debido a que el PIN es incorrecto

Ingresa el PIN correcto de 6 dígitos que configuraste en tu panel de seguridad.

133006

Se necesita volver a verificar el número de teléfono

Solicita un nuevo código de registro por SMS o llamada e ingrésalo en el portal de WhatsApp.

133008

Demasiadas peticiones fallidas de verificacion de dos pasos

Estás intentando registrar el PIN con demasiados errores. Espera el tiempo de sanción indicado por la plataforma.

133009

Demasiadas peticiones de verificacion de dos pasos

Superaste el límite de intentos. Detente y vuelve a intentarlo más tarde o mañana.

133010

El numero no esta registrado en Whatsapp Business Platform

Completa el proceso de alta y registro de la línea en Meta Business Suite.

133015

El numero de teléfono que desea registrar fue recientemente eliminado y aun no se completa el proceso

Debes esperar hasta que la base de datos de Meta termine de purgar la eliminación (puede tardar horas) antes de registrarlo.

135000

El mensaje no se pudo enviar debido a un error desconocido con los parámetros del mensaje.

Revisa a fondo cómo armaste la estructura del mensaje o acércate a Soporte para validarlo.

130472

El mensaje no se pudo enviar porque el número de teléfono del usuario es parte de un experimento

Situación técnica y temporal del lado de Meta. No puedes hacer nada de tu lado, solo esperar.

2388269

El tipo de categoría en la plantilla no es soportada

Asigna una categoría oficial permitida a tu plantilla (MARKETING, UTILIDAD o AUTENTICACIÓN).

138000

Calling no habilitado

Verifica que la funcionalidad de llamadas esté encendida para tu número de WhatsApp.

138001

Receptor no puede recibir llamadas

El cliente tiene una versión muy antigua o ha deshabilitado recibir llamadas.

138002

Límite de llamadas concurrentes alcanzado

Tu línea ya está gestionando el número máximo de llamadas simultáneas permitidas.

138003

Llamada duplicada

El sistema intentó iniciar la misma llamada dos veces.

138004

Error de conexión

Fallo en la red al intentar enlazar la llamada.

138005

Límite de llamadas excedido

Alcanzaste el tope de minutos o llamadas de tu cuenta comercial.

138006

Sin permiso de llamada aprobado

Debes solicitar previamente el permiso de llamada y esperar a que el usuario lo acepte.

138007

Error de timeout de conexión

La llamada expiró o no se pudo establecer comunicación antes de que se acabara el tiempo límite.

138009

Límite de solicitudes de permiso de llamada alcanzado

Has enviado la solicitud de permiso a este usuario demasiadas veces sin respuesta.

138010

Límite de llamadas por permiso alcanzado

Se ha agotado el número de llamadas que podías hacer bajo el permiso aceptado por el usuario.

138011

No se pudo enviar solicitud de permiso de llamada

Hubo un error de envío. Reintenta enviar el botón de solicitud más tarde.

138012

Límite de llamadas iniciadas por negocio alcanzado

Has superado tu cuota de llamadas salientes como empresa.

131062

Los destinatarios con identificador de usuario de ámbito empresarial (BSUID) no son compatibles con este mensaje.

El usuario protege su privacidad u oculta su número (BSUID). Intenta enviar un formato de mensaje más sencillo o compatible.