# Guia do Usuário

Documentação para clientes e usuários finais do Sender25

# Informativo: O que é o Sender25?

<section id="bkmrk-objetivo-apresentar-">#### Objetivo

Apresentar o Sender25 ao usuário: o que é, para que serve, quais recursos oferece e como funciona a plataforma de entrega de e-mails.

</section>---

<section id="bkmrk-escopo-e-p%C3%BAblico-apl">#### Escopo e Público

- **Aplica-se a:** Clientes que contrataram o serviço de envio de e-mails Sender25
- **Não cobre:** Instalação do servidor, configurações de infraestrutura ou administração do sistema
- **Público-alvo:** Clientes finais e usuários do painel Sender25

</section>---

<section id="bkmrk-o-que-%C3%A9-o-sender25-%22">#### O que é o Sender25

*"Seus e-mails entregues. Sempre."*

O Sender25 é uma plataforma de retransmissão (relay) de e-mails. Ele funciona como um servidor SMTP privado e como uma API HTTP para que seus sistemas, sites ou aplicações enviem e-mails de forma confiável e controlada.

É indicado para enviar:

- Confirmações de cadastro e de pedidos
- Notificações de sistema
- Redefinição de senha
- E-mails de cobrança e financeiros (boletos, faturas, comprovantes de pagamento)
- Confirmação e verificação de e-mail (códigos OTP / tokens de validação)
- Atualizações de status de pedido e rastreamento de entrega
- Alertas de segurança (novo login, alteração de senha, acesso suspeito)
- Lembretes e notificações de agendamento (consultas, reuniões, vencimentos)
- Recibos e comprovantes de transações
- Mensagens de boas-vindas e onboarding
- Notificações de tickets e respostas de suporte
- Relatórios automáticos e resumos periódicos enviados por uma aplicação
- Qualquer e-mail gerado automaticamente por uma aplicação (transacional)
- Envios de notas fiscais

⚠️ Para campanhas de marketing e disparos em massa, observe sempre as boas práticas de consentimento e a legislação aplicável (LGPD).

</section>---

<section id="bkmrk-principais-recursos-">#### Principais recursos

<table><thead><tr><th>Recurso</th><th>Descrição</th></tr></thead><tbody><tr><td>**Proteção anti-spam ativa**</td><td>Sete camadas de filtragem e suspensão automática de envios com conteúdo malicioso</td></tr><tr><td>**Autenticação de domínio**</td><td>Configuração de SPF, DKIM e suporte a DMARC para garantir entregabilidade</td></tr><tr><td>**IPs monitorados**</td><td>Pools de IPs com reputação positiva; IP dedicado disponível como opção adicional</td></tr><tr><td>**Dashboard em tempo real**</td><td>Métricas por domínio, histórico de mensagens, logs de entrega e alertas automáticos</td></tr><tr><td>**Conformidade LGPD**</td><td>O Sender25 não armazena o conteúdo dos e-mails, apenas metadados (remetente, destinatário, timestamps)</td></tr></tbody></table>

</section>---

<section id="bkmrk-como-o-sender25-func">#### Como o Sender25 funciona

O fluxo básico de envio é:

1. Seu sistema se conecta ao Sender25 via **SMTP** ou **API HTTP**
2. O Sender25 aplica as camadas de filtragem e coloca a mensagem na fila de envio
3. O sistema processa e entrega o e-mail ao servidor de destino com roteamento inteligente por provedor
4. O resultado fica registrado no painel: entregue, falhou, devolvido (bounce), etc.

</section>---

<section id="bkmrk-componentes-principa">#### Componentes principais do painel

<table><thead><tr><th>Componente</th><th>Função</th></tr></thead><tbody><tr><td>**Organização**</td><td>Agrupa servidores e usuários da sua conta</td></tr><tr><td>**Servidor de envio**</td><td>Unidade de configuração com domínio, credenciais e métricas</td></tr><tr><td>**Domains**</td><td>Domínios verificados via DNS para assinar os e-mails com SPF e DKIM</td></tr><tr><td>**Credentials**</td><td>Chaves de acesso para autenticação SMTP ou via API HTTP</td></tr><tr><td>**Messages**</td><td>Histórico completo de todos os e-mails processados</td></tr><tr><td>**Suppressions**</td><td>Lista de endereços bloqueados por bounce ou reclamação de spam</td></tr></tbody></table>

[![image.png](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/scaled-1680-/7Qgimage.png)](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/7Qgimage.png)

  
**Figura 1** - Painel principal do Sender25 com gráfico de envios e lista de mensagens

</section>---

<section id="bkmrk-observa%C3%A7%C3%B5es-importan">#### Observações importantes

⚠️ O Sender25 é uma plataforma de **retransmissão (relay)**. Ele não substitui o webmail, não fornece caixas de entrada e não recebe e-mails. Ele apenas **envia** e-mails a partir dos sistemas que você integrar.

ℹ️ O Sender25 não armazena o conteúdo dos e-mails — apenas metadados de envio — em conformidade com a LGPD.

</section>---

<section id="bkmrk-controle-de-mudan%C3%A7as">#### Controle de Mudanças

<details><summary>Informações de controle de versão</summary>

- **Última revisão** 05-06-2026
- **Próxima revisão** 04-12-2026
- **Autor** Sender25
- **Versão** 1.4

</details></section>

# Guia: Como acessar o painel do Sender25

<section id="bkmrk-objetivo-orientar-o-">#### Objetivo

Orientar o usuário a acessar o painel web do Sender25 pela primeira vez e redefinir a senha quando necessário.

</section>---

<section id="bkmrk-escopo-e-p%C3%BAblico-apl">#### Escopo e Público

- **Aplica-se a:** Primeiro acesso ao painel e recuperação de senha
- **Não cobre:** Criação de novas contas ou gerenciamento de usuários adicionais
- **Público-alvo:** Clientes finais do Sender25

</section>---

<section id="bkmrk-pr%C3%A9-requisitos-e-mai">#### Pré-requisitos

- Ter um usuário criado dentro do sistema
- Acesso à internet e navegador atualizado (Chrome, Firefox, Edge ou Safari)

</section>---

<section id="bkmrk-passos-%28sequ%C3%AAncia%29-p">#### Passos (sequência)

##### Passo 1 — Acesse o painel

Abra o navegador e acesse o endereço do painel fornecido:

```
https://app.sender25.com
```

##### Passo 2 — Faça login

Na tela de login, informe:

- **E-mail:** o e-mail cadastrado na sua conta
- **Senha:** a senha definida na sua conta

Clique em **Entrar**.

[![image.png](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/scaled-1680-/Mloimage.png)](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/Mloimage.png)

  
**Figura 1** - Tela de login do painel Sender25

##### Passo 3 — Redefinição de senha (primeiro acesso)

Se você recebeu um link de redefinição de senha por e-mail:

1. Clique no link recebido no e-mail
2. Digite uma nova senha (mínimo 8 caracteres)
3. Confirme a nova senha
4. Clique em **Salvar**
5. Faça login com a nova senha

[![image.png](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/scaled-1680-/xNhimage.png)](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/xNhimage.png)

  
**Figura 2** - Tela de redefinição de senha do Sender25

##### Passo 4 — Navegue pelo painel

Após o login, você verá o painel principal com sua organização, servidores de envio e e-mails processados recentemente.

[![image.png](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/scaled-1680-/HHJimage.png)](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/HHJimage.png)

  
**Figura 3** - Painel inicial do Sender25 logo após o login

</section>---

<section id="bkmrk-problemas-comuns-n%C3%A3o">#### Problemas comuns

##### Minha senha não funciona

Use a opção **Esqueci minha senha** na tela de login para gerar um novo link de redefinição.

##### A página não carrega

Verifique sua conexão com a internet. Se o problema persistir, contate o suporte.

</section>---

<section id="bkmrk-suporte-o-suporte-at">#### Suporte

O suporte atende em horário comercial via:

- **WhatsApp**
- **Ticket** pelo portal de suporte

</section>---

<section id="bkmrk-observa%C3%A7%C3%B5es-importan">#### Observações importantes

⚠️ Nunca compartilhe sua senha de acesso. Cada usuário deve ter suas próprias credenciais.

</section>---

<section id="bkmrk-controle-de-mudan%C3%A7as">#### Controle de Mudanças

<details><summary>Informações de controle de versão</summary>

- **Última revisão** 04-06-2026
- **Próxima revisão** 04-12-2026
- **Autor** Sender25
- **Versão** 1.3

</details></section>

# Guia: Como configurar manualmente seu domínio de envio no Sender25

<section id="bkmrk-objetivo-configurar-">#### Objetivo

Configurar um domínio de envio verificado no Sender25 para que seus e-mails sejam assinados corretamente e não caiam em spam.

</section>---

<section id="bkmrk-escopo-e-p%C3%BAblico-apl">#### Escopo e Público

- **Aplica-se a:** Configuração inicial de domínio e reconfiguração por mudança de DNS
- **Não cobre:** Configuração de zonas DNS em provedores específicos (cPanel, Cloudflare, etc.)
- **Público-alvo:** Clientes finais do Sender25 com acesso ao painel DNS do domínio

</section>---

<section id="bkmrk-pr%C3%A9-requisitos-acess">#### Pré-requisitos

- Acesso ao painel do Sender25
- Acesso ao painel de gerenciamento de DNS do domínio
- O domínio deve ser de sua propriedade

</section>---

<section id="bkmrk-registros-dns-de-e-m">#### Registros DNS de e-mail

Para garantir a entregabilidade, três mecanismos de autenticação são usados:

<table><thead><tr><th>Registro</th><th>Tipo DNS</th><th>Função</th></tr></thead><tbody><tr><td>**SPF**</td><td>TXT</td><td>Informa quais servidores estão autorizados a enviar e-mails pelo seu domínio</td></tr><tr><td>**DKIM**</td><td>TXT</td><td>Assina criptograficamente cada e-mail enviado, provando autenticidade</td></tr><tr><td>**DMARC**</td><td>TXT</td><td>Define a política de como servidores de destino devem tratar e-mails que falham SPF/DKIM. Configuração recomendada.</td></tr></tbody></table>

O painel do Sender25 guia a configuração de **SPF e DKIM**. A configuração de DMARC é recomendada como complemento e deve ser feita diretamente no DNS do seu domínio.

</section>---

<section id="bkmrk-passos-%28sequ%C3%AAncia%29-p">#### Passos (sequência)

##### Passo 1 — Acesse o servidor de envio

No painel do Sender25, clique no seu servidor de envio e vá até a seção **Domains**.

##### Passo 2 — Adicione um novo domínio

Clique em **Add New Domain** e informe o domínio que usará para enviar e-mails (ex.: `seudominio.com.br`). Confirme a criação.

[![image.png](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/scaled-1680-/Ctoimage.png)](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/Ctoimage.png)

  
**Figura 1** - Tela para adicionar domínio

[![image.png](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/scaled-1680-/EReimage.png)](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/EReimage.png)

  
**Figura 2** - Adição de um novo domínio na seção Domains do Sender25

##### Passo 3 — Verifique a propriedade do domínio

O Sender25 solicita a verificação de propriedade via registro TXT. Adicione o registro informado no DNS do domínio e clique em **Verify Domain**.

##### Passo 4 — Configure SPF e DKIM no DNS

Após a verificação, a tela **DNS Setup** exibe os valores dos dois registros obrigatórios:

- **SPF** — registro TXT na raiz (`@`) do domínio
- **DKIM** — registro TXT com nome específico exibido na tela

Copie os valores e crie os registros no painel DNS do seu domínio. A propagação pode levar de 5 minutos a 48 horas.

[![image.png](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/scaled-1680-/WI8image.png)](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/WI8image.png)

  
**Figura 3** - Tela DNS Setup do Sender25 com os registros SPF e DKIM a serem copiados

##### Passo 5 — Confirme os registros

De volta ao Sender25, clique em **Check my records are correct**. Quando SPF e DKIM aparecerem com o badge **Good**, o domínio está pronto.

##### Passo 6 — Configure DMARC (facultativo, recomendado)

Para máxima proteção, adicione também um registro DMARC no seu DNS. Um valor inicial conservador:

```
Nome: _dmarc.seudominio.com.br
Tipo: TXT
Valor: v=DMARC1; p=none; rua=mailto:dmarc@seudominio.com.br
```

A política `p=none` apenas monitora sem rejeitar e-mails. Quando você tiver confiança nos seus envios, pode avançar para `p=quarantine` ou `p=reject`.

</section>---

<section id="bkmrk-problemas-comuns-a-v">#### Problemas comuns

##### A verificação falha mesmo após adicionar os registros

Aguarde pelo menos 30 minutos (propagação de DNS) e tente novamente. Confira se os valores foram copiados exatamente como exibidos — um espaço extra invalida o registro.

##### Não sei onde editar o DNS do meu domínio

O DNS é gerenciado no painel do registrador do domínio ou na hospedagem. Entre em contato com o suporte se precisar de ajuda.

</section>---

<section id="bkmrk-observa%C3%A7%C3%B5es-importan">#### Observações importantes

⚠️ Enviar e-mails sem SPF e DKIM configurados aumenta a chance de as mensagens serem marcadas como spam ou rejeitadas.

ℹ️ SPF + DKIM + DMARC formam o conjunto completo de autenticação de e-mail recomendado pelos principais provedores (Gmail, Outlook, Yahoo).

</section>---

<section id="bkmrk-controle-de-mudan%C3%A7as">#### Controle de Mudanças

<details><summary>Informações de controle de versão</summary>

- **Última revisão** 04-06-2026
- **Próxima revisão** 04-12-2026
- **Autor** Sender25
- **Versão** 1.3

</details></section>

# Guia: Como criar credenciais SMTP no Sender25

<section id="bkmrk-objetivo-criar-crede">#### Objetivo

Criar credenciais no Sender25 para que sua aplicação ou sistema possa enviar e-mails autenticados via SMTP ou API HTTP.

</section>---

<section id="bkmrk-escopo-e-p%C3%BAblico-apl">#### Escopo e Público

- **Aplica-se a:** Criação de credenciais SMTP e de API
- **Não cobre:** Configuração do SMTP na aplicação (WordPress, Laravel, etc.)
- **Público-alvo:** Clientes finais e desenvolvedores que integram sistemas ao Sender25

</section>---

<section id="bkmrk-pr%C3%A9-requisitos-acess">#### Pré-requisitos

- Acesso ao painel do Sender25
- Pelo menos um servidor de envio configurado

</section>---

<section id="bkmrk-tipos-de-credencial-">#### Tipos de credencial

O Sender25 oferece dois tipos de credencial de envio:

<table><thead><tr><th>Tipo</th><th>Uso</th></tr></thead><tbody><tr><td>**SMTP**</td><td>Autenticação no servidor SMTP para envio via protocolo SMTP</td></tr><tr><td>**API**</td><td>Autenticação via header HTTP para envio pela API REST</td></tr></tbody></table>

</section>---

<section id="bkmrk-passos-%28sequ%C3%AAncia%29-p">#### Passos (sequência)

##### Passo 1 — Acesse as credenciais do servidor

No painel do Sender25, clique no seu servidor de envio e vá até a seção **Credentials** no menu lateral.

##### Passo 2 — Crie uma nova credencial

Clique em **Add your first credential** (ou **Add another credential**). Preencha:

- **Type:** selecione `SMTP` para envio por SMTP ou `API` para envio pela API HTTP
- **Name:** um nome descritivo para identificar a credencial (ex.: `wordpress-producao`)

Clique em **Create credential**. O sistema gera automaticamente uma chave única.

[![image.png](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/scaled-1680-/iNtimage.png)](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/iNtimage.png)

  
**Figura 1** - Formulário de criação de credencial no Sender25

##### Passo 3 — Copie a chave

A chave gerada fica sempre visível na listagem de credenciais. Acesse **Credentials** a qualquer momento para consultá-la.

[![image.png](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/scaled-1680-/v4fimage.png)](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/v4fimage.png)

  
**Figura 2** - Listagem de credenciais do servidor com as chaves de acesso

  
##### Passo 4 — Configure sua aplicação (para SMTP)

<table><thead><tr><th>Parâmetro</th><th>Valor</th></tr></thead><tbody><tr><td>Servidor SMTP</td><td>Endereço informado no seu painel ou e-mail de boas-vindas</td></tr><tr><td>Porta</td><td>Conforme a configuração do servidor (normalmente 25)</td></tr><tr><td>Usuário</td><td>Deixe em branco ou informe qualquer valor — o Sender25 autentica pela chave</td></tr><tr><td>Senha / Chave</td><td>A chave gerada no passo anterior</td></tr><tr><td>Autenticação</td><td>PLAIN</td></tr></tbody></table>

</section>---

<section id="bkmrk-problemas-comuns-a-a">#### Problemas comuns

##### A autenticação SMTP está falhando

Verifique se a chave foi copiada corretamente, sem espaços extras. Confirme se o tipo da credencial é `SMTP` (não `API`).

##### Preciso revogar uma credencial

Na listagem de credenciais, clique sobre ela e use o botão **Delete credential**. Crie uma nova credencial se necessário.

</section>---

<section id="bkmrk-observa%C3%A7%C3%B5es-importan">#### Observações importantes

⚠️ Crie uma credencial por sistema. Não compartilhe a mesma chave entre múltiplas aplicações — isso facilita o rastreamento e a revogação em caso de comprometimento.

</section>---

<section id="bkmrk-controle-de-mudan%C3%A7as">#### Controle de Mudanças

<details><summary>Informações de controle de versão</summary>

- **Última revisão** 04-06-2026
- **Próxima revisão** 04-12-2026
- **Autor** Sender25
- **Versão** 1.3

</details></section>

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

<section id="bkmrk-objetivo-enviar-e-ma">#### Objetivo

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

</section>---

<section id="bkmrk-escopo-e-p%C3%BAblico-apl">#### 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
 
</section>---

<section id="bkmrk-pr%C3%A9-requisitos-acess">#### Pré-requisitos

- Acesso ao painel do Sender25
- Credencial do tipo **API** criada no servidor de envio
- Domínio de envio configurado e verificado
 
</section>---

<section id="bkmrk-passos-%28sequ%C3%AAncia%29-p">#### 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.

</section>---

<section id="bkmrk-problemas-comuns-sta">#### 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.

</section>---

<section id="bkmrk-observa%C3%A7%C3%B5es-importan">#### 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.

</section>---

<section id="bkmrk-controle-de-mudan%C3%A7as">#### Controle de Mudanças

 <details> <summary>Informações de controle de versão</summary>

- **Última revisão** 04-06-2026
- **Próxima revisão** 04-12-2026
- **Autor** Sender25
- **Versão** 1.1
 
 </details></section>

# Guia: Como acompanhar suas métricas de envio no Sender25

<section id="bkmrk-objetivo-monitorar-o">#### Objetivo

Monitorar o desempenho dos envios, consultar o histórico de mensagens e interpretar os status de entrega no painel do Sender25.

</section>---

<section id="bkmrk-escopo-e-p%C3%BAblico-apl">#### Escopo e Público

- **Aplica-se a:** Monitoramento de envios em produção e diagnóstico de entregas
- **Não cobre:** Configuração de domínios, credenciais ou integrações
- **Público-alvo:** Clientes finais do Sender25

</section>---

<section id="bkmrk-pr%C3%A9-requisitos-acess">#### Pré-requisitos

- Acesso ao painel do Sender25
- Pelo menos um e-mail enviado pelo servidor

</section>---

<section id="bkmrk-passos-%28sequ%C3%AAncia%29-p">#### Passos (sequência)

##### Passo 1 — Acesse o painel de métricas

No painel do Sender25, clique no seu servidor de envio. Na tela inicial você verá o gráfico de mensagens recebidas e enviadas do período.

[![image.png](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/scaled-1680-/Gqcimage.png)](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/Gqcimage.png)

  
**Figura 1** - Gráfico de mensagens recebidas e enviadas no painel do servidor

##### Passo 2 — Consulte o histórico de mensagens

Clique em **Messages** no menu lateral para ver todos os e-mails processados com: destinatário, assunto, data e status de entrega.

[![image.png](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/scaled-1680-/1ecimage.png)](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/1ecimage.png)

  
**Figura 2** - Histórico de mensagens do servidor no Sender25

##### Passo 3 — Entenda os status de entrega

<table style="width: 100%;"><thead><tr><th style="width: 10.9615%;">Status</th><th style="width: 89.0385%;">Significado</th></tr></thead><tbody><tr><td style="width: 10.9615%;">**Sent**</td><td style="width: 89.0385%;">E-mail entregue com sucesso ao servidor de destino</td></tr><tr><td style="width: 10.9615%;">**SoftFail**</td><td style="width: 89.0385%;">Falha temporária — o Sender25 tentará reenviar automaticamente</td></tr><tr><td style="width: 10.9615%;">**HardFail**</td><td style="width: 89.0385%;">Falha permanente — endereço inválido ou servidor rejeitou definitivamente</td></tr><tr><td style="width: 10.9615%;">**Pending**</td><td style="width: 89.0385%;">E-mail será enviada assim que chegar sua vez de ser despachada</td></tr><tr><td style="width: 10.9615%;">**Error**</td><td style="width: 89.0385%;">Semelhante ao SoftFail, o erro é interno do software</td></tr><tr><td style="width: 10.9615%;">**Held**</td><td style="width: 89.0385%;">Retido por regra de segurança ou limite de envio excedido (requer ação manual para o envio, ou seja, remover o endereço de destino da regra)</td></tr></tbody></table>

##### Passo 4 — Abra o detalhe de uma mensagem

Clique em qualquer mensagem para ver o log completo de tentativas, erros retornados pelo servidor de destino e timestamps de cada evento.

[![image.png](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/scaled-1680-/KmDimage.png)](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/KmDimage.png)

  
**Figura 3** - Detalhe de uma mensagem com o log de entregas no Sender25

</section>---

<section id="bkmrk-problemas-comuns-uma">#### Problemas comuns

##### Uma mensagem está com SoftFail há muito tempo

Verifique o log de entregas para identificar o erro retornado. Se persistir por mais de 24h, entre em contato com o suporte.

##### Muitos HardFail na lista

Indica base de contatos com endereços inválidos. Faça limpeza periódica da lista de destinatários.

</section>---

<section id="bkmrk-controle-de-mudan%C3%A7as">#### Controle de Mudanças

<details><summary>Informações de controle de versão</summary>

- **Última revisão** 04-06-2026
- **Próxima revisão** 04-12-2026
- **Autor** Sender25
- **Versão** 1.3

</details></section>

# Guia: Como gerenciar bounces e listas de supressão no Sender25

<section id="bkmrk-objetivo-consultar-a">#### Objetivo

Consultar a lista de supressão do servidor e entender como o Sender25 gerencia endereços que geraram bounces, protegendo a reputação do domínio.

</section>---

<section id="bkmrk-escopo-e-p%C3%BAblico-apl">#### Escopo e Público

- **Aplica-se a:** Consulta da lista de supressão e manutenção de listas de envio
- **Não cobre:** Configuração de domínio ou credenciais SMTP
- **Público-alvo:** Clientes finais do Sender25

</section>---

<section id="bkmrk-o-que-s%C3%A3o-bounces-e-">#### O que são bounces e supressões

**Bounce** ocorre quando um e-mail não pode ser entregue. Há dois tipos:

- **Hard bounce (HardFail):** falha permanente — endereço inválido ou domínio inexistente. O Sender25 adiciona automaticamente o endereço à lista de supressão.
- **Soft bounce (SoftFail):** falha temporária — caixa cheia, servidor indisponível. O Sender25 tenta reenviar automaticamente.

**Supressão** é o bloqueio automático de um endereço que gerou hard bounce ou bounce confirmado. O Sender25 bloqueia futuras tentativas de envio para aquele endereço. As supressões expiram automaticamente após o período configurado pelo administrador do servidor.

</section>---

<section id="bkmrk-passos-%28sequ%C3%AAncia%29-p">#### Passos (sequência)

##### Passo 1 — Acesse a lista de supressão

No painel do Sender25, clique no seu servidor de envio, vá até **Messages** no menu lateral e clique em **Suppressions** na barra de navegação interna.

Você verá os endereços suprimidos com: endereço, motivo, data de inclusão e data de expiração.

[![image.png](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/scaled-1680-/BOTimage.png)](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/BOTimage.png)

  
**Figura 1** - Lista de supressão do servidor no Sender25

[![image.png](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/scaled-1680-/NfHimage.png)](https://oraculo.gk2.cloud/uploads/images/gallery/2026-06/NfHimage.png)

  
**Figura 2** - Detalhes da mensagem em Held

##### Passo 2 — Identifique os endereços problemáticos

Anote os endereços com o motivo de supressão. Use o link do endereço para ver as mensagens associadas a ele e entender o histórico de falhas.

##### Passo 3 — Atualize sua base de contatos

Remova os endereços suprimidos do seu sistema de origem (CRM, banco de dados, plataforma de e-commerce). Não tente reenviar para endereços com hard bounce — o Sender25 irá bloqueá-los novamente.

##### Passo 4 — Monitore a taxa de bounce

Acompanhe a proporção de hard bounces em relação ao total de envios no histórico de mensagens. Uma taxa acima de 5% indica que a base de contatos precisa de limpeza urgente.

</section>---

<section id="bkmrk-problemas-comuns-mui">#### Problemas comuns

##### Muitos endereços sendo suprimidos de uma vez

A base de contatos está desatualizada. Faça uma limpeza antes de continuar enviando para evitar comprometer a reputação do domínio.

##### Um endereço válido está na lista de supressão

As supressões expiram automaticamente após o período configurado. Se precisar reativar um endereço antes da expiração, entre em contato com o suporte para remoção manual.

</section>---

<section id="bkmrk-observa%C3%A7%C3%B5es-importan">#### Observações importantes

⚠️ Alta taxa de bounces pode levar provedores como Gmail, Outlook e Yahoo a bloquear os e-mails do seu domínio. Mantenha sempre sua base de contatos atualizada.

ℹ️ A lista de supressão é por servidor. Cada servidor tem sua própria lista independente.

</section>---

<section id="bkmrk-controle-de-mudan%C3%A7as">#### Controle de Mudanças

<details><summary>Informações de controle de versão</summary>

- **Última revisão** 04-06-2026
- **Próxima revisão** 04-12-2026
- **Autor** Sender25
- **Versão** 1.3

</details></section>