Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 31 additions & 9 deletions _i18n/en/integrations/set-up-email-sending.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
Set up an email sender to send messages from Hellotext using an address on your business domain, such as `support@acme.com`.

You will choose the sender name and address, add three records to your domain's DNS settings, and allow time for verification. Once the domain is verified, Hellotext activates the sender's Email channel.
You will choose the sender name and address, add three DKIM records and a DMARC record to your domain's DNS settings, and allow time for verification. Once the domain is verified, Hellotext activates the sender's Email channel.

This guide walks through the setup in Hellotext and the changes your domain administrator needs to make. It also explains how to reopen the DNS instructions, add another sender, and handle common setup problems.

Expand All @@ -21,7 +21,7 @@ Have the following ready:

Your DNS provider is the service that manages your domain's DNS records. It may be your domain registrar, a service such as Cloudflare, or a provider used by your website administrator. Buying a domain from one company does not necessarily mean that company still manages its DNS.

If someone else manages the domain, you can complete the sender form yourself and share the three DNS records with them. They can publish the records without signing in to Hellotext.
If someone else manages the domain, you can complete the sender form yourself and share the DNS records with them. They can publish the records without signing in to Hellotext.

### What happens to your existing mailbox?

Expand Down Expand Up @@ -79,25 +79,25 @@ The domain appears in the instructions on that page. Confirm that it matches the

If an error appears on the form, follow the message shown. An invalid address or missing sender name needs to be corrected before you can continue. Domain conflicts and registration errors are covered in the troubleshooting section below.

## 3. Add the three DNS records
## 3. Add the DNS records

The **Verify your sending domain** page displays three DNS records. Each record has a **Type**, **Name**, and **Value**.
The **Verify your sending domain** page displays three DKIM records and, below them, a **DMARC** record. Each record has a **Type**, **Name**, and **Value**.

These are DKIM records. DKIM helps receiving mail services verify that messages sent using your domain are authorized. Publishing the records is also how the sending service checks your control of the domain.
DKIM helps receiving mail services verify that messages sent using your domain are authorized. Publishing the DKIM records is also how the sending service checks your control of the domain.

### Match the fields in Hellotext to your DNS provider

DNS providers use different labels for the same fields. Use this mapping when creating each record:

| In Hellotext | Common label at your DNS provider | What to enter |
| --- | --- | --- |
| **Type** | Type or Record type | Choose **CNAME**. |
| **Type** | Type or Record type | Choose **CNAME** for the DKIM records and **TXT** for the DMARC record. |
| **Name** | Name, Host, or Hostname | Use the record name shown in Hellotext, accounting for whether your provider adds the domain automatically. |
| **Value** | Value, Target, Destination, or Points to | Copy the complete value shown for that same record. |

Create each record separately. Keep the name and value from the same record together; do not combine the three values into one entry.

### Publish the records
### Publish the DKIM records

1. Open your DNS provider in another browser tab and sign in.
2. Select the domain whose DNS records you need to manage.
Expand All @@ -124,9 +124,31 @@ The token in this example is illustrative. Always use your actual record name fr

Set these CNAME records to **DNS only**. Cloudflare's proxy is for web traffic and should not be enabled for email verification records. See [Cloudflare's proxy limitations](https://developers.cloudflare.com/dns/proxy-status/limitations/) and its [instructions for managing DNS records](https://developers.cloudflare.com/dns/manage-dns-records/how-to/create-dns-records/).

### Add the DMARC record

Below the DKIM records, the page shows a **DMARC** record:

| Type | Name | Value |
| --- | --- | --- |
| **TXT** | `_dmarc.` followed by your sending domain, such as `_dmarc.acme.com` | `v=DMARC1; p=reject;` |

Gmail and Yahoo require a DMARC record from domains that send bulk email, such as campaigns. Without one, your campaigns can land in spam or be rejected. DMARC also tells receiving mail services to reject messages that pretend to come from your domain.

Hellotext does not need the DMARC record to verify the sender, but publish it before you send campaigns.

1. In your DNS provider, add a new record and choose **TXT**.
2. Enter the **Name** shown in Hellotext. If your provider adds the domain automatically and you are editing the zone for `acme.com`, enter `_dmarc` for a sender on `acme.com`, or `_dmarc.mail` for a sender on `mail.acme.com`.
3. Enter the **Value** exactly as shown, without quotation marks unless your provider requires them.
4. Save the record.

Before you publish it, check the following:

- **The domain already has a DMARC record.** Look for an existing TXT record named `_dmarc` on the sending domain whose value starts with `v=DMARC1`. If one exists, keep it and do not add the Hellotext record: a domain with two DMARC records is treated as having none.
- **Other services send email from the same domain.** `p=reject` asks receiving mail services to reject any email from this domain that fails authentication. If your mailbox provider, invoicing system, or another tool also sends from this domain, confirm with your domain administrator that those services are authenticated before publishing. Using a subdomain dedicated to Hellotext, such as `mail.acme.com`, avoids affecting them.

### Preserve your other DNS records

Add the three records alongside your existing DNS configuration. The wizard does not ask you to replace your website records, change nameservers, or remove records used by your current email provider.
Add the Hellotext records alongside your existing DNS configuration. The wizard does not ask you to replace your website records, change nameservers, or remove records used by your current email provider.

If your provider reports that a record with the same name already exists, compare its type and target with the Hellotext instructions. An exact match may already be in place. If the target differs or you do not know what the existing record is for, ask your domain administrator before replacing it.

Expand Down Expand Up @@ -220,7 +242,7 @@ Open **Edit** for the saved sender, confirm the email address, and click **Next*
Check the following with the person who manages your DNS:

- You edited the active DNS provider for the domain shown in Hellotext.
- All three entries were saved as CNAME records.
- The three DKIM entries were saved as CNAME records.
- Each name is paired with the value from the same Hellotext record.
- The saved names match Hellotext's full names, including `_domainkey`.
- The provider did not append your domain twice.
Expand Down
2 changes: 2 additions & 0 deletions _i18n/en/numbers/email-channel-fundamentals.md
Original file line number Diff line number Diff line change
Expand Up @@ -242,6 +242,8 @@ Review the sender's name and address in **Settings > Integrations**. If you have

Confirm the exact recipient address and review whether the message has delivery information or a failure. Ask the customer to check their spam or junk folder as well as their usual inbox.

If your emails often land in spam, check that your sending domain has a DMARC record. See [Add the DMARC record]({% link _integrations/set-up-email-sending.md %}#add-the-dmarc-record).

If the email is still sending, give processing time to complete. If it failed, review the available reason, correct the destination or content when appropriate, and reduce images or simplify the design if its size prevents sending.

### The customer's reply does not appear
Expand Down
40 changes: 31 additions & 9 deletions _i18n/es/integrations/set-up-email-sending.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
Configura un remitente de correo para enviar mensajes desde Hellotext con una dirección del dominio de tu negocio, como `support@acme.com`.

Elegirás el nombre y la dirección del remitente, agregarás tres registros en la configuración DNS de tu dominio y esperarás a que se complete la verificación. Una vez verificado el dominio, Hellotext activa el canal de correo electrónico del remitente.
Elegirás el nombre y la dirección del remitente, agregarás tres registros DKIM y un registro DMARC en la configuración DNS de tu dominio y esperarás a que se complete la verificación. Una vez verificado el dominio, Hellotext activa el canal de correo electrónico del remitente.

Esta guía explica la configuración en Hellotext y los cambios que debe realizar quien administra tu dominio. También muestra cómo volver a consultar las instrucciones DNS, agregar otro remitente y resolver problemas habituales de configuración.

Expand All @@ -21,7 +21,7 @@ Ten preparado lo siguiente:

Tu proveedor de DNS es el servicio que administra los registros DNS de tu dominio. Puede ser la empresa donde registraste el dominio, un servicio como Cloudflare o un proveedor que utiliza quien administra tu sitio web. Haber comprado el dominio a una empresa no significa necesariamente que esa empresa siga administrando su DNS.

Si otra persona administra el dominio, puedes completar el formulario del remitente y compartir los tres registros DNS con ella. Podrá publicarlos sin iniciar sesión en Hellotext.
Si otra persona administra el dominio, puedes completar el formulario del remitente y compartir los registros DNS con ella. Podrá publicarlos sin iniciar sesión en Hellotext.

### ¿Qué pasa con tu casilla de correo actual?

Expand Down Expand Up @@ -79,25 +79,25 @@ El dominio aparece en las instrucciones de esa página. Confirma que coincida co

Si aparece un error en el formulario, sigue el mensaje que se muestra. Debes corregir una dirección inválida o completar el nombre del remitente antes de continuar. Los conflictos de dominio y los errores de registro se explican en la sección de solución de problemas más abajo.

## 3. Agrega los tres registros DNS
## 3. Agrega los registros DNS

La página **Verifica tu dominio de envío** muestra tres registros DNS. Cada registro tiene un **Tipo**, un **Nombre** y un **Valor**.
La página **Verifica tu dominio de envío** muestra tres registros DKIM y, debajo de ellos, un registro **DMARC**. Cada registro tiene un **Tipo**, un **Nombre** y un **Valor**.

Son registros DKIM. DKIM ayuda a los servicios de correo que reciben los mensajes a verificar que los envíos realizados con tu dominio estén autorizados. Publicar estos registros también permite al servicio de envío comprobar que controlas el dominio.
DKIM ayuda a los servicios de correo que reciben los mensajes a verificar que los envíos realizados con tu dominio estén autorizados. Publicar los registros DKIM también permite al servicio de envío comprobar que controlas el dominio.

### Relaciona los campos de Hellotext con los de tu proveedor de DNS

Los proveedores de DNS usan distintos nombres para los mismos campos. Usa esta tabla al crear cada registro:

| En Hellotext | Nombre habitual en tu proveedor de DNS | Qué ingresar |
| --- | --- | --- |
| **Tipo** | Tipo o Tipo de registro | Elige **CNAME**. |
| **Tipo** | Tipo o Tipo de registro | Elige **CNAME** para los registros DKIM y **TXT** para el registro DMARC. |
| **Nombre** | Nombre, Host o Nombre de host | Usa el nombre del registro que muestra Hellotext, teniendo en cuenta si tu proveedor agrega el dominio automáticamente. |
| **Valor** | Valor, Destino o Apunta a | Copia el valor completo que aparece para ese mismo registro. |

Crea cada registro por separado. Mantén juntos el nombre y el valor de cada registro; no combines los tres valores en una sola entrada.

### Publica los registros
### Publica los registros DKIM

1. Abre tu proveedor de DNS en otra pestaña del navegador e inicia sesión.
2. Selecciona el dominio cuyos registros DNS necesitas administrar.
Expand All @@ -124,9 +124,31 @@ El token de este ejemplo es ilustrativo. Usa siempre el nombre real del registro

Configura estos registros CNAME como **Solo DNS (DNS only)**. El proxy de Cloudflare está destinado al tráfico web y no debe estar habilitado para los registros de verificación de correo. Consulta las [limitaciones del proxy de Cloudflare](https://developers.cloudflare.com/dns/proxy-status/limitations/) y sus [instrucciones para administrar registros DNS](https://developers.cloudflare.com/dns/manage-dns-records/how-to/create-dns-records/).

### Agrega el registro DMARC

Debajo de los registros DKIM, la página muestra un registro **DMARC**:

| Tipo | Nombre | Valor |
| --- | --- | --- |
| **TXT** | `_dmarc.` seguido de tu dominio de envío, como `_dmarc.acme.com` | `v=DMARC1; p=reject;` |

Gmail y Yahoo exigen un registro DMARC a los dominios que hacen envíos masivos, como las campañas. Sin él, tus campañas pueden llegar a spam o ser rechazadas. DMARC también indica a los servicios de correo que rechacen los mensajes que se hacen pasar por tu dominio.

Hellotext no necesita el registro DMARC para verificar el remitente, pero publícalo antes de enviar campañas.

1. En tu proveedor de DNS, agrega un registro nuevo y elige **TXT**.
2. Ingresa el **Nombre** que muestra Hellotext. Si tu proveedor agrega el dominio automáticamente y estás editando la zona DNS de `acme.com`, ingresa `_dmarc` para un remitente de `acme.com`, o `_dmarc.mail` para un remitente de `mail.acme.com`.
3. Ingresa el **Valor** tal como aparece, sin comillas, salvo que tu proveedor las exija.
4. Guarda el registro.

Antes de publicarlo, revisa lo siguiente:

- **El dominio ya tiene un registro DMARC.** Busca un registro TXT llamado `_dmarc` en el dominio de envío cuyo valor comience con `v=DMARC1`. Si existe, mantenlo y no agregues el de Hellotext: un dominio con dos registros DMARC se trata como si no tuviera ninguno.
- **Otros servicios envían correos desde el mismo dominio.** `p=reject` pide a los servicios de correo que rechacen cualquier correo de este dominio que no supere la autenticación. Si tu proveedor de correo, tu sistema de facturación u otra herramienta también envían desde este dominio, confirma con quien administra tu dominio que esos servicios estén autenticados antes de publicarlo. Usar un subdominio exclusivo para Hellotext, como `mail.acme.com`, evita afectarlos.

### Conserva tus otros registros DNS

Agrega los tres registros junto a tu configuración DNS existente. El asistente no te pide reemplazar los registros de tu sitio web, cambiar los servidores de nombres ni eliminar registros que utiliza tu proveedor de correo actual.
Agrega los registros de Hellotext junto a tu configuración DNS existente. El asistente no te pide reemplazar los registros de tu sitio web, cambiar los servidores de nombres ni eliminar registros que utiliza tu proveedor de correo actual.

Si tu proveedor indica que ya existe un registro con el mismo nombre, compara su tipo y destino con las instrucciones de Hellotext. Es posible que ya exista un registro que coincida exactamente. Si el destino es distinto o no sabes para qué se usa el registro existente, consulta a quien administra tu dominio antes de reemplazarlo.

Expand Down Expand Up @@ -220,7 +242,7 @@ Abre **Editar** en el remitente guardado, confirma la dirección de correo y haz
Revisa lo siguiente con quien administra tu DNS:

- Editaste el proveedor de DNS activo para el dominio que muestra Hellotext.
- Las tres entradas se guardaron como registros CNAME.
- Las tres entradas DKIM se guardaron como registros CNAME.
- Cada nombre está asociado al valor del mismo registro de Hellotext.
- Los nombres guardados coinciden con los nombres completos de Hellotext, incluida la parte `_domainkey`.
- El proveedor no agregó el dominio dos veces.
Expand Down
2 changes: 2 additions & 0 deletions _i18n/es/numbers/email-channel-fundamentals.md
Original file line number Diff line number Diff line change
Expand Up @@ -242,6 +242,8 @@ Revisa el nombre y la dirección del remitente en **Ajustes > Integraciones**. S

Confirma la dirección exacta del destinatario y revisa si el mensaje tiene información de entrega o un fallo. Pide al cliente que revise la carpeta de spam o correo no deseado, además de su bandeja de entrada habitual.

Si tus correos suelen llegar a spam, comprueba que tu dominio de envío tenga un registro DMARC. Consulta [Agrega el registro DMARC]({% link _integrations/set-up-email-sending.md %}#agrega-el-registro-dmarc).

Si el correo todavía se está enviando, espera a que termine el procesamiento. Si falló, revisa el motivo disponible, corrige el destino o el contenido cuando corresponda y reduce las imágenes o simplifica el diseño si el tamaño impide el envío.

### La respuesta del cliente no aparece
Expand Down
Loading