Introdução

​

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
• 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.

​

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

​

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.

• PENDING, domínio cadastrado, DNS ainda não validado
• VERIFIED, pronto para usar no remetente
• FAILED, verificação falhou; confira TXT/CNAME no provedor DNS

Sem domínio verificado, o envio retorna 400 com DOMAIN_NOT_VERIFIED. Códigos de verify: Respostas de erro.

​

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 só funciona enquanto o status for SCHEDULED.

​

O que dá para fazer

• Enviar para 1 a 100 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
• 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.

​

Depois do primeiro envio

• Acompanhe entrega, abertura e clique por webhooks (email.sent, email.delivered, email.opened, …)
• 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

• Quick Start: domínio, primeiro envio e consulta
• Escopos da API Key: permissões
• Eventos dos webhooks: o que chega na sua URL
• Comece aqui: integração geral da plataforma