En esta guía configurarás Adapty Mail y lanzarás tu primer flujo de correo electrónico.

La configuración consta de seis partes:

1. Configura tu SDK de Adapty
2. Configura tu dominio de envío
3. Crea un paywall web
4. Genera una campaña con IA
5. Lanza un flujo
6. Activa el envío

Antes de empezar

Asegúrate de tener esto listo antes de comenzar:

• Acceso a DNS: Puedes añadir registros a tu dominio raíz.
• Proveedor de pagos web: Tienes una cuenta de Stripe, Paddle o PayPal con tus productos de suscripción configurados.

1. Configura tu SDK de Adapty

Adapty Mail necesita tres cosas de tu app: datos de compra (para poder atribuir los ingresos al email que generó cada conversión), un identificador de usuario estable y los emails de los usuarios.

1. Deja que Adapty registre tus ingresos. El primer paso depende de si ya tienes compras in-app implementadas:

   • Si ya tienes compras in-app implementadas con Adapty, no necesitas hacer nada más en esta etapa.
   • Si ya tienes compras in-app implementadas sin Adapty y no tienes previsto migrar a Adapty, instala el SDK de Adapty para tu plataforma en modo observador. En esta etapa solo necesitas añadir el SDK a tu proyecto, activarlo con el modo observador habilitado y reportar las transacciones. Guías por plataforma: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
   • Si aún no tienes compras in-app implementadas y quieres usar Adapty, completa los pasos de la guía de inicio rápido para delegar la gestión de compras a Adapty. Luego activa las notificaciones del servidor de App Store en Adapty para recibir actualizaciones relacionadas con los ingresos directamente desde App Store.

2. Configura la identificación de usuarios. Pasa un ID estable — el ID de usuario de tu backend, un UID de Firebase o similar — ya sea llamando a Adapty.identify() o pasando customerUserId a .activate() al iniciar el SDK. El customer_user_id es lo que usa Adapty Mail para vincular campañas, clics y compras al perfil correcto. Guías de plataforma: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.

3. Recopila los correos electrónicos de los usuarios. En cuanto un usuario proporcione su correo en tu app (por ejemplo, durante el registro o el proceso de pago), pásaselo a Adapty llamando a updateProfile con el atributo de correo electrónico. Todos los destinatarios de una campaña necesitan este valor. Guías por plataforma: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.

Si tu app todavía no recopila correos electrónicos, consulta Estrategias de recopilación de emails.

2. Configura tu dominio de envío

Adapty Mail envía desde tu propio dominio. Añades los registros DNS una sola vez y todas las campañas usan el mismo dominio verificado.

1. En Adapty Mail, ve a Settings → Email Domains.
2. Introduce tu dominio raíz (por ejemplo, yourapp.com) y haz clic en Preview. Solo se aceptan dominios apex; los subdominios como app.yourapp.com se rechazan en el momento de introducirlos.

3. Adapty genera dos subdominios de envío (mail.yourapp.com y email.yourapp.com). Haz clic en Confirm para ver los registros DNS necesarios.

4. En tu registrador de dominio, añade los 10 registros DNS que se muestran (5 por subdominio):
   • 3 registros CNAME (DKIM) por subdominio
   • 1 registro MX (Mail-From) por subdominio
   • 1 registro TXT (SPF, v=spf1 include:amazonses.com ~all) por subdominio
5. Opcionalmente, añade un registro TXT DMARC en tu dominio raíz (recomendado).
6. Vuelve a Settings → Email Domains y haz clic en Check Verification.

Resumen de los tiempos de verificación:

• Sondeo automático: La primera comprobación se realiza unos 5 minutos después de enviar. Los intervalos aumentan hasta una vez por hora hasta que se encuentren los registros.
• Comprobación manual: Haz clic en Check Verification en cualquier momento para lanzar una comprobación inmediata.
• Propagación DNS: Normalmente cuestión de minutos, aunque en casos excepcionales puede llegar a 48 horas.
• Ventana de verificación: 7 días. Si caduca, tus registros DNS permanecen en su lugar — vuelve a introducir tu dominio en Settings → Email Domains para iniciar una nueva ventana.

Para más detalles sobre cada tipo de registro y el calentamiento del dominio, consulta Configura tu dominio de envío.

3. Configura tu dominio de envío

Adapty Mail envía desde tu propio dominio. Añades los registros DNS una sola vez — todas las campañas usan el mismo dominio verificado.

1. En Adapty Mail, ve a Settings → Email Domains.
2. Introduce tu dominio raíz (por ejemplo, yourapp.com) y haz clic en Preview. Solo se aceptan dominios apex — los subdominios como app.yourapp.com se rechazan al introducirlos.

3. Adapty genera dos subdominios de envío (mail.yourapp.com y email.yourapp.com). Haz clic en Confirm para ver los registros DNS necesarios.

4. En tu registrador de dominio, añade los 10 registros DNS que se muestran (5 por subdominio):
   • 3 registros CNAME (DKIM) por subdominio
   • 1 registro MX (Mail-From) por subdominio
   • 1 registro TXT (SPF, v=spf1 include:amazonses.com ~all) por subdominio
5. Opcionalmente, añade un registro DMARC TXT en tu dominio raíz (recomendado).
6. Vuelve a Settings → Email Domains y haz clic en Check Verification.

Tiempos de verificación de un vistazo:

• Comprobación automática: La primera verificación se ejecuta unos 5 minutos después de que envíes los registros. Los intervalos aumentan hasta una vez por hora hasta que se encuentran los registros.
• Comprobación manual: Haz clic en Check Verification en cualquier momento para lanzar una verificación inmediata.
• Propagación DNS: Normalmente en minutos, hasta 48 horas en casos excepcionales.
• Ventana de verificación: 7 días. Si caduca, tus registros DNS se mantienen — vuelve a introducir tu dominio en Settings → Email Domains para abrir una nueva ventana.

Para más detalles sobre cada tipo de registro y el calentamiento del dominio, consulta Configura tu dominio de envío.

Opción A: Generar con IA

La página muestra una lista de verificación de Prerequisites con botones en línea — recórrela en orden y luego vuelve para generar. La lista cubre el inicio de sesión en el paywall builder, la conexión con Stripe, la incorporación de productos y la revisión del resultado. Consulta Configurar el checkout para ver el proceso completo.

Cuando todos los requisitos estén en verde, haz clic en Generate para abrir el diálogo de generación:

• Environment: Elige Production o Sandbox. Sandbox usa tus productos en modo de prueba de Stripe y es la opción segura por defecto para entornos de desarrollo y locales.
• Plans: Selecciona hasta 3 planes de Stripe (cada plan es un producto + precio). Estas son las ofertas que el paywall generado presenta a los usuarios en el proceso de pago.

Haz clic en Generate para ejecutar la generación. Cuando termine, abre el editor para revisar y publicar.

Opción A: Generar con IA

1. Selecciona Generate with AI.
2. Haz clic en Log in to the paywall builder. El editor de web paywalls se abre en una nueva pestaña. Si todavía no has iniciado sesión, hazlo con tus credenciales de Adapty.
3. En el editor, activa la integración con tu proveedor de pagos (Stripe, Paddle o PayPal). Consulta Configuración del web paywall para más detalles.
4. Vuelve a Adapty Mail y haz clic en Proceed to generation.
5. Revisa el paywall generado, luego guárdalo y publícalo.

4. Genera una campaña con IA

La IA crea toda la secuencia de correos por ti: textos, diseño, imágenes destacadas y enlaces de checkout personalizados, todo adaptado a tu marca.

1. En Adapty Mail, ve a Campaigns y haz clic en Create.
2. Escribe el nombre de la campaña.
3. En el desplegable Web paywall, selecciona el web paywall que añadiste en el paso anterior.

4. Haz clic en Generate emails.
5. Rellena el diálogo de generación: tono, idioma, un prompt personalizado opcional (hasta 2.000 caracteres) y el número de correos (1–15, por defecto 4). Consulta Crear una campaña para saber qué hace cada campo.

6. Haz clic en Generate. La generación suele tardar unos minutos. El sistema agota el tiempo tras 5 minutos si no puede completarla — vuelve a intentarlo si ocurre.
7. Previsualiza cada correo. La cabecera de vista previa tiene un Theme toggle (Auto, Light, Dark) que controla cómo se renderiza la vista previa — el contenido generado es idéntico en todos los modos. Puedes regenerar correos individuales, editar el texto o abrir el editor HTML para un control más detallado.

8. Haz clic en Create para guardar la campaña. La campaña se guarda como borrador y aún no envía nada: las campañas solo se activan cuando se vinculan a un flujo (siguiente paso). No hay ninguna acción de “publicar” separada en el editor de campañas.

5. Lanzar un flujo

Un flujo combina un trigger (un evento como el vencimiento de una suscripción) con un segmento, y envía a ese segmento la campaña que elijas. Adapty Mail incluye cinco triggers fijos, cada uno con su propia vista de flujo.

1. En Adapty Mail, ve a Flows y abre el activador que quieres configurar:

   • Never purchased — usuarios que se registraron pero aún no han realizado ninguna compra.
   • Renewal cancelled — usuarios que desactivaron la renovación automática pero aún tienen una suscripción activa.
   • Billing issue — pago fallido, tarjeta rechazada o caducada, o período de gracia.
   • Expired — la suscripción ha caducado y el acceso ya no está disponible.
   • Refunded — usuarios que solicitaron un reembolso tras la compra.

   Consulta Flows para conocer el objetivo y el tono recomendado para cada activador.

2. Haz clic en Create para abrir el cuadro de diálogo.

3. En el diálogo:
   • Elige un Segment (por ejemplo, All Users para dirigirte a todos los usuarios que activen este disparador, o crea un nuevo segmento basado en los atributos del perfil).
   • Deja el tipo de contenido en Campaign (la opción de prueba A/B se explica en Pruebas A/B).
   • Selecciona la Campaign que guardaste en el Paso 4.
4. Haz clic en Save.

El flujo se activa de inmediato — no hay un paso de lanzamiento independiente. A partir de este momento, los usuarios que coincidan con el segmento empezarán a recibir la campaña en cuanto activen el evento disparador.

6. Activar el envío

Hasta ahora tu campaña está configurada pero aún no se está ejecutando: la integración con Adapty que sincroniza los eventos de suscripción en Adapty Mail sigue desactivada. Activarla es el paso final: los eventos empiezan a fluir, los segmentos empiezan a coincidir y los correos empiezan a enviarse.

Este paso solo se desbloquea después del Paso 5. Antes de lanzar un flujo, el botón Enable en Settings → Integrations aparece desactivado con el tooltip “Set up at least one flow before enabling Adapty integration.”

1. En Adapty Mail, ve a Settings → Integrations.
2. Haz clic en Enable Adapty integration (o en Enable si la integración ya existe de una configuración anterior).

Una vez activada, Adapty envía cada evento de suscripción —nuevas suscripciones, renovaciones, pruebas, conversiones, reembolsos, problemas de facturación— a Adapty Mail. Estos eventos determinan la pertenencia a segmentos, el enrutamiento de campañas y las condiciones de parada que pausan una secuencia cuando un usuario convierte.

Solución de problemas

Problema	Solución
Verificación DNS bloqueada	Comprueba que los registros coincidan exactamente: sin puntos finales, con los destinos CNAME correctos. Espera 5-10 minutos y vuelve a hacer clic en Check Verification
Ventana de verificación expirada	Tus registros siguen en su lugar. Vuelve a introducir tu dominio en Settings → Email Domains para iniciar una nueva ventana
Generación fallida o por tiempo de espera	Comprueba tu conexión a internet e inténtalo de nuevo. Si el problema persiste, contacta con el soporte de Adapty

Más información

• Recopilar emails de usuarios: Estrategias para conseguir cobertura de emails si tu app todavía no los recoge.
• Configura tu dominio de envío: Detalles de los registros DNS, niveles de calentamiento y solución de problemas.
• Configura el checkout: Anatomía del embudo de checkout y personalización.
• Analíticas de campañas: Monitoriza la entrega, el engagement y los ingresos.
• Pruebas A/B: Prueba múltiples versiones de secuencias.