Errores en el envío de mensajes en Zenvia Customer Cloud

Los errores en el envío de mensajes ocurren cuando los mensajes, por alguna razón, no llegan a los destinatarios. Estos casos se indican como Errores en el envpío o No entregados en los informes de envío.

Para entender los motivos de estos errores, accede a un envío específico en Análisis > Envíos y:

Descarga un archivo haciendo clic en Solicitar informe del envío. En este archivo, hay una columna dedicada a los posibles motivos;
Utiliza el filtro Fallos en el envío del mensaje o No entregados, disponibles en la lista Progreso del envío por contacto e identifica el motivo.

⚠️ Atención: Estas funcionalidades están disponibles solo para usuarios con perfiles de Viewer, Operator o Admin.

Información sobre errores en el envío y cargos

Los envíos de mensajes pueden tener dos estados principales cuando ocurre un error: Fallos en el envío y No entregado. La facturación depende del estado del mensaje:

Envíos con estado Fallos en el envío del mensaje: No hay facturación, ya que el envío no llegó a realizarse debido a un problema interno en Zenvia.
Envíos con estado No Entregado: Hay facturación. El mensaje fue enviado a la operadora, pero no llegó al destinatario. Las operadoras son responsables de entregar el mensaje al destinatario final.

Flujo de envío y facturación

Zenvia envía un mensaje a la operadora.
Si el envío es exitoso, el estado cambia a Enviado y se genera una facturación.
La operadora intenta entregar el mensaje al destinatario.
Si ocurre un error durante esta etapa, el estado cambia a No Entregado y los motivos pueden incluir:
- Dispositivo del destinatario no disponible (apagado, sin batería, fuera de cobertura, o con problemas técnicos).
- Buzón de mensajes del destinatario lleno.
- Contenido bloqueado por el proveedor (spam o malicioso).

A continuación, revisa los motivos de los errores por canal y cómo solucionarlos.

Entiende los errores de SMS

Para envíos de SMS, los mensajes de error que pueden mostrarse son:

Error	Solución
140 - Mobile number not covered El número de teléfono está fuera de la cobertura del operador	El número de teléfono está fuera de la cobertura del operador. Verifique si hay señal en el dispositivo o si hay algún problema con el operador. Por favor, intente nuevamente más tarde.
161- Message rejected by operator El mensaje SMS fue rechazado por el operador del destinatario	El mensaje SMS fue rechazado por el operador del destinatario. Esto puede haber ocurrido debido al contenido del mensaje o porque el destinatario bloqueó al remitente. Por favor, revise el contenido de su mensaje y verifique su lista de contactos. Intente nuevamente más tarde.
190 - Unknown error Ocurrió un error desconocido durante el envío	Ocurrió un error desconocido durante el envío. Esto puede deberse a un problema técnico o una situación imprevista. Por favor, intente nuevamente más tarde o contacte al soporte técnico.
999 - Unknown Error Ocurrió un error desconocido durante el envío	Ocurrió un error desconocido durante el envío. Esto puede deberse a un problema técnico o una situación imprevista. Por favor, intente nuevamente más tarde o contacte al soporte técnico.
990 - Has alcanzado el límite de tu cuenta. Ponte en contacto con el Soporte	Has alcanzado el límite de uso de este canal. Para continuar enviando y recibiendo mensajes, por favor, ponte en contacto con nuestro equipo de ventas para actualizar tu plan.
EMPTY - Estado de errores que no tienen código de razón	Ocurrió un error desconocido durante el envío. Esto puede deberse a un problema técnico o una situación imprevista. Por favor, intente nuevamente más tarde o contacte al soporte técnico.
MESSAGE_LIMIT_REACHED - Has alcanzado el límite de tu cuenta. Ponte en contacto con el Soporte.	Has alcanzado el límite de uso de este canal. Para continuar enviando y recibiendo mensajes, por favor, ponte en contacto con nuestro equipo de ventas para actualizar tu plan.
Mensaje bloqueado por infracción de contenido	Revise el contenido del mensaje para asegurarse de que cumpla con las políticas del proveedor de SMS. Evite enviar mensajes con contenido considerado inapropiado o que viole las directrices.
El límite de contenido del mensaje fue superado	El mensaje SMS superó el límite de 160 caracteres. Puede reducir el contenido del mensaje o realizar el envío de SMS concatenados, lo que permite el envío de mensajes más largos divididos automáticamente en varios mensajes SMS de 160 caracteres y se reagrupan en el dispositivo del destinatario.
Número del destinatario incorrecto o incompleto; Contacto inválido	Verifique y corrija el número del destinatario. Asegúrese de incluir los códigos DDI+DDD para enviar el mensaje con éxito.
Valor de campo variable inválido	Las variables deben completarse en el formato: {{nombredelavariable}}. Corrija cualquier valor de campo variable inválido antes de enviar el mensaje.
El servicio aún no está listo. Intente nuevamente más tarde; Servicio temporalmente no disponible	Intente enviar el mensaje nuevamente en un momento posterior, cuando el servicio esté disponible.

Entiende los errores de WhatsApp

Para el canal de WhatsApp, hemos listado los códigos de error específicos más comunes y cómo solucionarlos.

Para verificar todos los errores de mensajes de WhatsApp, consulta la tabla Códigos de error del cliente de la WhatsApp Business API.

Error	Solución
El remitente y el destinatario ya tienen una interacción abierta	Cierra la atención actual para continuar con el nuevo envío.
33 - Unsupported post request	La API de WhatsApp Business no existe o no tiene los permisos necesarios. Consulta la documentación de la API de Graph.
666 - Contact [555555555555] has received too many messages in a short period	El destinatario ha recibido demasiados mensajes en un corto período. Espera antes de enviar más mensajes.
1346003 - No se puede enviar tu mensaje porque contiene contenido que otras personas en Facebook han denunciado como abusivo	Verifica el contenido del mensaje para garantizar el cumplimiento con las políticas de Facebook.
2593006 - The account is not registered	La cuenta no está registrada. Registra la cuenta según la documentación de Meta.
3252001 - Parece que estabas usando esta función de manera indebida avanzando demasiado rápido. Tu capacidad para usar la función ha sido bloqueada temporalmente	La cuenta de WhatsApp Business ha sido bloqueada temporalmente por violación de políticas.
DENY_LISTED - Recipient is in the deny list for this senderId	El destinatario está en la lista de bloqueo para este remitente. Verifica tu lista de contactos y elimina al destinatario de la lista de bloqueo antes de intentar nuevamente.
error - Error handling content [0] from message [7a9cbf06-57a6-41f5-bcbc-db8fedc667f7]: Cannot read properties of undefined (reading 'length')	Error relacionado con el formato inválido de campos en la plantilla. Por ejemplo: URL inválida, o están en blanco.
error - Error handling content [0] from message [7a12c9b4-cadb-4a95-989a-75fdad286109]: Invalid URL	Error relacionado con el formato inválido de campos en la plantilla. Por ejemplo: URL inválida, o están en blanco.
INVALID_CONTACT - Contact 9176800 is not a valid Whatsapp number	El contacto no es un número válido de WhatsApp. Verifica si el número de teléfono es correcto y está registrado en WhatsApp.
130472 - Failed to send message because this user's phone number is part of an experiment	Error al enviar el mensaje debido a un experimento de Meta. Espera a que se complete para reenviar el mensaje.
131000 - Something went wrong	Error desconocido al enviar el mensaje. Intenta nuevamente después de algún tiempo.
131000 - Template is temporarily unavailable to use because it was paused due to low quality	La plantilla del mensaje fue pausada debido a comentarios negativos recurrentes de los clientes o a una baja tasa de lectura. Revisa y edita el contenido del mensaje y solicita nuevamente la aprobación de la plantilla.
131031 - Business account has been locked La cuenta comercial ha sido bloqueada	La cuenta comercial ha sido bloqueada. La cuenta de WhatsApp Business asociada fue restringida o deshabilitada por violación de política; o no fue posible verificar los datos incluidos en la solicitud en relación al conjunto de datos en la cuenta de WhatsApp Business.
131042 - Message failed to send because there were one or more errors related to your payment method El mensaje no se envió porque hubo uno o más errores relacionados con tu método de pago	Fallo al enviar el mensaje debido a uno o más errores relacionados con tu método de pago de WhatsApp. Por favor, contacta al equipo de soporte.
131047 - Message failed to send because more than 24 hours have passed since the customer last replied to this number El mensaje no se envió porque han pasado más de 24 horas desde la última respuesta del cliente a este número	Han pasado más de 24 horas sin respuesta. Inicia una nueva conversación para continuar enviando mensajes.
131048 - Message failed to send because there are restrictions on how many messages can be sent from this phone number.This may be because too many previous messages were blocked or flagged as spam El mensaje no se envió porque hay restricciones sobre cuántos mensajes se pueden enviar desde este número de teléfono. Esto puede deberse a que demasiados mensajes anteriores fueron bloqueados o marcados como spam	Restricciones debido a bloqueos o mensajes marcados como spam por los destinatarios. Mejora la calidad de tus mensajes y solicita nuevamente la verificación de tu número.
131053 Downloading media from weblink failed with http code 404, status message Not Found Downloading media from web link failed as web link server had too many redirects. Downloading media from weblink failed with http code 500, status message Internal Server Error Downloading media from weblink failed with http code 503, status message Service Unavailable Image file has size 5851921 bytes but must be atmost 5242880 bytes and non-empty Image is invalid. Please check the image properties; supported are JPG/JPEG, RGB/RGBA, 8 bit/channels and PNG, RGB/RGBA, up to 8 bit/channel. Video file has size 22083556 bytes but must be atmost 16777216 bytes and non-empty Your server hosting media content did not respond back in time. For better performance with links learn more about Media HTTP Caching under the error code section for Media upload error.

Comprenda los errores de correo electrónico

Al analizar los errores del correo electrónico, encontrarás códigos que indican la decisión del proveedor con respecto a tu mensaje. Cada código se compone de 3 dígitos (XXX), siendo el primer dígito el estado de su mensaje.

4XX – Error temporal (Soft bounce)

Este código indica un error temporal al enviar su mensaje, como que la bandeja de entrada del destinatario está llena o una inestabilidad temporal en el servicio de correo electrónico del destinatario. Puedes intentar enviarlo nuevamente ya que puede ser aceptado en otro momento.

Analice los otros dígitos (4.X.X) para comprender mejor la descripción del error.

Vea algunas posibles soluciones:

Bloqueo antispam: El servicio de correo electrónico del contacto tiene un bloqueo interno que puede incluir el dominio, IP o algún contenido específico del correo electrónico. Mantén tu base de contactos actualizada, evitando contactos inexistentes y contenidos que puedan considerarse spam.
Bandeja de entrada llena: Ignora o elimina el contacto de la base, o envíalo a un correo electrónico alternativo.
Cuenta no disponible, servidor no disponible, entrega fallida: ignorar o eliminar temporalmente el contacto de la lista.
Variables no válidas: Alguna variable en el contenido del correo electrónico no está completada correctamente, por lo tanto, actualice la información de registro del contacto.

5XX – Error permanente (Hard bounce)

Indica que la cuenta no es válida o el dominio no es válido, es decir, la dirección de correo electrónico no existe o la dirección no acepta mensajes del remitente. Analice los otros dígitos (5.X.X) para comprender mejor el tipo de error permanente informado.

Error	Solución
400 Received: (qmail 60130/11702 invoked for bounce)	Se produjo un error al enviar el mensaje. Las posibles causas incluyen detección de SPAM o que el dominio del remitente esté en la lista de bloqueo del destinatario. Por favor, revise el contenido y vuelva a intentarlo.
400 attachments.0.type: The attachment type cannot contain ';', or CRLF characters	El tipo de archivo adjunto contiene caracteres no válidos. Asegúrese de que el tipo MIME del archivo adjunto no contenga estos caracteres.
400 personalizations.0.custom_args: The combined size of both global and personalization custom arguments may not exceed 10000 bytes per personalization	El tamaño combinado de los argumentos personalizados no debe exceder 10,000 bytes. Reduzca el tamaño de los datos personalizados.
400 personalizations.0.to.0.email: Does not contain a valid address	La dirección de correo electrónico del remitente proporcionada no es válida. Verifique y corrija la dirección de correo electrónico.
400 reply_to.email: The reply_to email does not contain a valid address	La dirección de correo electrónico en el campo reply_to no es válida. Verifique y corrija la dirección de correo electrónico.
401 DomainKeys Identified Mail (DKIM)	Se produjo un error al verificar la firma DKIM. Verifique que la clave pública sea correcta en el registro DNS. Por favor, comuníquese con el equipo de soporte.
401 Return-Path	Error de autenticación al establecer el camino de retorno. Verifique las configuraciones de autenticación. Por favor, comuníquese con el equipo de soporte.
401 Authenticated user is not authorized to send mail	El usuario autenticado no tiene permiso para enviar correos electrónicos. Verifique los permisos de la clave API en el panel de SendGrid. Por favor, comuníquese con nuestro equipo de soporte.
502 Bad Gateway	Nuestro servidor de correo recibió una respuesta inválida de otro servidor. Verifique la comunicación entre servidores. Por favor, comuníquese con nuestro equipo de soporte.
503 #5.5.1 RCPT first	Este error ocurre cuando usa el protocolo SMTP directamente, como con TELNET o una herramienta de prueba SMTP, y no con la API de SendGrid. El RCPT TO debe enviarse antes de otros comandos, como DATA.
503 Bad sequence of commands. Could not process RCPT command when in this state.	Este error ocurre cuando usa el protocolo SMTP directamente, como con TELNET o una herramienta de prueba SMTP, y no con la API de SendGrid. El RCPT TO debe enviarse antes de otros comandos, como DATA.
503 NEDD RCPT BEFORE DATA	Este error ocurre cuando usa el protocolo SMTP directamente, como con TELNET o una herramienta de prueba SMTP, y no con la API de SendGrid. El RCPT TO debe enviarse antes de otros comandos, como DATA.
503 This mail server requires authentication	Error de autenticación al intentar enviar a una dirección no local. Verifique las configuraciones de autenticación y los registros DNS. Por favor, comuníquese con nuestro equipo de soporte.
complained - User reported the e-mail	El mensaje no se puede enviar. El destinatario ha marcado el mensaje como SPAM en su bandeja de entrada.
DENY_LISTED - Recipient is in the deny list for this senderId	El destinatario ha solicitado no recibir más correos electrónicos del remitente.
error - Template id not approved yet	El mensaje no se puede enviar. La plantilla de correo electrónico no ha sido aprobada. Por favor, espere la aprobación de la plantilla.
error - Failed to access URL	Error al acceder a la URL especificada. Por favor, verifique la disponibilidad de la URL y vuelva a intentarlo.
EXCEPTION - read ECONNRESET	No se pudo enviar el mensaje, la conexión se cerró inesperadamente. Verifique la conexión de su red de Internet y vuelva a intentarlo.
EXCEPTION - socket hang up	No se pudo enviar el mensaje, la conexión se cerró inesperadamente. Verifique la conexión de su red de Internet y vuelva a intentarlo.
timeout of 30000ms exceeded	La operación de envío de mensajes superó el límite de tiempo establecido. Verifique la conectividad con el servidor.
required - The field to (recipient) must be provided	Mensaje enviado sin destinatario definido. Defina un destinatario para el mensaje.
INVALID_SENDER - Please contact support team	El mensaje no fue enviado. Este error ocurre cuando el "from" del mensaje no coincide con el "credentials.senderId". Por favor, comuníquese con el equipo de soporte.

Entienda los errores de RCS

Para el canal RCS, hemos listado los errores específicos más comunes y cómo solucionarlos.

Si tiene más dudas, consulte los Términos de Servicio de RCS Business Messaging y la Política de Uso Aceptable.

Error	Solución
0 - Unexpected error preparing message Error inesperado al preparar el mensaje	Ocurrió una condición de error no prevista o no especificada durante el procesamiento de una solicitud en el sistema RCS.
11 - Message body invalid Cuerpo del mensaje inválido	El cuerpo del mensaje es inválido.
12 - Message content overflow Desbordamiento del contenido del mensaje	El contenido del mensaje excede el tamaño permitido. Reduzca el tamaño del contenido del mensaje para que esté dentro del límite permitido. Consulte los formatos y tamaños permitidos.
13 - Incorrect or incomplete 'to' mobile number Número de teléfono 'to' incorrecto o incompleto	El número de teléfono del destinatario es incorrecto o incompleto. Verifique y corrija el número de teléfono del destinatario, asegurándose de que esté en el formato correcto (DDI+DDD+9 dígitos).
105 - Message blocked by duplicated external key Mensaje bloqueado por clave externa duplicada	Mensaje bloqueado por clave externa duplicada. Cada mensaje de RCS tiene un ID que Google RCS espera que sea único. Es decir, enviar un mensaje con IDs iguales generará un error en el segundo.
130 - Message blocked Mensaje bloqueado	El mensaje ha sido bloqueado por Google. Puede deberse a varias razones; algunas de ellas: contenido SPAM o malicioso, el destinatario optó por no recibir más mensajes del remitente.
134 - Message blocked by forbidden content Mensaje bloqueado por contenido prohibido	El mensaje ha sido bloqueado por contener contenido prohibido. Puede deberse a varias razones, entre ellas: enlaces maliciosos, archivos con extensiones no permitidas, lenguaje ofensivo o prohibido.
135 - Aggregate is Invalid or Inactive Agregado inválido o inactivo	El agregado es inválido o inactivo. En el contexto de RCS, se refiere a un Agregado (grupo de mensajes) cuyo ID está inactivo o es inválido.
136 - Message expired Mensaje expirado	El mensaje RCS no se entregó dentro de un período específico de tiempo y ha expirado. Verifique la conexión de Google o si el dispositivo del destinatario está apagado.
141 - International sending not allowed Envío internacional no permitido	Mensaje RCS enviado a un número internacional y el envío internacional no está permitido por la configuración o políticas del servicio de mensajes.
190 - Unknown error Error desconocido	Error genérico. Ocurrió un problema, pero no se puede determinar la causa exacta.
400 - com.google.apps.framework.request.CanonicalCodeException: La URL del archivo proporcionada https://negocie.ceapay.com.br/images/logo_mob.png es inválida Código: INVALID_ARGUMENT	La URL proporcionada para el archivo es inválida. Verifique si la URL es correcta y accesible.
400 - com.google.apps.framework.request.CanonicalCodeException: Tipo de contenido no compatible ,image/png. La plataforma RBM determina el tipo MIME del archivo a partir del campo content-type en los encabezados HTTP. El campo content-type de la URL proporcionada no es compatible. Este tipo de contenido debe ser uno de: [image/jpeg, image/jpg, image/gif, image/png, video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm, application/pdf]. Código: INVALID_ARGUMENT	El tipo de contenido (tipo MIME) del archivo proporcionado en la URL no es compatible con la plataforma RBM. Verifique los tipos de archivo compatibles con la plataforma.
400 - Tipo de archivo no compatible: gcs_url: "https://rbm-us.storage.googleapis.com/691582025489/lr8gl6osBmiuVnQUqMsghllc" mime_type: "image/webp" size: 9948 file_name: "b7d3244a7a6ddce9682aea28fd12a05c407 a42e747354a663575257b33c335df.bin" width: 424 height: 186	El tipo de archivo proporcionado no es compatible con la plataforma RBM. Verifique los tipos de archivo compatibles con la plataforma.
400 - User phone number is not of a valid format. Número de teléfono del usuario no es de un formato válido.	El número de teléfono proporcionado no está en un formato válido.
400 - Within contentMessage, text must not be empty Dentro de contentMessage, el texto no debe estar vacío	El texto del mensaje no puede estar vacío. Asegúrese de que el campo de texto del mensaje no esté vacío antes de enviarlo.
Errores con estado 400	La solicitud hecha al servidor es inválida o contiene argumentos incorrectos. Verifique los códigos de la API para identificar y corregir el problema.
403 - There was an error looking up the RBM agent (ID: rbm-agent) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.	El sistema no pudo encontrar el agente RBM correspondiente al proyecto de GCP con el que te estás autenticando.
403 - This operation is blocked because it violates the RBM Terms of Service (Terms of Service for RCS Business Messaging \| RCS Business Messaging Developer Docs \| Google for Developers ) and/or Policies (Acceptable Use Policy \| Business Communications \| Google for Developers ).	Esta operación fue bloqueada debido a violaciones de los Términos de Servicio y/o Políticas de RBM, como el envío de contenido prohibido o el uso indebido de la API.
403 - This operation is blocked because the RBM agent has not launched on the user's carrier nor have they been invited to become a tester (Test devices \| RCS Business Messaging Developer Docs \| Google for Developers ).	Esta operación fue bloqueada porque el agente RBM aún no se ha lanzado en la operadora del usuario o el usuario no ha sido invitado a convertirse en tester.
Errores con estado 403	Falló la autenticación. Verifique las configuraciones y el estado del agente RBM que realizó la solicitud.
404 - Requested entity was not found	El recurso o la entidad solicitada no pudo ser localizada por el servidor. Esto puede incluir URLs incorrectas, que el número del destinatario no sea reconocido por el RCS o el intento de acceder a un recurso que fue eliminado o nunca existió.
429 - You have reached the maximum number of times that this request can be made in a given time period. Some requests are limited according to their parameters: for instance, a request can only be made once every four hours from a given agent for a given user	Has alcanzado el número máximo de veces que esta solicitud puede hacerse en un periodo de tiempo determinado. Algunas solicitudes están limitadas según sus parámetros: por ejemplo, una solicitud solo se puede hacer una vez cada cuatro horas desde un agente determinado para un usuario determinado.
500 - Internal error encountered	El servidor RCS encontró un problema interno que le impide procesar la solicitud.
503 - The service is currently unavailable	El servidor RCS está temporalmente no disponible o sobrecargado y no puede atender la solicitud. Esto puede deberse a un mantenimiento programado, sobrecarga del servidor, fallos temporales en la infraestructura u otros motivos que hagan que el servicio no esté disponible.
990 - Account Limit Reached - Please contact support	Se alcanzó el límite de la cuenta.
999 - Unknown Error	Ocurrió un error desconocido durante el envío. Esto puede deberse a un problema técnico o una situación imprevista. Por favor, inténtalo de nuevo más tarde o contacta con el soporte técnico.
CONTENT_RESTRICTION - Agent has rich content restriction	El agente RCS está configurado con restricciones de contenido Rich Card que prohíben el envío de ciertos tipos de medios o contenido formateado de manera específica.
error - Unexpected Error	Ocurrió un error desconocido durante el envío. Esto puede deberse a un problema técnico o una situación imprevista. Por favor, inténtalo de nuevo más tarde o contacta con el soporte técnico.
INVALID_CONTACT - Contacto inválido	Contacto inválido.
NOT_CAPABLE_RCS - Phone {telefone} is not capable to receive RCS	El teléfono no es capaz de recibir RCS.

Hola, Humans. ﻿¿En qué podemos ayudarte?