La API de correo electrónico de Vonage ya está disponible en fase beta abierta

Nos complace anunciar que la API de correo electrónico de Vonage ya está en fase beta abierta, y está disponible para todos los clientes de servicios gestionados como un canal dentro de la Messages API de Vonage.

Los desarrolladores ya no necesitan recurrir a un proveedor externo para integrar otros canales de mensajería, como SMS, WhatsApp o Viber, con el envío de correos electrónicos. Como solo se trata de añadir otro canal, puedes utilizarlo con la misma autenticación y los mismos webhooks que ya tienes configurados en tu aplicación de la Messages API. ¡Genial!

Con este anuncio, vamos a ver qué funciones están disponibles y cómo realizar tu primera llamada a la API para probarla.

Primeros pasos

Antes de poder empezar a utilizar el correo electrónico, tendrás que completar la configuración de la autenticación del dominio. Puedes leer cómo hacerlo, pero en resumen: añadir y configurar los registros DNS de tu proveedor permite que los servicios sepan que Vonage tiene permiso para enviar mensajes en tu nombre. Una vez hecho esto, tendrás que configurar tu autenticación con Vonage, y ahora te guiaremos paso a paso en el proceso.

Autenticación de Vonage

Security FirstSi aún no dispones de un mecanismo de autenticación, tendrás que configurarlo. En primer lugar, crea una nueva aplicación de Vonage en el panel de control y descarga tu clave privada:

La autenticación de Vonage requerirá un token JWT ; puedes crear un JWT de Vonage utilizando la CLI de Vonage. Para instalarla, necesitarás tener instalado Node.js, de modo que puedas utilizar un gestor de paquetes como npm o yarn. Una vez que tengas Node, instala la CLI de Vonage de forma global:

npm install -g @vonage/cli

A continuación, en el mismo directorio donde tienes el archivo descargado private.key, utiliza tu application_id para generar un JWT:

vonage jwt create --app_id <your_app_id> --private-key ./private.key

La CLI te devolverá un token JWT que podrás utilizar.

Envía tu primer correo electrónico

Necesitarás cURL instalado (que suele venir incluido en la mayoría de los sistemas operativos). Desde la línea de comandos, pega este comando de cURL y sustituye el $JWT por la que acabas de crear.

curl -X POST https://api-eu.nexmo.com/v1/messages \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "from": "sender@yourdomain.com",
    "to": "recipient@example.com",
    "message_type": "text",
    "text": "Hello! Your order has been confirmed.",
    "email": {
      "subject": "Order Confirmation"
    }
  }'

Esto enviará un correo electrónico de texto sin formato, pero el campo «message_type» también te permite enviar HTML; por ejemplo:

curl -X POST https://api-eu.nexmo.com/v1/messages \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "from": "sender@yourdomain.com",
    "to": "recipient@example.com",
    "message_type": "html",
    "html": {
      "body": "<h1>Order Confirmed</h1><p>Thank you for your purchase. Your order is on its way!</p>"
    },
    "email": {
      "subject": "Order Confirmation"
    }
  }'

Una característica muy útil es que puedes anidar ambos tipos de contenido utilizando la etiqueta tipo de mensaje , lo que permite disponer de soluciones alternativas de compatibilidad para distintos dispositivos finales:

curl -X POST https://api-eu.nexmo.com/v1/messages \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "from": "Your Brand <sender@yourdomain.com>",
    "to": "recipient@example.com",
    "message_type": "content",
    "content": [
      { "type": "text", "text": "Your order has been confirmed." },
      { "type": "html", "body": "<p>Your order has been <strong>confirmed</strong>.</p>" }
    ],
    "email": {
      "subject": "Order Confirmation"
    }
  }'

Una vez enviado el mensaje a la API, deberías recibir una 202 respuesta con un message_uuid, igual que ocurriría con otros canales.

Configuración de webhooks

Los webhooks te permitirán recibir notificaciones: hay cinco estados de entrega que coinciden con los de los demás canales: delivered, rejected, undeliverable, read, y submitted. Necesitarás un marco de trabajo de back-end para poder leer los mensajes entrantes, lo cual no es el objetivo de este anuncio, pero una característica bastante interesante es que, si instalas ngrok, puedes utilizar la CLI de Vonage como envoltorio para que sustituya temporalmente tu dominio local para las entregas de Webhooks de la aplicación (estas son las que puedes ver en el panel «Aplicación» del panel de control) por una dirección local de ngrok más la ruta que hayas indicado. Por ejemplo, si los eventos de la aplicación están configurados para ser http:///example.com/webhooks/status, y ejecutas el comando para abrir tu túnel con la CLI:

vonage tunnel ngrok "<your-application-id>" --port=8000

Se iniciará ngrok y cambiará tu dominio local a algo como https://sa9s8d.ngrok.app/webhooks/status. Es muy útil a la hora de probar tu integración. Una notificación de estado entrante tendrá un aspecto similar a este:

{
  "message_uuid": "aaaaaaaa-bbbb-4ccc-8ddd-0123456789ab",
  "from": "sender@yourdomain.com",
  "to": "recipient@example.com",
  "timestamp": "2026-06-01T10:00:01.000Z",
  "status": "delivered",
  "channel": "email"
}

Características y casos de uso

Campañas

Anteriormente, si querías llevar a cabo una campaña de marketing que utilizara tanto SMS (con algo como 10DLC) y correo electrónico, necesitabas un servicio de correo electrónico independiente. Ahora, si tienes una campaña de marketing que utiliza varios métodos de envío, puedes utilizar la Messages API de Vonage para ampliarla al tamaño que necesites.

Seguimiento

En mercados verticales como la logística o el comercio electrónico, lo habitual es enviar solicitudes de confirmación o confirmaciones de entrega por correo electrónico, en lugar de a través de otros canales de comunicación. La incorporación del correo electrónico como canal permite ahora hacerlo.

Autenticación y seguridad

El canal de correo electrónico se utiliza en nuestra Verify API cuando es necesario enviar una contraseña de un solo uso (OTP) (y también puede utilizarse junto con otros canales, como SMS o WhatsApp). Ten en cuenta que esta también es una función en fase beta. No obstante, con el canal de correo electrónico de la Messages API, también puedes integrar los mensajes en tu propio sistema de autenticación, por ejemplo, para enviar correos electrónicos de verificación de cuenta o restablecimientos de contraseña.

Soluciones alternativas

«Mensajes» ya cuenta con una función alternativa para el envío, por lo que la incorporación del correo electrónico como canal adicional te permite ahora intentar completar el envío de información esencial a través de múltiples vías para garantizar una mejor confirmación de la recepción. Ya he mencionado que el comercio electrónico es un mercado vertical típico en el que se utilizaría el correo electrónico, por lo que a continuación se muestra un ejemplo de cuándo se desea enviar una confirmación de compra a través de WhatsApp (porque el usuario final lo ha especificado como método de comunicación preferido), pero la entrega no se puede completar (el usuario final ha realizado el pedido en un territorio no compatible o no hay cobertura móvil) y, por lo tanto, la confirmación se envía por correo electrónico:

{
  "template": {
    "name": "order_confirmation",
    "parameters": [{ "type": "text", "text": "ORD-12345" }]
  },
  "workflow": [
    {
      "channel": "whatsapp",
      "from": "15551234567",
      "to": "15559876543"
    },
    {
      "channel": "email",
      "from": "orders@yourdomain.com",
      "to": "customer@example.com",
      "message_type": "html",
      "html": { "body": "<p>Your order ORD-12345 is confirmed!</p>" },
      "email": { "subject": "Order Confirmation - ORD-12345" }
    }
  ]
}

Próximamente

El lanzamiento de esta versión como beta abierta es solo el principio; tenemos muchas funciones previstas en nuestra hoja de ruta antes de que llegue a la disponibilidad general (GA):

• Tercer trimestre de 2026 (GA): Asistencia por correo electrónico entrante, compatibilidad con archivos adjuntos, direcciones IP dedicadas, alta autónoma a través del Panel de control del cliente, integración con Verify (correo electrónico como alternativa para la contraseña de un solo uso)

• 4.º trimestre de 2026: Plantillas de correo electrónico dinámicas, personalización y etiquetas dinámicas, integración con Conversation Connect (interfaz de usuario del gestor de campañas)

• 2027+: Análisis avanzado, pruebas A/B, gestión de contactos y automatización completa del marketing

Conclusión

Tanto si envías confirmaciones de pedidos o códigos OTP como si creas flujos de trabajo omnicanal para situaciones de conmutación por error, la incorporación del canal de correo electrónico a la Messages API ofrece a los desarrolladores más opciones y posibilidades para integrar las comunicaciones en sus aplicaciones.

¿Listo para empezar? Echa un vistazo a la documentación para desarrolladores y ponte en contacto con tu Account Manager para dar de alta tu dominio.