Início rápido

O Ritto Mail é um serviço hospedado: o painel fica em app.ritto.email e a API em https://api.ritto.email. Não há infraestrutura para configurar.

1. Crie sua conta

Cadastre-se em app.ritto.email. Só isso — sem servidores, sem conta de provedor de email para configurar.

2. Verifique um domínio de envio

O Ritto Mail só envia a partir de domínios que você verificou.

1. No painel, vá em Domínios e adicione um domínio que você controla (ex.: acme.dev).
2. Adicione os registros DNS exibidos — um registro TXT de DKIM e os registros de MAIL FROM — no seu provedor de DNS.
3. Clique em Verificar registros DNS. O Ritto Mail também resolve os registros ao vivo, então você vê na hora quais ainda faltam.

3. Crie uma chave de API

Vá em Chaves de API e crie uma. O token rm_ é exibido uma única vez — copie agora. (Chaves criadas antes da mudança de nome para Ritto Mail começam com ms_ e continuam funcionando.) Chaves podem ter acesso total ou somente envio, e opcionalmente ficar restritas a um único domínio.

4. Envie um email

Sua URL base da API é https://api.ritto.email.

Com curl:

curl -X POST https://api.ritto.email/emails \
  -H "Authorization: Bearer rm_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <onboarding@acme.dev>",
    "to": ["delivered@example.com"],
    "subject": "Hello from Ritto Mail",
    "html": "<strong>It works!</strong>"
  }'

Ou com o SDK oficial de Node do Resend (npm install resend) — o Ritto Mail não tem SDK próprio; a API dele é compatível com a do Resend, então os SDKs do Resend funcionam sem mudanças quando apontados para o Ritto Mail:

// RESEND_BASE_URL=https://api.ritto.email (lido pelo SDK)
import { Resend } from "resend";

const resend = new Resend("rm_...");

const { data, error } = await resend.emails.send({
  from: "Acme <onboarding@acme.dev>",
  to: "delivered@example.com",
  subject: "Hello from Ritto Mail",
  html: "<strong>It works!</strong>",
});

if (error) console.error(error.name, error.message);
else console.log("sent", data.id);

Ambos retornam { "id": "..." }. Acompanhe o email indo de queued a delivered na página Emails.

Já usa o Resend? Aponte o SDK oficial do Resend para o Ritto Mail — defina RESEND_BASE_URL com https://api.ritto.email e use sua chave rm_. O formato de comunicação é idêntico. Defina-a no ambiente antes de o SDK carregar — versões antigas do SDK a leem uma única vez e ignoram a opção baseUrl, e um pedido que ainda chega ao Resend falha com 401 "API key is invalid". Veja SDKs.

Próximos passos

• Conceitos para contatos, segmentos, tópicos e broadcasts.
• SDKs para usar os SDKs oficiais do Resend com o Ritto Mail.
• Referência da API para todos os endpoints.
• Migrar do Resend para levar uma integração existente.