A API de Mailbox para agentes que respondem ao seu próprio e-mail.
Uma caixa de entrada real que o seu código controla. O e-mail chega como conversas; o seu agente lê e responde pela API. Sem IMAP, sem parsing 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_…", … } }
Reivindique, componha e responda na linguagem que já utiliza.
SDKs, CLI e o servidor MCP hospedado falam o mesmo ciclo.
Cada interface executa as mesmas quatro chamadas: reivindicar um endereço, aguardar um webhook, ler o novo conteúdo e responder. Escolha o seu runtime; o contrato é 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.",
});
Reivindicar, receber, ler, responder.
O ciclo completo são quatro chamadas.
O endereço é seu desde a primeira chamada e, no inbox.ai, fica permanentemente reservado para a sua organização. Nada faz polling: o passo 02 é o despertar, via webhook. Os exemplos são REST puro; os SDKs, o CLI e o servidor MCP hospedado executam o mesmo ciclo.
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"
}
Você decide o que entra.
Nada desaparece.
Uma política de receção e regras por remetente são aplicadas ao remetente do envelope; um bloqueio sempre prevalece sobre uma permissão. E-mails bloqueados por uma regra de remetente são armazenados silenciosamente — você ainda pode lê-los, e nenhum webhook é acionado. (A política `drop` descarta o e-mail completamente e não o armazena.)
O modelo lê a mensagem.
Not the old replies.
Cada mensagem expõe cabeçalhos, HTML, código-fonte bruto e anexos. O campo que o seu agente realmente quer é extracted_text: o conteúdo novo, sem citações. O contexto vive na thread, não em quarenta linhas de citação.
Para que pode usar Mailboxes.
Quatro tarefas que uma mailbox realiza desde o primeiro dia.
Uma caixa de entrada de suporte gerida pelo agente.
Cada conversa é um thread; o agente responde no próprio thread e sinaliza as mensagens incertas com uma etiqueta que um humano monitora.
Tudo na caixa.
A superfície completa num relance.
API de Caixa de Entrada.
Reivindique um endereço numa única chamada: gerado em inbox.ai, um handle personalizado ou o seu próprio domínio.
MCP & SDKs.
Um servidor MCP hospedado para agentes; SDKs e a CLI para todo o resto.
Threads & etiquetas.
Uma thread por conversa; etiquetas estilo Gmail com uma gramática PATCH única.
extracted_text.
O conteúdo novo, sem citações, pronto para entregar ao modelo.
Anexos.
Cabeçalhos, HTML, código-fonte bruto e anexos, tudo via API.
Eventos.
A família de webhooks email_mailbox.*: message_received, thread_created, message_sent, message_delivered, message_failed.
Regras de receção.
Uma política mais permissões e bloqueios por remetente, verificados contra o remetente do envelope.
Filtros de threads.
Filtre as threads de qualquer caixa de entrada por etiqueta, participante, assunto ou estado de leitura via API.
Chaves com escopo.
mailbox lê e escreve conversas; mailbox_management administra.
Envios com supressão integrada.
As respostas declaram marketing ou transacional; a lista de supressão é aplicada por categoria.
O e-mail chega.
O seu agente desperta.
Webhooks para entrega durável. Apenas e-mails que chegam à caixa de entrada disparam webhooks — spam e e-mails bloqueados são armazenados silenciosamente.
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_receivedO e-mail recebido chegou à caixa de entrada.email_mailbox.thread_createdUma nova conversa foi aberta.email_mailbox.message_sentUma resposta ou composição saiu da mailbox.email_mailbox.message_deliveredO servidor de destino aceitou a mensagem.email_mailbox.message_failedA entrega falhou; o estado é registado na mensagem.
Preços
Caixas de entrada incluídas no seu plano de Email
Não há uma assinatura separada para caixas de entrada. Todos os planos de e-mail incluem caixas de entrada com endereços @inbox.ai gerados; planos pagos adicionam handles personalizados.
Grátis
$0
Startup
a partir de $15/mês
Growth
a partir de $80/mês
Enterprise
Personalizado
Caixas de entrada (qualquer domínio)
5
a partir de 50
a partir de 100
Personalizado
Handles @inbox.ai personalizados
—
a partir de 10
a partir de 25
Personalizado
Endereços @inbox.ai gerados
Ilimitados dentro do seu número de caixas de correio, gratuitos em todos os planos
Handles no seu próprio domínio
Qualquer handle, sem uso de limite
Retenção de conversas
30 dias em todos os planos
Janela de restauração após exclusão
As caixas de correio excluídas entram numa janela de restauração de 30 dias. Os endereços Inbox.ai ficam permanentemente reservados para a sua organização; os endereços de domínio personalizado podem ser reatribuídos pelo mesmo workspace após 30 dias.
Os limites crescem com o volume de e-mail do seu plano. Downgrades nunca desativam uma caixa de correio: os handles que já reivindicou continuam a funcionar, apenas não pode reivindicar novos até voltar a estar dentro do limite.