# API de e-mail transacional: como escolher e começar (2026)

> Como escolher uma API de e-mail transacional, enviar o primeiro e-mail com código, autenticar SPF, DKIM e DMARC e ver os planos reais do Pidgely, do grátis ao Scale.

Source: https://pidgely.com/pt-br/blog/api-de-email-transacional/ · Published: 2026-11-14 · Updated: 2026-11-14 · Pidgely

**Uma API de e-mail transacional envia, com uma chamada HTTP ou por SMTP, as mensagens que o seu sistema dispara sozinho: cadastro, senha, recibo, aviso de pedido.** Na hora de escolher, olhe cinco coisas: autenticação do domínio (SPF, DKIM e DMARC), limites reais do plano, separação entre e-mail transacional e campanha, webhooks e logs do que aconteceu com cada mensagem, e o custo do excedente. O Pidgely tem plano grátis com 6.000 e-mails por mês e planos pagos a partir de R$ 39.

## Como escolher uma API de e-mail transacional?

Use esta lista para comparar qualquer serviço, inclusive o Pidgely:

1. **Autenticação do domínio.** O serviço deve publicar SPF e DKIM alinhados ao seu domínio e aceitar DMARC. Sem isso, Gmail e Outlook desconfiam. Veja o [guia de SPF, DKIM e DMARC](/pt-br/blog/spf-dkim-dmarc-configuracao/).
2. **Limites escritos.** Volume mensal, limite diário, número de domínios e o que acontece ao estourar: o envio para ou o excedente é cobrado?
3. **Transacional separado de campanha.** Se os dois saem pelo mesmo IP, uma campanha ruim derruba a entrega do recibo. Entenda em [e-mail transacional vs. marketing](/pt-br/blog/email-transacional-vs-marketing/).
4. **Webhooks assinados e logs.** Você precisa saber se o e-mail foi entregue, devolvido (bounce) ou marcado como spam, e poder verificar a assinatura do evento.
5. **Preço do excedente e teto de gasto.** Cobrança surpresa é o erro mais comum de quem começa no grátis e cresce.

## Quanto custa a API do Pidgely?

Os planos abaixo vêm da [página de preços](/pt-br/precos/) (conferidos em 14/11/2026). Preços em reais, por mês.

| | Free | Starter | Growth | Scale |
|---|---|---|---|---|
| Preço | R$ 0 | R$ 39 | R$ 149 | R$ 449 |
| E-mails por mês | 6.000 (até 200 por dia) | 50.000 | 250.000 | 1.000.000 |
| Domínios de envio | 3 | 10 | 25 | ilimitados |
| Templates | 3 | 50 | 200 | ilimitados |
| Excedente a cada 1.000 | o envio para no limite | R$ 1,00 | R$ 0,80 | R$ 0,50 |
| Extras | API completa, SMTP, webhooks | igual ao Free | igual ao Free | IA no construtor, automações, IP dedicado opcional (R$ 129) |

Nos planos pagos, o excedente é cobrado no fim do mês, dentro de um teto de gasto que você define. O Free nunca é cobrado. A contratação dos planos pagos é ativada pela equipe do Pidgely, a pedido, com nota fiscal de serviço.

Quer comparar com outros serviços? Veja [qual API de e-mail tem o melhor plano grátis](/pt-br/blog/melhor-api-de-email-gratis-2026/), com fonte em cada linha.

## Como enviar o primeiro e-mail pela API?

Crie uma chave de API no painel, verifique um domínio e faça um `POST` em `https://api.pidgely.com/emails`:

```bash
curl -X POST https://api.pidgely.com/emails \
  -H "Authorization: Bearer $PIDGELY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-10482-recebido" \
  -d '{
    "from": "Loja Exemplo <pedidos@lojaexemplo.com.br>",
    "to": "ana@example.com",
    "reply_to": "atendimento@lojaexemplo.com.br",
    "template": {
      "id": "pedido-recebido",
      "variables": { "ORDER_ID": "10482", "TOTAL": 189.9, "CUSTOMER_NAME": "Ana" }
    },
    "tags": [{ "name": "category", "value": "order_received" }]
  }'
```

A resposta traz o `id` do e-mail. O cabeçalho `Idempotency-Key` evita envio duplicado se a sua aplicação repetir a chamada. Os valores (loja, pedido, endereços) são fictícios: troque pelos seus e envie de um domínio verificado. Enquanto o domínio não está verificado, só dá para enviar de um endereço `@test.pidgely.com`, para pessoas da sua organização.

Prefere SMTP? Aponte o plugin ou o framework para `smtp.pidgely.com`, com usuário `pidgely` e a chave de API como senha.

## Como configurar SPF, DKIM e DMARC com o Pidgely?

Depois de adicionar o domínio, o painel mostra os valores exatos, com botão de copiar. São quatro registros:

| Registro | Onde | Para quê |
|---|---|---|
| TXT de DKIM | `pdg…._domainkey` | assinar as mensagens |
| MX | `bounces`, para `mta.pidgely.com` (prioridade 10) | receber devoluções |
| TXT de SPF | `bounces`, com `include:_spf.mta.pidgely.com` | autorizar o envio |
| TXT de DMARC (recomendado) | `_dmarc` | dizer ao Gmail e ao Yahoo o que fazer com falhas |

O SPF fica no subdomínio `bounces`, então o SPF que você já tem na raiz não muda e não consome o limite de 10 consultas DNS. Comece o DMARC com `v=DMARC1; p=none; rua=mailto:dmarc@seudominio.com.br` e suba para `quarantine` e `reject` quando as fontes legítimas passarem. O Pidgely confere o DNS sozinho a cada 5 minutos nos 3 primeiros dias. O passo a passo por provedor (Cloudflare, Registro.br, GoDaddy, Hostinger, Locaweb) está em [verificar domínio no Pidgely](/pt-br/blog/verificar-dominio-spf-dkim-dmarc-passo-a-passo/), e você pode testar o resultado no [verificador grátis](/pt-br/ferramentas/verificador-spf-dkim-dmarc/).

## Quando o Pidgely não é a melhor escolha?

- **Você precisa de mais de 200 e-mails em um único dia sem pagar.** O limite diário do Free segura rajadas. Use o Starter.
- **Seu código depende de um SDK oficial em outra linguagem.** Hoje o SDK oficial é o de Go; Node.js, Python, PHP e Ruby estão em prévia. Qualquer cliente HTTP funciona com a API REST.
- **Você quer contratar plano pago sozinho, sem falar com ninguém.** O Free abre na hora; os planos pagos são ativados pela equipe, a pedido.

## Qual é o próximo passo?

[Crie uma conta grátis no Pidgely](https://app.pidgely.com/signup/) e envie o primeiro e-mail de teste hoje: 6.000 e-mails por mês, sem cartão de crédito. A documentação completa está em [docs.pidgely.com](https://docs.pidgely.com).

## Perguntas frequentes

### O que é uma API de e-mail transacional?

É um serviço que envia, por uma chamada HTTP ou por SMTP, os e-mails que o seu sistema dispara sozinho: confirmação de cadastro, redefinição de senha, recibo, aviso de pedido. Ele cuida da entrega, da reputação dos IPs e do registro do que aconteceu com cada mensagem.

### Existe API de e-mail transacional grátis?

Existe. O plano Free do Pidgely envia 6.000 e-mails por mês, até 200 por dia, sem cartão de crédito, e o envio para no limite em vez de cobrar excedente. Ele inclui API REST, relay SMTP, webhooks, até 3 domínios e 3 templates.

### Preciso configurar SPF, DKIM e DMARC?

Para enviar do seu domínio no Pidgely, sim: o domínio precisa estar verificado, com DKIM, MX e SPF no subdomínio bounces. O DMARC não é obrigatório para enviar, mas Gmail e Yahoo exigem DMARC de quem envia em grande volume. Comece com p=none.

### Posso enviar por SMTP em vez de API?

Pode, em todos os planos. Use o host smtp.pidgely.com, o usuário pidgely e a chave de API como senha. É o caminho para plugins e plataformas que só aceitam SMTP, como o WooCommerce.

### Quanto custa enviar 50 mil e-mails por mês?

No Pidgely, o Starter custa R$ 39 por mês e inclui 50.000 e-mails. Acima da franquia, o excedente é cobrado a R$ 1,00 por mil no Starter, dentro de um teto de gasto que você define.

### Quando o Pidgely não é a melhor escolha?

Se você precisa de mais de 200 e-mails num único dia sem pagar, o Free não basta. Se o seu código depende de um SDK oficial em outra linguagem: hoje só o de Go é oficial; Node.js, Python, PHP e Ruby estão em prévia. E se quer contratar plano pago sozinho: a ativação é feita pela equipe, a pedido.

