Skip to main content
E-mail é a carta registrada digital: texto longo, HTML, links rastreáveis, ideal para recibo, reset de senha e confirmação de pedido.

​
O que é E-mail na Notifique?

É o canal para mandar mensagens transacionais e campanhas com remetente do seu domínio. Você envia pelo painel ou API; a plataforma cuida da fila, da entrega e do status de cada mensagem. Você pode:
  • Enviar recibos, confirmações, newsletters e avisos com HTML e links
  • Receber e-mails no seu domínio (MX + webhook email.received e/ou inbox no painel)
  • Agendar envio para data e hora futuras
  • Consultar histórico e status de cada e-mail
  • Rastrear entrega, abertura e clique por webhook
  • Cancelar agendamentos antes da fila
Pense numa carta com AR: o destinatário recebe na caixa de entrada, você sabe se foi entregue e se abriu.
Diferente do WhatsApp, e-mail não usa instância. Basta domínio VERIFIED, API Key com os escopos certos e destinatários válidos.

​
Quando usar?

Funciona muito bem para recibo, reset de senha, confirmação de pedido e texto longo com links. Para aviso urgente no celular em segundos, prefira SMS ou push. Para conversa em tempo real, use WhatsApp.

​
Como funciona na prática

  1. Registre e verifique um domínio no DNS (prova que você controla o @seudominio.com)
  2. Envie com remetente verificado, destinatários, assunto e corpo (text e/ou html)
  3. A plataforma enfileira, envia e atualiza o status; seu backend recebe avisos se configurou webhooks
Cada API Key pertence a um workspace. Na v1 não envie x-workspace-id.

​
Domínio verificado

Antes do primeiro envio, o domínio do from precisa estar VERIFIED. Cadastre no painel ou API, configure os registros DNS que a Notifique mostra e chame verify até confirmar. As respostas de domínio (GET/POST /v1/email/domains, GET .../:id, POST .../:id/verify) incluem:
  • dnsRecords — registros do provedor (DKIM, bounce CNAME, tracking, etc.)
  • suggestedDnsRecords — SPF e DMARC recomendados
  • inboundDnsRecords — MX para receber e-mails no domínio
  • dkim — atalho com nome e valor do DKIM principal
  • verification — status por rota de entrega e por registro DNS
  • verificationSummary — no verify, texto legível com o que ainda falta (ex.: DKIM pendente)
Status do domínio:
  • PENDING, domínio cadastrado, DNS ainda não validado
  • VERIFIED, pronto para usar no remetente (e para inbound quando o MX estiver ok)
  • FAILED, verificação falhou; confira registros no provedor DNS
Sem domínio verificado, o envio retorna 400 com DOMAIN_NOT_VERIFIED. Códigos de verify: Respostas de erro. Recebimento: Recebimento de e-mails.

​
Ciclo da mensagem

Depois do POST, o e-mail passa por QUEUED ou SCHEDULED, depois SENT, DELIVERED, OPENED ou CLICKED conforme engajamento. Falhas viram FAILED; reclamação de spam vira COMPLAINED; cancelamento de agendamento vira CANCELLED. Cancelamento pela API funciona enquanto o status for QUEUED ou SCHEDULED.

​
O que dá para fazer

  • Enviar para 1 a 500 destinatários por chamada
  • Agendar com schedule.sendAt
  • Consultar histórico ou um envio pelo id
  • Cancelar agendamento antes da fila
  • Idempotência com header Idempotency-Key para evitar duplicata
  • Threading com headers (In-Reply-To, References) ao responder um e-mail recebido
  • Categoria options.category (transactional ou marketing) para precificação e consentimento
  • One-click unsubscribe (RFC 8058) em campanhas, guia: One-click unsubscribe
Cada e-mail costuma consumir 1 crédito (plano) ou saldo em Pague pelo uso. Veja Cobrança. Detalhe de campos e erros: referência da API na aba E-mails.

​
Localização e variáveis

  • localization (mode: off | manual | ai) e i18n traduzem assunto e corpo por idioma do contato.
  • variables na raiz substituem placeholders no HTML/texto.
  • A resposta 202 pode incluir data.localization.
Guia completo: Localização e i18n.

​
Depois do primeiro envio

  • Acompanhe entrega, abertura e clique por webhooks (email.sent, email.delivered, email.opened, …)
  • Automatize inbox com email.received — Recebimento de e-mails
  • Suprima endereços que reclamaram spam ao receber email.complained
  • Teste no Sandbox com sk_test_... antes de ir para produção

​
Próximos passos