A API de e-mail da Vonage já está disponível em beta aberto

Temos o prazer de anunciar que a API de e-mail da Vonage já está em beta aberto, disponível para todos os clientes gerenciados como um canal dentro da Messages API da Vonage.

Os desenvolvedores não precisam mais recorrer a um provedor externo para integrar outros canais de mensagens, como SMS, WhatsApp ou Viber, ao envio de e-mails. Como se trata apenas de adicionar mais um canal, você pode utilizá-lo com a mesma autenticação e os mesmos Webhooks que já estão configurados em seu aplicativo da Messages API. Que legal!

Com este anúncio, vamos ver quais recursos estão disponíveis e como fazer sua primeira chamada à API para testá-la.

Introdução

Antes de começar a usar o e-mail, você precisará concluir a configuração da autenticação do domínio. Você pode ler sobre como fazer isso, mas, resumindo: adicionar e configurar registros DNS com seu provedor permite que os serviços saibam que a Vonage está autorizada a enviar mensagens em seu nome. Depois de fazer isso, você precisará configurar sua autenticação com a Vonage, e vamos orientá-lo nessa etapa agora.

Autenticação da Vonage

Security FirstSe você ainda não tiver um mecanismo de autenticação configurado, será necessário configurá-lo. Primeiro, crie um novo aplicativo da Vonage no Painel de Controle e baixe sua chave privada:

A autenticação da Vonage exigirá um token JWT — você pode criar um JWT da Vonage usando a CLI da Vonage. Para instalá-la, você precisará ter o Node.js instalado, para que você possa usar um gerenciador de pacotes como o npm ou yarn. Depois de instalar o Node, instale a CLI da Vonage globalmente:

npm install -g @vonage/cli

Em seguida, no mesmo diretório em que você baixou o arquivo private.key, use seu application_id para gerar um JWT:

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

A CLI retornará um token JWT que você poderá usar.

Envie seu primeiro e-mail

Você vai precisar de o cURL instalado (que geralmente já vem com a maioria dos sistemas operacionais). Na linha de comando, cole este comando do cURL e substitua o $JWT pela que você acabou de criar.

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"
    }
  }'

Isso enviará um e-mail em texto simples, mas o campo `message_type` também permite enviar HTML; por exemplo:

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"
    }
  }'

Um recurso útil é que você pode aninhar ambos os tipos de conteúdo usando o tipo de mensagem , o que permite ter soluções alternativas de compatibilidade para diferentes dispositivos finais:

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"
    }
  }'

Depois que uma mensagem for enviada à API, você deverá receber uma 202 resposta com um message_uuid, da mesma forma que aconteceria com outros canais.

Configurando Webhooks

Os webhooks permitem que você receba notificações: há cinco status de entrega que correspondem aos dos outros canais: delivered, rejected, undeliverable, read, e submitted. Você precisará de uma estrutura de back-end para poder ler as mensagens recebidas, o que não é o objetivo deste anúncio, mas um recurso bem legal é que, se você instalar o o ngrok, você pode usar a CLI da Vonage como um wrapper para ele, de modo que ela substitua temporariamente seu domínio local para entregas de Webhooks do aplicativo (são aqueles que você pode ver no painel “Applications” no Dashboard) por um endereço local do ngrok mais o caminho que você definiu. Por exemplo, se os eventos do aplicativo estiverem configurados como http:///example.com/webhooks/status, e você executar o comando para abrir seu túnel com a CLI:

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

Isso iniciará o ngrok e alterará seu domínio local para algo como https://sa9s8d.ngrok.app/webhooks/status. Muito útil ao testar sua integração. Uma notificação de status recebida terá uma aparência semelhante a esta:

{
  "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"
}

Recursos e casos de uso

Campanhas

Anteriormente, se você quisesse realizar uma campanha de marketing que utilizasse tanto SMS (com algo como 10DLC) e e-mail, você precisaria de um serviço de e-mail separado. Agora, se você tiver uma campanha de marketing que utilize vários métodos de entrega, pode usar a Messages API do Vonage para expandir a campanha para o tamanho que for necessário.

Rastreamento

Em mercados verticais, como logística ou comércio eletrônico, geralmente é preferível enviar solicitações de confirmação ou confirmações de entrega por e-mail, em vez de outros canais de comunicação. A introdução do e-mail como canal agora permite isso.

Autenticação e segurança

O canal de e-mail é utilizado em nossa Verify API quando é necessário enviar uma senha de uso único (OTP) (e também pode ser usado em conjunto com outros canais, como SMS ou WhatsApp). Observe que esse também é um recurso em fase beta. No entanto, com o canal de e-mail na Messages API, você também pode integrar a Messages API à sua própria pilha de autenticação, por exemplo, para enviar e-mails de verificação de conta ou redefinições de senha.

Soluções alternativas

O “Mensagens” já possui um recurso de alternativa para entrega; portanto, a adição do e-mail como canal significa que agora você pode tentar concluir a entrega de informações essenciais por meio de várias formas, a fim de garantir uma melhor confirmação de entrega. Já mencionei que o comércio eletrônico é um mercado vertical típico em que o e-mail seria utilizado; portanto, segue um exemplo de quando você deseja enviar uma confirmação de compra pelo WhatsApp (porque o usuário final o especificou como método preferencial de comunicação), mas a entrega não pode ser concluída (o usuário final fez o pedido em um território não suportado ou não há cobertura de celular) e, por isso, a confirmação é enviada por e-mail:

{
  "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" }
    }
  ]
}

O que vem a seguir

O lançamento desta versão como Beta Aberto é apenas o começo; temos muitos recursos previstos em nosso roteiro antes que ela chegue à Disponibilidade Geral (GA):

• 3º trimestre de 2026 (GA): Suporte a e-mails recebidos, suporte a anexos, endereços IP dedicados, integração autônoma por meio do Painel do Cliente, integração com o Verify (e-mail como alternativa para OTP)

• 4º trimestre de 2026: Modelos dinâmicos de e-mail, personalização e tags dinâmicas, integração com o Conversation Connect (interface do gerenciador de campanhas)

• 2027+: Análise avançada, testes A/B, gerenciamento de contatos e automação completa de marketing

Conclusão

Seja para enviar confirmações de pedidos, OTPs ou criar fluxos de trabalho de failover omnicanal, a inclusão do canal de e-mail na Messages API oferece aos desenvolvedores mais opções e recursos para integrar comunicações em seus aplicativos.

Pronto para começar? Confira a documentação para desenvolvedores e entre em contato com seu gerente de contas para fazer a integração do seu domínio.