Capítulo 7 de 8 · 12 min

Emails sin ruta: el Audit Log

Qué pasa con un email que no se pudo procesar, qué significa cada error, cómo reintentarlo, los filtros de la inbox y los rebotes de lo que mandaste.

Cuando un email llega a tu workspace y no se puede convertir en registro, Nxar no lo tira: lo guarda en el Audit Log, con el motivo, para que lo corrijas y lo vuelvas a procesar. Lo mismo para el otro lado: los emails que mandaste y el proveedor no pudo entregar.

ConfiguraciónEmailSetupAudit Log

Arriba a la derecha hay dos pestañas: Inbound (lo que entró) y Outbound (lo que salió y no llegó).

Pantalla Audit Log en la pestaña Inbound, con el selector Inbound y Outbound arriba a la derecha y la casilla Incluir resueltos — Si no hay nada que revisar, la pestaña Inbound lo dice: todo se está procesando bien.

Inbound: lo que no se pudo procesar

Cada fila muestra cuándo llegó (Recibido), el código de Error con el detalle debajo, De, Para y Asunto. En una inbox de reenvío, Para muestra la parsing address, no tu casilla. Los códigos:

Error	Qué pasó	Qué hacer
`INBOX_NOT_FOUND`	La dirección es de tu workspace, pero no de ninguna inbox (alguien escribió a `ventas@…` y esa inbox no existe)	Crear la inbox con ese nombre, o avisarle al remitente
`INBOX_INACTIVE`	La inbox existe pero está desactivada	Activarla, si corresponde
`RECORD_CREATE_FAILED`	El registro no pasó la validación: falta un obligatorio, un valor no es válido. El detalle dice qué campo (`subject: Subject es obligatorio`)	Corregir los Valores default por campo de la inbox
`CONTACT_CREATE_FAILED`	No se pudo buscar o crear el contacto del remitente	Revisar la entidad Contact
`SENDER_BLOCKED`	El remitente está bloqueado, o su dominio no está entre los permitidos	Nada, si fue a propósito
`REPLY_TARGET_NOT_FOUND`	Es la respuesta a un email del CRM que ya no existe (se borró)	Descartar, o reenviarlo como email nuevo
`ENTITY_TYPE_MISSING`	La entidad de emails no está en el workspace	Avisar a soporte
`UNKNOWN`	Un error inesperado al procesarlo	Reintentar más tarde; si se repite, avisar a soporte con el detalle

Cada fila sin resolver tiene dos íconos en Acciones:

Reintentar (la flecha circular): vuelve a procesar el email con la configuración de ahora. Si esta vez sale bien, se crea el registro y la fila pasa a resuelta. Si vuelve a fallar, queda pendiente con el error nuevo.
Descartar (la papelera): la marca como resuelta sin procesarla.

Las resueltas desaparecen de la lista; Incluir resueltos las vuelve a mostrar, con la etiqueta resolved.

Encontrá el email perdido

En Inbound, buscá por De la dirección del cliente. Si está, el código te dice por qué no entró. Si no está, el email no llegó a Nxar: revisá la regla de reenvío de tu casilla o la dirección a la que escribió.

Corregí la causa

Por ejemplo, para INBOX_NOT_FOUND con Para ventas@estudio-norte.inbound.nx-ar.com: creá una inbox del tipo Default del platform con Local part ventas. Para RECORD_CREATE_FAILED, ajustá los campos de la inbox que dice el detalle.

Reintentá

Volvé al Audit Log y hacé clic en Reintentar en esa fila. Desaparece de la lista y el registro aparece en su entidad.

Los filtros de la inbox

En la pestaña Avanzado de cada inbox están las reglas que deciden qué se rechaza antes de crear nada:

Dominios permitidos: uno por línea, sin @ (cliente.com). Vacío acepta cualquier dominio. Con algo cargado, todo lo que venga de otro dominio va al Audit Log como SENDER_BLOCKED.
Senders bloqueados: uno por línea, una dirección completa (avisos@banco.com) o un dominio con @ adelante (@promos.com).
Tamaño máximo de adjunto (MB) y Extensiones bloqueadas (exe, bat, cmd): los adjuntos que no pasan se descartan, pero el email entra igual.
Threshold de spam: con el proveedor de email que usa Nxar hoy no tiene efecto, porque el spam se filtra antes de llegar a tu workspace.

Outbound: lo que mandaste y no llegó

Muestra los últimos 30 días de emails que el proveedor no pudo entregar: Evento, Destinatario, Asunto, Motivo y Provider.

Evento	Qué significa
`hard_bounce`	La dirección no existe: corregí el email del contacto
`soft_bounce`	Buzón lleno o problema pasajero; suele resolverse solo
`deferred`	El proveedor lo está reintentando
`blocked`	El servidor del destinatario lo rechazó
`spam`	El destinatario lo marcó como spam: no insistas sin hablar con él

El mismo estado aparece como etiqueta al lado del email, en la tarjeta Emails de la ficha.

Cómo saber que te salió

Abrí Audit Log: en Inbound ves los emails pendientes, o el mensaje “No hay emails sin rutear”.
Mandá un email a una dirección inventada de tu workspace, como ventas@<tu-slug>.inbound.nx-ar.com (la parte después de la arroba es la misma que la de tu inbox Support). En un minuto aparece en Inbound con INBOX_NOT_FOUND.
Hacé clic en Descartar: la fila desaparece. Tildá Incluir resueltos: vuelve a aparecer con resolved.

¿Llegaste al resultado de arriba?

En la referencia

Email inboxes: Audit Log