Solución de problemas de errores de correo electrónico
Esta página enumera los códigos de error que Pushwoosh puede devolver al enviar un correo electrónico, agrupados por su causa. Cada entrada explica qué significa el error y cómo resolverlo.
Límites de cuenta y de envío
Anchor link toEstos errores significan que su cuenta o conjunto de configuración alcanzó un límite de envío, pausa o suspensión; no hay nada malo con el mensaje en sí.
| Error | Descripción | Qué hacer |
|---|---|---|
| AccountDailyQuotaExceeded | Su cuenta ha alcanzado su cuota diaria de envío de correos electrónicos. | Espere a que la cuota se restablezca o póngase en contacto con el Soporte de Pushwoosh para solicitar una cuota más alta. |
| AccountSendingPaused / AccountSendingPausedException / ConfigurationSetSendingPaused / ConfigurationSetSendingPausedException | El envío de correos electrónicos se ha pausado para su cuenta o conjunto de configuración, generalmente debido a una alta tasa de rebotes o quejas. | Revise sus tasas de rebote y quejas y póngase en contacto con el Soporte de Pushwoosh para reanudar el envío. |
| AccountSuspended | La capacidad de su cuenta para enviar correos electrónicos ha sido suspendida. | Póngase en contacto con el Soporte de Pushwoosh para averiguar por qué y cómo restaurar el envío. |
| AccountThrottled | Se enviaron demasiados correos electrónicos en un corto período de tiempo y se excedió el límite de la tasa de envío. | Reduzca su tasa de envío o póngase en contacto con el Soporte de Pushwoosh para solicitar un límite de tasa más alto. |
Configuración del remitente y del dominio
Anchor link toEstos errores apuntan a un problema con la forma en que su dominio de envío o la dirección “De” está configurada y verificada.
| Error | Descripción | Qué hacer |
|---|---|---|
| CannotGetCredentials | Pushwoosh no pudo obtener las credenciales necesarias para enviar el correo electrónico. | Compruebe que su dominio de remitente esté verificado y activo. |
| FromEmailAddressNotVerifiedException | La dirección del remitente no está verificada y no se puede usar para enviar este correo electrónico. | Verifique el dominio y la dirección de correo electrónico del remitente e inténtelo de nuevo. |
| From email domain is not verified (1296) | El dominio “De” no ha completado la verificación de DNS, por lo que el mensaje (incluidos los correos electrónicos de prueba) no se puede crear. | Compruebe el estado del dominio en Sus dominios de remitente y añada cualquier registro que todavía esté marcado como Pendiente. |
| Reply email domain is not verified (1297) | El dominio de respuesta no ha completado la verificación de DNS, por lo que el mensaje (incluidos los correos electrónicos de prueba) no se puede crear. | Compruebe el estado del dominio en Sus dominios de remitente y añada cualquier registro que todavía esté marcado como Pendiente. |
| FromEmailMissing | La dirección de correo electrónico “De” falta o no es válida. | Establezca una dirección de correo electrónico “De” válida y verificada en la configuración de la plataforma de correo electrónico o en la configuración del mensaje. |
| FromNameMissing | El “Nombre del remitente” para el correo electrónico falta o no es válido. | Establezca un “Nombre del remitente” válido en la configuración de la plataforma de correo electrónico o en la configuración del mensaje. |
| MailFromDomainNotVerified / MailFromDomainNotVerifiedException | El mensaje no se pudo enviar porque Pushwoosh no pudo encontrar el registro MX requerido para el dominio de envío. | Compruebe los registros DNS/DKIM de su dominio de envío y asegúrese de que estén publicados correctamente. |
| InvalidTrackingOptionsException | El dominio de seguimiento personalizado configurado para el seguimiento de aperturas/clics no es válido. | Compruebe la configuración de su dominio de seguimiento personalizado. |
Problemas con la dirección del destinatario
Anchor link toEstos errores son causados por la propia dirección de correo electrónico del destinatario (su formato, o su historial de rebotes y quejas), no por su cuenta o plantilla.
| Error | Descripción | Qué hacer |
|---|---|---|
| AddressContainsControlOrWhitespace | La dirección de correo electrónico contiene caracteres de control o espacios en blanco adicionales. | Elimine cualquier carácter oculto o espacio en blanco de la dirección de correo electrónico e inténtelo de nuevo. |
| EmailComplaint | El destinatario marcó previamente un mensaje suyo como spam. | Elimine a este destinatario de futuros envíos para proteger su reputación como remitente. |
| EmailIsBounced | El mensaje no se envió porque esta dirección de correo electrónico ya ha rebotado. | Utilice una dirección de correo electrónico válida y activa, o elimine a este destinatario de su lista de correo. |
| IllegalEmailAddress | La dirección de correo electrónico del destinatario tiene un formato no válido. | Compruebe la dirección de correo electrónico del destinatario y corríjala. |
| UnableToParseEmailBCC | El campo CCO contiene un valor no válido. | Compruebe el formato de las direcciones en el campo CCO. |
Errores de entrega SMTP
Anchor link toEstos errores ocurren mientras Pushwoosh entrega el mensaje a través de SMTP, desde una configuración faltante hasta una conexión fallida.
| Error | Descripción | Qué hacer |
|---|---|---|
| SMTPCannotProcessData | Pushwoosh no pudo construir el correo electrónico para la entrega SMTP. | Compruebe la configuración de la plantilla de correo electrónico. |
| SMTPCannotProcessFrom | El campo SMTP “FROM” está vacío. | Establezca una dirección de correo electrónico “De” válida para el mensaje. |
| SMTPCannotProcessRcpt | El campo SMTP “RCPT” (destinatario) está vacío. | Compruebe que la dirección de correo electrónico del destinatario esté configurada correctamente. |
| SMTPCannotProcessSending | Se produjo un error interno al enviar el mensaje a través de SMTP. | Intente enviar el mensaje de nuevo más tarde. Si el error persiste, póngase en contacto con el Soporte de Pushwoosh. |
| SMTPIsNotConfigured | SMTP no ha sido configurado para esta cuenta. | Póngase en contacto con el Soporte de Pushwoosh para configurar el envío SMTP. |
| SMTPUnableToCreateConnection | Pushwoosh no pudo establecer una conexión SMTP. | Compruebe la configuración y las credenciales de su servidor SMTP y vuelva a intentarlo. |
| SMTPUnableToSignDKIM | Pushwoosh no pudo firmar el mensaje con DKIM. | Compruebe la configuración de DKIM para su dominio de envío. |
| SMTPUnknownError | Se produjo un error SMTP no especificado. | Intente enviar el mensaje de nuevo. Si el error persiste, póngase en contacto con el Soporte de Pushwoosh. |
Errores de plantilla y contenido
Anchor link toEstos errores ocurren mientras Pushwoosh construye o renderiza el correo electrónico: una plantilla faltante, datos de marcador de posición no válidos o HTML mal formado.
| Error | Descripción | Qué hacer |
|---|---|---|
| CannotGetEmailPlaceholders | Pushwoosh no pudo obtener los marcadores de posición utilizados en la plantilla de correo electrónico. | Compruebe los marcadores de posición de Contenido Dinámico en la plantilla de correo electrónico. |
| CannotGetTemplateBindings | Pushwoosh no pudo obtener las vinculaciones de datos necesarias para renderizar la plantilla. | Compruebe la configuración de Contenido Dinámico y Plantillas Liquid utilizada en la plantilla. |
| CannotNormalizeHTML | El contenido del correo electrónico no se pudo preparar para el envío. | Compruebe si hay errores en el contenido HTML de la plantilla de correo electrónico. |
| CannotProcessEmailTemplateFromRepo | La plantilla de correo electrónico no se pudo cargar y procesar. | Compruebe la configuración de la plantilla de correo electrónico y vuelva a intentarlo. |
| EmailCannotGetEmailTemplateCode | No se pudo obtener email_template_code o está vacío. | Compruebe que la plataforma esté configurada correctamente y vuelva a intentarlo. |
| EmailCannotGetEmailTemplateFromRepo | No se pudo obtener la plantilla de correo electrónico por email_template_code. | Compruebe que la plataforma esté configurada correctamente y vuelva a intentarlo. |
| InvalidRenderingParameterException | Uno de los valores utilizados para rellenar la plantilla no es válido, a menudo debido a un JSON mal formado. | Compruebe los datos de Contenido Dinámico pasados a la plantilla. |
| InvalidTemplateException | La plantilla de correo electrónico especificada no se pudo renderizar. | Compruebe si hay errores en la plantilla de correo electrónico y vuelva a intentarlo. |
| MissingRenderingAttributeException | No se proporcionó un valor al que hace referencia un marcador de posición en la plantilla. | Asegúrese de que todos los marcadores de posición utilizados en la plantilla tengan valores coincidentes. |
| TemplateDoesNotExistException | La plantilla de correo electrónico especificada no existe. | Compruebe que la plantilla de correo electrónico esté configurada correctamente y no haya sido eliminada. |
| TooDeepTemplateInsertion | Las plantillas están anidadas demasiado profundamente unas dentro de otras. | Reduzca el número de inserciones de plantillas anidadas en el contenido del correo electrónico. |
| UnableToBuildEmailAttachments | No se pudieron construir uno o más archivos adjuntos. | Compruebe los archivos adjuntos añadidos al correo electrónico y vuelva a intentarlo. |
| UnableToBuildHTML | No se pudo compilar la plantilla de correo electrónico. Lo más probable es que la plantilla contenga un error relacionado con los marcadores de posición de Contenido Dinámico o las Plantillas Liquid. | Compruebe la configuración de la plantilla de correo electrónico. |
| UnableToCreateHTML | Pushwoosh no pudo generar el HTML final para el correo electrónico. | Compruebe la configuración de la plantilla de correo electrónico. |
| UnableToInsertTemplate | Pushwoosh no pudo insertar una plantilla referenciada en el correo electrónico. | Compruebe la referencia de la plantilla insertada/anidada en el contenido del correo electrónico. |
| UnableToMinifyHTML | Pushwoosh no pudo minificar el contenido HTML del correo electrónico. | Compruebe el HTML de la plantilla de correo electrónico en busca de marcado mal formado. |
Plantillas Liquid y Contenido Conectado
Anchor link toEstos errores son específicos de la sintaxis de Liquid y de las solicitudes de Contenido Conectado (Connected Content) utilizadas para obtener datos personalizados.
| Error | Descripción | Qué hacer |
|---|---|---|
| ConnectedContentInvalidJSON | El punto final de Contenido Conectado devolvió un JSON no válido. | Compruebe que su backend devuelva un JSON válido para la solicitud de Contenido Conectado. |
| ConnectedContentInvalidParameters | El número de parámetros pasados a Contenido Conectado no coincide con la plantilla. | Compruebe los parámetros pasados en la etiqueta de Contenido Conectado con su plantilla. |
| ConnectedContentInvalidTemplate | La etiqueta de Contenido Conectado contiene una plantilla Liquid no válida. | Compruebe la sintaxis de Liquid utilizada dentro de la etiqueta de Contenido Conectado. |
| ConnectedContentInvalidURL | Pushwoosh no pudo obtener la URL especificada en Contenido Conectado. | Compruebe que la URL del Contenido Conectado sea correcta y accesible. |
| ConnectedContentInvalidVarExpression | La expresión ${} utilizada en Contenido Conectado no es válida. | Compruebe la sintaxis ${} utilizada en la etiqueta de Contenido Conectado. |
| InvalidLiquidTemplate | El correo electrónico contiene una plantilla Liquid no válida. | Compruebe la sintaxis de las Plantillas Liquid utilizada en el correo electrónico. |
| LiquidTemplateInvalidParsing | La plantilla Liquid no se pudo analizar debido a un error de sintaxis. | Compruebe la sintaxis de las Plantillas Liquid utilizada en el correo electrónico. |
| LiquidTemplateInvalidRendering | La plantilla Liquid no se pudo renderizar con los datos disponibles. | Compruebe que las variables utilizadas en las Plantillas Liquid coincidan con los datos disponibles para el destinatario. |
| LiquidTemplateInvalidTimezone | Se utilizó una zona horaria no válida con un filtro de fecha en la plantilla Liquid. | Compruebe el valor de la zona horaria utilizado con el filtro de fecha en sus Plantillas Liquid. |
Errores de entrega e infraestructura
Anchor link toEstos errores provienen de la propia infraestructura de envío de correo electrónico. La mayoría son transitorios o internos, y varios requieren que el Soporte de Pushwoosh los investigue.
| Error | Descripción | Qué hacer |
|---|---|---|
| CannotConnect | Pushwoosh no pudo conectarse a la pasarela de envío de correo electrónico. | Intente enviar el mensaje de nuevo más tarde. Si el error persiste, póngase en contacto con el Soporte de Pushwoosh. |
| CannotGetDeviceAPIURL | Pushwoosh no pudo determinar la URL de la API necesaria para enviar el correo electrónico. | Póngase en contacto con el Soporte de Pushwoosh. |
| CannotSend | El correo electrónico no se pudo enviar. | Intente enviar el mensaje de nuevo más tarde. Si el error persiste, póngase en contacto con el Soporte de Pushwoosh. |
| EmailSESInvalidParameterValue | Uno de los parámetros pasados a Amazon es incorrecto. | Compruebe los parámetros pasados y vuelva a intentarlo. |
| Failed | El mensaje no se pudo enviar por una razón interna. | Intente enviar el mensaje de nuevo. Si el error persiste, póngase en contacto con el Soporte de Pushwoosh. |
| MessageRejected | Amazon rechazó el mensaje y no se envió. | Compruebe el contenido del mensaje y la dirección del destinatario, y vuelva a intentarlo. |
| RequestTimeout | La solicitud al servicio de envío de correo electrónico expiró. | Intente enviar el mensaje de nuevo más tarde. |
| SpamDetected | El mensaje fue marcado como spam y no se envió. | Revise su contenido en busca de características similares al spam y póngase en contacto con el Soporte de Pushwoosh si cree que se trata de un error. |
| TransientFailure | Se produjo un fallo temporal por parte de Amazon al enviar el mensaje. | Intente enviar el mensaje de nuevo más tarde. |
| UnableToUnmarshalMetaData | Pushwoosh no pudo procesar los metadatos adjuntos al correo electrónico. | Póngase en contacto con el Soporte de Pushwoosh con el ID del mensaje. |
| UnknownError | Se produjo un error de envío no especificado. | Póngase en contacto con el Soporte de Pushwoosh con el ID del mensaje para su investigación. |
Errores de configuración de Amazon SES
Anchor link toEstos errores provienen de la infraestructura de envío interna de Amazon SES de Pushwoosh, no del contenido de su mensaje ni de la configuración de su cuenta.
| Error | Descripción | Qué hacer |
|---|---|---|
Errores de configuración de Amazon SES
| Un error interno en la infraestructura de envío de Amazon SES de Pushwoosh. Esto no es causado por el contenido de su mensaje ni por la configuración de su cuenta. | Póngase en contacto con el Soporte de Pushwoosh con el nombre exacto del error y la hora en que se envió el mensaje. |