Die Mailbox API für Agenten, die ihre eigenen E-Mails beantworten.
Ein echtes Postfach, das Ihr Code besitzt. E-Mails landen als Threads; Ihr Agent liest und antwortet über die API. Kein IMAP, kein MIME-Parsing.
# 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_…", … } }
Täglich vertraut von Teams, die erstklassige Software entwickeln
Weitere Kundenberichte lesenBeanspruchen, verfassen und antworten – in der Sprache, die Sie bereits nutzen.
SDKs, CLI und der gehostete MCP-Server sprechen denselben Loop.
Jede Oberfläche führt dieselben vier Aufrufe aus: Adresse beanspruchen, auf einen Webhook warten, den neuen Inhalt lesen und antworten. Wählen Sie Ihre Runtime – der Vertrag ist identisch.
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.email.mailboxes.create({
domain: "inbox.ai",
local_part: "support",
display_name: "Acme Support",
receive_policy: "open",
});
// Send a message from the mailbox
await bird.email.mailboxes.messages.create(mailbox.id, {
to: ["alice@example.com"],
subject: "Your request has been received",
text: "We'll get back to you within one business day.",
});
Beanspruchen, empfangen, lesen, antworten.
Der gesamte Loop besteht aus vier Aufrufen.
Die Adresse gehört Ihnen ab dem ersten Aufruf, und auf inbox.ai ist sie dauerhaft für Ihre Organisation reserviert. Kein Polling: Schritt 02 ist das Aufwecken per Webhook. Die Beispiele sind reines REST; die SDKs, die CLI und der gehostete MCP-Server führen denselben Loop aus.
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"
}
Sie entscheiden, was reinkommt.
Wenden Sie Ihre Empfangsrichtlinie an.
Eine Empfangsrichtlinie und absenderspezifische Regeln prüfen den Envelope-Sender; ein Block schlägt immer ein Allow. Von einer Absenderregel blockierte Mails werden stillschweigend gespeichert – Sie können sie weiterhin lesen, und es werden keine Webhooks ausgelöst. (Die `drop`-Richtlinie verwirft Mails vollständig und speichert sie nicht.)
Das Modell liest die Nachricht.
Nicht die alten Antworten.
Nachrichten stellen Header, extrahierten Text und Anhänge innerhalb ihres Aufbewahrungszeitraums bereit. Originale Nachrichtentexte und empfangene MIME-Rohdaten haben ein separates 30-Tage-Fenster. Das Feld, das Ihr Agent tatsächlich benötigt, ist extracted_text: der neue Inhalt, ohne Zitate. Der Kontext liegt im Thread, nicht in vierzig Zeilen Zitiertext.
Wofür Sie Mailboxes nutzen können.
Vier Aufgaben, die eine Mailbox ab dem ersten Tag erledigt.
Ein Support-Postfach, das der Agent betreibt.
Jede Konversation ist ein Thread; der Agent antwortet im Thread und markiert unsichere Fälle mit einem Label, das ein Mensch überwacht.
Alles in der Box.
Die gesamte Oberfläche auf einen Blick.
Inbox API.
Beanspruchen Sie eine Adresse mit einem einzigen Aufruf: generiert auf inbox.ai, ein benutzerdefiniertes Handle oder Ihre eigene Domain.
MCP & SDKs.
Ein gehosteter MCP-Server für Agents; SDKs und die CLI für alles andere.
Threads & Labels.
Ein Thread pro Konversation; Labels im Gmail-Stil mit einer einzigen PATCH-Grammatik.
extracted_text.
Der neue Inhalt, ohne Zitate, bereit zur Übergabe an das Modell.
Anhänge.
Lesen Sie gespeicherte Anhänge über die API. Originale Nachrichtentexte und empfangene MIME-Rohdaten haben ein separates 30-Tage-Fenster.
Events.
Die email_mailbox.*-Webhook-Familie: message_received, thread_created, message_sent, message_delivered, message_failed.
Empfangsregeln.
Eine Richtlinie plus absenderspezifisches Allow und Block, geprüft gegen den Envelope-Sender.
Thread-Filter.
Filtern Sie die Threads jeder Mailbox nach Label, Teilnehmer, Betreff oder Lesestatus über die API.
Zugriffsschlüssel mit Geltungsbereich.
mailbox liest und schreibt Konversationen; mailbox_management verwaltet.
Versand mit Unterdrückungslisten-Prüfung.
Antworten werden als Marketing oder Transaktional deklariert; die Unterdrückungsliste wird nach Kategorie durchgesetzt.
E-Mail trifft ein.
Ihr Agent wird geweckt.
Webhooks für zuverlässige Zustellung. Nur E-Mails, die den Posteingang erreichen, lösen Webhooks aus – Spam und blockierte E-Mails werden stillschweigend gespeichert.
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_receivedEingehende E-Mail hat den Posteingang erreicht.email_mailbox.thread_createdEine neue Konversation wurde eröffnet.email_mailbox.message_sentEine Antwort oder neue Nachricht hat die Mailbox verlassen.email_mailbox.message_deliveredDer empfangende Server hat sie akzeptiert.email_mailbox.message_failedZustellung fehlgeschlagen; der Status wird der Nachricht zugeordnet.
Fragen zu Agent-Mailboxen
Wie unterscheidet sich eine Agent Mailbox von eingehenden E-Mails?
Kann ich meine eigene Domain verwenden?
Wie lange sind Postfachinhalte verfügbar?
Kann ein Agent ohne Polling zuhören?
Die richtige E-Mail-Integration wählen
Verwenden Sie eine Mailbox, wenn Ihre Anwendung eine Adresse, gespeicherte Konversationen und Antworten benötigt.
Preise
Mailboxen sind in Ihrem Email-Plan enthalten
Es gibt kein separates Mailbox-Abo. Jeder Email-Plan enthält Mailboxen mit generierten @inbox.ai-Adressen; kostenpflichtige Pläne bieten benutzerdefinierte Handles.
Kostenlos
Kostenlos
Startup
Kostenpflichtiger Plan
Growth
Kostenpflichtiger Plan
Enterprise
Individuell
Mailboxen (beliebige Domain)
5
ab 50
ab 100
Individuell
Benutzerdefinierte @inbox.ai-Handles
—
ab 10
ab 25
Individuell
Aufbewahrung von Text und Anhängen
30 Tage
30 Tage
90 bis 365 Tage
Individuell
Gemeinsamer Postfachspeicher
1,25 GB
ab 12,5 GB
ab 25 GB
Individuell
Wie der Speicher geteilt wird
Ein organisationsweites Kontingent wird von allen aktiven und wiederherstellbaren Postfächern gemeinsam genutzt.
Generierte @inbox.ai-Adressen
Unbegrenzt innerhalb Ihres Postfach-Kontingents, in jedem Plan kostenlos
Handles auf Ihrer eigenen Domain
Beliebiges Handle, kein Kontingent verbraucht
Was eine längere Stufe aufbewahrt
Eine längere Stufe bewahrt Nachrichtenheader, extrahierten Text und Anhänge auf. Originale Nachrichtentexte, empfangene MIME-Rohdaten und Weiterleitungen sind bei jedem Plan auf 30 Tage begrenzt. Sie können danach weiterhin extrahierten Text lesen und mit neuem Inhalt antworten.
Wiederherstellungsfenster nach Löschung
Gelöschte Postfächer haben ein 30-tägiges Wiederherstellungsfenster. Inbox.ai-Adressen bleiben dauerhaft für Ihre Organisation reserviert; Custom-Domain-Adressen können nach 30 Tagen vom selben Workspace neu zugewiesen werden.
Kontingente wachsen mit dem E-Mail-Volumen Ihres Plans. Downgrades deaktivieren nie ein Postfach: Bereits beanspruchte Handles funktionieren weiterhin – Sie können nur keine neuen beanspruchen, bis Sie wieder unter dem Kontingent liegen.
In die Praxis umsetzen.
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.
Sprechen Sie mit unserem E-Mail-Team
Geben Sie Ihrem Agenten einen E-Mail-Workflow.
Besprechen Sie, wie Ihre Anwendung oder Ihr KI-Agent Nachrichten empfängt, Threads verfolgt und Antworten sendet. Wir helfen Ihnen bei der Planung der Integration.
Erstellen Sie Ihr Konto, wählen Sie eine Adresse und empfangen Sie Ihre erste Nachricht.