Guia: Como enviar e-mails pela API HTTP do Sender25

Objetivo

Enviar e-mails via API HTTP REST do Sender25, sem precisar de configuração SMTP na aplicação.

Escopo e Público

• Aplica-se a: Integração de sistemas via API REST
• Não cobre: Envio via SMTP ou configuração de domínio e credenciais
• Público-alvo: Desenvolvedores que integram o Sender25 via API HTTP

Pré-requisitos

• Acesso ao painel do Sender25
• Chave de API gerada no servidor de envio
• Domínio de envio configurado e verificado

Passos (sequência)

Passo 1 — Obtenha a chave de API

No painel do Sender25, acesse seu servidor de envio e vá até Credenciais > Chave de API. Copie a chave exibida.

Passo 2 — Monte a requisição HTTP

Envie um POST para o endpoint de mensagens:

POST https://sender25.seudominio.com.br/api/v1/send/message

Cabeçalhos obrigatórios:

Content-Type: application/json
X-Server-API-Key: SUA_CHAVE_DE_API

Passo 3 — Envie o corpo da requisição

Exemplo de corpo JSON:

{
  "to": [{"address": "destinatario@exemplo.com", "name": "Nome"}],
  "from": {"address": "noreply@seudominio.com.br", "name": "Seu Sistema"},
  "subject": "Confirmação de cadastro",
  "plain_body": "Olá! Seu cadastro foi confirmado.",
  "html_body": "<p>Olá! Seu cadastro foi <strong>confirmado</strong>.</p>"
}

Passo 4 — Valide a resposta

Uma resposta de sucesso retorna HTTP 200 com o ID da mensagem:

{"message_id": "abc123...", "status": "queued"}

Use o message_id para consultar o status de entrega no painel do Sender25.

Problemas comuns

Retorno 401 Unauthorized

A chave de API está incorreta ou ausente. Verifique se o header X-Server-API-Key está presente com o valor correto.

E-mail não é entregue mesmo com retorno 200

O status queued indica que o e-mail foi aceito para envio. Verifique o log de entregas no painel para identificar a causa da falha.

Erro de domínio não verificado

O endereço no campo from deve pertencer a um domínio verificado no servidor.

Observações importantes

⚠️ Nunca exponha a chave de API em código client-side (JavaScript no navegador). Use sempre a API a partir do backend da sua aplicação.

Controle de Mudanças