Configurar la integración con SendGrid

Esta guía explica cómo conectar SendGrid con OneChat para enviar y recibir correos electrónicos desde Live Chat. Crearás una API Key de SendGrid, autenticarás el dominio de envío, conectarás OneChat y configurarás Inbound Parse para que las respuestas regresen a OneChat.

Lo que necesitarás

En OneChat, abre **Integraciones -> Email Marketing -> SendGrid**. La pantalla de integración solicita cuatro datos:

• **API Key**
• **Nombre del remitente** (Sender Name)
• **Correo del remitente** (Sender Email)
• **Dominio de recepción** (Receiving Domain)

También encontrarás el campo opcional **Forward to url**, que reenvía los registros del webhook a la URL indicada, y la pestaña **Webhook Logs**.

TODO_IMAGE[image-20260802-165113.png]: revisar imagen desde Confluence.

Ruta: OneChat -> Integraciones -> Email Marketing -> SendGrid.

Parte 1 - Crear la API Key en SendGrid

Paso 1

En SendGrid, ve a **Settings -> API Keys** y haz clic en **Create API Key**.

TODO_IMAGE[image-20260802-165133.png]: revisar imagen desde Confluence.

Ruta: Settings -> API Keys -> Create API Key.

Paso 2

Asigna un nombre a la clave y selecciona el nivel de acceso. Las opciones son **Full Access**, **Custom Access** y **Billing Access**. Para el correo bidireccional, elige **Full Access**, ya que concede el permiso Mail Send que necesita OneChat. Si prefieres restringir la clave, selecciona Custom Access y concede acceso completo a **Mail Send**.

TODO_IMAGE[image-20260802-165151.png]: revisar imagen desde Confluence.

Creación de la API Key. Se recomienda Full Access para el correo bidireccional.

Paso 3

Haz clic en **Create & View**. SendGrid muestra la clave una sola vez. Cópiala y guárdala en un lugar seguro; luego la pegarás en OneChat.

Parte 2 - Autenticar el dominio de envío

Abre **Settings -> Sender Authentication**. Puedes autenticar un dominio completo, opción recomendada e identificada como **RECOMMENDED**, o verificar una única dirección de remitente.

TODO_IMAGE[image-20260802-165207.png]: revisar imagen desde Confluence.

Ruta: Settings -> Sender Authentication.

Autenticación del dominio

#### Paso 1

En Domain Authentication, haz clic en **Get Started**. Selecciona tu proveedor de DNS, decide si deseas usar enlaces con tu marca y haz clic en **Next**.

TODO_IMAGE[image-20260802-165226.png]: revisar imagen desde Confluence.

Selecciona el proveedor de DNS y la opción de enlaces con marca; luego continúa con Next.

#### Paso 2

Escribe el dominio desde el cual enviarás los correos y haz clic en **Next**.

TODO_IMAGE[image-20260802-165241.png]: revisar imagen desde Confluence.

Ejemplo de dominio de envío: acelerador.pro.

#### Paso 3

SendGrid muestra los registros DNS que debes instalar. La pantalla tiene tres pestañas: **Automatic Setup**, **Manual Setup** y **Send To A Coworker**. El conjunto incluye tres registros CNAME y un registro TXT de DMARC con el host _dmarc y el valor v=DMARC1; p=none;.

TODO_IMAGE[image-20260802-165254.png]: revisar imagen desde Confluence.

Pantalla para instalar los registros DNS.

TODO_IMAGE[image-20260802-165306.png]: revisar imagen desde Confluence.

Conjunto completo de registros, incluido el TXT de DMARC.

#### Paso 4

Agrega todos los registros en tu proveedor de DNS.

**En Cloudflare:** configura los tres registros CNAME como **DNS only** (nube gris). Si están enviados a través del proxy (nube naranja), la verificación fallará. Agrega también el registro TXT de DMARC.

TODO_IMAGE[image-20260802-165320.png]: revisar imagen desde Confluence.

Registros de SendGrid en Cloudflare configurados como DNS only.

#### Paso 5

Vuelve a SendGrid, marca **I've added these records** y haz clic en **Verify**. Cuando la validación termine correctamente, verás la pantalla de confirmación.

TODO_IMAGE[image-20260802-165334.png]: revisar imagen desde Confluence.

Confirmación de que el dominio autenticado fue verificado.

Verificación de un único remitente (alternativa)

Si prefieres no autenticar un dominio completo, verifica una sola dirección: haz clic en **Verify an Address -> Create New Sender** y completa los datos.

**Ten en cuenta:** si el dominio ya está autenticado, cualquier dirección de remitente de ese dominio se verifica automáticamente. SendGrid indicará que el remitente fue verificado porque coincide con un dominio autenticado.

TODO_IMAGE[image-20260802-165348.png]: revisar imagen desde Confluence.

Un remitente del dominio autenticado se verifica automáticamente.

Parte 3 - Conectar OneChat con SendGrid

Paso 1

Regresa a la pantalla de SendGrid en OneChat, completa **API Key**, **Sender Name**, **Sender Email** con una dirección del dominio autenticado y **Receiving Domain**. Luego haz clic en **Save**.

TODO_IMAGE[image-20260802-165402.png]: revisar imagen desde Confluence.

Paso 2

Cuando la integración sea válida, OneChat mostrará el estado **Verified** y generará una **Webhook URL**. En el siguiente paso pegarás esa URL en Inbound Parse de SendGrid. Mantén privada la URL del webhook.

TODO_IMAGE[image-20260802-165413.png]: revisar imagen desde Confluence.

Estado Verified y Webhook URL generada después de guardar. La URL está oculta por seguridad.

Parte 4 - Configurar Inbound Parse para recibir respuestas

Paso 1

En SendGrid, abre **Settings -> Inbound Parse** y haz clic en **Add Host & URL**.

TODO_IMAGE[image-20260802-165428.png]: revisar imagen desde Confluence.

Ruta: Settings -> Inbound Parse -> Add Host & URL.

Paso 2

Completa **Receiving Domain**, compuesto por un **Subdomain** y tu **Domain** autenticado; solo se pueden usar dominios autenticados. Pega la **Webhook URL** de OneChat en **Destination URL**. Se recomienda activar las opciones de revisión de spam y **POST the raw, full MIME message**.

TODO_IMAGE[image-20260802-165444.png]: revisar imagen desde Confluence.

Configuración de Add Host & URL con el subdominio, el dominio, la URL de destino y las dos opciones recomendadas.

**Importante:** utiliza un subdominio dedicado, por ejemplo parse.tudominio.com, y no los registros de correo del dominio principal. Para recibir correos, el subdominio necesita un registro MX que apunte a mx.sendgrid.net con prioridad 10. OneChat incluye este subdominio en el campo Reply-To de cada correo enviado desde Live Chat; así, las respuestas de los clientes llegan a Inbound Parse.

TODO_IMAGE[image-20260802-165509.png]: revisar imagen desde Confluence.

Host de Inbound Parse agregado con Spam Check y Send Raw activados. La URL del webhook está oculta por seguridad.

Agrega en tu proveedor de DNS un registro MX para el subdominio de recepción que apunte a mx.sendgrid.net.

Paso 3

Regresa a OneChat y haz clic nuevamente en **Save** para aplicar todos los cambios. La configuración del correo bidireccional habrá terminado. Continúa con el artículo complementario **SendGrid: sincronización bidireccional de correo**.

Recorrido en video:

TODO_VIDEO[2cf1bc7110]: reemplazar este video con un recurso oficial de OneChat.