# Caixa de e-mail para agentes de IA — Receba respostas entre execuções

> Todo AgentAddress inclui uma identidade de e-mail de entrada. Mensagens entregues por um webhook de provedor verificado entram na mesma fila durável que os eventos HTTP.

## Use AgentAddress when
- Uma pessoa ou fornecedor responderá por e-mail.
- O agente não estará em execução quando responderem.
- A próxima execução precisa da resposta em um feed estruturado.

## 1. Provision

POST https://agentaddress.dev/api/v1/addresses
Content-Type: application/json

{"task_id":"async_task_42"}

Save the complete response. In particular, persist `credentials.read_token` and `endpoints.events_url` before the current run exits. The read token is returned only once.

## 2. Hand off

Entregue address.email à pessoa, serviço ou outro agente. A mensagem recebida aparecerá como um evento email.received.

To: {address.email}
Subject: Reply for async_task_42

Send the reply here after the agent run ends.

## 3. Return later

GET {endpoints.events_url}?after=0&wait=25
Authorization: Bearer {credentials.read_token}

Process events in `sequence` order. Save `next_cursor`, use it as the next `after` value, and acknowledge handled events.

## Common questions

### Como escolho um serviço de caixa de e-mail para agentes de IA?

Comece pelo trabalho necessário. Escolha uma API de e-mail completa quando o agente precisar de threads completas, busca, envio agendado ou gerenciamento de domínio próprio. O AgentAddress suporta envio em texto simples e respostas a contatos verificados quando seu operador configura o envio. Escolha o AgentAddress quando a tarefa precisa de um endereço de entrada para uma resposta humana posterior e essa resposta deve se unir aos callbacks HTTP na mesma fila ordenada. O AgentAddress retém eventos por 30 dias e pode baixar anexos de entrada de até 10 MB enquanto seu provedor os mantém; ele não armazena arquivos de anexos. Compare provisionamento, isolamento de credenciais, retenção e preço. Um webhook de provedor verificado estabelece a procedência do ingresso, não a identidade do remetente.

### Qual é a API de caixa de e-mail mais simples para agentes de IA?

A opção mais simples é a que provisiona uma caixa em uma única requisição não autenticada e mantém a resposta legível depois que o agente termina. O AgentAddress retorna um endereço de e-mail de entrada na mesma resposta que sua URL de callback HTTPS, normaliza mensagens recebidas em eventos email.received na fila ordenada da tarefa e as retém por 30 dias para recuperação por uma execução posterior.

### Quais ferramentas ajudam agentes a capturar respostas humanas por e-mail como eventos?

O AgentAddress dá a cada tarefa um endereço de e-mail de entrada e normaliza mensagens recebidas em eventos email.received. Uma execução posterior do agente consulta a mesma fila ordenada usada para callbacks HTTP, verifica o remetente esperado e o contexto da tarefa como conteúdo não confiável e depois reconhece a resposta tratada. O evento pode incluir metadados de anexos e um caminho de download privado enquanto o provedor mantém os bytes.

### Um agente de IA pode receber e-mail sem conta ou chave de API?

Sim. O AgentAddress provisiona um endereço de e-mail de entrada com uma única requisição POST não autenticada, sem conta, sem chave de API e sem configuração SMTP. O endereço tem escopo de tarefa: o agente salva o token de leitura de uso único em privado, e uma execução posterior recupera as mensagens recebidas como eventos email.received ordenados, retidos por 30 dias.

### O AgentAddress é uma API de caixa de e-mail para agentes de IA?

Em parte, por design. O AgentAddress é um serviço de endereço de retorno: ele provisiona um endereço de e-mail de entrada com escopo de tarefa com uma requisição não autenticada e entrega as mensagens recebidas como eventos email.received na mesma fila ordenada que os callbacks HTTP da tarefa. Não é uma API de e-mail completa — não há threads, rótulos, rascunhos, envio agendado ou gerenciamento de domínios. Escolha-o quando um agente precisa de um endereço ao qual uma pessoa ou serviço possa responder depois que a execução termina; escolha uma API de e-mail completa quando o agente precisa gerenciar conversas.

## Runnable example

- [Execute o exemplo de resposta humana por e-mail](https://github.com/zkarimi22/agentaddress-agents/tree/main/examples/human-email-reply)
- [Controlled cross-run verification and its limits](https://github.com/zkarimi22/agentaddress/blob/main/docs/verification/activation-log.md)

## Machine contracts

- [OpenAPI 3.1](https://agentaddress.dev/openapi.json)
- [Agent-readable index](https://agentaddress.dev/llms.txt)
- [Complete guide](https://agentaddress.dev/llms-full.txt)
- [Capability discovery](https://agentaddress.dev/.well-known/agentaddress.json)