Introdução
O que é o Ritto Mail e como as peças se encaixam.
Ritto Mail é uma plataforma de email hospedada. Envie um. Envie um milhão.
- Painel em app.ritto.email — crie sua conta, verifique um domínio, gerencie chaves de API, contatos e broadcasts.
- API em
https://api.ritto.email— envie a partir do seu próprio código.
Cadastre-se, verifique um domínio, envie. Em volta do núcleo de envio você tem um painel, uma API HTTP (que funciona com os SDKs do Resend), webhooks, contatos, broadcasts e um relay SMTP.
API compatível com Resend
A API HTTP é compatível na comunicação com a do Resend: mesmos formatos de requisição e resposta, mesmo formato de erro. Os SDKs oficiais do Resend respeitam uma URL base configurável, então migrar uma integração existente significa trocar duas variáveis de ambiente — a chave de API e a URL base — sem reescrever seu código. O Ritto Mail não tem SDKs próprios: a página SDKs mostra como apontar cada SDK oficial do Resend para ele.
Uma diferença deliberada: contatos são globais ao time. Não existe o conceito de "audiences" — cada contato pertence diretamente ao seu time, e você segmenta com segmentos (filtros salvos) e tópicos (categorias de inscrição). Veja Contatos.
O que está incluído
| Área | Notas |
|---|---|
| API de emails | Enviar, lote, consultar, cancelar envios agendados. Idempotência via header Idempotency-Key. |
| Contatos | Contatos do time inteiro, com estado de inscrição, propriedades customizadas e importação CSV. |
| Segmentos | Filtros salvos sobre os contatos, usáveis como alvo de broadcasts. |
| Tópicos | Categorias granulares de inscrição, integradas à página de descadastro hospedada. |
| Broadcasts | Componha, agende e envie para todos os contatos, um segmento ou um tópico. |
| Templates | Templates reutilizáveis com campos de mesclagem por contato. |
| Domínios | Verificação de DNS guiada, BYODKIM, rastreamento e TLS por domínio. |
| Webhooks | Assinaturas Standard Webhooks, seleção de eventos por endpoint, log de entregas. |
| Supressões | Hard bounces e reclamações suprimidos automaticamente. |
| Descadastro em um clique | Headers List-Unsubscribe (RFC 8058) e página de descadastro hospedada. |
| Relay SMTP | SMTP pronto para uso em smtp.ritto.email: porta 465 (SSL/TLS), 587 ou 2587 (STARTTLS), com autenticação por chave de API. |
| Métricas | Envios diários com taxas de bounce e reclamação acompanhadas contra limites de reputação de envio. |
| Painel | Painel completo em inglês e português do Brasil. |
Como funciona
O Ritto Mail opera toda a infraestrutura de envio para você — fila, entrega, novas tentativas e monitoramento de reputação. Você não gerencia servidores nem contas de provedor: verifica os registros DNS do seu domínio no painel e envia pela API, pelos SDKs ou pelo relay SMTP.
Os corpos dos emails são criptografados em repouso (criptografia de envelope AES-256-GCM) e expurgados após uma janela de retenção. Eventos de entrega (entregas, bounces, reclamações) são processados automaticamente e chegam a você pelo painel e por webhooks.
Próximos passos
- Início rápido — do zero ao primeiro email em poucos minutos.
- Migrar do Resend — leve uma integração existente.
- Referência da API — gerada a partir do código do servidor, sempre em sincronia.
Para agentes de IA
Toda página desta documentação está disponível como markdown puro
acrescentando .md à sua URL (ou enviando Accept: text/markdown).
/llms.txt é um índice legível por máquina,
/llms-full.txt é a documentação inteira em um arquivo, e
/openapi.json é a especificação OpenAPI 3.1 gerada a partir
do código da API.