Saltar al contenido

Proveedores de correo

Amazon SES

Configura Amazon SES como proveedor de correo en Notifuse.

Notifuse puede enviar correos a través de AWS Simple Email Service (SES).

Configuración

Ve a Configuración → Integraciones, haz clic en Añadir integración y elige Amazon SES en Envío de correos. El formulario se abre a página completa.

Formulario de la integración Amazon SES Ajustes de Amazon SES

Campos del formulario

CampoDescripciónEjemplo
RegiónRegión de AWS donde están tus identidades verificadasus-east-1
ID de clave de accesoClave de acceso de un usuario IAM con permiso para enviar con SESAKIAIOSFODNN7EXAMPLE
Clave de acceso secretaLa clave de acceso secreta de ese usuario IAMwJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Aislamiento de tenantOpcional. Da a esta integración su propio perfil de reputación y su propia lista de supresión (consulta más abajo)Desactivado
Conjunto de configuraciónOpcional, en Avanzado. Envía a través de un conjunto de configuración que gestionas túmy-config-set
Tenant SESOpcional, en Avanzado. Envía a través de un tenant que gestionas túmy-tenant

Lista de remitentes

Añade direcciones de remitente verificadas en tu configuración de AWS SES:

CampoDescripciónEjemplo
NombreNombre visible del remitenteSupport Team
Correo electrónicoDirección de correo del remitentesupport@yourdomain.com

Los remitentes deben estar verificados en la consola de AWS SES antes de poder usarlos.

Tipos de uso

Elige qué envía esta integración de Amazon SES desde el menú ⋯ de su tarjeta en Configuración → Integraciones (Usar para marketing, Usar para transaccional), o desde el panel Envío de correos de esa página:

OpciónDescripciónEjemplos
Usar para transaccionalCorreos generados por el sistema a raíz de acciones del usuarioRestablecimiento de contraseña, confirmaciones de pedido, avisos de la cuenta
Usar para marketingCorreos promocionales y newsletters enviados a suscriptoresAnuncios de producto, newsletters, campañas promocionales

Elige las dos opciones para enviar todos los tipos de correo con la misma configuración de SES.

Webhooks

Notifuse se suscribe automáticamente a estos webhooks de SES:

Tipo de webhookDescripciónFinalidad
EntregaCorreo entregado correctamenteSeguir las entregas correctas
ReboteCorreo rebotadoVigilar los rebotes
QuejasEl destinatario ha presentado una queja por abusoGestionar las denuncias de abuso

Notifuse recibe estos eventos de entrega en cuanto se producen.

Aislamiento de reputación (tenants de SES)

Por defecto, todos los espacios de trabajo de una cuenta de AWS comparten una misma reputación de envío y una sola lista de supresión. Una campaña mal segmentada de un equipo puede llevar la tasa de rebotes o de quejas de la cuenta por encima de los umbrales de AWS y pausar el envío para todos. Además, un rebote duro en un espacio de trabajo suprime a ese destinatario en todos los demás.

Aislamiento de tenant da a una integración su propio tenant de SES, con su propio perfil de reputación, sus propias métricas de rebotes y quejas y su propia lista de supresión. Así AWS puede pausar un solo tenant en lugar de toda la cuenta.

Nota

En self-hosting, crear un nuevo tenant de SES requiere una clave de licencia. Un tenant ya creado sigue enviando con su propia reputación indefinidamente sin ella: el envío no comprueba la licencia. Notifuse Cloud incluye el aislamiento por tenant de SES a partir del plan Starter (detalles).

Activarlo

Abre la integración (Configuración → Integraciones), activa Aislamiento de tenant en el panel Reputación y guarda. Notifuse te pide confirmación, porque un tenant es un recurso de AWS que se factura, y después crea todo en tu cuenta:

PasoQué hace Notifuse
Crear el tenantLo llama notifuse-<integration ID>, con SuppressionScope: TENANT para rebotes y quejas
Asociar el conjunto de configuraciónAsocia el conjunto de configuración con el que envía esta integración
Asociar las identidadesAsocia cada identidad verificada que cubre a un remitente: la dirección exacta, su dominio o un dominio superior

Al guardar de nuevo se repiten los mismos pasos. Así se asocia un remitente que añadas más tarde y se reintenta una ejecución que quedó a medias.

Nota

La supresión por tenant no es la opción por defecto de AWS. Un tenant creado a mano en la consola de SES hereda la lista de supresión de la cuenta salvo que definas tú el ámbito de supresión. Obtienes así aislamiento de reputación pero, sin ningún aviso, no aislamiento de supresión. Notifuse define el ámbito al crear el tenant y lo corrige si ya existe un tenant con ese nombre.

Nota

El aislamiento se aplica a la integración, no al espacio de trabajo. Un espacio de trabajo con integraciones de SES separadas para marketing y para transaccional tiene dos tenants, cada uno con su lista de supresión: SES no suprime en una el rebote registrado por la otra. La supresión propia de Notifuse por espacio de trabajo sigue aplicándose a las dos, así que en el peor caso sale un mensaje de más hacia una dirección que SES ya sabe que es mala.

Lo que verás

  • Un remitente sin identidad verificada aparece por su nombre después de guardar. Sus envíos fallarían con o sin tenants, así que corrígelo.
  • Un permiso de IAM que falta aparece con la acción exacta y un comando de la CLI aws para ejecutarlo. Notifuse solo pasa la integración al tenant cuando su conjunto de configuración está asociado, porque SES rechaza todos los mensajes enviados a través de un tenant sin él. Una configuración a medias deja el envío exactamente como estaba.
  • La tarjeta de la integración muestra el conjunto de configuración en uso y si la reputación está isolated o shared with the rest of this AWS account.

Desactivarlo

Desactivar Aislamiento de tenant surte efecto en el siguiente envío: los mensajes vuelven a salir con la reputación compartida de la cuenta. El tenant sigue en AWS con su lista de supresión y su historial de reputación, y al volver a activarlo se retoma el mismo tenant.

Nota

Un tenant con el aislamiento desactivado se sigue facturando hasta que se elimina la integración. Desactívalo para cambiar tu forma de enviar; elimina la integración para dejar de pagarlo.

Advertencia

Eliminar la integración elimina el tenant, junto con su lista de supresión y su historial de reputación, que no se pueden recrear. Si retiras solo los webhooks, los dos se quedan, porque el envío sigue dependiendo de ellos.

Avanzado: usa tu propio tenant o conjunto de configuración

En Avanzado, los dos campos son opcionales y proponen los nombres que existen en tu cuenta (pasan a texto libre si tus credenciales no pueden listarlos):

CampoDescripción
Conjunto de configuraciónEnvía a través de un conjunto de configuración que gestionas tú en lugar del notifuse-<integration ID>. Notifuse le añade su destino de eventos, pero nunca lo crea ni lo elimina.
Tenant SESEnvía a través de un tenant que gestionas tú. No se puede combinar con el interruptor de arriba. Notifuse no lo crea, ni lo modifica, ni lo elimina.

Con tu propio tenant, tienes que asociarle tú la identidad de envío y el conjunto de configuración, o SES rechaza todos los envíos:

aws sesv2 create-tenant-resource-association \
  --tenant-name my-tenant \
  --resource-arn arn:aws:ses:<region>:<account>:configuration-set/<name>

Nota

Los tenants solo existen en la API v2 de SES, que es la que usa ahora Notifuse para enviar. Además son regionales: un tenant está en la misma región que su integración.

Respuestas entrantes (stop-on-reply)

Para usar Salir al responder en las automatizaciones, SES tiene que reenviar las respuestas entrantes a Notifuse. SES gestiona el correo recibido aparte del envío, así que esto se configura una sola vez, en dos partes:

  1. Apunta los registros MX de tu dominio a SES. Añade en tu dominio de envío un registro MX que apunte al endpoint de entrada de SES de tu región, inbound-smtp.<region>.amazonaws.com (por ejemplo inbound-smtp.us-east-1.amazonaws.com), con prioridad 10. Sin él, las respuestas nunca llegan a SES. SES no tiene API de DNS, así que esto se hace a mano.
  2. Registra la ruta de entrada. En Configuración → Integraciones, abre el menú ⋯ de la integración de SES y elige Volver a registrar webhooks (Registrar webhooks si aún no están registrados). Además de los webhooks de eventos de entrega, rebote y queja, Notifuse crea un tema SNS (suscrito por HTTPS a Notifuse y firmado con SignatureVersion 2) y una regla de recepción de SES con una acción SNS. Si tu cuenta tiene un conjunto de reglas de recepción activo, la regla se añade dentro de él. Solo reenvía una copia y no tiene acción stop, así que una configuración existente (como Amazon WorkMail) sigue funcionando. Notifuse crea y activa un conjunto de reglas propio, notifuse-inbound, solo si no hay ninguno activo.

Nota

La recepción de correo de SES solo existe en algunas regiones de AWS (por ejemplo us-east-1, us-west-2, eu-west-1). Si la región de tu integración no la admite, el registro de entrada aparece como no disponible. Consulta la lista de Email Receiving endpoints de AWS.

El tema SNS de entrada, la regla de recepción y la suscripción requieren permisos de IAM además de los de envío: sns:CreateTopic, sns:SetTopicAttributes, sns:Subscribe, ses:DescribeActiveReceiptRuleSet, ses:CreateReceiptRuleSet, ses:CreateReceiptRule, ses:SetActiveReceiptRuleSet, ses:DeleteReceiptRule y ses:ListIdentities. La regla de recepción solo cubre las identidades verificadas de tu cuenta (dominios y direcciones de correo). Si no hay ninguna verificada, se rechaza el registro de entrada, para que la regla nunca reenvíe todo el correo de la cuenta.

Las respuestas se emparejan con el envío original por su Message-ID. SES sobrescribe esa cabecera al enviar, así que Notifuse guarda el valor que devuelve SES y lo empareja sea cual sea el host, sin una clave de firma de entrada aparte. Antes de aceptarla, cada notificación SNS de entrada se verifica con su firma RSA y se vincula al tema creado: se rechaza un mensaje de cualquier otro tema SNS, aunque tenga una firma de AWS válida. El endpoint tiene límite de peticiones.

Advertencia

Una configuración manual debe registrar el ARN del tema SNS. Los mensajes entrantes se autentican contra el tema creado, así que una integración sin ARN de tema vinculado rechaza todo el correo entrante. Registrar los webhooks desde el menú ⋯ lo guarda por ti. Si conectas a mano la entrada de SES (tu propio tema SNS + regla de recepción), indica el ARN del tema en el ajuste inbound_topic_arn de la integración de SES, o no se aceptarán las respuestas.

Con las dos partes listas, un contacto que responde a un correo de una automatización sale del recorrido si esa automatización tiene activado Salir al responder. Los rebotes y las respuestas automáticas de ausencia nunca cuentan como respuesta.

Requisitos previos

Necesitas:

  1. Una cuenta de AWS activa con SES habilitado
  2. Direcciones de correo o dominios verificados en la consola de AWS SES
  3. Un usuario de AWS con permisos de envío en SES (ver más abajo)
  4. Acceso de producción: sal del sandbox de SES para enviar sin restricciones

Permisos de IAM

Solo el primer grupo es obligatorio. Cada uno de los demás activa una función opcional, y Notifuse funciona sin él: un permiso que falta se notifica con la acción que hay que añadir, nunca como un fallo silencioso.

FinalidadAcciones
Envío (obligatorio)ses:SendEmail
Webhooks de eventosses:CreateConfigurationSet, ses:DescribeConfigurationSet, ses:ListConfigurationSets, ses:DeleteConfigurationSet, ses:CreateConfigurationSetEventDestination, ses:UpdateConfigurationSetEventDestination, ses:DeleteConfigurationSetEventDestination, sns:CreateTopic, sns:Subscribe, sns:GetTopicAttributes, sns:DeleteTopic
Aislamiento de reputaciónses:CreateTenant, ses:GetTenant, ses:PutTenantSuppressionAttributes, ses:CreateTenantResourceAssociation, ses:ListEmailIdentities
Selectores de nombres y comprobacionesses:ListTenants, ses:ListTenantResources
Eliminación limpiases:DeleteTenant, ses:DeleteTenantResourceAssociation
Respuestas entrantesConsulta la nota sobre stop-on-reply de más arriba

Advertencia

Sin los permisos de eliminación limpia, al eliminar una integración su tenant se queda en tu cuenta de AWS, donde se sigue facturando hasta que lo elimines a mano.

Pruebas

Haz clic en Enviar un correo de prueba, arriba en el formulario de la integración, o en Enviar prueba en su tarjeta para comprobar tu configuración.