# Configuración de email

<Aside type="note">
Ten en cuenta que la configuración de la plataforma es específica para cada proyecto. Configura la plataforma de Email para cada proyecto que quieras usar para enviar emails. Los emails y dominios verificados están disponibles para todos los proyectos en tu cuenta.
</Aside>

Para empezar a enviar emails a través de Pushwoosh, necesitarás completar una serie de pasos de configuración para verificar tu cuenta, configurar los detalles del remitente y autenticar tu dominio. Este proceso asegura una entrega de email segura y conforme a las normativas, y permite un seguimiento preciso de las métricas de interacción.

## Verifica tu cuenta
Antes de empezar a enviar emails a través de Pushwoosh, necesitas verificar tu cuenta.

Este es un paso importante para garantizar la entrega fiable y segura de tus emails. La verificación ayuda a prevenir el uso indebido de la plataforma para spam o actividades maliciosas y asegura el cumplimiento de las regulaciones.

Sigue estos pasos para completar el proceso de verificación:

1. Navega a **Settings > Configure platforms**.

2. Localiza Emails y haz clic en **Connect**.

<img src="/configure-project-email-verification-1.webp" alt="Canal directo de Emails en el Panel de Control de Pushwoosh con el botón Conectar"/>

3. En el formulario que aparece, proporciona la URL del sitio web de tu empresa en el campo Your company website URL (por ejemplo, https://example.com).

4. En el campo **Primary technical contact**, introduce la dirección de email de la persona responsable de gestionar los aspectos técnicos de tu integración. Este contacto se utilizará para cualquier consulta o problema técnico.

5. En el campo **Tell us about how you’ll be using Pushwoosh**, proporciona detalles sobre cómo pretendes usar Pushwoosh para tus campañas de email. Incluye información como:

- Los tipos de mensajes que planeas enviar (por ejemplo, newsletters, ofertas promocionales, etc.).

- Cómo se suscriben tus suscriptores para recibir estos mensajes (por ejemplo, formulario del sitio web, registro en la aplicación móvil).

<img src="/configure-project-email-verification-2.webp" alt="Formulario de verificación de email con los campos de URL del sitio web de la empresa, contacto técnico principal y detalles de uso"/>

Una vez que toda la información esté completada, haz clic en el botón **Verify my account** para enviar tu solicitud. Pushwoosh revisará tus detalles y se pondrá en contacto contigo lo antes posible.

Después de que tu cuenta sea verificada, recibirás un email de confirmación. Entonces podrás proceder a configurar los ajustes de tu remitente de email.

Para ello, ve a **Settings**, selecciona **Configure Platforms** y haz clic en **Continue Configuration** junto a la plataforma de Email.

<img src="/configure-project-email-verification-3.webp" alt="Botón Continuar Configuración junto a la plataforma de Email en el Panel de Control de Pushwoosh"/>

## Configurar detalles del remitente

### Añadir un dominio

Para enviar emails con Pushwoosh, añade y verifica un dominio. En el campo **Domain**, introduce el dominio que deseas usar para enviar emails (por ejemplo, tuempresa.com).

<img src="/configure-project-email-verification-4.webp" alt="Campo de dominio para añadir un dominio de remitente en la configuración de email de Pushwoosh"/>

**Importante:** Este dominio debe ser verificado a través de DNS en el siguiente paso antes de que pueda ser utilizado en tus campañas de email.

<Aside type="note">
Verás el número restante de dominios que puedes añadir en la parte superior de la pantalla. Para aumentar este límite, por favor [contacta a nuestro equipo de soporte](https://help.pushwoosh.com/hc/en-us/)
</Aside>

<span id="add-default-sender-details" />

### Añadir detalles del remitente por defecto

#### Dirección del remitente

Configura un nombre y una dirección de email de remitente por defecto que aparecerán en las bandejas de entrada de los destinatarios. Esto ayuda a los usuarios a reconocer al remitente y genera confianza.

*   **Name**: Introduce el nombre del remitente (por ejemplo, John).
*   **Email**: Introduce la dirección de email del remitente antes del símbolo "@" (por ejemplo, para *marketing@tuempresa.com*, introduce *marketing*)

**Nota**: Estos detalles de remitente por defecto se usarán automáticamente en las campañas a menos que especifiques detalles de remitente diferentes para una campaña individual.

<img src="/configure-project-email-verification-5.webp" alt="Formulario de detalles del remitente por defecto con los campos de nombre y email de la dirección De en Pushwoosh"/>

Selecciona la casilla **Use this as reply-to address to track replies** si quieres que las respuestas de los destinatarios vayan directamente a la dirección de email del remitente.

#### Dirección de respuesta

Para usar una dirección de respuesta diferente, deja la casilla sin marcar y especifica:

*   **Reply-To name**: El nombre que aparecerá como contacto para las respuestas.
*   **Reply-To email**: La dirección de email a la que se deben enviar las respuestas.

<img src="/configure-project-email-verification-6.webp" alt="Campos de configuración de la dirección de Responder a con nombre y email en Pushwoosh"/>

Si ambos campos se dejan en blanco, las respuestas se enviarán al email del remitente por defecto especificado en la sección **From address**.

Después de completar los campos requeridos, haz clic en **Next** para proceder con la verificación del dominio.

<span id="configure-dns-records" />

## Configurar registros DNS

Para autenticar tu dominio y habilitar el envío de emails para tus campañas, necesitarás configurar los siguientes registros DNS en la configuración de DNS de tu proveedor de hosting:

*   **DKIM (Requerido)**. Este registro firma digitalmente tus emails, permitiendo a los proveedores de email verificar que un email proviene de tu dominio y no ha sido alterado en tránsito.
*   **SPF (Requerido)**: Este registro especifica qué servidores de correo están permitidos para enviar emails en nombre de tu dominio, ayudando a prevenir la suplantación de identidad (spoofing).
*   **DMARC (Requerido)**: Este registro proporciona instrucciones para manejar emails no autenticados y reportarte, mejorando la seguridad del email.

### Comprobar el estado del dominio y solucionar problemas

Utiliza estos controles situados encima de la lista de registros DNS:

*   **Verify DNS records**: Actualiza el estado de la verificación después de añadir o modificar registros DNS.
*   **Send test email**: Envía un email de prueba una vez configurado el dominio (consulta [Enviar email de prueba](#send-test-email)).
*   **Copy instructions**: Copia como texto plano todos los registros DNS requeridos, con notas de configuración, para que puedas pegarlos donde quieras.
*   **Email to your IT team**: Abre tu cliente de correo predeterminado con las mismas instrucciones ya rellenadas, listas para enviar a quien gestione tu DNS.

<img src="/configure-project-email-verification-19.webp" alt="Registros DNS de un dominio verificado, con el banner verde de todos los registros requeridos verificados encima de los botones Verify DNS records, Send test email, Copy instructions y Email to your IT team."/>

Pushwoosh también ejecuta un diagnóstico automático del dominio y muestra un banner cuando algo requiere tu atención:

*   **Some required DNS records are missing or wrong**: Consulta la nota situada bajo cada registro para ver la solución concreta.
*   **DNS records are in place**: Se han encontrado los registros en el DNS y Pushwoosh ahora los está verificando con el proveedor de correo. Este último paso suele completarse en menos de 30 minutos, muy por debajo del plazo de propagación descrito en [Registros DKIM](#dkim-records-required).
*   **Verification stopped before the records were added**: Los registros ya son correctos, pero el intento de verificación anterior ya había caducado. Haz clic en **Restart verification** en el banner para volver a intentarlo. Esto solo vuelve a crear la verificación del dominio con el proveedor de correo. No modifica tus registros SPF ni DMARC y, normalmente, conserva los mismos valores CNAME de DKIM. Vuelve a comprobar los registros DKIM de arriba tras reiniciar, ya que el proveedor puede volver a emitirlos en ocasiones.
*   **This domain does not exist in DNS**: El propio nombre de dominio no está registrado o no se puede resolver. Comprueba que esté bien escrito o registra primero el dominio.

Cuando el banner indique un proveedor de DNS (por ejemplo, "DNS for this domain is managed at ..."), añade los registros allí y no en tu registrador de dominios.


<span id="dkim-records-required" />

### Registros DKIM (requerido)

<details>
  <summary>¿Qué son los registros DKIM?</summary>

DKIM (DomainKeys Identified Mail) es un método de autenticación de email que permite a los servidores receptores verificar que un email fue enviado por el dominio indicado y no ha sido alterado en tránsito.

Al añadir registros DKIM a tu configuración de DNS, aplicas una firma criptográfica a los emails salientes. Esta firma verifica que el contenido del mensaje permanece sin cambios y lo autentica como un mensaje legítimo de tu dominio.
</details>

Para configurar DKIM, necesitarás añadir los cuatro registros CNAME (Canonical Name) a tu configuración de DNS. Estos registros son esenciales para autenticar tu dominio y confirmar que los emails enviados desde tu dominio están autorizados.

<img src="/configure-project-email-verification-8.webp" alt="Registros CNAME de DKIM mostrados en la configuración de email de Pushwoosh"/>

Copia los registros CNAME y añádelos a tu configuración de DNS.

<Aside type="note">
Los proveedores de DNS manejan los registros de manera diferente. Algunos requieren que pegues el registro completo (nombre de host + dominio), mientras que otros solo necesitan la porción de la clave única (nombre de host sin el dominio). Consulta las instrucciones de tu proveedor de DNS sobre cómo añadir los registros.
</Aside>

Si un registro no está configurado correctamente, aparece debajo de él una nota que explica el problema, por ejemplo que falta, que apunta a un valor incorrecto, que todavía tiene el nombre de tu dominio añadido dos veces, que se publicó como registro TXT en lugar de CNAME, o que el DNS no respondió y hay que volver a comprobarlo en unos minutos.

Una vez que hayas añadido los registros DNS requeridos, el proceso de verificación del dominio suele tardar entre 5 y 10 minutos, pero puede tardar hasta 24 horas en algunos casos. Durante este tiempo, no podrás enviar emails a través de Pushwoosh hasta que la verificación se complete.

Haz clic en **Verify DNS records** para actualizar el estado de la verificación después de añadir los registros DNS. Una vez que la verificación sea exitosa, el estado de verificación del Dominio cambiará a **Verified**.

<img src="/configure-project-email-verification-9.webp" alt="Estado de verificación de dominio mostrando el estado Verificado después de configurar los registros DNS"/>

Mientras tanto, siéntete libre de pasar a otros pasos de configuración y volver más tarde para comprobar el estado de la verificación.

<span id="send-test-email" />

#### Enviar email de prueba

Una vez que la configuración de tu dominio y la verificación de DKIM estén completas, puedes enviar un email de prueba para asegurarte de que la configuración de tu email funciona correctamente y que los emails se entregarán con éxito a los usuarios una vez que tu campaña se ponga en marcha.

Para enviar un email de prueba:

1. En la sección **Email Channel Configuration**, haz clic en **Send test email**.

<img src="/configure-project-email-verification-10.webp" alt="Botón Enviar email de prueba en la sección de Configuración del Canal de Email"/>

2. Introduce los detalles del Remitente y del Destinatario:
*   **From**: La dirección de email del remitente que configuraste.
*   **Recipient**: Introduce la dirección de email a la que quieres enviar el email de prueba. Por defecto, este campo se rellena con el email del usuario que ha iniciado sesión, pero puedes cambiarlo si es necesario.
3. Selecciona el contenido del email del menú desplegable para incluirlo en el email de prueba.
4. Haz clic en **Send**.

<img src="/configure-project-email-verification-11.webp" alt="Formulario de email de prueba con campos de selección de remitente, destinatario y contenido del email"/>

### Registros SPF (requerido)

Pushwoosh requiere la configuración de un registro **Sender Policy Framework (SPF)** para autorizar a sus servidores de correo a enviar emails en nombre de tu dominio. SPF es un protocolo de autenticación de email que ayuda a prevenir la suplantación de identidad (spoofing) y mejora la entregabilidad del email.

<Aside type="note">
Antes de añadir un nuevo registro SPF, comprueba si tu dominio ya tiene uno, ya que la mayoría de los proveedores de DNS solo permiten un registro SPF por dominio.
</Aside>

#### Añadir un nuevo registro SPF

Si tu dominio no tiene un registro SPF, añade un nuevo registro TXT con el siguiente valor.

**Valor SPF**

```
"v=spf1 include:spf.pushwoosh.io ~all"
```

Dependiendo de tu proveedor de DNS, el nombre del registro puede estar en blanco o establecido como @.

#### Añadir a un registro SPF existente

Si tu dominio ya tiene un registro SPF, simplemente añade el siguiente mecanismo SPF a tu registro existente para autorizar a Pushwoosh.

```
include:spf.pushwoosh.io
```

<img src="/configure-project-email-verification-12.webp" alt="Ejemplo de configuración de registro SPF mostrando cómo añadir include:spf.pushwoosh.io a un registro SPF existente"/>

Si tu registro SPF existente no incluye los servidores de Pushwoosh, o el dominio tiene más de un registro SPF (lo que hace que los receptores los ignoren todos), una nota debajo del registro indica cuál de estos problemas se ha detectado.

### Verificación DMARC (requerido)

**DMARC** (Domain-based Message Authentication, Reporting, and Conformance) es un protocolo de autenticación de email que ayuda a proteger tu dominio del uso no autorizado, como la suplantación de identidad por email (email spoofing).

Pushwoosh requiere que DMARC esté configurado en tu dominio para asegurar una entrega de email segura y autenticada. Para más información sobre DMARC, consulta la [Documentación del Protocolo DMARC](https://dmarc.org/overview/).

El registro DMARC que Pushwoosh genera para ti usa una política de solo supervisión (`p=none`): el correo no autenticado se sigue entregando y se informa de él, pero no se pone en cuarentena ni se rechaza. Si tu dominio ya tiene un registro DMARC con una política más estricta, conserva el existente en lugar de sustituirlo.

Para configurar DMARC:

1. Copia el registro TXT de DMARC que se muestra en este paso.

<img src="/configure-project-email-verification-13.webp" alt="Tarjeta del registro DMARC que muestra el registro TXT de DMARC verificado con el valor v=DMARC1; p=none; que debe añadirse a la configuración de DNS."/>

2. Ve a la configuración de tu proveedor de DNS y añade el registro DMARC a la configuración de DNS. (Consulta la documentación de tu proveedor de DNS si necesitas ayuda para añadir estos registros).
3. Habilita los informes (opcional). Para recibir informes sobre la autenticación de email y problemas de seguridad, añade una dirección de email en el campo
`rua` dentro del parámetro **Value**.

### Elegir un dominio diferente

Si en este paso te das cuenta de que necesitas cambiar tu dominio, haz clic en **Choose different domain**. Luego, puedes añadir un nuevo dominio de remitente.

Ten en cuenta que cambiar el nombre de tu dominio generará nuevos registros DNS. Esto asegura que el límite de dominios se rastree correctamente y excluye cualquier dominio que ya no necesites.

<img src="/configure-project-email-verification-14.webp" alt="Botón Elegir un dominio diferente en la configuración de email de Pushwoosh"/>

## Configurar el seguimiento de enlaces

El seguimiento de enlaces te ayuda a entender cómo interactúa tu audiencia con los enlaces en tus emails añadiendo **parámetros UTM**. Con las etiquetas UTM, puedes rastrear la interacción del email directamente en Google Analytics o en cualquier otro sistema de análisis que rastree UTM.

<Aside type="note">
Si eliges no configurar el seguimiento de URL de Google Analytics, Pushwoosh seguirá rastreando los clics en los enlaces y proporcionará estadísticas básicas. Simplemente deja el interruptor de **Google Analytics URL tracking** desactivado y haz clic en **Complete setup**.
</Aside>

Para añadir el seguimiento de enlaces, habilita el seguimiento de URL de Google Analytics.

Se añadirán los siguientes parámetros UTM a tus enlaces:

- **utm_source**: Identifica la fuente de tráfico.

- **utm_medium**: Especifica el medio de marketing, que se establece en "email" por defecto.

- **utm_campaign**: Añade el código de la campaña (por ejemplo, el ID de la campaña). Esto se inserta automáticamente.

- **utm_content**: Rastrea el contenido específico dentro del email, como el asunto. Esto se inserta automáticamente.

La **Link Preview** muestra un ejemplo de cómo se verán tus enlaces con los parámetros UTM seleccionados.

<img src="/configure-project-email-verification-15.webp" alt="Configuración de seguimiento de URL de Google Analytics con parámetros UTM y vista previa del enlace"/>

Una vez que hayas configurado los parámetros UTM, haz clic en **Complete setup** para guardar tu configuración.

Las etiquetas UTM se añadirán automáticamente a cada enlace en tu email, permitiéndote rastrear el rendimiento de la fuente, el medio, la campaña y el contenido directamente en Google Analytics.

## Resumen de la configuración del canal de email

Una vez que tu canal de email está configurado, el panel de **Email channel configuration** proporciona una visión general y te permite gestionar ajustes clave para el envío de emails, incluyendo dominios de remitente, detalles del remitente por defecto y opciones de seguimiento de enlaces.

### Estado de la configuración

En la parte superior, puedes ver el estado de la plataforma de email, que indica si está configurada. Si la plataforma no está configurada, puede deberse a las siguientes razones:

*   No se han especificado los **detalles del remitente por defecto**. [Aprende más sobre los detalles del remitente por defecto](#add-default-sender-details).

<img src="/configure-project-email-verification-16.webp" alt="Estado de la plataforma de Email mostrando un problema de configuración debido a la falta de detalles del remitente por defecto"/>

*   Un **dominio no verificado** está configurado como remitente por defecto. [Aprende más sobre cómo verificar tu dominio](#configure-dns-records).

<img src="/configure-project-email-verification-17.webp" alt="Estado de la plataforma de Email mostrando una advertencia de dominio no verificado en Pushwoosh"/>

### Tus dominios de remitente
En la sección **Your sender domains**, puedes ver y gestionar los dominios que usas para enviar emails y el estado de cada dominio:

*   **READY**: El dominio está configurado y listo para enviar emails.
*   **NOT READY**: La verificación del dominio está incompleta, generalmente debido a la verificación de DKIM pendiente, que es requerida. Los dominios marcados como **NOT READY** no pueden enviar emails hasta que se completen todas las verificaciones necesarias. Para completar la configuración, haz clic en el nombre del dominio en la lista.

Además, esta sección muestra el estado de cada registro de verificación (DKIM, SPF, DMARC) como **Verified** o **Pending**. **Pending** indica que el registro está esperando verificación o aún no ha sido configurado.

Haz clic en **Update status** para actualizar el estado de verificación de cada dominio.

Pushwoosh rechaza los mensajes enviados desde un dominio que aún no está verificado. Para conocer los códigos de error y cómo solucionar cada uno, consulta [Errores de correo electrónico](/es/product/troubleshooting/sending-errors/email-errors/#sender-and-domain-configuration).

##### Añadir un dominio

Para añadir dominios adicionales, haz clic en **Add domain**. Para aumentar este límite, por favor contacta a soporte.

<img src="/configure-project-email-verification-18.webp" alt="Botón Añadir dominio en la sección Tus dominios de remitente de la configuración de email de Pushwoosh"/>

##### Eliminar un dominio

Para eliminar un dominio:

1. En **Your Sender Domains**, localiza el dominio a eliminar.
2. Haz clic en el **menú de tres puntos** junto al nombre del dominio y selecciona **Delete domain**.
3. Confirma la eliminación, o haz clic en **Cancel** para conservar el dominio.

> **Importante**: Eliminar un dominio puede interrumpir las campañas de email activas que lo utilizan como remitente. Asegúrate de revisar todas las campañas en curso antes de eliminar el dominio.

<Aside type="note">
Si un dominio está configurado como la dirección "From" por defecto en cualquier proyecto, no puedes eliminarlo hasta que la información del remitente se actualice en esos proyectos. Aparecerá un mensaje de error, junto con una lista de proyectos que usan este dominio como remitente por defecto. Actualiza la dirección "From" en cada proyecto a un dominio verificado diferente, y luego intenta eliminar el dominio de nuevo.
</Aside>

##### Enviar un email de prueba

Desde la lista de dominios, también puedes enviar un email de prueba. Para ello, haz clic en el menú de tres puntos junto al dominio configurado y selecciona **Send Test Email**. Ten en cuenta que esta opción solo está disponible para dominios que han sido completamente configurados.

### Detalles del remitente por defecto

En esta sección, puedes ver y gestionar los detalles del remitente por defecto, incluyendo:

*   **From Address**: El nombre y la dirección de email que aparecerán como remitente en los emails.
*   **Reply-To Address**: El nombre y el email por defecto para las respuestas.

Para hacer cambios, haz clic en **Edit default sender details**.

> **Importante**: El canal de email no se configurará si no especificas los detalles del remitente por defecto, y aparecerá un mensaje de advertencia. Para establecer los detalles del remitente por defecto, haz clic en **Set sender details.**

### Seguimiento de URL de Google Analytics

En esta sección, puedes gestionar los ajustes de **Link Tracking**.

Cuando está habilitado, los parámetros UTM se añaden automáticamente a los enlaces de los emails, permitiéndote rastrear la interacción del usuario en Google Analytics. También verás una **Link Preview** que muestra cómo aparecerán tus URLs con las etiquetas UTM.

Para habilitar el seguimiento, cambia el interruptor a **Enable**.

## Configurar emails a través de la API de Pushwoosh

Para configurar la plataforma de Email a través de la API de Pushwoosh, envía la solicitud [`configureApplication`](/es/developer/api-reference/app-configuration#configureapplication-for-email).



## Configurar un dominio de seguimiento personalizado


El **Click Tracking Domain (CTD)** es la parte del dominio de una URL de enlace rastreada que se muestra en un mensaje de email. Combina un subdominio con tu dominio principal, por ejemplo, `click.tudominio.com`. El subdominio se crea en la configuración de DNS de tu dominio con tu proveedor de dominio, generalmente añadiendo un registro CNAME. Con un CTD, puedes envolver los enlaces de los emails para el seguimiento de clics en tu propio subdominio y mantener la entregabilidad y los enlaces profundos funcionando como se espera.

Para configurar un dominio de seguimiento personalizado:

1. Decide qué subdominio usarás como tu CTD (por ejemplo, `click.tudominio.com`).
2. En Pushwoosh, abre **Settings**, luego selecciona **Configure Platforms**.
3. En la página **Email channel configuration**, desplázate hasta **Custom tracking domain** y selecciona **Enable**.

<Aside type="note" >
La sección **Custom tracking domain** se muestra solo después de que el canal de email esté configurado para tu aplicación. Si no la ves, completa primero la [configuración de email](/es/product/first-steps/start-with-your-project/configure-platforms/email-verification/).
</Aside>

<img src="/integrations-appsflyer-esp2-email-integration-2.webp" alt="Panel de Control de Pushwoosh mostrando Ajustes, Configurar Plataformas, Configuración del canal de Email, y la tarjeta de Dominio de seguimiento personalizado con el control Habilitar."/>

4. Introduce tu CTD en el campo **Domain** y selecciona **Next**.

<img src="/integrations-appsflyer-esp2-email-integration-3.webp" alt="Diálogo para habilitar el dominio de seguimiento personalizado con el campo Dominio para introducir el CTD y los botones Cancelar y Siguiente."/>

5. Fuera de Pushwoosh, abre el servicio donde gestionas el DNS público para el dominio de tu CTD (normalmente tu registrador de dominios, un host de DNS o tu cuenta de hosting). En su editor de DNS o de zona para ese dominio, añade el **CNAME** que Pushwoosh muestra en este paso para que tu CTD apunte a `api.pushwoosh.com`.

<Aside type="note" title="Propagación de DNS">
Los cambios de DNS suelen tener efecto en minutos, pero pueden tardar hasta 48 horas.
</Aside>

6. En Pushwoosh, selecciona **Verify**.

<img src="/integrations-appsflyer-esp2-email-integration-4.webp" alt="Paso de verificación de DNS del dominio de seguimiento personalizado mostrando el destino CNAME api.pushwoosh.com y los controles Atrás, Verificar y Guardar."/>

7. Cuando la verificación sea exitosa, selecciona **Save**.
8. Si necesitas cambiar el **Domain** o el registro DNS, selecciona **Back** y ajusta los pasos anteriores.

9. Después de hacer clic en **Save**, tu CTD aparece en la lista de **Custom tracking domain** en **Email channel configuration**.

<img src="/integrations-appsflyer-esp2-email-integration-5.webp" alt="Configuración del canal de Email con la sección de Dominio de seguimiento personalizado mostrando el dominio de seguimiento de clics guardado en la lista."/>

Para deshabilitarlo más tarde, selecciona `...` junto a tu CTD, luego selecciona **Disable custom tracking domain**.