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
• Credencial do tipo API criada no servidor de envio
• Domínio de envio configurado e verificado

Passos (sequência)

Passo 1 — Crie uma credencial do tipo API

No painel do Sender25, acesse Credentials no seu servidor de envio e crie uma credencial com o tipo API. Copie a chave 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://<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": "noreply@seudominio.com.br",
  "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 — Interprete a resposta

A API sempre retorna HTTP 200. O sucesso ou erro é 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": "error",
  "data": { "code": "UnauthenticatedFromAddress", "message": "..." }
}

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

Problemas comuns

status: "error" com code "AccessDenied"

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

status: "error" com code "UnauthenticatedFromAddress"

O endereço no campo from não pertence a um domínio verificado neste servidor. Verifique os domínios configurados.

Mensagem aceita mas não entregue

A API confirma o recebimento, não a entrega. Verifique o log de entregas no painel do Sender25 usando o message_id 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