Entender la mensajería por correo electrónico

El canal Messages API Email de Vonage te permite enviar correos electrónicos usando la misma API unificada que ya usas para SMS, WhatsApp, RCS y otros canales de mensajería.

En esta página se explica cómo funciona el canal de correo electrónico, qué funciones admite y los conceptos clave que debes conocer antes de desarrollar aplicaciones con él.

El canal de correo electrónico se centra en los casos de uso del correo electrónico transaccional e incluye las siguientes funciones:

  • Correo electrónico saliente: texto sin formato y HTML
  • Webhooks de estado de entrega
  • Envíos regionales (UE, EE. UU., APAC)
  • Autenticación de dominios de autoservicio a través del panel de control del cliente
  • Enlace de dominio a la aplicación de Vonage a través del panel de control
  • Registros y análisis en el panel de control del cliente
  • Gestión de devoluciones y reclamaciones
  • Gestión de la lista de exclusión
  • Correos electrónicos entrantes a través de webhook
  • Direcciones IP dedicadas
  • Compatibilidad con CC y CCO

Cómo funciona el canal del correo electrónico

El correo electrónico es un canal nativo de la Messages API. Utiliza el mismo /v1/messages punto final, modelo de autenticación JWT y patrón de entrega de webhooks como SMS, WhatsApp y RCS.

Flujo de salida

Tu aplicación envía una solicitud mediante POST /v1/messages con el canal configurado para correo electrónico. El motor de correo electrónico de Vonage entrega el mensaje en el buzón del destinatario y envía actualizaciones sobre la entrega a la URL de estado que hayas configurado.

Flujo de entrada

Un remitente envía un correo electrónico a tu dominio verificado. El registro MX del dominio redirige el mensaje a Vonage, que identifica el dominio vinculado y envía el evento a la URL de entrada configurada en la aplicación de Vonage.

Integración del correo electrónico con la Messages API

El correo electrónico se integra como un nuevo canal dentro del modelo actual de la Messages API. No se introducen nuevos puntos finales básicos: se utilizan los mismos /v1/messages punto final que ya utilizas para otros canales.

Para enviar un correo electrónico, configura "channel": "email" en el cuerpo de la solicitud. La dirección message_type El campo acepta "text" para mensajes de texto sin formato y "html" para correos electrónicos HTML.

Incorporación de dominios mediante autoservicio

La autenticación del dominio se realiza de forma totalmente autónoma a través del panel de control de clientes de Vonage. Sigue estos pasos para preparar tu dominio para el envío de mensajes de correo electrónico:

  1. Añade tu dominio. En el panel de control del cliente, ve a Mensajes > Correo electrónico > Autenticación de dominio e introduce el dominio que quieras utilizar.
  2. Configura los registros DNS. Añade los registros SPF, DKIM y DMARC que te proporciona Vonage a través de tu proveedor de DNS.
  3. Espera a que se complete la verificación. La verificación del DNS puede tardar hasta 72 horas.
  4. Vincula el dominio verificado. Conecta el dominio a una aplicación de Vonage para habilitar el enrutamiento de webhooks y el correo electrónico entrante.

Siguiente paso: Ver Primeros pasos con el correo electrónico para consultar la guía completa de puesta en marcha y configuración.

Correo electrónico recibido

El canal de correo electrónico admite mensajes entrantes enviados a un dominio o subdominio verificado por Vonage. Vonage recibe el correo electrónico y lo envía a la aplicación de Vonage vinculada a través de la URL de entrada configurada.

Requisitos fundamentales:

  • Configura los registros DNS de entrada. Dirige el dominio o subdominio de entrada a los servidores de correo proporcionados por Vonage.
  • Asigna el dominio. Conecta el dominio verificado a una aplicación de Vonage.
  • Configura la URL de entrada. Configura el punto final de la aplicación que recibirá los eventos de correo electrónico entrantes.
  • Utiliza un subdominio específico. Un subdominio como reply.example.com ayuda a evitar que el enrutamiento entrante afecte al correo electrónico corporativo del dominio raíz.
  • Gestionar mensajes de varios dominios. Si un correo electrónico incluye destinatarios de varios dominios Verify, Vonage genera un evento por cada destinatario de un dominio Verify. Cada evento tiene un UUID de mensaje diferente, un CDR independiente y la matriz completa de destinatarios originales.

Registros y análisis

La sección «Registros y análisis» del panel de control de clientes de Vonage ofrece información en tiempo real sobre la actividad de envío y entrega de correos electrónicos.

Los clientes con acceso a la API de correo electrónico pueden utilizar el panel de control sin necesidad de configuración adicional para revisar la actividad de los mensajes, analizar los resultados de entrega y facilitar la resolución de problemas operativos.

Direcciones IP dedicadas

De forma predeterminada, los correos electrónicos se envían a través del grupo de direcciones IP compartidas de Vonage. Los remitentes con un volumen elevado de envíos que cuenten con planes que cumplan los requisitos pueden solicitar direcciones IP dedicadas para aislar la reputación del remitente y obtener un mayor control sobre la capacidad de entrega.

Aspectos clave a tener en cuenta:

  • Derechos del plan: El plan «Advanced» incluye una dirección IP dedicada en su versión de disponibilidad general.
  • Capacidad adicional: Se ofrecen direcciones IP adicionales por un importe único de 30 dólares por dirección IP.
  • Precalentamiento: Vonage no gestiona el proceso de precalentamiento de las direcciones IP, por lo que el cliente debe encargarse de precalentar las direcciones IP dedicadas.
  • Consistencia en el volumen: Las direcciones IP dedicadas requieren un volumen de envío estable para crear y mantener la reputación del remitente.

Casos de uso del correo electrónico

El canal de correo electrónico está diseñado para casos de uso transaccionales en los que un mensaje se activa a raíz de una acción del usuario o de un evento del sistema. Algunos ejemplos habituales son:

  • Confirmaciones de pedido y recibos: envíe un correo electrónico de confirmación inmediatamente después de una compra.
  • Restablecimiento de contraseña y verificación de Account: envía de forma fiable correos electrónicos de seguridad en los que el tiempo es un factor crucial.
  • Notificaciones de envío y entrega: mantén a los clientes informados en cada fase del proceso de tramitación del pedido.
  • Recordatorios de citas: reduce el número de ausencias con correos electrónicos automáticos de recordatorio
  • Alertas y notificaciones del sistema: avisa a los usuarios o a los equipos internos de eventos importantes en tiempo real.
  • OTP / Autenticación de dos factores: el correo electrónico como canal alternativo para Vonage Verify.
  • Seguimiento de respuestas y gestión de incidencias: utiliza el correo electrónico entrante para recibir las respuestas de los clientes a tus correos electrónicos automáticos.
  • Conmutación por error omnicanal: configura el correo electrónico como alternativa en caso de que WhatsApp o los SMS fallen, utilizando el modelo de conmutación por error de la Messages API.
  • Notificaciones de KYC y cumplimiento normativo: envía de forma fiable los documentos de verificación de identidad y los documentos reglamentarios.
  • Secuencias de bienvenida e incorporación: activa el envío automático de correos electrónicos de incorporación desde tu plataforma.

El correo electrónico como parte de tu estrategia omnicanal

Dado que el correo electrónico es un canal nativo dentro de la Messages API, puedes utilizarlo junto con SMS, WhatsApp y RCS a través de una API y un modelo de autenticación uniformes.

Ejemplo de flujo de trabajo de conmutación por error:

  1. Empieza por el canal que prefieras. Envía el mensaje inicial a través de WhatsApp.
  2. Recurre al correo electrónico. Si el mensaje de WhatsApp no se entrega dentro del plazo establecido, envía un correo electrónico.
  3. Utiliza el SMS como último recurso. Si el correo electrónico se devuelve, envía una notificación por SMS.

Este enfoque mantiene la coordinación de canales dentro de la Messages API y reduce la necesidad de mantener integraciones independientes con los distintos proveedores.

Más información