Como enviar e-mails com o Mailjet

A Mailjet é uma empresa terceirizada que oferece serviços de e-mail global a usuários do App Engine gratuitamente para até 25.000 e-mails por mês. Além disso, ele também oferece:

  • compliance europeu de privacidade de dados;
  • recursos de e-mail e de entrega como configurações de prioridade personalizáveis e gerenciamento automático acelerado;
  • uma vasta biblioteca de recursos de API em Go, PHP, Nodejs, Java, Python e Ruby para gerenciar subcontas, autenticação, contatos, campanhas, payloads personalizados, estatísticas, eventos em tempo real e análises pela Event API;
  • suporte 24 horas por dia, 7 dias por semana, em mais de 4 idiomas;
  • capacidade de enviar e-mails para domínios diferentes de gmail.com.

Antes de começar

Antes de enviar e-mails com o Mailjet, siga estas etapas:

  1. Crie uma conta do Mailjet. Como desenvolvedor do App Engine, você começa com 25.000 e-mails gratuitos por mês.

  2. No Mailjet, adicione e verifique o endereço de e-mail do remetente.

  3. Anote a chave de API e o segredo exibidos nas configurações de SMTP do Mailjet.

  4. Selecione ou crie um novo projeto do GCP no console do Google Cloud Platform e verifique se há um aplicativo do App Engine e se o faturamento está ativado:

    Acessar o App Engine

    O Painel será aberto se houver um aplicativo do App Engine no projeto e o faturamento estiver ativado. Do contrário, siga os avisos para escolher uma região e ativar o faturamento.

  5. Adicione sua chave da API MailJet e a chave secreta como variáveis de ambiente ao seu arquivo app.yaml.

    1. Adicione o pacote do Mailjet à pasta do aplicativo:

      go get github.com/mailjet/mailjet-apiv3-go
      
    2. Defina as configurações do Mailjet, como a chave e a chave secreta da API, além do endereço de e-mail do remetente no arquivo app.yaml:

      env_variables:
        MJ_FROM_EMAIL: your-mailjet-sender-address
        MJ_APIKEY_PUBLIC: your-mailjet-api-key
        MJ_APIKEY_PRIVATE: your-mailjet-secret-key

    3. Importe a biblioteca no código do aplicativo:

      import "github.com/mailjet/mailjet-apiv3-go"
      

    Como enviar e-mails

    Para enviar uma mensagem no código do aplicativo, siga estas etapas:

    1. Crie um novo cliente do Mailjet.

    2. Especifique os detalhes e o conteúdo da mensagem, inclusive o e-mail e o nome do remetente, o assunto, o corpo e os destinatários.

    3. Recupere a resposta do servidor para verificar o status da mensagem.

    Por exemplo:

    func sendEmail(w http.ResponseWriter, r *http.Request) {
    	to := r.FormValue("to")
    	if to == "" {
    		http.Error(w, "Missing 'to' parameter.", http.StatusBadRequest)
    		return
    	}
    
    	messagesInfo := []mailjet.InfoMessagesV31{
    		{
    			From: &mailjet.RecipientV31{
    				Email: fromEmail,
    				Name:  "Mailjet Pilot",
    			},
    			To: &mailjet.RecipientsV31{
    				mailjet.RecipientV31{
    					Email: to,
    					Name:  "passenger 1",
    				},
    			},
    			Subject:  "Your email flight plan!",
    			TextPart: "Dear passenger, welcome to Mailjet! May the delivery force be with you!",
    			HTMLPart: "<h3>Dear passenger, welcome to Mailjet!</h3><br />May the delivery force be with you!",
    		},
    	}
    
    	messages := mailjet.MessagesV31{Info: messagesInfo}
    	resp, err := mailjetClient.SendMailV31(&messages)
    	if err != nil {
    		msg := fmt.Sprintf("Could not send mail: %v", err)
    		http.Error(w, msg, 500)
    		return
    	}
    
    	fmt.Fprintf(w, "%d email(s) sent!", len(resp.ResultsV31))
    }

    Estatísticas

    O payload de resposta de uma chamada da Mailjet Send API fornece um MessageID. É possível usar o MessageID para acessar informações e estatísticas sobre a mensagem.

    Use a operação GET em /message para ver informações básicas sobre uma mensagem, como remetente, destinatário e tamanho. Para saber mais sobre as estatísticas das mensagens, incluindo amostras de respostas da API, consulte o guia da Mailjet API.

    Event API

    A Mailjet Event API oferece notificações em tempo real por meio de solicitações HTTP, ou webhooks, sobre qualquer evento relacionado às mensagens enviadas. Isso inclui o momento em que as mensagens são enviadas ou abertas. Essa notificação funciona com todos os tipos de mensagem, como campanhas de marketing e transações.

    Use a Event API para realizar ações específicas com eficiência. Por exemplo, registrar as mensagens de marketing enviadas aos clientes ou atualizar os contatos que cancelaram a inscrição no sistema de gerenciamento de relacionamento com o cliente (CRM, na sigla em inglês). Em vez de pesquisar a Mailjet API algumas vezes ao dia, os dados são extraídos em tempo quase real conforme os eventos acontecem.

    Também é possível agrupar os eventos, o que é útil ao enviar volumes maiores. Para ver mais instruções, consulte a documentação do Mailjet.

    Parse API para e-mails recebidos

    Receba e analise os e-mails com o Mailjet e forneça o conteúdo a um webhook. O Mailjet organiza todas as informações para que você possa salvá-las no CRM ou banco de dados.

    Assim como a Event API, a Parse API notifica um webhook definido em tempo quase real. Esse webhook envia os dados de volta ao aplicativo quando uma nova mensagem corresponde a uma rota predefinida. Os e-mails enviados ao seu aplicativo são estruturados como um pacote JSON com todas as informações necessárias, como remetente, destinatário, assunto, corpo e cabeçalhos.

    Para mais informações, inclusive campos adicionais enviados com todos os e-mails e instruções de configuração e uso do DNS, consulte a documentação da API Parse do Mailjet.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Ambiente flexível do App Engine para Go