Empieza con Adapty Mail

En esta guía configurarás Adapty Mail y lanzarás tu primer email flow.

La configuración tiene seis partes:

1. Conecta tus datos
2. Configura tu dominio de envío
3. Crea un paywall web
4. Genera una campaña con IA
5. Lanza un flow
6. Empieza a enviar

Antes de empezar

Asegúrate de tener lo siguiente antes de comenzar:

• Acceso DNS: Puedes añadir registros a tu dominio raíz.
• Pagos: Tienes una cuenta de Stripe con tus productos de suscripción configurados. Si quieres usar otro proveedor, aloja el checkout tú mismo — consulta Configurar checkout.

1. Conecta tus datos

Adapty Mail necesita el historial de compras (para atribuir los ingresos al email que generó cada conversión), un identificador de usuario estable y una dirección de email para cada usuario. Prepara el punto de entrada que corresponda a donde ya viven esos datos — abrirás el flujo en el Paso 6, una vez que el resto de la configuración pueda actuar sobre lo que llegue:

• Adapty: Si tu app usa el SDK de Adapty, configura la identificación de usuarios y la recopilación de correos electrónicos. Por ahora, deja la integración desactivada — Adapty Mail la bloquea hasta que tengas un flow. Consulta Conectar Adapty con Adapty Mail.
• Adapty Mail API: Si tu backend es la fuente de verdad, obtén tu clave secreta desde Settings y prepara tus solicitudes, pero no las envíes todavía. Los perfiles que llegan antes de que termine la configuración nunca recibirán nada. Consulta Enviar correos electrónicos y transacciones mediante la Adapty Mail API.

Puedes usar más de un punto de entrada a la vez. Adapty Mail combina los datos entrantes por customer_user_id y dirección de email, de modo que una persona identificada desde varias fuentes sigue teniendo un solo perfil y una sola secuencia.

2. Configura tu dominio de envío

Abre Adapty Mail: haz clic en el logo de Adapty en la cabecera y elige Mail.

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 → DNS y, en la sección Email domains, haz clic en Add domain.
2. En el campo Domain, escribe tu dominio raíz (por ejemplo, yourapp.com). Solo se aceptan dominios apex — los subdominios como app.yourapp.com se rechazan al introducirlos.
3. En el campo Sending subdomain, escribe el prefijo desde el que se enviarán tus correos, o déjalo vacío para usar mail. Los correos se enviarán desde hello@mail.yourapp.com.
4. Haz clic en Add domain.

5. En el registrador de tu dominio, añade todos los registros DNS que aparecen en la nueva tarjeta de dominio. Vienen en tres grupos: los registros DKIM y MAIL FROM de tu subdominio de envío, los registros del buzón que calienta el dominio, y los registros de go.yourapp.com, que sirve imágenes y enlaces rastreados. Para saber qué autentica cada grupo, consulta Qué registros añades. Para exportarlos todos de una vez, haz clic en Export.
6. Opcionalmente, añade el registro TXT DMARC sugerido en tu dominio raíz (recomendado).
7. Haz clic en Check para verificar de inmediato, o sal de la tarjeta y deja que Adapty Mail consulte el DNS.

Verificación en un vistazo:

• Sondeo automático: La primera comprobación se ejecuta 1 minuto después de añadir el dominio, y los intervalos se duplican hasta una vez por hora hasta que se encuentren los registros.
• Comprobación manual: Haz clic en Check en cualquier momento para lanzar una comprobación inmediata.
• Propagación DNS: Normalmente unos minutos, y en casos raros hasta 48 horas.
• Ventana de verificación: 7 días. Si caduca, tus registros DNS permanecen en su sitio — vuelve a añadir tu dominio en Settings → DNS para iniciar una nueva ventana.

Un dominio verificado es suficiente para empezar a enviar. Un proyecto puede tener hasta cinco, y puedes añadir el resto más adelante.

Para más información 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 B: Usa tu propio paywall alojado

1. Selecciona Enter URL manually.

2. Pega la URL de tu paywall alojado con marcadores de posición como parámetros de consulta. Adapty Mail los sustituye por destinatario para que la página de pago pueda identificar al visitante. Ejemplo:

   https://example.com/paywall?email={email}&adapty_profile_id={adapty.external_profile_id}

   La página de creación lista los marcadores de posición que puedes usar. Consulta Configurar el checkout para ver a qué se resuelve cada uno.

3. Guarda y publica.

Para conocer la anatomía del funnel de pago y cómo funciona la personalización, consulta Configurar el checkout.

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. Empezar a enviar

Tu campaña está configurada pero aún no se ha activado — ningún dato de usuario llega todavía a Adapty Mail. Iniciar el flujo de datos es el último paso, y cada punto de entrada del Paso 1 se inicia de forma diferente:

• Adapty: En Adapty Mail, ve a Settings → Project y haz clic en Enable Adapty integration. El botón está desactivado hasta que completes el paso 5, con el tooltip “Set up at least one flow before enabling Adapty integration”. Consulta Conectar Adapty con Adapty Mail.
• Adapty Mail API: Comienza a publicar perfiles y eventos de transacciones. Los perfiles que envíes antes de completar esta configuración nunca recibirán nada, por eso este paso va al final. Consulta Enviar emails y transacciones a través de la Adapty Mail API.

Desde aquí, los usuarios que coincidan con tu segmento recibirán la campaña en cuanto cumplan la condición de activación. Antes de dar acceso a usuarios reales, prueba toda la cadena con un usuario de prueba.

Solución de problemas

Más información

• Prueba tu flow: Ejecuta un usuario de prueba por toda la cadena antes de lanzar.
• Conecta Adapty con Adapty Mail: Configuración del SDK y estrategias para obtener cobertura de email si tu app aún no los recopila.
• Configura tu dominio de envío: Detalles de registros DNS, niveles de calentamiento y resolución de problemas.
• Configura el checkout: Anatomía del funnel de checkout y personalización.
• Analíticas de campañas: Seguimiento de entrega, interacción e ingresos.
• Pruebas A/B: Prueba múltiples versiones de secuencias.