Envie e-mail pelo seu código, do jeito que você já faz.

Use uma chave por sistema e por ambiente. O checkout, o WordPress ou o ERP só precisam enviar: dê a eles uma chave só de envio, presa ao domínio certo.

• Se uma chave só de envio vazar, ela só envia e vê o que ela mesma enviou
• A chave aparece uma única vez, na criação
• Chaves só de envio e presas a um domínio dependem do plano

Todos os caminhos passam pelas mesmas regras: domínio verificado, cotas, lista de supressão e os mesmos eventos. Escolha por onde enviar.

curl -X POST https://api.postal.so/emails \
  -H "Authorization: Bearer $POSTAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Aurora Cosméticos <[email protected]>",
    "to": ["[email protected]"],
    "subject": "Seu pedido #10482 saiu para entrega",
    "html": "<p>O pedido <b>#10482</b> está a caminho.</p>"
  }'

import { Postal } from 'postal-so';

const postal = new Postal(); // lê POSTAL_API_KEY

const { id } = await postal.emails.send(
  {
    from: 'Aurora Cosméticos <[email protected]>',
    to: '[email protected]',
    subject: 'Seu pedido #10482 saiu para entrega',
    html: '<p>O pedido <b>#10482</b> está a caminho.</p>',
  },
  { idempotencyKey: 'order-10482-shipped' },
);

use Postal\Client;

$postal = new Client(); // lê POSTAL_API_KEY

$result = $postal->emails->send([
    'from' => 'Aurora Cosméticos <[email protected]>',
    'to' => '[email protected]',
    'subject' => 'Seu pedido #10482 saiu para entrega',
    'html' => '<p>O pedido <b>#10482</b> está a caminho.</p>',
], 'order-10482-shipped'); // chave de idempotência

echo $result['id'];

Servidor   smtp.postal.so
Porta      465 (TLS direto) ou 587 (STARTTLS)
Usuário    postal
Senha      uma chave de API (ps_...)

# Laravel, no .env
MAIL_MAILER=smtp
MAIL_SCHEME=smtps
MAIL_HOST=smtp.postal.so
MAIL_PORT=465
MAIL_USERNAME=postal
MAIL_PASSWORD=ps_sua_chave

Cada requisição feita com uma chave de API e cada mensagem enviada por SMTP aparece em Logs, com o corpo enviado e a resposta. Os logs ficam guardados por 30 dias.

Receba cada evento de e-mail no seu servidor, com assinatura no padrão Standard Webhooks, até 8 tentativas e reenvio manual. O SDK confere a assinatura em uma linha.

• 30 tipos de evento, de e-mails a contatos e inboxes
• Mesmo webhook-id em todas as tentativas, para descartar duplicatas
• Evento de teste e endereços de teste, como [email protected]

import express from 'express';
import {
  verifyWebhook,
  PostalWebhookVerificationError,
} from 'postal-so';

const app = express();

// O corpo precisa chegar cru (Buffer)
app.post(
  '/webhooks/postal',
  express.raw({ type: 'application/json' }),
  (req, res) => {
    try {
      const event = verifyWebhook(
        req.body,
        req.headers,
        process.env.POSTAL_WEBHOOK_SECRET,
      );
      if (event.type === 'email.bounced') {
        // descarte o endereço
      }
      res.sendStatus(200);
    } catch (error) {
      if (error instanceof
          PostalWebhookVerificationError) {
        return res.sendStatus(400);
      }
      throw error;
    }
  },
);

Ver a página de webhooks

Os endereços de teste geram eventos e webhooks reais, não usam a cota e não afetam a reputação. Dependem do plano. A CLI ajuda a testar pelo terminal, com saída JSON para scripts.

npm install --global postal-so
postal login
postal emails send \
  --from [email protected] \
  --to [email protected] \
  --subject "Teste" --text "Funcionou"

A API da Postal usa os mesmos recursos, nomes de campos e formatos de resposta, então a migração costuma ser trocar a URL base e a chave. O SDK da Resend continua funcionando se você apontar a URL base para a Postal.

• Testado com o pacote resend 6.34 para Node.js
• O que muda: o segredo e as regras de assinatura dos webhooks, os limites e as cotas

- curl -X POST https://api.resend.com/emails \-   -H "Authorization: Bearer re_..."- - # ou, com o SDK da Resend, no .env- RESEND_BASE_URL=https://api.resend.com+ curl -X POST https://api.postal.so/emails \+   -H "Authorization: Bearer ps_..."+ + # ou, com o SDK da Resend, no .env+ RESEND_BASE_URL=https://api.postal.so

Ler o guia de migração

O cabeçalho OTP-Token leva o código e o site de origem. Ainda é um rascunho na IETF e nem todo cliente de e-mail o lê; quem não conhece, ignora.

From: Aurora Cosméticos <[email protected]>
Subject: Seu código de acesso
OTP-Token: "123456"; origin="https://app.exemplo.com.br"