API skrzynek pocztowych dla agentów, którzy sami odpowiadają na swoje e-maile.
Prawdziwa skrzynka odbiorcza, którą zarządza Twój kod. Wiadomości trafiają jako wątki; Twój agent odczytuje je i odpowiada przez API. Bez IMAP, bez parsowania 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_…", … } }
Przypisuj, twórz i odpowiadaj w języku, którego już używasz.
SDK, CLI i hostowany serwer MCP korzystają z tej samej pętli.
Każdy interfejs wykonuje te same cztery wywołania: przypisz adres, czekaj na webhook, odczytaj nową treść i odpowiedz. Wybierz swoje środowisko uruchomieniowe — kontrakt jest identyczny.
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.",
});
Przypisz, odbierz, odczytaj, odpowiedz.
Cała pętla to cztery wywołania.
Adres jest Twój od pierwszego wywołania, a na inbox.ai jest trwale zarezerwowany dla Twojej organizacji. Nic nie odpytuje: krok 02 to wybudzenie przez webhook. Przykłady są w czystym REST; SDK, CLI i hostowany serwer MCP wykonują tę samą pętlę.
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"
}
Ty decydujesz, co trafia do skrzynki.
Nic nie znika.
Polityka odbioru i reguły per nadawca są sprawdzane względem nadawcy koperty; blokada zawsze wygrywa z zezwoleniem. Wiadomości zablokowane przez regułę nadawcy są przechowywane w tle — nadal możesz je przeczytać, ale nie wyzwalają webhooków. (Polityka `drop` odrzuca wiadomość całkowicie i nie zapisuje jej.)
Model odczytuje wiadomość.
Not the old replies.
Każda wiadomość udostępnia nagłówki, HTML, surowe źródło i załączniki. Pole, którego Twój agent naprawdę potrzebuje, to extracted_text: nowa treść, bez cytatów. Kontekst znajduje się w wątku, a nie w czterdziestu linijkach cytowania.
Do czego możesz wykorzystać Mailboxes.
Cztery zadania, które skrzynka wykonuje od pierwszego dnia.
Skrzynka wsparcia zarządzana przez agenta.
Każda rozmowa to wątek; agent odpowiada w wątku i oznacza etykietą te niepewne — a człowiek je monitoruje.
Wszystko w skrzynce.
Pełen obraz na pierwszy rzut oka.
Inbox API.
Przypisz adres jednym wywołaniem: wygenerowany na inbox.ai, własny uchwyt lub Twoja domena.
MCP i SDK.
Hostowany serwer MCP dla agentów; SDK i CLI do wszystkiego innego.
Wątki i etykiety.
Jeden wątek na konwersację; etykiety w stylu Gmaila z prostą gramatyką PATCH.
extracted_text.
Nowa treść, bez cytatów, gotowa do przekazania modelowi.
Załączniki.
Nagłówki, HTML, surowe źródło i załączniki — wszystko przez API.
Zdarzenia.
Rodzina webhooków email_mailbox.*: message_received, thread_created, message_sent, message_delivered, message_failed.
Reguły odbioru.
Polityka plus listy zezwoleń i blokad per nadawca, weryfikowane względem nadawcy koperty.
Filtry wątków.
Filtruj wątki każdej skrzynki według etykiety, uczestnika, tematu lub statusu przeczytania przez API.
Klucze z ograniczonym zakresem.
mailbox odczytuje i zapisuje konwersacje; mailbox_management zarządza.
Wysyłki z uwzględnieniem suppressji.
Odpowiedzi deklarują typ marketingowy lub transakcyjny; lista suppressji jest egzekwowana według kategorii.
Wiadomość trafia.
Twój agent się budzi.
Webhooki zapewniające niezawodne dostarczanie. Tylko wiadomości trafiające do skrzynki odbiorczej są przekazywane do webhooków — spam i zablokowane wiadomości są zapisywane po cichu.
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_receivedWiadomość przychodząca trafiła do skrzynki.email_mailbox.thread_createdOtwarto nową konwersację.email_mailbox.message_sentOdpowiedź lub nowa wiadomość opuściła skrzynkę.email_mailbox.message_deliveredSerwer odbiorczy ją zaakceptował.email_mailbox.message_failedDostarczenie nie powiodło się; status wraca do wiadomości.
Cennik
Skrzynki są częścią Twojego planu Email
Nie ma osobnej subskrypcji skrzynek. Każdy plan e-mail obejmuje skrzynki z generowanymi adresami @inbox.ai; płatne plany dodają własne uchwyty.
Darmowy
$0
Startup
od 15 $/mies.
Growth
od 80 $/mies.
Enterprise
Indywidualny
Skrzynki (dowolna domena)
5
od 50
od 100
Indywidualny
Niestandardowe adresy @inbox.ai
—
od 10
od 25
Indywidualny
Wygenerowane adresy @inbox.ai
Bez limitu w ramach liczby skrzynek, bezpłatnie w każdym planie
Adresy na własnej domenie
Dowolny adres, bez zużywania limitu
Przechowywanie wątków
30 dni w każdym planie
Okno przywracania po usunięciu
Usunięte skrzynki wchodzą w 30-dniowe okno przywracania. Adresy inbox.ai pozostają na stałe zarezerwowane dla Twojej organizacji; adresy na własnej domenie mogą zostać ponownie przypisane przez ten sam workspace po 30 dniach.
Limity rosną wraz z wolumenem e-mail w Twoim planie. Obniżenie planu nigdy nie uszkodzi skrzynki: przypisane adresy nadal działają — po prostu nie można przypisywać nowych, dopóki nie wrócisz poniżej limitu.