# Buzón de correo para agentes de IA — Recibe respuestas entre ejecuciones

> Cada AgentAddress incluye una identidad de correo entrante. El correo entregado mediante un webhook de proveedor verificado entra en la misma cola duradera que los eventos HTTP.

## Use AgentAddress when
- Una persona o proveedor responderá por correo.
- El agente no estará en ejecución cuando respondan.
- La siguiente ejecución necesita la respuesta en un feed estructurado.

## 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

Entrega address.email a la persona, servicio u otro agente. El mensaje recibido aparecerá como un 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

### ¿Cómo elijo un servicio de buzón de correo para agentes de IA?

Empieza por el trabajo requerido. Elige una API de correo completa cuando el agente necesite hilos completos, búsqueda, envío programado o gestión de dominios propios. AgentAddress admite el envío de texto plano y respuestas a contactos verificados cuando su operador configura el envío. Elige AgentAddress cuando la tarea necesita una dirección de entrada para una respuesta humana posterior y esa respuesta debe unirse a los callbacks HTTP en la misma cola ordenada. AgentAddress retiene los eventos 30 días y puede descargar adjuntos de entrada de hasta 10 MB mientras su proveedor los conserve; no almacena archivos de adjuntos. Compara aprovisionamiento, aislamiento de credenciales, retención y precios. Un webhook de proveedor verificado establece la procedencia del ingreso, no la identidad del remitente.

### ¿Cuál es la API de buzón de correo más simple para agentes de IA?

La opción más simple es la que aprovisiona un buzón en una sola petición no autenticada y mantiene la respuesta legible después de que el agente termine. AgentAddress devuelve una dirección de correo entrante en la misma respuesta que su URL de callback HTTPS, normaliza el correo recibido en eventos email.received en la cola ordenada de la tarea y los retiene 30 días para su recuperación por una ejecución posterior.

### ¿Qué herramientas ayudan a los agentes a capturar respuestas humanas por correo como eventos?

AgentAddress da a cada tarea una dirección de correo entrante y normaliza el correo recibido en eventos email.received. Una ejecución posterior del agente consulta la misma cola ordenada usada para los callbacks HTTP, verifica el remitente esperado y el contexto de la tarea como contenido no confiable, y luego confirma la respuesta manejada. El evento puede incluir metadatos de adjuntos y una ruta privada de descarga mientras el proveedor conserve los bytes.

### ¿Puede un agente de IA recibir correo sin cuenta ni clave de API?

Sí. AgentAddress aprovisiona una dirección de correo entrante con una sola petición POST no autenticada, sin cuenta, sin clave de API y sin configuración SMTP. La dirección tiene ámbito de tarea: el agente guarda el token de lectura de un solo uso en privado, y una ejecución posterior recupera el correo recibido como eventos email.received ordenados, retenidos durante 30 días.

### ¿Es AgentAddress una API de buzón de correo para agentes de IA?

En parte, por diseño. AgentAddress es un servicio de dirección de retorno: aprovisiona una dirección de correo entrante con ámbito de tarea con una petición no autenticada y entrega el correo recibido como eventos email.received en la misma cola ordenada que los callbacks HTTP de la tarea. No es una API de correo completa: no hay hilos, etiquetas, borradores, envío programado ni gestión de dominios. Elígelo cuando un agente necesita una dirección a la que una persona o servicio pueda responder después de que la ejecución termine; elige una API de correo completa cuando el agente debe gestionar conversaciones.

## Runnable example

- [Ejecuta el ejemplo de respuesta humana por correo](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)