Como enviar e-mails com o Mailjet

O Mailjet é um serviço de e-mail global terceirizado que oferece a usuários do App Engine um nível gratuito com 25.000 mensagens por mês. Além disso, ele também oferece:

  • conformidade europeia de privacidade de dados.
  • recursos de e-mail e de entrega, como configurações de prioridade personalizáveis e gerenciamento automático de controle de fluxo.
  • uma vasta biblioteca de recursos de API em Go, PHP, Node.js, Java, Python e Ruby para gerenciar subcontas, autenticação, contatos, campanhas, payloads personalizados, estatísticas, eventos em tempo real e análises por meio da API Event.
  • suporte 24 horas, 7 dias por semana, em mais de 4 idiomas.
  • capacidade de enviar e-mails de 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 (em inglês). 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 da API e o segredo nas configurações de SMTP do Mailjet.

  4. Selecione ou crie um novo projeto do GCP no Console do Google Cloud Platform. Depois, 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. Caso contrário, siga as instruções para escolher uma região e ativar o faturamento.

  5. Adicione a chave da API MailJet e a chave secreta como variáveis de ambiente ao 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 de API, a chave secreta e o 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"
      

    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 API Mailjet Send 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 API Mailjet (em inglês).

    API Event

    A API Event do Mailjet 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 API Event 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 gestão de relacionamento com o cliente (CRM, na sigla em inglês). Em vez de pesquisar a API Mailjet 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 (em inglês).

    API Parse para e-mails recebidos

    Você também pode receber e analisar e-mails com o Mailjet e fornecer o conteúdo a um webhook. O Mailjet organiza todas as informações para que você possa salvá-las no seu CRM ou banco de dados.

    Assim como a API Event, a API Parse notifica em tempo quase real um webhook definido que 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