Primeros pasos con el correo electrónico

La Messages API de Vonage admite el correo electrónico como canal, lo que te permite enviar correos electrónicos transaccionales utilizando el mismo contrato de API que ya utilizas para otros canales de mensajería.

El canal Email se encuentra actualmente en fase Beta. Durante esta fase, la incorporación será gestionada por su Account Manager.

Requisitos previos

Antes de empezar, asegúrate de que tienes:

  • A Account de la API de Vonage
  • Tu clave API y tu secreto API del panel de control de la API de Vonage
  • Un dominio de envío que puedes gestionar en el DNS
  • Acceso beta al canal de correo electrónico

Incorporación por correo electrónico

Para empezar a utilizar la API de correo electrónico:

  1. Proporcione la siguiente información a su Account Manager:
    • Tu clave API de Vonage
    • Los dominios personalizados que tienes previsto utilizar para el envío (por ejemplo, yourdomain.com)
    • Tu región preferida para la verificación del dominio (US, EU, o APAC)
  2. Tu gestor de cuenta transmite esta información al equipo interno para iniciar el proceso de incorporación.
  3. Vonage te proporciona los registros DNS que debes añadir a tu dominio. Consulta Configuración de la autenticación de dominio.
  4. Una vez actualizado el DNS, confirma que el proceso se ha completado con tu gestor de cuentas. La verificación del DNS puede tardar hasta 72 horas.
  5. Añade los registros DNS lo antes posible. Si la propagación tarda más de lo previsto, abre un ticket de asistencia o ponte en contacto con tu gestor de cuentas.
  6. Una vez que la verificación se haya completado con éxito, Vonage lo notificará a tu gestor de cuentas y podrás empezar a enviar correos electrónicos mediante la Messages API.

Durante la fase beta, un dominio solo se puede verificar en una región. Elige la región más cercana a tus usuarios o a tu infraestructura.

Configuración de la autenticación de dominio

Antes de poder enviar correos electrónicos, debes autenticar tu dominio de envío. La autenticación del dominio mejora la capacidad de entrega y permite a los proveedores de buzones de correo verificar que Vonage está autorizado a enviar en tu nombre.

La autenticación se completa añadiendo registros DNS a tu dominio. Estos registros permiten:

  • SPF (Sender Policy Framework) para autorizar la infraestructura de envío de Vonage.
  • DKIM (DomainKeys Identified Mail) para firmar criptográficamente el contenido de los correos electrónicos salientes.
  • DMARC (Autenticación, generación de informes y conformidad de mensajes basados en el dominio) para definir la política y la generación de informes en caso de fallos de autenticación.

Los principales proveedores de correo electrónico, entre ellos Google, Microsoft y Yahoo, se basan en estas normas a la hora de decidir si entregan, rechazan o filtran los mensajes.

Para más información, consulta Factores que influyen en la capacidad de entrega de tus correos electrónicos.

Registros DNS que hay que configurar

Vonage proporciona los valores exactos durante el proceso de incorporación. La tabla siguiente muestra la estructura prevista de los registros:

Propósito Tipo Anfitrión / Clave Valor Descripción
AUTH CNAME <dkim_key_1>._domainkey.<your_domain> <dkim_value_1>._domainkey.xxxx.com Clave DKIM 1
AUTH CNAME <dkim_key_2>._domainkey.<your_domain> <dkim_value_2>._domainkey.xxxx.com Clave DKIM 2
AUTH CNAME <dkim_key_3>._domainkey.<your_domain> <dkim_value_3>._domainkey.xxxx.com Clave DKIM 3
SEND TXT _dmarc.<your_domain> v=DMARC1; p=none; Política DMARC
SEND TXT <your_domain> v=spf1 include:msg.vonage.com ~all Política de SPF

Prácticas recomendadas en materia de autenticación

  • Configura todos los registros DKIM proporcionados por Vonage para cada dominio de envío.
  • Empieza con DMARC p=none durante la fase de seguimiento, y luego aplicar políticas más estrictas cuando esté todo listo.
  • Añade Vonage a tu registro SPF utilizando include:msg.vonage.com.
  • Si ya tienes un registro SPF, añade la inclusión de Vonage en lugar de sustituir las entradas existentes.

Ejemplo:

  • SPF actual: v=spf1 include:example.com ~all
  • FPS actualizado: v=spf1 include:example.com include:msg.vonage.com ~all

Opciones avanzadas de DNS

  • Haz clic y abre el DNS de seguimiento: Vonage puede proporcionar registros CNAME adicionales para la configuración del seguimiento.
  • Personalizado mail from / ruta de retorno: Vonage admite la configuración personalizada de la ruta de retorno y puede proporcionar registros MX y TXT adicionales.

Si necesitas estas opciones avanzadas durante el proceso de incorporación, pregúntale a tu Account Manager.

Envíe su primer correo electrónico

Una vez verificado tu dominio, ya podrás enviar mensajes de correo electrónico mediante la Messages API.

Crear una aplicación de Vonage (opcional)

Para utilizar la Messages API, necesitas una aplicación de Vonage que tenga habilitada la función de mensajes.

  1. Ir a Crear una aplicación en el panel de control de Vonage.
  2. Introduce el nombre de la aplicación.
  3. Haz clic Generar clave pública y privada y guarda la clave privada de forma segura.
  4. En Capacidadesactivar Mensajes.
  5. Configura tus webhooks de URL de entrada y URL de estado.
  6. Haz clic Generar nueva aplicación.

Para más información, consulte Crear una aplicación de Vonage.

Establece tus valores sustituibles

Utiliza las siguientes variables en los ejemplos y sustitúyelas por tus propios valores:

Variable Descripción
VONAGE_API_KEY Tu clave API de Vonage, que encontrarás en el panel de control de la API.
VONAGE_API_SECRET Tu clave secreta de la API de Vonage.
VONAGE_APPLICATION_ID Tu ID de solicitud de Vonage.
VONAGE_PRIVATE_KEY Ruta de acceso al archivo de tu clave privada.
FROM_EMAIL Tu dirección de correo electrónico de remitente verificada.
TO_EMAIL Dirección de correo electrónico del destinatario.
EMAIL_SUBJECT Asunto del correo electrónico.

Generar un JWT

La Messages API utiliza la autenticación JWT. Genera un JWT utilizando tu ID de aplicación y tu clave privada antes de llamar a la API.

Enviar un mensaje de texto

{
   "channel": "email",
   "from": "sender@example.com",
   "to": "recipient@example.com",
   "message_type": "text",
   "text": "Email body text",
   "email": {
      "subject": "Email subject"
   }
}

Si la operación se realiza correctamente, la respuesta de la API contiene message_uuid:

{
   "message_uuid": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab"
}

Enviar un correo electrónico HTML

{
   "channel": "email",
   "from": "sender@example.com",
   "to": "recipient@example.com",
   "message_type": "html",
   "html": {
      "body": "<p>Email body html</p>"
   },
   "email": {
      "subject": "Email subject"
   }
}

Límites de tamaño de los correos electrónicos

El cuerpo del correo electrónico admite un máximo de 100 KB por solicitud de API. Si el cuerpo supera este límite, la solicitud devuelve un error.

La Messages API también impone un límite de carga útil a nivel de red de 200 KB.

Comprobar el estado de la entrega

Tras enviar un correo electrónico, Vonage envía actualizaciones sobre el estado del mensaje a la URL de estado que hayas configurado.

Estado Descripción
submitted El correo electrónico se ha aceptado y se ha puesto en cola para su envío.
delivered El correo electrónico se ha entregado en el buzón del destinatario.
read El destinatario ha abierto el correo electrónico.
rejected No se ha podido entregar el correo electrónico. Consulta los detalles del error.

Factores que influyen en la capacidad de entrega de tus correos electrónicos

La capacidad de entrega del correo electrónico es la capacidad que tiene un mensaje de correo electrónico para llegar a la bandeja de entrada del destinatario.

Delivery y deliverability son diferentes:

  • La entrega significa que el servidor de correo receptor ha aceptado el mensaje.
  • La capacidad de entrega se refiere a que el mensaje llegue a la bandeja de entrada en lugar de acabar en la carpeta de correo no deseado o ser rechazado.

Modelo de responsabilidad compartida

La entrega de los correos electrónicos es una responsabilidad compartida entre Vonage y el cliente.

Responsabilidades de Vonage Responsabilidades del cliente
Infraestructura fiable para el envío de correos electrónicos Envío de correos electrónicos relevantes y esperados
Plataforma de alta disponibilidad Mantenimiento de las listas de destinatarios
Procesamiento de mensajes Autenticación de los dominios de origen
Gestión de devoluciones y reclamaciones Seguir las buenas prácticas en el uso del correo electrónico
Gestión de la lista de exclusión Seguimiento de las métricas de interacción

1. Autenticación de dominio

La autenticación del dominio es uno de los factores más importantes para la entregabilidad.

  • DKIM firma el contenido del mensaje.
  • DMARC define la política de gestión de los errores de autenticación.
  • SPF autoriza a los remitentes autorizados.

Estas normas ayudan a los proveedores de correo electrónico a verificar la identidad del remitente y la integridad de los mensajes.

2. Reputación del remitente

Los proveedores de correo electrónico evalúan continuamente la reputación de los dominios y las direcciones IP.

Una mala reputación puede dar lugar a:

  • Colocación en la carpeta de spam
  • Limitación temporal
  • Rechazo de un mensaje
  • Menor posicionamiento en la bandeja de entrada

La reputación se ve influida por las quejas por spam, las tasas de rebote, la regularidad en el envío, la interacción de los usuarios y la calidad de los mensajes.

Buenas prácticas:

  • Envía tus mensajes únicamente a destinatarios que los esperen.
  • Evita los picos repentinos en el volumen de envíos.
  • Elimina periódicamente a los destinatarios inactivos.
  • Supervisa las tasas de rebote y de reclamaciones.

3. Calidad del contenido de los correos electrónicos

Los proveedores de servicios de correo electrónico también evalúan la calidad del contenido de los mensajes.

Los enlaces rotos, los archivos adjuntos sospechosos, el contenido que consta exclusivamente de imágenes o los mensajes con un tamaño excesivo pueden afectar negativamente a la capacidad de entrega.

Buenas prácticas:

  • Utiliza dominios de confianza en los enlaces.
  • Asegúrate de que el contenido del mensaje sea claro, relevante y esté bien estructurado.
  • Mantén un equilibrio adecuado entre el texto y las imágenes.
  • Comprueba que los archivos adjuntos sean válidos y que el tamaño de la carga útil se mantenga dentro de los límites permitidos.

4. Participación de los destinatarios

Los proveedores de correo electrónico utilizan las señales de interacción de los destinatarios para determinar la ubicación en la bandeja de entrada.

Entre las señales positivas se incluyen las aperturas, los clics, las respuestas y el traslado de mensajes de la carpeta de spam a la bandeja de entrada. Entre las señales negativas se incluyen las quejas, la eliminación inmediata y la inactividad prolongada.

Un mayor nivel de interacción suele mejorar la reputación del remitente.

5. Gestión de rebotes

Los rebotes duros y los rebotes blandos afectan de forma diferente a la reputación del remitente.

  • Rechazo definitivo: error permanente (por ejemplo, dirección no válida o destinatario inexistente).
  • Rechazo blando: error temporal (por ejemplo, buzón lleno o problema temporal del servidor).

Vonage procesa automáticamente los mensajes devueltos y gestiona la supresión para reducir los intentos repetidos de entrega a destinatarios a los que no es posible enviarles mensajes de forma permanente.

6. Quejas por spam

Las quejas por spam se encuentran entre las señales negativas más importantes que utilizan los proveedores de correo electrónico para evaluar la confianza.

Las elevadas tasas de reclamaciones pueden provocar:

  • Menor posicionamiento en la bandeja de entrada
  • Bloqueos temporales
  • Daño permanente a la reputación

Buenas prácticas:

  • Envía el mensaje únicamente a los usuarios que hayan dado su consentimiento.
  • Identifica claramente tu organización.
  • Haz que la opción para darse de baja sea fácil y visible.
  • Responde sin demora a las solicitudes de baja.

Vonage procesa los casos de spam y bloquea el reenvío a los destinatarios afectados.

7. Calidad de los anuncios

Las listas de destinatarios obsoletas, no válidas o compradas reducen considerablemente la capacidad de entrega.

Aumenta la mala calidad de las listas:

  • Rebotes definitivos
  • Quejas por correo basura
  • Bajas

Buenas prácticas:

  • Recopila direcciones mediante procesos de suscripción válidos.
  • Elimina rápidamente los destinatarios no válidos.
  • Elimina periódicamente los destinatarios inactivos.
  • Nunca compres listas de direcciones de correo electrónico.

Precios por correo electrónico

Las tarifas de la API de correo electrónico se basan en una suscripción y están disponibles en varios niveles. Cada nivel incluye un número fijo de correos electrónicos, y se aplican recargos por cada correo electrónico adicional.

Para obtener información actualizada sobre los precios, ponte en contacto con tu gestor de cuentas.

Más información