Correo electrónico: proveedores de envío de Fidelización y tienda

Los correos de Fidelización y de la tienda online del delivery propio de Connect Manager, la plataforma que conecta servicios con Ágora, salen por el Amazon SES de la plataforma o por el proveedor de correo del propio club: SMTP, Amazon SES con sus claves, Resend, Brevo, Mailgun, Postmark, Mailjet, MailerSend o Mailchimp Transactional. Este manual es para el técnico que elige y configura ese proveedor: qué datos pedir, dónde se ponen en cada panel, qué hay que preparar en el dominio, cómo funciona el seguimiento de aperturas y rebotes y qué hacer cuando un correo no llega.

Qué hace la integración#

• Un proveedor de correo por grupo, compartido por Fidelización y por la tienda online: la pantalla de correo de la tienda edita la misma configuración que Fidelización.

• «Servicio propio» (el de serie): los correos salen por el envío de la plataforma, sin que el club contrate nada. Cuando FOS tiene activo el Amazon SES de la plataforma, salen por él con un remitente del dominio de la plataforma propio de cada club y el nombre del club; si no, por el correo general de la plataforma.

• Proveedor del club con sus propias claves: SMTP de cualquier proveedor, Amazon SES por SMTP o por API, Resend, Brevo, Mailgun, Postmark, Mailjet, MailerSend, Mailchimp Transactional (Mandrill) y Bird.

• Por ese proveedor salen todos los correos del grupo: el acceso al área del socio, la bienvenida, el envío de la tarjeta del móvil, los avisos de cupón, nivel, cumpleaños y recuperación, las campañas, las tarjetas regalo, los correos de socios, las entradas y los recordatorios de eventos, y en la tienda el enlace de acceso, el pedido confirmado, el «listo / en camino» y el aviso interno de pedidos que no entran en el TPV.

• Seguimiento propio de las campañas, con cualquier proveedor: aperturas por un píxel, clics por enlaces firmados y bajas por un enlace en el pie.

• Con el Amazon SES de la plataforma, además, entregas, rebotes y quejas de cada correo de campaña, y la dirección que rebota en duro o se queja como spam se suprime sola.

• Lista de supresiones por grupo (bajas, rebotes, quejas y altas manuales) que deja fuera esas direcciones de las campañas.

• Las campañas por correo llevan la cabecera de baja en un clic que piden Gmail y Yahoo cuando salen por el envío de la plataforma, por SMTP o por Amazon SES.

• Las campañas se envían a un ritmo limitado (de serie, 13 correos por segundo) para no pasar la cuota del envío.

Qué no hace#

• Los proveedores por API (Resend, Brevo, Mailgun, Postmark, Mailjet, MailerSend y Mailchimp Transactional) y Bird envían solo el HTML: sin adjuntos (como el justificante en PDF de las entradas), sin la cabecera de baja en un clic y sin registro de rebotes ni quejas.

• Los rebotes y las quejas solo se registran solos con el Amazon SES de la plataforma.

• La lista de supresiones solo frena las campañas: los correos de servicio (acceso, pedidos, entradas) se siguen enviando.

• No configura el DNS del dominio del cliente: los registros SPF y DKIM los añade quien gestione ese dominio.

• En la pantalla de correo de la tienda solo se ofrecen «Servicio propio», «SMTP» y «Amazon SES SMTP» (si el grupo ya tenía otro proveedor, se conserva).

• Con «Servicio propio» el remitente no es una dirección del dominio del restaurante: las respuestas se recogen con «Responder a».

• El botón «Enviar prueba» de la tienda y la prueba del «Email de acceso» de Fidelización salen por el correo general de la plataforma, no por el proveedor elegido.

Requisitos#

• Con «Servicio propio»: nada que contratar. FOS mantiene el Amazon SES de la plataforma (dominio verificado con DKIM y cuenta fuera del modo de pruebas) y el correo general.

• Con un proveedor del club: cuenta activa en el proveedor, el dominio o la dirección remitente verificados en él (con sus registros DKIM y SPF en el DNS del dominio) y las credenciales de envío. En Amazon SES, además, la cuenta fuera del modo sandbox.

• Permisos: Fidelización: Activar por grupo para el portal de Fidelización y Delivery: Configurar locales para la pantalla de correo de la tienda.

• Quién hace qué: el cliente contrata el proveedor y verifica su dominio (o pide a su informático que añada los registros DNS); el distribuidor pone las credenciales y prueba; FOS mantiene el envío de la plataforma, las colas y el seguimiento de Amazon SES.

Datos que necesitamos#

Configuración paso a paso#

En el proveedor de correo (solo si el club usa el suyo)#

1. Da de alta el dominio o la dirección remitente y verifícalo con los registros DNS que indique el proveedor (DKIM y, si lo pide, SPF).

2. Genera las credenciales: usuario y contraseña SMTP o una clave de API con permiso de envío. En Amazon SES, las credenciales SMTP se generan aparte en la consola de SES y no son la clave de API de AWS.

3. En Amazon SES, pide el acceso de producción si la cuenta sigue en modo sandbox; en Mailgun, anota el dominio de envío y si la cuenta es de la región europea.

En Connect Manager: Fidelización#

1. En /fidelizacion, ve a Configuración → Portal público de clientes, abre el grupo y entra en la sub-página Fidelización.

2. En «Servicios de comunicación (proveedores)», en el desplegable Email, elige el proveedor. Aparecen solo los campos que necesita y, en SMTP, Amazon SES SMTP, Mailgun, Postmark y Mailjet, una nota con lo que significa cada uno. Rellénalos y guarda.

3. En la sub-página Comunicaciones, con «Email de acceso (enlace mágico)» seleccionado, revisa Nombre del remitente, Email remitente y Responder a (reply-to), y personaliza y activa cada comunicación.

[!WARNING] Con «Servicio propio», deja Email remitente vacío salvo que FOS te confirme que esa dirección está verificada en el envío de la plataforma: el envío por Amazon SES solo admite remitentes verificados. Para recibir las respuestas usa «Responder a».

En Connect Manager: la tienda online#

1. En /delivery-propio, ve a Configuración → Tienda pública → Correo.

2. En «Quién envía»: Nombre del remitente, Dirección del remitente (solo aparece con un proveedor del club) y Responder a.

3. En «Correo de acceso a la tienda», si quieres cambiar el texto por defecto: Asunto, Texto y Pie, con los marcadores {customer_name}, {tienda}, {magic_link} y {minutos}. En blanco sale el texto por defecto.

4. En «Servicio de envío», elige Servicio («Servicio propio», «SMTP» o «Amazon SES SMTP») y rellena sus campos. Es la misma configuración de Fidelización: cambiarla aquí la cambia para todo el grupo.

5. En «Avisos internos», rellena Avisar a con los correos que deben enterarse de un pedido cobrado que no entra en el TPV.

6. Pulsa Guardar.

Seguimiento con el Amazon SES de la plataforma (lo hace FOS)#

1. En la cuenta de AWS de la plataforma, crea un Configuration Set de SES que publique los eventos de entrega, rebote y queja en un tema de SNS, y desactiva en él el seguimiento de aperturas y clics de SES (se usa el propio).

2. Suscribe ese tema por HTTPS a https://hub.connectmanager.es/api/loyalty/webhooks/ses; la suscripción se confirma sola.

3. Pon el nombre del Configuration Set en la configuración del servidor y deja activa la comprobación de la firma de SNS.

Cómo funciona#

Por dónde sale cada correo#

Cada correo del club o de la tienda pasa por un único punto de envío que mira el proveedor de email del grupo. Con «Servicio propio» y el Amazon SES de la plataforma activo, sale por él con el remitente del club en el dominio de la plataforma (el «Email remitente» si lo hay o uno que se forma con el nombre corto del grupo); la excepción es el enlace de acceso de la tienda, que con servicio propio sale siempre por el correo general de la plataforma, porque es un correo suelto que alguien espera con la pantalla abierta. Con SMTP o Amazon SES, el correo se encola y se envía con las credenciales del club (por SMTP, con 8 segundos de espera máxima por intento y un reintento si la conexión se había cerrado). Con los proveedores por API y con Bird se llama directamente a su API con el remitente, el destinatario, el asunto y el HTML.

flowchart TD
    M[Correo del club o de la tienda] --> P{Proveedor de email del grupo}
    P -- Servicio propio --> T{Enlace de acceso de la tienda}
    T -- Sí --> G[Correo general de la plataforma]
    T -- No --> S{Amazon SES de la plataforma activo}
    S -- Sí --> SES[Amazon SES de la plataforma]
    S -- No --> G
    P -- SMTP o Amazon SES --> Q[Cola de envío con las credenciales del club]
    P -- Proveedor por API --> API[API del proveedor, solo HTML]
    P -- Bird --> B[API de Bird, solo HTML]

El seguimiento de las campañas#

Cada destinatario de una campaña tiene un identificador propio. El cuerpo se monta para él con un píxel de apertura, los enlaces reescritos y firmados para contar los clics sin permitir redirecciones a cualquier sitio, y un enlace de baja; los accesos de escáneres de correo se descartan. Cuando el correo sale por el envío de la plataforma, por SMTP o por Amazon SES, lleva además la cabecera de baja en un clic y una cabecera con el identificador del destinatario. Con el Amazon SES de la plataforma, SES publica en SNS la entrega, el rebote o la queja y SNS los manda a Connect Manager, que comprueba la firma, encuentra al destinatario por esa cabecera, actualiza la campaña y suprime la dirección si el rebote es duro o es una queja. El enlace de baja abre una página de confirmación (así los escáneres de correo no dan de baja a nadie por error) y, al confirmar, suprime la dirección en ese grupo; se puede deshacer desde la misma página. La baja desde el enlace de otros correos del club, además, retira el consentimiento de correo de la ficha del cliente.

sequenceDiagram
    participant H as Connect Manager
    participant S as Amazon SES
    participant C as Destinatario
    participant N as SNS
    H->>S: Campaña con píxel, enlaces firmados y cabecera del destinatario
    S->>C: Entrega el correo
    C->>H: Abre el correo o pulsa un enlace
    S->>N: Evento de entrega, rebote o queja
    N->>H: Notificación firmada al webhook de SES
    H->>H: Actualiza el destinatario y suprime si rebota en duro o se queja

Dónde se ve#

• En Administración → Campañas de /fidelizacion, los resultados de cada campaña: enviados, entregados, aperturas, clics, rebotes, quejas y bajas, con la opción de reenviar a quien no la abrió.

• En Administración → Supresiones, las direcciones que no reciben campañas con su motivo: «Baja», «Rebote», «Spam» o «Manual». Se pueden añadir a mano y quitar.

• En la ficha de cada cliente, su historial de comunicaciones, incluidos los enlaces de acceso que pidió.

Comprobar que funciona#

1. Guarda el proveedor. En Fidelización → Comunicaciones, selecciona una comunicación de email que no sea la de acceso (por ejemplo «Email de bienvenida») y pulsa Enviar prueba con un correo tuyo: esa prueba sí sale por el proveedor elegido.

2. Revisa la bandeja de entrada y la de spam, y en las cabeceras del mensaje comprueba que SPF y DKIM pasan.

3. Si se van a mandar campañas, crea una en Administración → Campañas y usa su Enviar prueba: sale por el proveedor real y no da de alta a nadie.

4. Si hay tienda online, pide el enlace de acceso desde la tienda con un correo de un cliente de prueba y haz un pedido de prueba para recibir el correo de pedido confirmado.

5. Con el Amazon SES de la plataforma, después de enviar una campaña de prueba debe aparecer la entrega en sus resultados.

[!NOTE] «Enviar prueba» en Tienda pública → Correo, y en Fidelización con la comunicación «Email de acceso (enlace mágico)», salen por el correo general de la plataforma: sirven para revisar el texto, no las credenciales del proveedor. Además, la prueba de Comunicaciones y la de la tienda dan de alta (o reutilizan) en el club un cliente con ese correo: usa una dirección interna.

Errores frecuentes y solución#

Preguntas frecuentes#

¿Qué proveedor de correo uso para Fidelización y la tienda online de Ágora?#

Si el club no tiene uno propio, «Servicio propio»: sale por el envío de la plataforma, con Amazon SES y el seguimiento completo de rebotes. Si quiere enviar desde su dominio, elige su proveedor (SMTP, Amazon SES, Resend, Brevo, Mailgun, Postmark, Mailjet, MailerSend o Mailchimp Transactional) y verifica el dominio en él.

¿Puedo enviar los correos desde el dominio del restaurante?#

Sí, con un proveedor propio en el que ese dominio esté verificado. Con «Servicio propio» el remitente es del dominio de la plataforma y las respuestas van a «Responder a».

¿Cómo se registran las aperturas y los rebotes de las campañas?#

Las aperturas, los clics y las bajas los cuenta Connect Manager con su píxel y sus enlaces, con cualquier proveedor. Las entregas, los rebotes y las quejas solo llegan con el Amazon SES de la plataforma, a través de SNS.

¿Por qué no llegan los adjuntos con Brevo, Resend o Mailgun?#

Porque con esos proveedores se envía solo el HTML por su API. Si hacen falta adjuntos, como el justificante de las entradas, usa SMTP, Amazon SES o el servicio propio.

Si cambio el proveedor en la tienda, ¿cambia también el del club?#

Sí. La tienda y Fidelización comparten la misma configuración de correo del grupo.

¿Qué pasa cuando un cliente se da de baja de las campañas?#

Su dirección entra en Supresiones con el motivo «Baja» y deja de recibir campañas de ese grupo. Los correos de servicio, como el acceso o los pedidos, le siguen llegando. Si se arrepiente, puede deshacerlo desde la misma página de baja.

Referencias#

• Ficha de Amazon SES en el catálogo y las de Resend, Brevo, Mailgun, Postmark, Mailjet, MailerSend y Mailchimp Transactional

• Fidelización: conectar el club con Ágora y WhatsApp y Bird: mensajes y campañas del club

• Delivery propio: conectar la tienda online con Ágora

• Redsys: pasarela de pago de la tienda y de Fidelización

• Guía de Amazon SES

• Credenciales SMTP de Amazon SES