Skrzynki agentowe
Skrzynka agentowa to adresowalna skrzynka odbiorcza, którą Twój kod zarządza przez API. Czytaj i filtruj jej wątki, odpowiadaj na wiadomości lub twórz nowe bez uruchamiania serwera IMAP i bez parsowania surowego MIME.
Skrzynka działa na współdzielonej domenie inbox.ai albo na Twojej własnej domenie nadawczej z włączonym odbiorem. Adres jest rezerwowany w momencie utworzenia skrzynki i pozostaje Twój: część lokalna jest przypisana do Twojego obszaru roboczego i nigdy nie zostanie przekazana nikomu innemu, nawet po usunięciu skrzynki.
Adresy
Każda skrzynka ma jeden adres, {local_part}@inbox.ai. Adres możesz uzyskać na dwa sposoby:
- Wygenerowany: pomiń część lokalną, a wygenerujemy dla Ciebie unikalną (a7f3k2@inbox.ai). Zawsze dostępny.
- Własny: podaj konkretną część lokalną (support@inbox.ai). Własne identyfikatory są globalnie unikalne, przydzielane w kolejności zgłoszeń i wliczane w limit płatnego planu; darmowy obszar roboczy korzysta z adresów generowanych.
Adres po utworzeniu jest niezmienny. Aby go zmienić, utwórz nową skrzynkę i usuń starą. Stara część lokalna jest przechowywana przez 30 dni (okno przywracania), zanim będzie mogła zostać ponownie zajęta, i pozostaje zarezerwowana dla Twojego obszaru roboczego.
Wątki i wiadomości
Odebrana i wysłana poczta jest grupowana w wątki, jeden na konwersację. Wątek zawiera adresy uczestników, licznik nieprzeczytanych, kierunek najnowszej wiadomości (inbound lub outbound) oraz znacznik czasu ostatniej aktywności. Odpowiedzi trafiają do wątku, na który odpowiadają; nowa wiadomość rozpoczyna nowy wątek.
Każda wiadomość udostępnia nagłówki, wyekstrahowany tekst z usuniętą historią cytowań oraz załączniki. Oryginalne treści są dostępne przez 30 dni; surowy MIME jest dostępny tylko dla wiadomości odebranych. Identyfikatory wiadomości mają prefiks kierunku: rem_ dla wiadomości odebranej, em_ dla wysłanej.
Kontrola przyjmowania poczty
Przed skrzynką odbiorczą działają dwie kontrole, obie sprawdzane względem nadawcy kopertowego, a nie nagłówka From:, który można sfałszować:
- Polityka odbioru: domyślna reguła całej skrzynki.
- open akceptuje wszystko, co przejdzie uwierzytelnianie.
- replies_only akceptuje tylko pocztę kontynuującą wątek już istniejący w skrzynce.
- allowlist akceptuje tylko nadawców dopuszczonych przez Twoje reguły oraz odpowiedzi na istniejący wątek.
- drop odrzuca wszystko, bez wyjątków.
- Reguły odbioru: wpisy zezwalające lub blokujące poszczególnych nadawców, dopasowywane po pełnym adresie lub domenie (reguła domenowa obejmuje też subdomeny). Blokada zawsze wygrywa z zezwoleniem.
Poczta zablokowana przez regułę lub odrzucona przez DMARC nadal jest przechowywana w skrzynce i pozostaje czytelna: jest odkładana poza skrzynkę odbiorczą, a nie kasowana, i nie wyzwala webhooka. Jedynym wyjątkiem jest skrzynka ustawiona na drop, która odrzuca wszystko u progu zamiast odkładać.
Wysyłanie
Skrzynka wysyła na dwa sposoby przez API: odpowiedź na wiadomość (wiadomość wychodząca trafia do tego samego wątku) lub nowa wiadomość (która otwiera nowy wątek). W panelu otwórz wiadomość i wybierz Przekaż dalej, aby wysłać jej oryginalną treść i załączniki do nowych odbiorców w ramach 30-dniowego okna dostępności treści. Poczta jest wysyłana z adresu skrzynki, z nazwą wyświetlaną i domyślnym Reply-To, które na niej skonfigurowałeś. Status doręczenia jest dołączany do wysłanej wiadomości, więc widzisz, czy odpowiedź została doręczona, czy odrzucona.
Zdarzenia
Subskrybuj rodzinę webhooków email_mailbox.*, aby sterować agentem bez odpytywania: email_mailbox.message_received (poczta przychodząca dotarła do skrzynki odbiorczej), email_mailbox.thread_created oraz zdarzenia statusu doręczenia dla wysyłanych wiadomości. Tylko poczta ze skrzynki odbiorczej generuje zdarzenia; spam i poczta zablokowana regułami są przechowywane po cichu, więc zalana skrzynka nie wywoła lawiny webhooków. Poczta ze skrzynki odbiorczej wyzwala też standardowe zdarzenie email.received, więc istniejąca integracja przychodząca działa bez zmian.
Aby obserwować aktywność na żywo bez infrastruktury webhookowej, połącz się z GET /v1/email/mailboxes/{mailbox_id}/events. Strumień SSE wysyła typ zdarzenia, identyfikator wątku i identyfikator wiadomości dla aktywności skrzynki, w tym spamu i zablokowanych wiadomości. Pobieraj pełne wiadomości na podstawie tych identyfikatorów. Strumień nie odtwarza zdarzeń po rozłączeniu. Używaj webhooków do trwałego dostarczania, a endpointów listujących do nadrobienia zaległości po przerwie.
Retencja i usuwanie
Warstwa retencji skrzynki określa, jak długo możesz czytać nagłówki wiadomości, wyekstrahowany tekst i załączniki skrzynki, licząc od wysłania lub odbioru. Domyślnie jest to 30 dni. Jeśli Twój plan obejmuje retencję 90- lub 365-dniową, ustaw retention_tier podczas tworzenia lub aktualizacji. Warstwa nieuwzględniona w planie jest odrzucana z E17048.
| Treść lub działanie | Okno retencji |
|---|---|
| Nagłówki wiadomości, wyekstrahowany tekst i załączniki skrzynki | Wybrana warstwa: 30, 90 lub 365 dni |
| Oryginalne treści HTML i tekstowe | 30 dni na każdej warstwie |
| Surowy MIME dla wiadomości odebranych | 30 dni na każdej warstwie; wysłane wiadomości nie mają przechowywanego surowego MIME |
| Przekazywanie wiadomości w panelu | Wymaga oryginalnej treści w jej 30-dniowym oknie |
| Odczyt wyekstrahowanego tekstu lub odpowiedź z nową treścią | Dostępne, dopóki wiadomość jest przechowywana |
Na przykład w 40. dniu wiadomość w skrzynce z retencją 90-dniową wciąż ma czytelny, przeszukiwalny wyekstrahowany tekst i zachowane załączniki. Możesz odpowiedzieć z nową treścią, ale nie możesz otworzyć oryginalnej treści, pobrać surowego MIME ani przekazać wiadomości. Wyekstrahowany tekst jest ograniczony do 64 KiB na wiadomość i może pomijać fragmenty oryginału. Załączniki zapisane przed włączeniem rozszerzonej retencji załączników zachowują swój pierwotny termin wygaśnięcia wynoszący około 31 dni; zmiana warstwy ich nie migruje. Podniesienie warstwy nie przywróci treści, która została już usunięta.
Wiadomości przestają być zwracane przez API, gdy ich retencja wygaśnie. Cykliczne czyszczenie co godzinę przetwarza usuwanie w tle; fizyczne usunięcie może nastąpić z opóźnieniem względem wygaśnięcia API.
Obniżenie warstwy działa na odczyty natychmiast: wszystko starsze niż nowy próg przestaje być zwracane od razu. Masz dziesięć minut na cofnięcie tej operacji i dziesięć minut to jedyna gwarancja: podnieś warstwę ponownie w tym oknie, a nic nie zostanie utracone. Po jego upływie osierocone wiadomości stają się kwalifikowane do usunięcia i następne cykliczne czyszczenie je zabiera, więc późniejsze podniesienie odzyskuje tylko to, czego czyszczenie jeszcze nie objęło.
Podniesienie do warstwy uwzględnionej w planie jest akceptowane w dowolnym momencie, także gdy wcześniejsza zmiana jest jeszcze stosowana. Aktualizacja w tle jest niezależna od dziesięciominutowego okna cofania. Ponowne obniżenie jest akceptowane po tym, jak pierwsza zmiana zaktualizuje każdą przechowywaną wiadomość. Aktualizacja startuje co dziesięć minut i w przypadku dużych skrzynek może trwać godzinami. Dopóki się nie zakończy, API zwraca E17050; spróbuj ponownie później.
Jeśli Twój plan określa skończony limit przestrzeni skrzynek, jeden limit jest współdzielony przez wszystkie aktywne i możliwe do przywrócenia skrzynki. Każda skrzynka raportuje swój udział jako size_bytes. Plan bez skończonego limitu zapewnia nieograniczoną przestrzeń skrzynek. Gdy skrzynki łącznie osiągną skończony limit, wysyłanie jest odrzucane z E17049, dopóki nie zwolnisz miejsca w którejkolwiek z nich.
Usunięcie skrzynki natychmiast wstrzymuje odbieranie poczty. Skrzynkę można przywrócić przez 30 dni, a normalne wygasanie retencji wiadomości trwa nadal. Po 30 dniach trwałe usunięcie kasuje skrzynkę i jej pozostałe wiadomości. Gdy trwałe usunięcie się rozpocznie, przywracanie jest odrzucane, nawet jeśli czyszczenie wciąż trwa. Adres pozostaje zarezerwowany dla Twojego obszaru roboczego.
Następne kroki
- Utwórz swoją pierwszą skrzynkę: ścieżka API od utworzenia do odpowiedzi.
- Buduj z AI: steruj skrzynkami z agenta przez serwer MCP.
Powiązane zasoby
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.
Obejrzyj przewodnikGetting started with emailPoznaj możliwościEmailPodążaj ścieżką naukiBuild your first integrationPrzewodnik wdrożeniowySend your first email
Wypróbuj ćwiczenie i uzyskaj brief wdrożeniowy