← Documentação

Serviços para a sua aplicação

CLAUDO Mail

E-mail transacional do seu domínio, numa API no formato do Resend.

Domínio de envio

  1. Em Mail, em Domínios de envio, digite o domínio (como mail.seudominio.com.br) e clique em Cadastrar domínio.
  2. Crie no DNS os registros mostrados (SPF, DKIM e o MX de retorno). O nome é relativo ao domínio.
  3. Clique em Verificar agora. Verificado, o domínio envia.

Chave e envio

Em Chaves de envio, Criar chave. Escolhendo um projeto, CLAUDO_MAIL_URL e CLAUDO_MAIL_KEY vão para Production. A API segue o formato da API do Resend.

curl -X POST "$CLAUDO_MAIL_URL/emails" \
  -H "Authorization: Bearer $CLAUDO_MAIL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Loja <pedidos@mail.seudominio.com.br>",
    "to": ["cliente@exemplo.com"],
    "subject": "Pedido confirmado",
    "html": "<p>Obrigado!</p>"
  }'
CampoDetalhe
from"Nome <endereço>" de um domínio verificado da organização
to, cc, bcc, reply_toaté 50 destinatários
subject, html, textassunto de uma linha; corpo até 1 MB
attachmentsaté 20, 10 MB no total: { filename, content } em base64, ou { filename, path } https
scheduled_atdata ISO 8601, até 30 dias à frente
template e variablesmodelo do painel no lugar de html/text
headers, tagscabeçalhos extras e etiquetas

A resposta traz o id. GET /emails/<id> dá o status; POST /emails/<id>/cancel cancela um agendado. O cabeçalho Idempotency-Key evita envio duplicado.

Modelos

Em Modelos, crie assunto e corpo com variáveis: {{nome}} é escapada para HTML; {{{nome}}} entra como está. Variável que falta no envio dá erro 422.

Entregue, devolvido e recebido

  • Os eventos mail.delivered, mail.bounced e mail.complained chegam pelos webhooks.
  • Caixa de entrada: num domínio verificado, Receber e-mail neste domínio e crie o MX mostrado. Cada e-mail recebido dispara mail.received; leia por GET /inbound e GET /inbound/<id>.

Limites

E-mails no mês, contando cada destinatário: Free 300, Pro 10.000, Scale 100.000. Acima disso, a API responde 429. Não há rastreio de abertura nem de clique.