Noções básicas sobre mensagens de e-mail
O canal de e-mail da Messages API da Vonage permite que você envie e-mails usando a mesma API unificada que você já utiliza para SMS, WhatsApp, RCS e outros canais de mensagens.
Esta página explica como funciona o canal de e-mail, quais recursos são oferecidos na versão beta atual e os Concepts-chave que você precisa entender antes de começar a desenvolver com ele.
A versão beta concentra-se em casos de uso de e-mails transacionais e inclui os seguintes recursos:
- E-mail de saída individual — envie um único e-mail para um único destinatário por solicitação de API.
- Conteúdo em texto simples e HTML — usar
message_type: "text"para texto simples oumessage_type: "html"para e-mails em HTML. - Casos de uso transacionais — confirmações de pedidos, redefinições de senha, notificações de envio e mensagens automatizadas semelhantes.
- Status de entrega por meio de webhooks — receba atualizações de status usando o mesmo modelo de webhook que os outros canais da Messages API.
- Envio regional — envie e-mails por meio de pontos de conexão específicos por região, alinhados à região do seu domínio Verify.
Integração de e-mail com a Messages API
O e-mail está integrado como um novo canal no modelo existente da Messages API. Não foram introduzidos novos endpoints básicos — você usa o mesmo endpoint /v1/messages que já utiliza para outros canais.
Para enviar um e-mail, configure "channel": "email" no corpo da sua solicitação. O message_type o campo aceita "text" para e-mails em texto simples e "html" para e-mails em HTML.
Casos de uso do e-mail
O canal de e-mail foi projetado para casos de uso transacionais, nos quais uma mensagem é acionada por uma ação do usuário ou por um evento do sistema. Exemplos comuns incluem:
- Confirmações de pedidos e recibos — envie um e-mail de confirmação imediatamente após a compra.
- Redefinição de senha e verificação de Account — envie e-mails de segurança urgentes de forma confiável.
- Notificações de envio e entrega — mantenha os clientes informados em cada etapa do processo de atendimento do pedido.
- Lembretes de consultas — reduza o número de faltas com e-mails automáticos de lembrete
- Alertas e notificações do sistema — informem os usuários ou equipes internas sobre eventos importantes em tempo real.