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 do 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 de API MailJet e a chave secreta ao arquivo app.yaml como variáveis de ambiente.

    1. Instale a biblioteca Python do Mailjet no ambiente de desenvolvimento:

      pip install mailjet_rest
      
    2. Defina as configurações do Mailjet como a chave secreta da API, além do endereço de e-mail do remetente no arquivo app.yaml:

      env_variables:
          MAILJET_API_KEY: your-mailjet-api-key
          MAILJET_API_SECRET: your-mailjet-api-secret
          MAILJET_SENDER: your-mailjet-sender-address
    3. No código do aplicativo, use import para importar a biblioteca Python do Mailjet e adicionar as chaves:

      import mailjet_rest
      
      MAILJET_API_KEY = os.environ['MAILJET_API_KEY']
      MAILJET_API_SECRET = os.environ['MAILJET_API_SECRET']
      MAILJET_SENDER = os.environ['MAILJET_SENDER']

    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.

    Exemplo:

    def send_message(to):
        client = mailjet_rest.Client(
            auth=(MAILJET_API_KEY, MAILJET_API_SECRET), version='v3.1')
    
        data = {
            'Messages': [{
                "From": {
                        "Email": MAILJET_SENDER,
                        "Name": 'App Engine Flex Mailjet Sample'
                },
                "To": [{
                    "Email": to
                }],
                "Subject": 'Example email.',
                "TextPart": 'This is an example email.',
                "HTMLPart": 'This is an <i>example</i> email.'
            }]
        }
    
        result = client.send.create(data=data)
    
        return result.json()

    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 outros campos 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…

Documentos do ambiente flexível do App Engine para Python