API de email
Envie a partir do seu código, exatamente uma vez.
Uma chamada envia uma mensagem ou um lote de cem. Cada envio tem um id antes de sair, e uma repetição devolve o resultado em vez de enviar de novo.
Em resumo
O que é uma API de email transacional?
É a forma de uma app enviar o seu próprio correio, como recibos, links de início de sessão e alertas, com um pedido HTTP em vez de alguém carregar em Enviar.
100
mensagens numa chamada em lote
365
dias de antecedência para agendar um envio
900
segundos para anular um envio imediato
Como funciona
Um lote que nunca é tudo ou nada
Até 100 mensagens por chamada, cada uma verificada à parte. Um endereço errado faz falhar esse item e o resto segue na mesma.
Agora, mais tarde ou com margem para anular
Agende até um ano antes ou segure um envio imediato até 15 minutos. Cancele ou reagende até sair.
Um rasto para cada mensagem
Cada envio recebe logo um id msg_. Consulte o estado, os eventos de cada destinatário e as aberturas e cliques.
Enviar um lote
O SDK de TypeScript, ou o mesmo JSON por HTTP simples.
import { init, openemail } from '@openemail/sdk' init({ apiKey: process.env.OPENEMAIL_API_KEY }) const result = await openemail.emails.sendBatch( [ { from: '[email protected]', to: '[email protected]', subject: 'Order AC-4192 has shipped', text: 'It is on its way.' }, { from: '[email protected]', to: '[email protected]', subject: 'Order AC-4193 has shipped', text: 'It is on its way.' }, ], { idempotencyKey: 'shipments:2026-09-23' },) console.log(result.sent, result.failed)O que recebe
Já no produto
Modelos por id
Envie um modelo guardado e fixe a versão que testou.
Na língua deles
Acrescente translate e cada destinatário lê na sua língua, ou não é enviado.
Também no formato Resend
Aponte o SDK do Resend para /compat/resend e mantenha o seu código.
Boas práticas
Tirar o máximo partido
- 01
Derive a chave de idempotência
Use o que motivou o envio, como um número de encomenda, nunca um carimbo de hora.
- 02
Leia o estado
202 quer dizer em fila ou agendado. Veja status antes de o dar como entregue.
- 03
Etiquete o que envia
Até 10 etiquetas por mensagem, devolvidas em cada leitura.
Ponto de situação
Convém saber
- Sem modo de teste
- Todas as chaves são reais, por isso cada envio é mesmo entregue.
- Sem estado de devolução no envio
- Uma devolução chega à conversa e ao webhook email.bounced, não a GET /emails.
- Envios do editor não aparecem
- O correio enviado a partir da app não aparece em GET /emails.
Perguntas
O que mais nos perguntam
Continue a explorar
Combina bem com
Começar
O seu domínio,
o seu correio.
Aponte um domínio para o OpenEmail e leia o correio dele numa caixa de correio construída à volta dele. O plano gratuito inclui um domínio.
