Descripción general de la configuración de Email-in
Cómo llega el correo entrante a Nura24 — las tres partes móviles y cuál requiere qué configuración.
La versión orientada al usuario está en Email-in. Este artículo es para la persona que realmente configura el canal.
Las tres partes móviles
- Su proveedor de correo (Gmail, Microsoft 365, Fastmail, su propio MX) — donde llegan los correos de los clientes.
- Un proveedor de webhook de análisis (Postmark Inbound, Mailgun Routes, Amazon SES + SNS) — recibe el correo sin procesar y nos envía JSON analizado por POST.
- Nura24 — acepta el POST en
/api/email/inboundy crea el ticket.
Dos patrones de entrega
A. Directo al proveedor de análisis
Usted proporciona a los clientes una dirección que ya apunta al MX del proveedor de análisis (por ejemplo, una dirección en un dominio cuyos registros MX ha apuntado a Postmark Inbound). El analizador recibe el correo y nos lo envía. No hay paso de reenvío.
Esta es la opción más rápida y confiable. Postmark y Mailgun permiten asignar un subdominio entrante (inbox.acme.com) cuyo MX se establece en sus servidores. La dirección se convierte en tickets@inbox.acme.com o como usted prefiera.
B. Reenvío desde su bandeja existente
Usted mantiene su dirección de cara al cliente (support@acme.com) en su proveedor de correo actual y agrega una regla de reenvío que envía cada mensaje a la dirección de captura general del proveedor de análisis.
Es un poco más lento (un salto adicional) y el correo reenviado a veces pierde encabezados, pero no requiere modificar los registros MX.
Qué necesita Nura24
Solo una cosa: el proveedor de análisis debe enviar el correo analizado por POST a:
POST https://api.nura24.com/email/inbound
con un encabezado Authorization: Bearer <secreto> (o X-Inbound-Secret, o la consulta ?secret=) donde <secreto> es la clave compartida configurada en nuestro lado como EMAIL_INBOUND_SECRET.
El formato del payload es independiente del proveedor. Buscamos remitente/destinatario/asunto/cuerpo en múltiples variantes de clave — las de Postmark, Mailgun y SES — y usamos las que estén presentes.
La dirección del destinatario
Para que Nura24 enrute un mensaje entrante a un espacio de trabajo, el analizador debe enviar por POST una dirección de destinatario con el formato:
tickets+<token-de-bandeja>@<EMAIL_INBOUND_DOMAIN>
donde <token-de-bandeja> es el token por espacio de trabajo de Tickets → Bandeja de entrada y <EMAIL_INBOUND_DOMAIN> es el dominio que hemos registrado como destino entrante a nivel de plataforma.
Configuración específica por proveedor
Aún no contamos con una guía de Amazon SES en la nube porque la mayoría de los usuarios utilizan Postmark o Mailgun para esto. Si necesita SES, contáctenos.