La API de buzones para agentes que responden su propio correo.
Un buzón real que tu código controla. El correo llega como hilos de conversación; tu agente lee y responde a través de la API. Sin IMAP, sin parseo de MIME.
# Claim an address on inbox.ai
curl -X POST https://us1.platform.bird.com/v1/email/mailboxes \
-H "Authorization: Bearer $BIRD_API_KEY" \
-d '{
"domain": "inbox.ai",
"local_part": "goldcrest",
"display_name": "Goldcrest Support"
}'
{
"id": "mbx_01krdgeqcxet5s7t44vh8rt9mg",
"address": "goldcrest@inbox.ai",
"receive_policy": "open",
"state": "active"
}
# Mail arrives; your webhook fires
POST /your-webhook-endpoint
{ "type": "email_mailbox.message_received", "data": { "thread_id": "thr_…", … } }
Reclama, redacta y responde en el lenguaje que ya usas.
Los SDK, la CLI y el servidor MCP alojado hablan el mismo flujo.
Cada interfaz ejecuta las mismas cuatro llamadas: reclamar una dirección, esperar un webhook, leer el contenido nuevo y responder. Elige tu entorno de ejecución; el contrato es idéntico.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
// Claim an address on inbox.ai
const mailbox = await bird.mailbox.create({
domain: "inbox.ai",
local_part: "support",
display_name: "Acme Support",
receive_policy: "open",
});
// Send a message from the mailbox
await bird.mailbox.compose(mailbox.id, {
to: ["alice@example.com"],
subject: "Your request has been received",
text: "We'll get back to you within one business day.",
});
Reclama, recibe, lee, responde.
El flujo completo son cuatro llamadas.
La dirección es tuya desde la primera llamada, y en inbox.ai queda reservada permanentemente para tu organización. Nada hace polling: el paso 02 es el despertar, vía webhook. Los ejemplos son REST puro; los SDK, la CLI y el servidor MCP alojado ejecutan el mismo flujo.
curl -X POST https://us1.platform.bird.com/v1/email/mailboxes \
-H "Authorization: Bearer $BIRD_API_KEY" \
-d '{"domain": "inbox.ai", "receive_policy": "open"}'
{
"id": "mbx_01krdgeqcxet5s7t44vh8rt9mg",
"address": "k7mq3vx2npr5wcj4tzh6@inbox.ai",
"state": "active"
}
curl -X POST https://us1.platform.bird.com/v1/email/mailboxes \
-H "Authorization: Bearer $BIRD_API_KEY" \
-d '{"domain": "inbox.ai", "receive_policy": "open"}'
{
"id": "mbx_01krdgeqcxet5s7t44vh8rt9mg",
"address": "k7mq3vx2npr5wcj4tzh6@inbox.ai",
"state": "active"
}
Tú decides qué entra.
Nada desaparece.
Una política de recepción y reglas por remitente se evalúan contra el remitente del sobre; un bloqueo siempre prevalece sobre una autorización. El correo bloqueado por una regla de remitente se almacena en silencio: aún puedes leerlo y no dispara webhooks. (La política `drop` descarta el correo por completo y no lo almacena.)
El modelo lee el mensaje.
Not the old replies.
Cada mensaje expone encabezados, HTML, código fuente sin procesar y archivos adjuntos. El campo que tu agente realmente necesita es extracted_text: el contenido nuevo, sin citas. El contexto vive en el hilo, no en cuarenta líneas de citas.
Para qué puedes usar Mailboxes.
Cuatro tareas que un buzón realiza desde el primer día.
Una bandeja de entrada de soporte gestionada por el agente.
Cada conversación es un hilo; el agente responde dentro del hilo y marca con una etiqueta los casos dudosos para que un humano los revise.
Todo en el buzón.
Toda la superficie de un vistazo.
API de buzón.
Reclama una dirección en una sola llamada: generada en inbox.ai, un identificador personalizado o tu propio dominio.
MCP y SDKs.
Un servidor MCP alojado para agentes; SDKs y la CLI para todo lo demás.
Hilos y etiquetas.
Un hilo por conversación; etiquetas estilo Gmail con una gramática PATCH única.
extracted_text.
El contenido nuevo, sin citas, listo para enviar al modelo.
Archivos adjuntos.
Encabezados, HTML, código fuente sin procesar y archivos adjuntos, todo a través de la API.
Eventos.
La familia de webhooks email_mailbox.*: message_received, thread_created, message_sent, message_delivered, message_failed.
Reglas de recepción.
Una política más listas de autorización y bloqueo por remitente, verificadas contra el remitente del sobre.
Filtros de hilos.
Filtra los hilos de cualquier buzón por etiqueta, participante, asunto o estado de lectura a través de la API.
Claves con alcance definido.
mailbox lee y escribe conversaciones; mailbox_management administra.
Envíos con reconocimiento de supresión.
Las respuestas se declaran como marketing o transaccionales; la lista de supresión se aplica por categoría.
Llega el correo.
Tu agente despierta.
Webhooks para entrega duradera. Solo el correo que llega a la bandeja de entrada se envía a los webhooks — el spam y el correo bloqueado se almacenan en silencio.
POST /your-webhook-endpoint HTTP/1.1
Content-Type: application/json
{
"type": "email_mailbox.message_received",
"timestamp": "2026-07-23T14:11:02Z",
"data": {
"thread_id": "thr_01krdh2p8qz3m9wv6xf0abcnde",
"message_id": "rem_01krdh3v7t2j5nqx8fw4mzp6bc"
}
}
email_mailbox.message_receivedEl correo entrante llegó a la bandeja de entrada.email_mailbox.thread_createdSe abrió una nueva conversación.email_mailbox.message_sentUna respuesta o composición salió del buzón.email_mailbox.message_deliveredEl servidor receptor lo aceptó.email_mailbox.message_failedLa entrega falló; el estado se refleja de vuelta en el mensaje.
Precios
Los buzones están incluidos en tu plan de Email
No hay una suscripción de buzón separada. Cada plan de email incluye buzones con direcciones generadas @inbox.ai; los planes de pago añaden identificadores personalizados.
Gratis
$0
Startup
desde $15/mes
Growth
desde $80/mes
Enterprise
Personalizado
Buzones (cualquier dominio)
5
desde 50
desde 100
Personalizado
Identificadores @inbox.ai personalizados
—
desde 10
desde 25
Personalizado
Direcciones @inbox.ai generadas
Ilimitadas dentro de tu cantidad de buzones, gratis en todos los planes
Identificadores en tu propio dominio
Cualquier identificador, sin consumo de asignación
Retención de hilos
30 días en todos los planes
Ventana de restauración tras eliminar
Los buzones eliminados entran en una ventana de restauración de 30 días. Las direcciones inbox.ai permanecen reservadas permanentemente para tu organización; las direcciones de dominio propio pueden reasignarse por el mismo workspace después de 30 días.
Las asignaciones crecen con el volumen de correo de tu plan. Las reducciones de plan nunca rompen un buzón: los identificadores que ya reclamaste siguen funcionando, simplemente no puedes reclamar nuevos hasta que vuelvas a estar dentro de la asignación.