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
• ChaveCredencial dedo tipo API geradacriada no servidor de envio
• Domínio de envio configurado e verificado

Passos (sequência)

Passo 1 — ObtenhaCrie auma chavecredencial dedo tipo API

No painel do Sender25, acesse Credentials no seu servidor de envio e vácrie atéuma credencial com o tipo Credenciais > Chave de API. Copie a chave exibida.gerada (sempre visível na listagem).

Passo 2 — Monte a requisição HTTP

Envie um POST para o endpoint de envio de mensagens:

POST https://sender25.seudominio.com.br/<endereco-do-sender25>/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 — ValideInterprete a resposta

UmaA respostaAPI de sucessosempre retorna HTTP 200. comO osucesso IDou daerro mensagem:é indicado pelo campo status no JSON:

Resposta de sucesso:

{
  "status": "success",
  "data": {
    "message_id": "abc123...",
    "messages": {
      "destinatario@exemplo.com": { "id": 1, "token": "xyz..." }
    }
  }
}

Resposta de erro:

{
  "status": "queued"error",
  "data": { "code": "UnauthenticatedFromAddress", "message": "..." }
}

Use o message_id para consultarlocalizar a mensagem no painel do Sender25 e acompanhar o status de entrega no painel do Sender25.entrega.

Problemas comuns

Retornostatus: 401"error" Unauthorizedcom code "AccessDenied"

A chave de API está incorreta ou ausente. Verifique se ono header X-Server-API-Key está presenteausente ou incorreta. Verifique a chave na listagem de credenciais do tipo API.

status: "error" com ocode valor correto.

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

O statusendereço no campo queuedfrom indicanão quepertence a um domínio verificado neste servidor. Verifique os domínios configurados.

Mensagem aceita mas não entregue

A API confirma o e-mailrecebimento, foinão aceitoa para envio.entrega. Verifique o log de entregas no painel parado identificarSender25 ausando causa da falha.

Erro de domínio não verificado

O endereço no campoo frommessage_id deve pertencer a um domínio verificado no servidor.retornado.

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.

ℹ️ A API aceita GET, POST, PUT e PATCH — embora POST seja o mais comum.

Controle de Mudanças