No cenário em rápida evolução da comunicação por e-mail, Mailgun se destaca como uma poderosa solução de API para empresas que buscam otimizar seus processos de entrega de e-mail. Com seu extenso conjunto de recursos, preços competitivos e capacidades de integração sem esforço, a API Mailgun se tornou uma escolha preferida para desenvolvedores e empresas.
Neste artigo abrangente, iremos explorar as complexidades da API Mailgun, explorar suas funções principais, estrutura de preços e opções de implantação. Além disso, forneceremos um guia passo a passo sobre como testar efetivamente a API Mailgun usando a plataforma fácil de usar Apidog.
Introdução ao Mailgun: Capacitando a Comunicação por E-mail
O Mailgun é um serviço líder em automação de e-mails que permite que empresas enviem, recebam e rastreiem e-mails sem esforço. Fundado em 2010, o Mailgun estabeleceu-se como uma solução confiável e escalável para gerenciar a comunicação por e-mail. Com sua robusta API, o Mailgun capacita desenvolvedores a integrar funcionalidades de e-mail em suas aplicações de forma fluida.
O que é a API Mailgun?
No cerne das ofertas do Mailgun está sua poderosa API. A API Mailgun fornece um conjunto abrangente de endpoints e funcionalidades que permitem que desenvolvedores interajam com o serviço de e-mail programaticamente. Desde o envio de e-mails transacionais até o gerenciamento de listas de e-mail e rastreamento de eventos de e-mail, a API Mailgun oferece uma ampla gama de possibilidades.
Funções Chave da API Mailgun: Envio, Rastreamento e Mais
A API Mailgun possui uma impressionante gama de funções que atendem a várias necessidades de comunicação por e-mail. Algumas das principais capacidades incluem:
- Envio de E-mails: Com a API Mailgun, os desenvolvedores podem facilmente enviar e-mails transacionais e em massa programaticamente. A API suporta vários formatos de e-mail, incluindo texto simples e HTML, e permite personalização e conteúdo dinâmico.
- Rastreamento de E-mails: O Mailgun fornece amplas capacidades de rastreamento de e-mails, permitindo que as empresas monitorem o status de entrega, aberturas, cliques e devoluções de seus e-mails enviados. Esses dados valiosos ajudam a otimizar campanhas de e-mail e melhorar a entregabilidade.
- Gerenciamento de Listas de E-mail: A API permite o gerenciamento sem esforço de listas de e-mail, incluindo adição, remoção e segmentação de assinantes. Esse recurso é particularmente útil para empresas com grandes bases de assinantes.
- Manuseio de E-mails Recebidos: A funcionalidade de e-mail recebido do Mailgun permite que aplicativos recebam e processem e-mails de entrada. Isso abre possibilidades para criar fluxos de trabalho e automações baseadas em e-mail.
Preços da API Mailgun
O Mailgun oferece planos de preços flexíveis para atender a várias necessidades empresariais:
Plano Gratuito
- Preço: $0/mês
- E-mails Incluídos: 100 e-mails/dia
- Recursos:
- Suporte por ticket
- APIs de e-mail RESTful e SMTP relay
- 1 domínio de envio personalizado
- 1 chave API
- Análise e relatórios de e-mail
- Retenção de log de 1 dia
- 1 rota de entrada
Plano Básico
- Preço: $15/mês
- E-mails Incluídos: 10.000 e-mails/mês
- Recursos:
- Recursos:
- Sem limite diário de e-mail
- Opções de transbordo mensal de e-mail
- APIs de e-mail RESTful e SMTP relay
- 1 domínio de envio personalizado
- 1 chave API
- Análise e relatórios de e-mail
- Retenção de log de 1 dia
- 1 rota de entrada
- E-mails Extras: A partir de $1.80/1.000 e-mails
Plano Foundation
- Preço: $35/mês
- E-mails Incluídos: 50.000 e-mails/mês
- Recursos:
- Tudo no Plano Básico mais:
- Acesso total às APIs de e-mail RESTful e SMTP relay
- 1.000 domínios de envio personalizados
- Construtor de modelos de e-mail e API
- Rastreamento, análises e webhooks
- Retenção de log de 5 dias
- Retenção de mensagens de 1 dia
- Acesso total ao roteamento de entrada
- E-mails Extras & Validações:
- A partir de $1.30/1.000 e-mails
- A partir de $1.20/100 validações
Plano Scale
- Preço: $90/mês
- E-mails Incluídos: 100.000 e-mails/mês
- Recursos:
- Tudo no Plano Foundation mais:
- SAML SSO
- 5.000 validações de e-mail
- Pools de IP dedicados
- Otimização do tempo de envio
- Suporte ao vivo por telefone e chat
- Retenção de log de 30 dias
- Retenção de mensagens de até 7 dias
- E-mails Extras & Validações:
- A partir de $1.10/1.000 e-mails
- A partir de $0.80/100 validações
Como Implantar a API Mailgun?
Para implantar a API Mailgun, você precisa seguir estas etapas:
- Cadastre-se para uma conta Mailgun em: ⬇

2. Obtenha suas credenciais da API Mailgun:
- Faça login na sua conta Mailgun.
- Clique em "Criar uma Chave API" e navegue até o painel de chaves API para criar uma nova chave.

- Copie a "Chave API" e mantenha em um lugar seguro para uso posterior.

3. Escolha sua linguagem de programação preferida e instale as bibliotecas ou SDKs necessários. O Mailgun fornece bibliotecas oficiais para várias linguagens, incluindo Python, PHP, Ruby e mais. Por exemplo, se você estiver usando Python, pode instalar a biblioteca Mailgun usando o pip:
pip install mailgun-python
4. Configure seu aplicativo para usar a API Mailgun. Aqui está um exemplo de como enviar um e-mail usando a API Mailgun em Python:
import requests
def send_simple_message():
return requests.post(
"https://api.mailgun.net/v3/YOUR_DOMAIN_NAME/messages",
auth=("api", "YOUR_API_KEY"),
data={"from": "Nome do Remetente <sender@your_domain_name>",
"to": ["recipient@example.com"],
"subject": "Olá",
"text": "Testando algumas funcionalidades incríveis do Mailgun!"})
send_simple_message()
Certifique-se de substituir "YOUR_DOMAIN_NAME" pelo seu verdadeiro nome de domínio e "YOUR_API_KEY" pela sua chave API Mailgun.
5. Integre a API Mailgun em seu aplicativo com base em seus requisitos específicos. Você pode usar a API para enviar e-mails, gerenciar listas de e-mail, rastrear eventos de e-mail e muito mais. Consulte a documentação da API Mailgun para informações detalhadas sobre os endpoints disponíveis e seu uso.
6. Teste sua integração da API Mailgun minuciosamente para garantir que funcione como esperado. Você pode usar ferramentas como Apidog para simplificar o processo de teste. O Apidog permite que você crie e envie solicitações de API, veja respostas e automatize testes de API.
7. Implante seu aplicativo no ambiente de hospedagem escolhido. Certifique-se de que seu aplicativo tenha as permissões e configurações necessárias para acessar a API Mailgun.
Aqui está um exemplo de como implantar um aplicativo Python usando a API Mailgun em um servidor:
1. Configure um servidor com Python e as dependências necessárias instaladas.
2. Copie o código do seu aplicativo para o servidor.
3. Defina as variáveis de ambiente para suas credenciais da API Mailgun:
export MAILGUN_API_KEY='YOUR_API_KEY'
export MAILGUN_DOMAIN='YOUR_DOMAIN_NAME'
4. Execute seu aplicativo no servidor. Por exemplo, se você tiver um aplicativo Flask, pode usar um servidor WSGI como o Gunicorn para executá-lo:
gunicorn your_app:app
5. Configure seu servidor para lidar com pedidos de entrada e direcioná-los ao seu aplicativo.
6. Monitore os logs do seu aplicativo e o painel do Mailgun para quaisquer problemas ou erros.
Lembre-se de lidar com informações sensíveis, como chaves API, de forma segura e nunca expô-las publicamente.
Seguindo estas etapas e aproveitando a documentação e bibliotecas da API Mailgun, você pode implantar e integrar com sucesso a API Mailgun em seu aplicativo.
Usando Apidog para Testar o Endpoint Antes da Implantação
Antes da implantação real da API Mailgun, pode ser necessário testar os endpoints para garantir que funcionem corretamente. O Apidog, uma plataforma de teste e desenvolvimento de API tudo-em-um, pode ser uma grande ajuda aqui para testar os endpoints e oferecer códigos prontos para uso. Aqui está um passo a passo de como você pode fazer isso:
Passo 1: Inscreva-se no Apidog
- Crie uma conta no Apidog para acessar as ferramentas de teste de API.
Passo 2: Crie uma Nova Solicitação de Endpoint
- Crie um novo projeto ou navegue até o projeto padrão após iniciar o aplicativo. (Você pode baixar o aplicativo Apidog ou simplesmente usar a versão web do Apidog)
- Crie um novo endpoint e, no documento do novo endpoint criado, especifique o método HTTP apropriado para o endpoint que você vai testar e copie a URL do endpoint ou o cURL para a barra de pesquisa.

- Após inserir a URL, quaisquer parâmetros relacionados à solicitação, corpo ou cabeçalhos serão preenchidos automaticamente.

- Troque para a aba "Auth" e escolha autenticação bearers conforme exigido pelo Mailgun.

- Preencha o nome de usuário (api) e a senha (chave API) conforme exigido pelo Mailgun.

- Clique em "Enviar" no canto superior direito para obter o resultado e o relatório da resposta da API.

Passo 3: Gere Código Pronto para Uso Direto
- Clique em "Salvar" para salvar o endpoint.
- Troque para o modo
DESIGN
da API Mailgun. No painel, clique emGerar Código
localizado na parte superior direita.

- Na janela pop-up, escolha o framework técnico adequado que se encaixa ao seu projeto e copie o código para implantação direta.

Parabéns! Você aprendeu com sucesso como integrar a API Mailgun em seu projeto sem a necessidade de codificações complexas ou conhecimentos técnicos.
Conclusão
A API Mailgun oferece uma solução poderosa e flexível para empresas que buscam otimizar seus processos de comunicação por e-mail. Com seu conjunto abrangente de recursos, planos de preços competitivos e opções de implantação simplificadas, a API Mailgun permite que os desenvolvedores integrem funcionalidades de e-mail em suas aplicações sem esforço. Ao utilizar ferramentas como Apidog para testes completos da API, as empresas podem garantir a confiabilidade e o desempenho de sua integração com a API Mailgun. Abrace o potencial da API Mailgun e desbloqueie novas possibilidades para suas estratégias de comunicação por e-mail. Com suas robustas capacidades e processo de integração amigável, a API Mailgun é um ativo valioso para qualquer empresa que busca melhorar suas entregas e fluxos de trabalho de gerenciamento de e-mail.