L<accent>API Mailbox</accent> per agenti che rispondono alle proprie email.
Una vera casella di posta controllata dal tuo codice. La posta arriva come thread; il tuo agente legge e risponde tramite API. Niente IMAP, niente parsing 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_…", … } }
Richiedi, componi e rispondi nel linguaggio che già usi.
SDK, CLI e il server MCP hosted parlano tutti lo stesso ciclo.
Ogni superficie esegue le stesse quattro chiamate: richiedi un indirizzo, attendi un webhook, leggi il nuovo contenuto e rispondi. Scegli il tuo runtime; il contratto è identico.
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.",
});
Richiedi, ricevi, leggi, rispondi.
L'intero ciclo in quattro chiamate.
L'indirizzo è tuo dalla prima chiamata e su inbox.ai è riservato in modo permanente alla tua organizzazione. Niente polling: lo step 02 è il risveglio, via webhook. Gli esempi sono in plain REST; gli SDK, la CLI e il server MCP hosted eseguono lo stesso 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"
}
Decidi tu cosa entra.
Nulla scompare.
Una policy di ricezione e regole per singolo mittente vengono applicate all'envelope sender; un blocco prevale sempre su un consenso. La posta bloccata da una regola mittente viene archiviata silenziosamente — puoi comunque leggerla e non attiva webhook. (La policy `drop` scarta la posta completamente e non la archivia.)
Il modello legge il messaggio.
Not the old replies.
Ogni messaggio espone header, HTML, sorgente raw e allegati. Il campo che il tuo agente vuole davvero è extracted_text: il nuovo contenuto, senza citazioni. Il contesto vive nel thread, non in quaranta righe di quoting.
Cosa puoi fare con Mailboxes.
Quattro attività che una casella di posta svolge dal primo giorno.
Una casella di supporto gestita dall'agente.
Ogni conversazione è un thread; l'agente risponde nel thread e contrassegna con un'etichetta quelli incerti, monitorati da un operatore umano.
Tutto nella casella.
L'intera superficie a colpo d'occhio.
Inbox API.
Richiedi un indirizzo con una sola chiamata: generato su inbox.ai, un handle personalizzato o il tuo dominio.
MCP e SDK.
Un server MCP hosted per gli agenti; SDK e CLI per tutto il resto.
Thread ed etichette.
Un thread per conversazione; etichette in stile Gmail con una singola grammatica PATCH.
extracted_text.
Il nuovo contenuto, senza citazioni, pronto da passare al modello.
Allegati.
Header, HTML, sorgente raw e allegati, tutto tramite API.
Eventi.
La famiglia di webhook email_mailbox.*: message_received, thread_created, message_sent, message_delivered, message_failed.
Regole di ricezione.
Una policy più consensi e blocchi per singolo mittente, verificati sull'envelope sender.
Filtri dei thread.
Filtra i thread di ogni casella per etichetta, partecipante, oggetto o stato di lettura tramite API.
Chiavi con ambito.
mailbox legge e scrive conversazioni; mailbox_management amministra.
Invii con gestione delle soppressioni.
Le risposte dichiarano marketing o transazionale; la lista di soppressione viene applicata per categoria.
La posta arriva.
Il tuo agente si attiva.
Webhook per la consegna durevole. Solo la posta che raggiunge la inbox viene inoltrata ai webhook — spam e posta bloccata vengono archiviati silenziosamente.
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_receivedLa posta in arrivo ha raggiunto la inbox.email_mailbox.thread_createdUna nuova conversazione è stata aperta.email_mailbox.message_sentUna risposta o un messaggio ha lasciato la casella di posta.email_mailbox.message_deliveredIl server ricevente l'ha accettata.email_mailbox.message_failedConsegna fallita; lo stato viene aggiornato sul messaggio.
Prezzi
Le caselle di posta sono incluse nel piano Email
Non esiste un abbonamento separato per le caselle. Ogni piano email include caselle con indirizzi @inbox.ai generati; i piani a pagamento aggiungono handle personalizzati.
Gratuito
$0
Startup
da 15 $/mese
Growth
da 80 $/mese
Enterprise
Personalizzato
Caselle di posta (qualsiasi dominio)
5
da 50
da 100
Personalizzato
Handle @inbox.ai personalizzati
—
da 10
da 25
Personalizzato
Indirizzi @inbox.ai generati
Illimitati entro il numero di caselle, gratuiti su ogni piano
Handle sul proprio dominio
Qualsiasi handle, nessuna quota utilizzata
Conservazione dei thread
30 giorni su ogni piano
Finestra di ripristino dopo l'eliminazione
Le caselle eliminate entrano in una finestra di ripristino di 30 giorni. Gli indirizzi Inbox.ai restano riservati in modo permanente alla vostra organizzazione; gli indirizzi con dominio personalizzato possono essere riassegnati dallo stesso workspace dopo 30 giorni.
Le quote crescono con il volume email del vostro piano. I downgrade non compromettono mai una casella: gli handle già rivendicati continuano a funzionare, semplicemente non potrete rivendicarne di nuovi finché non rientrate nella quota.