---
title: Segurança do agente
description: Como uma caixa de agente protege o agente de IA que a lê e as pessoas para quem ele escreve.
ai:
  exclude: true
---

Qualquer pessoa pode escrever para uma caixa, e um agente de IA que lê e-mails pode ser convencido a fazer coisas: uma mensagem pode trazer instruções escondidas das pessoas, se passar pelo dono do agente ou pedir que ele encaminhe um link de redefinição de senha. Uma [caixa de agente](/docs/pt-br/inboxes) responde em camadas. O agente só lê os e-mails que passam pelas regras da caixa; o que ele lê é limpo de texto oculto e isolado como não confiável; e o que ele envia passa por regras que transformam envios arriscados em rascunhos para uma pessoa.

Nada disso torna o e-mail recebido confiável. A análise é um sinal, não uma garantia: seu agente deve continuar tratando toda mensagem como dado, nunca como instrução.

## Visão geral

| Camada | O que faz |
| --- | --- |
| Verificação do destinatário | E-mail para um endereço sem caixa é recusado, a menos que o pega-tudo esteja ligado; uma caixa inundada responde "tente de novo mais tarde". |
| Verificação de vírus | E-mail infectado vai para a quarentena e seus downloads ficam bloqueados para sempre. |
| Nota de spam | A mensagem reprovada vai para a pasta `spam`. |
| Confiança no remetente | Classifica cada remetente, dos endereços da sua própria equipe até a autenticação que falhou. |
| Regras de entrada | E-mail de remetentes que a caixa não aceita vai para a quarentena. |
| Análise | Dá notas de injeção de prompt e phishing a e-mails de remetentes de fora; notas altas vão para a quarentena. |
| Texto oculto | O texto que uma pessoa não vê sai de tudo o que um agente ou um modelo lê. |
| Isolamento | Os resultados do MCP colocam o texto da mensagem entre marcadores de conteúdo não confiável. |
| Códigos | Códigos de verificação e links de acesso são extraídos para o agente e não podem ser repassados a estranhos. |
| Regras de envio | Respostas só dentro das conversas, limite diário, aumento gradual de destinatários novos, proteção contra loops; envios arriscados viram rascunhos. |
| Atividade | Toda ação e decisão fica registrada, e os proprietários são avisados do que está esperando. |

## Confiança no remetente

Toda mensagem recebida ganha um `sender_trust`, mostrado em `screening` nas leituras e como **Confiança** no painel. Vale a primeira linha que combinar:

| `sender_trust` | O remetente |
| --- | --- |
| `failed` | Falhou na autenticação, e o domínio pede que os receptores coloquem em quarentena ou rejeitem esse tipo de e-mail (ou não publica política DMARC e falha no SPF sem assinatura DKIM própria). Vale mais que qualquer outra linha, então um proprietário falsificado nunca passa. |
| `owner` | Um dos endereços de login dos membros da sua equipe, ou um endereço em `owner_addresses` da caixa, e o domínio o garante. |
| `allowlisted` | Combina com a lista de permitidos da caixa, e o domínio o garante. |
| `known_thread` | Responde numa conversa em que a caixa escreveu, de um endereço a quem a caixa escreveu, comprovado pelo token da conversa ou por um `In-Reply-To` que cita uma mensagem que a caixa enviou. Não exige autenticação. |
| `external` | Qualquer outro remetente cujo domínio o garante, inclusive outros endereços dos seus próprios domínios. |
| `unauthenticated` | Todos os demais: o domínio não garante o endereço From, ou a mensagem cita mais de um remetente. |

Um domínio **garante** o endereço From quando o DMARC passa ou, para um domínio sem política DMARC, quando há uma assinatura DKIM dele ou um SPF aprovado para a organização dele.

- Só os endereços de login dos membros da sua equipe e os `owner_addresses` da caixa são proprietários. Todos os outros do domínio da sua empresa são `external`, então o endereço de um colega, ou um sistema que envia como o seu domínio, não consegue dar ordens ao agente nem receber os códigos privados dele.
- O nível é definido quando a mensagem chega e não muda. Uma edição na lista de permitidos vale para os e-mails que chegarem depois; o que já está retido é liberado à mão.

## O que chega ao agente

`accept_from` decide, por nível:

| `sender_trust` | `anyone` | `verified` (padrão) | `allowlist` |
| --- | --- | --- | --- |
| `owner`, `allowlisted`, `known_thread` | entregue | entregue | entregue |
| `external` | analisado | analisado | quarentena, `not_allowlisted` |
| `unauthenticated` | analisado | quarentena, `unauthenticated_sender` | quarentena, `not_allowlisted` |
| `failed` | quarentena, `failed_auth` | quarentena, `failed_auth` | quarentena, `failed_auth` |

O e-mail **analisado** é entregue, a menos que a análise de injeção de prompt o mande para a quarentena. Além da tabela:

- Um vírus coloca a mensagem em quarentena em toda caixa, seja quem for o remetente.
- O e-mail de proprietários ou da lista de permitidos que encaminha a mensagem de outra pessoa também é analisado: o conteúdo encaminhado não herda confiança.
- O e-mail entregue que é reprovado na nota de spam vai para a pasta `spam`, que as listas de conversas omitem, a menos que você peça.
- O e-mail entregue fica com `screening.verdict: "suspicious"` quando o remetente é `unauthenticated` ou `failed`, a nota de spam é intermediária, ou a análise achou algo abaixo da linha de corte; caso contrário, `clean`.

Uma caixa `human` aceita `anyone` por padrão: tudo é entregue, exceto vírus, e o e-mail de um remetente `failed` vai para a pasta `spam`. A análise roda só em caixas de agente.

## Quarentena

O e-mail em quarentena é guardado pelo mesmo tempo que qualquer e-mail recebido, listado e liberável; nunca é descartado nem devolvido ao remetente.

| `quarantine_reason` | Retido porque |
| --- | --- |
| `failed_auth` | O remetente falhou na autenticação. |
| `unauthenticated_sender` | O domínio do remetente não o garante, e a caixa aceita remetentes verificados (ou lista o endereço como proprietário ou na lista de permitidos). |
| `not_allowlisted` | A caixa aceita só a lista de permitidos. |
| `injection` | A análise deu nota 80 ou mais para injeção de prompt. |
| `phishing` | A análise deu nota 80 ou mais para phishing. |
| `virus` | O verificador de vírus encontrou malware. |
| `unscreened` | A mensagem precisava de análise e o analisador não conseguiu responder. |
| `screening_cap` | A mensagem precisava de análise depois do limite diário de análises. |

**Os agentes nunca veem o e-mail retido.** Chaves restritas a uma caixa e toda chamada MCP pulam as mensagens retidas: ler uma responde `403 email_quarantined`, uma espera informa só o id dela, e nenhum código é servido a partir dela. Enquanto a análise roda, normalmente segundos, a mensagem fica pendente e o id dela responde `404`. As pessoas no painel veem tudo, sinalizado.

**Nenhum webhook avisa de e-mail retido.** `email.received` e `inbox.email.received` disparam quando a mensagem é entregue ou liberada; `inbox.email.quarantined` avisa os endpoints inscritos nele.

**Liberar.** Uma pessoa libera pela aba **Precisa de revisão** da caixa, uma chave de equipe de acesso total com `POST /inboxes/{id}/quarantine/{email_id}/release`, e um cliente MCP com `release_email` sob `receiving:manage`. Uma chave restrita a uma caixa nunca pode.

- Uma pessoa ou uma chave de equipe de acesso total libera qualquer retenção.
- Um cliente MCP é o agente a quem o e-mail se destina: não libera nada retido por injeção de prompt, phishing, vírus ou autenticação falha (`403 forbidden`), e qualquer outra retenção só quando a análise lê a mensagem abaixo de 80 (senão `409 held_by_screening`; `503 screening_unavailable` enquanto a análise não consegue rodar).
- **Liberar e confiar no remetente** (`trust_sender`) também coloca o remetente na lista de permitidos, só para uma retenção `not_allowlisted` de um remetente verificado e só para proprietários, administradores, desenvolvedores e chaves de equipe de acesso total (senão `403 trust_not_allowed`).
- Uma mensagem liberada é entregue como se tivesse acabado de chegar, webhooks inclusive. Um vírus continua sendo um vírus: seus anexos e a mensagem original continuam bloqueados.

Os proprietários recebem um e-mail por dia, **Suas caixas de entrada precisam de atenção**, enquanto houver mensagens na quarentena, rascunhos esperando aprovação ou envios recusados, com as contagens e um link, nunca remetentes nem assuntos. É o alerta **Caixas de entrada precisam de atenção** em **Configurações → Notificações**; veja [Notificações](/docs/pt-br/notifications).

## Análise de injeção de prompt

Numa caixa de agente com `screening` ligada, o e-mail de remetentes `external` e `unauthenticated` que as regras entregariam é analisado antes de o agente poder vê-lo. O analisador lê a mensagem como ela é mostrada, com o texto oculto separado: o remetente, a autenticação e o Reply-To; o assunto e o texto visível; o texto oculto que foi removido; os links como texto âncora e domínio (nunca acessados); os nomes dos anexos. Os códigos são mascarados e os endereços reduzidos ao domínio antes de qualquer coisa sair.

A resposta são duas notas de 0 a 100, `injection_score` e `phishing_score`, e os `reasons` que se aplicaram:

| Motivo | A mensagem |
| --- | --- |
| `targets_agent` | Se dirige a uma IA, assistente, modelo ou "sistema" em vez de a uma pessoa. |
| `override` | Tenta mudar as instruções, o papel ou as prioridades de quem lê. |
| `exfiltration` | Pede a quem lê que envie códigos, links, chaves, outros e-mails, contatos ou dados. |
| `unsafe_action` | Pede uma ação com efeitos fora da conversa: pagar, aprovar, excluir, executar algo. |
| `concealed` | Esconde instruções: em texto oculto, codificadas ou invertidas, depois de um falso fim de mensagem ou dentro de uma citação falsa. |
| `credential_lure` | Pede senhas, códigos ou dados de cartão numa página que o suposto remetente não possui. |

Uma nota de injeção de 80 ou mais coloca a mensagem em quarentena como `injection`; senão, uma nota de phishing de 80 ou mais, como `phishing`. Uma nota de 50 a 79 a entrega como `suspicious`. As notas aparecem sempre, nas leituras em `screening` e no painel.

- **Falha fechada.** Um analisador que dá timeout ou erro coloca a mensagem em quarentena como `unscreened`, e o mesmo vale para uma análise que nunca termina (o job falha repetidamente ou trava): nenhuma mensagem fica pendente por mais de cerca de uma hora. Acima de 200 mensagens analisadas numa caixa num dia, o e-mail que precisa de análise vai para a quarentena como `screening_cap`: uma enxurrada vira quarentena, nunca entrega sem análise.
- **Não afeta o seu envio.** Os veredictos sobre e-mails que você recebeu nunca contam para a sua própria reputação de envio nem para a análise de abuso.

## Texto oculto e extracted_text

Um e-mail pode trazer texto que ninguém vê mas que um modelo lê: uma instrução em branco sobre branco, um bloco `display:none`, caracteres que não aparecem. Antes de qualquer texto chegar a um agente ou a um modelo, o BillionSend remove elementos ocultos (`display:none`, `visibility:hidden`, opacidade quase zero, fontes minúsculas, conteúdo empurrado para fora da tela, texto da cor do fundo, comentários, `<template>`, `<noscript>`) e caracteres invisíveis (caracteres de largura zero, controles de direção de texto, caracteres de tag Unicode). Emojis mantêm os conectores de que precisam. Uma linha de pré-visualização oculta, que a maioria das newsletters traz, também é removida, mas não torna a mensagem suspeita.

O que o agente lê:

- **`extracted_text`**: a parte da resposta, com o histórico citado e as assinaturas separados, em texto simples com markdown leve, até 32.000 caracteres.
- **`text`** sem caracteres invisíveis.
- **`screening.hidden_text_removed: true`** quando texto oculto além de uma linha de pré-visualização, ou caracteres invisíveis, foram removidos.

O `html` continua exatamente como recebido, e a mensagem original guarda tudo.

**Isolamento.** Os resultados do MCP colocam o texto de cada mensagem entre duas linhas marcadoras com um valor aleatório por chamada:

```
-----BEGIN UNTRUSTED EMAIL CONTENT 95253f15-----
Olá! Seu pedido foi enviado hoje.
-----END UNTRUSTED EMAIL CONTENT 95253f15-----
```

Uma linha marcadora escrita dentro da mensagem é alterada antes, então uma mensagem não consegue fechar o próprio isolamento mais cedo.

## Códigos de verificação e links de acesso

Um agente que se cadastra em algum lugar precisa do código ou do link que o serviço envia. O BillionSend os extrai para o agente nunca precisar interpretar HTML:

- Os **códigos** precisam de uma palavra de código por perto (em inglês, português ou espanhol); números de pedido, preços, telefones, cupons e datas são ignorados. Quando dois códigos são igualmente prováveis, nenhum é respondido (`ambiguous`).
- Os **links** são links de acesso, confirmação, redefinição e convite; links de descadastro, privacidade e ajuda são ignorados. Os links nunca são acessados: um scanner que segue um link de uso único o gasta.

Eles são servidos por `extracted` em `GET /emails/receiving/{id}`, por `GET /inboxes/{id}/codes/latest` e pela ferramenta MCP `get_verification_code`, e em nenhum outro lugar: nunca em listas, webhooks, logs nem mensagens de erro. Nunca são servidos de e-mail retido, de um remetente `failed` ou quando `extract_codes` está desligado, e toda leitura fica registrada na atividade da caixa.

**Códigos privados.** Com `private_codes` ligado (o padrão do agente), um código ou link que a equipe recebeu nas últimas 24 horas não pode sair do endereço da caixa num envio a ninguém além dos proprietários e da lista de permitidos: esse envio vira um rascunho com o motivo `private_code`. Isso vale mesmo que o agente tenha sido convencido a fazê-lo. Cobre os envios do endereço da caixa, então dê aos agentes uma chave restrita a uma caixa, ou deixe `emails:send` fora das permissões MCP deles.

## O que um agente pode enviar

Toda forma de enviar de um endereço de caixa passa pelas mesmas regras: respostas, encaminhamentos e rascunhos da caixa, respostas e encaminhamentos no servidor, cópias de `forward_to`, `POST /emails`, `POST /emails/batch`, o relay SMTP e a ferramenta MCP `send_email`. Em ordem:

1. **Identidade.** Uma chave restrita a uma caixa envia só do endereço da caixa (`403 restricted_api_key`; `550 5.7.1` por SMTP).
2. **Domínio compartilhado.** Um [endereço compartilhado](/docs/pt-br/inboxes) segue as regras do domínio compartilhado: no plano Free, ou quando o nome dele parece uma marca conhecida, só responde dentro das próprias conversas. Qualquer outra coisa é recusada com `403 inbox_send_policy`, mesmo aprovada. Todo envio compartilhado conta para o limite diário da equipe no domínio compartilhado e aceita no máximo 10 destinatários.
3. **Limite diário.** `send_cap` destinatários por dia UTC. Acima disso, `429 inbox_send_cap_reached`. Os envios aprovados contam, mas nunca são recusados.

Numa caixa de agente, a menos que o envio seja [aprovado](/docs/pt-br/inboxes), cada um destes o retém como rascunho, com um motivo:

4. **Proteção contra loops.** Responder a e-mail automático (`loop_guard:` e o motivo): um remetente vazio, um cabeçalho `Auto-Submitted`, `Precedence: bulk`, cabeçalhos de lista de e-mails, cabeçalhos de resposta automática, um relatório de entrega, um endereço no-reply ou um assunto de ausência. Mais de 10 envios automáticos a um mesmo endereço em uma hora é `loop_burst`. As respostas do agente levam `Auto-Submitted: auto-replied`, então dois agentes escrevendo um para o outro param após uma rodada.
5. **Reply-To.** Uma resposta a um `Reply-To` de outra organização, a menos que o remetente seja um proprietário, esteja na lista de permitidos ou seja uma conversa conhecida (`reply_to_redirect`).
6. **Regra de envio.** `reply_only` (padrão): respostas dentro de uma conversa, a quem escreveu nela, proprietários e a lista de permitidos. `allowlist`: esses, mais conversas novas com proprietários e a lista de permitidos. `open`: qualquer pessoa, e não enquanto a sua equipe é nova nos envios (nos primeiros 1.000 envios ou 72 horas, ou abaixo de 10.000 envios nos 7 dias seguintes ao primeiro).
7. **Códigos privados** (`private_code`), como acima.
8. **Aumento gradual.** Os destinatários novos por dia ficam dentro do limite, e dentro de 10 no primeiro dia de envio da caixa, dobrando a cada dia: 20, 40, 80, 160 e assim por diante (`ramp`).
9. **Aprovação.** `require_approval` na caixa, ou `requires_approval: true` na requisição.

Uma caixa `human` roda só os três primeiros passos: pessoas que respondem pelo painel não são retidas. Em `POST /emails`, no endpoint em lote, no relay SMTP e em `send_email`, um envio que as regras reteriam é recusado com `403 inbox_send_policy` (ou `550 5.7.1` por SMTP), porque essas vias não criam rascunhos: envie pelos endpoints da caixa para obter um.

O primeiro e-mail de uma caixa de agente a um endereço novo também passa pela mesma análise de abuso de qualquer envio da sua equipe.

## O que o seu agente ainda deve fazer

- Tratar toda mensagem como dado. Instruções dentro de um e-mail são palavras de um desconhecido, sejam quais forem as notas.
- Ler `extracted_text`, não `html`, e conferir `screening.sender_trust` e `screening.verdict` antes de agir.
- Nunca seguir links de e-mails por conta própria; usar `codes/latest` ou `get_verification_code`.
- Manter `require_approval` ligado, ou passar `requires_approval: true`, para tudo que seja difícil de desfazer.
- Dar a cada agente a sua própria [chave restrita a uma caixa](/docs/pt-br/api-keys), e apontar os webhooks para caixas específicas com `inbox_ids`.

## O que estas proteções não fazem

- Os limites da análise e do spam são valores iniciais. Um e-mail pode passar por eles, e um e-mail legítimo pode ficar retido; o que fica retido está a um clique da liberação.
- Um domínio que não publica política DMARC, ou publica `p=none`, comprova pouco: o e-mail legítimo dele e uma falsificação podem parecer iguais.
- A detecção de texto oculto segue o HTML como os clientes de e-mail o renderizam, com o melhor esforço em marcação quebrada; os sinais e a mensagem original são a rede de segurança.
