Correo (SES): buzones, recepción y envío

Códigos de error · 39 códigos · catálogo del 2026-10-21

Buzones de correo por entidad sobre SES: alta de dominio y buzón, recepción (SNS → S3), rebotes y quejas, y envío desde el chat.

Para toda la familia

Lo que un código no dice lo hereda de aquí.

Cómo se detecta: Respuesta (code). Rebotes y quejas quedan en las supresiones del buzón y en el mensaje. Render: mailbox_onboarding_failed, líneas de ses-ingress.
Qué hacer: Dominio sin verificar o buzón dado de baja: revisar el alta en Configuración → Canales. Destinatario suprimido: quitar la supresión solo si el cliente lo pide. Límite diario: esperar al día siguiente.

39 códigos

Códigos

`bad_signature`

detalle

Un aviso de SES/SNS llegó con una firma que no cuadra: se descarta.

`cert_unavailable`

detalle

No se pudo bajar el certificado de SNS para verificar un aviso de SES: se descarta y SNS reintenta.

`EMAIL_ADDRESS_OUTSIDE_DOMAIN`

HTTPHTTP 400

La dirección del buzón no es del dominio de la entidad.

`EMAIL_ATTACHMENT_EMPTY`

HTTPHTTP 400

El adjunto que se intentó subir al correo vino vacío (0 bytes); no se guarda nada.

`EMAIL_ATTACHMENT_FILE_TOO_LARGE`

detalleHTTPHTTP 413

Un adjunto de correo pesa más de 10 MB (tope por archivo; el total por correo es 20 MB). Se niega al subirlo, antes de guardar nada.

Qué hacer: Comprimir el archivo o mandarlo en varios correos.

`EMAIL_ATTACHMENT_TYPE_NOT_ALLOWED`

detalleHTTPHTTP 400

Ese tipo de archivo no se adjunta a un correo. Se aceptan imágenes, PDF, Word, Excel, CSV, PowerPoint, texto y zip (lista blanca por extensión y tipo); un programa o script (.exe, .js, .sh, .apk…) se niega aunque cambie de nombre.

Causa típica: Al subir el adjunto (POST interactions/messages/email/attachments) o al enviar un correo que lo declara (attachments[].filename).
Qué hacer: Mandar el archivo en uno de los formatos aceptados (por ejemplo, exportarlo a PDF o comprimirlo en zip).

`EMAIL_BODY_REQUIRED`

HTTPHTTP 400

El correo necesita un mensaje.

`EMAIL_BOUNCE`

detalle

Rebote permanente de un correo enviado: la dirección no existe o no acepta correo. Se suprime para no volver a escribirle.

`EMAIL_CHANNEL_TYPE_MISSING`

HTTPHTTP 503

No existe el tipo de canal email.

`EMAIL_COMPLAINT`

detalle

El destinatario marcó el correo como spam. Se suprime para no volver a escribirle.

`EMAIL_COPY_ADDRESS_INVALID`

detalleHTTPHTTP 400

Una dirección escrita en CC o CCO no es un correo válido (o está vacía). Se niega el correo entero: nunca se descarta una copia en silencio.

`EMAIL_COPY_LIMIT_EXCEEDED`

detalleHTTPHTTP 400

Pasó el tope de copias: hasta 10 direcciones en CC y 10 en CCO por correo (contadas sin repetidas ni el destinatario).

`EMAIL_DAILY_LIMIT`

internodetalle

El buzón llegó a su tope diario de envíos.

`EMAIL_DOMAIN_NOT_FOUND`

HTTPHTTP 404

Dominio no encontrado.

`EMAIL_DOMAIN_NOT_VERIFIED`

internodetalle

El dominio del buzón no está verificado (DKIM).

`EMAIL_DOMAIN_TAKEN`

HTTPHTTP 409

El dominio ya lo usa otra entidad.

`EMAIL_MAILBOX_DISCONNECTED`

internodetalleHTTPHTTP 409

El buzón está dado de baja.

`EMAIL_MAILBOX_EXISTS`

HTTPHTTP 409

Ese buzón ya existe.

`EMAIL_MAILBOX_FORBIDDEN`

HTTPHTTP 403

No tiene asignado el buzón que recibió este correo.

`EMAIL_MAILBOX_NOT_CREATED`

HTTPHTTP 503

No se pudo crear el buzón; no quedó nada a medias.

`EMAIL_MAILBOX_NOT_FOUND`

internodetalleHTTPHTTP 404

Buzón no encontrado.

`EMAIL_MAILBOX_REQUIRED`

HTTPHTTP 400

Elija desde qué buzón escribir.

`EMAIL_NO_MAILBOX`

HTTPHTTP 409

No tiene un buzón de correo para escribir.

`EMAIL_ONBOARDING_AUDIT_UNAVAILABLE`

HTTPHTTP 503

No se pudo registrar la decisión; no se hace nada sin auditoría.

`EMAIL_ONBOARDING_INCOMPLETE`

HTTPHTTP 503

Falta configuración del servidor para el alta de correo; el mensaje y problems dicen qué (solo nombres de variables).

`EMAIL_RECIPIENT_INVALID`

internodetalle

Hay un destinatario inválido.

`EMAIL_RECIPIENT_MISSING`

detalle

El contacto no tiene correo electrónico.

`EMAIL_RECIPIENT_NOT_ALLOWED`

detalle

El destinatario elegido no es uno de los correos del chat.

`EMAIL_RECIPIENT_REQUIRED`

detalle

El contacto tiene varios correos: hay que elegir a cuál escribir.

`EMAIL_REJECT`

detalle

SES rechazó un correo que llegó (virus o spam): no se entrega al chat.

`EMAIL_REPLY_TARGET_NOT_FOUND`

HTTPHTTP 404

Ese correo no es de este chat.

`EMAIL_SEND_FAILED`

HTTPHTTP 409HTTP 429HTTP 502

El correo no salió; si SES dijo por qué, viaja su code concreto en lugar de este.

`EMAIL_SEND_UNAVAILABLE`

HTTPHTTP 409

El envío de correo no está disponible en este proceso.

`EMAIL_SENDING_PAUSED`

internodetalle

SES pausó el envío de la entidad por reputación.

`EMAIL_SUBJECT_REQUIRED`

HTTPHTTP 400

Un correo nuevo necesita asunto.

`EMAIL_SUPPRESSION_AUDIT_UNAVAILABLE`

HTTPHTTP 503

No se pudo registrar la decisión; no se quita sin auditoría.

`invalid_envelope`

detalle

Un aviso de SES/SNS no tiene la forma esperada: se descarta.

`topic_not_allowed`

detalle

Un aviso de SNS viene de un tópico que no es el configurado: se descarta.

`untrusted_cert_url`

detalle

El certificado de un aviso de SNS no viene de un dominio de AWS: se descarta.

Texto generado desde el catálogo de errores de BoostAPI. Para corregirlo, se cambia allá y se sincroniza: verMantener esta documentación. También enMarkdown.