Quickstart: Primeiro Email em 5 Minutos

Neste guia você vai sair do zero ao primeiro email enviado via Notifica. Cobre as duas abordagens: API REST e SMTP relay.

---

Passo 1: Criar conta (1 min)

1. Acesse app.usenotifica.com.br
2. Faça login com Google, GitHub ou magic link (email)
3. Pronto — sua conta e workspace estão criados automaticamente

dica

O plano Grátis inclui 10.000 emails/mês. Suficiente para testar e começar em produção.

---

Passo 2: Gerar API key (30 seg)

Via Dashboard

1. Vá em Configurações → API Keys
2. Clique em Criar API Key
3. Dê um nome descritivo (ex: backend-prod)
4. Copie a key imediatamente — ela não será exibida novamente

Via API (se já tiver uma key)

curl -X POST https://app.usenotifica.com.br/v1/api-keys \
  -H "Authorization: Bearer YOUR_EXISTING_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: create-key-001" \
  -d '{ "name": "backend-prod" }'

Exporte a key como variável de ambiente:

export NOTIFICA_API_KEY="ntf_live_xxxxxxxxxxxxxxxxxxxxxxxxx"

---

Passo 3: Verificar domínio (2 min)

Para enviar emails com @seudominio.com.br, você precisa provar que é dono do domínio.

3.1 Registrar o domínio

curl -X POST https://app.usenotifica.com.br/v1/domains \
  -H "Authorization: Bearer $NOTIFICA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: domain-setup-001" \
  -d '{ "domain": "seudominio.com.br" }'

A resposta inclui o registro DNS que você precisa adicionar:

{
  "id": "dom_abc123",
  "status": "pending",
  "dns_records": {
    "txt": {
      "name": "seudominio.com.br",
      "type": "TXT",
      "value": "notifica-verification=SEU_TOKEN"
    }
  }
}

3.2 Adicionar registro DNS

No painel do seu provedor DNS (Cloudflare, Route53, Registro.br, etc.), adicione:

Tipo	Nome	Valor
TXT	@	notifica-verification=SEU_TOKEN

3.3 Verificar

Aguarde 1-5 minutos para propagação DNS, depois:

curl -X POST https://app.usenotifica.com.br/v1/domains/dom_abc123/verify \
  -H "Authorization: Bearer $NOTIFICA_API_KEY"

Resposta esperada:

{
  "status": "verified",
  "verified_at": "2025-01-15T10:45:00Z"
}

informação

Para setup completo com SPF, DKIM e DMARC, veja o guia de domínios.

---

Passo 4: Enviar o primeiro email

Escolha sua abordagem preferida:

Opção A: API REST

curl -X POST https://app.usenotifica.com.br/v1/notifications \
  -H "Authorization: Bearer $NOTIFICA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: first-email-001" \
  -d '{
    "channel": "email",
    "recipient": "[email protected]",
    "payload": {
      "from": "[email protected]",
      "subject": "Meu primeiro email via Notifica 🚀",
      "html_body": "<h1>Funcionou!</h1><p>Este email foi enviado pela API do Notifica.</p>",
      "text_body": "Funcionou! Este email foi enviado pela API do Notifica."
    }
  }'

Resposta:

{
  "id": "ntf_xyz789",
  "channel": "email",
  "status": "pending",
  "recipient": "[email protected]",
  "created_at": "2025-01-15T10:50:00Z"
}

O status muda para delivered em segundos. Confira no dashboard ou consulte:

curl https://app.usenotifica.com.br/v1/notifications/ntf_xyz789 \
  -H "Authorization: Bearer $NOTIFICA_API_KEY"

Opção B: SMTP Relay

Use qualquer cliente SMTP. Exemplo com Python:

import smtplib
import os
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart

msg = MIMEMultipart("alternative")
msg["Subject"] = "Meu primeiro email via Notifica 🚀"
msg["From"] = "[email protected]"
msg["To"] = "[email protected]"

text = "Funcionou! Este email foi enviado pelo SMTP relay do Notifica."
html = "<h1>Funcionou!</h1><p>Este email foi enviado pelo SMTP relay do Notifica.</p>"

msg.attach(MIMEText(text, "plain"))
msg.attach(MIMEText(html, "html"))

with smtplib.SMTP("smtp.usenotifica.com.br", 587) as server:
    server.starttls()
    server.login("apikey", os.environ["NOTIFICA_API_KEY"])
    server.sendmail(
        "[email protected]",
        ["[email protected]"],
        msg.as_string(),
    )
    print("✅ Email enviado!")

Ou com Node.js:

const nodemailer = require('nodemailer');

const transporter = nodemailer.createTransport({
  host: 'smtp.usenotifica.com.br',
  port: 587,
  secure: false,
  auth: {
    user: 'apikey',
    pass: process.env.NOTIFICA_API_KEY,
  },
});

transporter.sendMail({
  from: '[email protected]',
  to: '[email protected]',
  subject: 'Meu primeiro email via Notifica 🚀',
  text: 'Funcionou! Este email foi enviado pelo SMTP relay do Notifica.',
  html: '<h1>Funcionou!</h1><p>Este email foi enviado pelo SMTP relay do Notifica.</p>',
}).then(info => {
  console.log('✅ Email enviado:', info.messageId);
}).catch(console.error);

---

Passo 5: Verificar entrega

Via Dashboard

Acesse app.usenotifica.com.br → Notificações. Você verá o email com status de entrega em tempo real.

Via API

# List recent notifications
curl "https://app.usenotifica.com.br/v1/notifications?channel=email" \
  -H "Authorization: Bearer $NOTIFICA_API_KEY"

# Check delivery attempts for a specific notification
curl "https://app.usenotifica.com.br/v1/notifications/ntf_xyz789/attempts" \
  -H "Authorization: Bearer $NOTIFICA_API_KEY"

---

Resumo

O que	Como
Dashboard	app.usenotifica.com.br
API Base URL	https://app.usenotifica.com.br/v1
SMTP Host	smtp.usenotifica.com.br:587 (STARTTLS)
Auth SMTP	user: apikey, pass: sua API key
Auth API	Header Authorization: Bearer YOUR_API_KEY

---

Próximos passos

Agora que seu primeiro email foi enviado, explore:

Guia	O que você vai aprender
In-App Inbox	SDK React para notificações in-app embeddable
Configuração de Domínio	SPF, DKIM, DMARC — setup completo para máxima entregabilidade
Configuração SMTP	Exemplos em Ruby, Elixir, Go, PHP e mais
Templates de Email	Templates reutilizáveis com variáveis dinâmicas

dica

Quer notificações in-app? Adicione uma inbox embeddable ao seu frontend React em minutos com o SDK @notifica/react. Veja o guia completo de In-App Inbox.

dica

Quer enviar WhatsApp ou SMS também? O Notifica é multi-canal. A mesma API key funciona para todos os canais. Confira o guia de WhatsApp e SMS.