Podsumowanie skrzynki
Sprawdź nieprzeczytane komentarze, wzmianki, wiadomości i opinie na swoich kontach, zobacz, z których kanałów skrzynki może korzystać każde konto, i poproś o świeży odczyt.
Skrzynka zbiera cztery kanały z połączonych kont: komentarze do postów, wzmianki o kontach w postach innych osób, wiadomości bezpośrednie oraz opinie w Google Business Profile. TikTok i X nie mają skrzynki.
https://post.adaptlypost.com/post/api/v1/inbox/summaryZwraca liczbę nieprzeczytanych elementów w każdym kanale oraz, dla każdego połączonego konta, dostępne kanały i czas ostatniego odczytu.
Każda rola ma inbox.read, więc skrzynkę może odczytać każdy ważny klucz.
Około 10 minut, nie w czasie rzeczywistym
AdaptlyPost odczytuje każde połączone konto co 10 minut i zapisuje znalezione dane. Listy korzystają z tej kopii, więc nowy komentarz, wzmianka, wiadomość lub opinia pojawia się w ciągu około 10 minut. POST /api/v1/inbox/refresh zleca odczyt od razu. Zdarzenia webhooków pochodzą z tych samych odczytów.Kanały wymagające ponownego połączenia
Każdy kanał jest dostępny przez API. Gdy połączeniu brakuje uprawnienia platformy do kanału lub działania, także takiego, które platforma nadal weryfikuje dla AdaptlyPost, GET /api/v1/inbox/summary pokazuje kanał jako RECONNECT_REQUIRED, a każdy zapis w nim zwraca 403 inbox_reconnect_required. Tak samo jest przy wygasłym tokenie. Należy poprosić użytkownika o ponowne połączenie konta w AdaptlyPost; ponawianie nie pomoże.Obsługiwane platformy
Kanały dostępne na każdej platformie. Konto ma tylko te kanały, do których jego połączenie ma uprawnienia; podsumowanie podaje to dla każdego konta.
| Platforma | Komentarze | Wzmianki | Wiadomości | Opinie |
|---|---|---|---|---|
FACEBOOK | Tak | Tak | Tak | Nie |
INSTAGRAM | Tak | Tylko odczyt, dla kont połączonych przez Facebooka | Tak | Nie |
THREADS | Tak | Tak | Nie | Nie |
YOUTUBE | Tak | Nie | Nie | Nie |
LINKEDIN | Tylko strony organizacji | Nie | Nie | Nie |
BLUESKY | Tak | Tak | Tak | Nie |
MASTODON | Tak | Tak | Tak | Nie |
GOOGLE_BUSINESS | Nie | Nie | Nie | Tak |
Pola podsumowania
| Pole | Opis |
|---|---|
unread | Elementy UNREAD w każdym kanale: comments, mentions, conversations i reviews |
accounts[].accountId | Id konta z GET /social-accounts, wraz z platform, accountName i avatarUrl |
accounts[].needsReconnect | True, gdy konto trzeba połączyć ponownie, aby odczytać jego komentarze |
accounts[].lastSyncedAt | Moment ostatniego odczytu konta przez AdaptlyPost lub null przed pierwszym odczytem |
accounts[].lastErrorCode | Przyczyna niepowodzenia ostatniego odczytu lub null |
accounts[].comments | AVAILABLE, RECONNECT_REQUIRED lub UNSUPPORTED dla danego kanału. Zob. poniżej |
accounts[].mentions | AVAILABLE, RECONNECT_REQUIRED lub UNSUPPORTED dla danego kanału. Zob. poniżej |
accounts[].messages | AVAILABLE, RECONNECT_REQUIRED lub UNSUPPORTED dla danego kanału. Zob. poniżej |
accounts[].reviews | AVAILABLE, RECONNECT_REQUIRED lub UNSUPPORTED dla danego kanału. Zob. poniżej |
Dostęp do kanałów
| Wartość | Opis |
|---|---|
AVAILABLE | Konto może korzystać z tego kanału |
RECONNECT_REQUIRED | Platforma ma ten kanał, ale połączeniu brakuje uprawnienia lub token wygasł. Zapisy zwracają 403 inbox_reconnect_required, dopóki użytkownik nie połączy konta ponownie w AdaptlyPost |
UNSUPPORTED | Platforma nie ma takiego kanału |
Natychmiastowy odczyt kont
https://post.adaptlypost.com/post/api/v1/inbox/refreshDodaje do kolejki odczyt każdego połączonego konta zamiast czekać na kolejne 10-minutowe uruchomienie i zwraca 202 { "queued": true }. Listy zmieniają się po zakończeniu odczytu.
Odmowy
Odrzucone wywołanie zwraca { statusCode, error, code, message }. Logikę należy opierać na code. message opisuje odmowę słownie.
| Kod | Status | Kiedy i co zrobić |
|---|---|---|
inbox_item_not_found | 404 | Id nie istnieje lub należy do innego obszaru roboczego. Należy przerwać |
inbox_action_unsupported | 400 | Platforma lub ten element nie pozwala na ukrycie, usunięcie lub polubienie. Możliwości opisuje capabilities. Należy przerwać |
inbox_reconnect_required | 403 | Połączeniu brakuje uprawnienia do tego kanału lub działania, także będącego w trakcie weryfikacji platformy, albo token wygasł. Należy poprosić użytkownika o ponowne połączenie konta w AdaptlyPost. Nie należy ponawiać |
inbox_reply_invalid | 400 | Tekst jest pusty lub przekracza limit. Komunikat podaje limit. Należy poprawić tekst |
inbox_messaging_window_closed | 400 | Facebook lub Instagram: minęło 24-godzinne okno na odpowiedź. Należy przerwać |
inbox_rate_limited | 429 | Platforma ograniczyła liczbę zapytań AdaptlyPost. Należy ponowić po pewnym czasie |
inbox_platform_error | 503 | Błąd platformy. Należy ponowić później |
permission_denied | 403 | Rola klucza nie ma inbox.read ani inbox.reply. Nie należy ponawiać |
subscription_required | 403 | Zapis bez aktywnego planu AdaptlyPost. Nie należy ponawiać |
curl --request GET \
--url https://post.adaptlypost.com/post/api/v1/inbox/summary \
--header 'Authorization: Bearer <api-key>'curl --request POST \
--url https://post.adaptlypost.com/post/api/v1/inbox/refresh \
--header 'Authorization: Bearer <api-key>'
202
{ "queued": true }{
"unread": {
"comments": 12,
"mentions": 3,
"conversations": 2,
"reviews": 1
},
"accounts": [
{
"accountId": "conn_ig_001",
"platform": "INSTAGRAM",
"accountName": "adaptlypost",
"avatarUrl": "https://cdn.adaptlypost.com/avatars/ig_001.jpg",
"needsReconnect": false,
"lastSyncedAt": "2026-11-08T09:40:12.000Z",
"lastErrorCode": null,
"comments": "AVAILABLE",
"mentions": "AVAILABLE",
"messages": "RECONNECT_REQUIRED",
"reviews": "UNSUPPORTED"
},
{
"accountId": "conn_gbp_001",
"platform": "GOOGLE_BUSINESS",
"accountName": "AdaptlyPost Kraków",
"avatarUrl": null,
"needsReconnect": false,
"lastSyncedAt": "2026-11-08T09:38:55.000Z",
"lastErrorCode": null,
"comments": "UNSUPPORTED",
"mentions": "UNSUPPORTED",
"messages": "UNSUPPORTED",
"reviews": "AVAILABLE"
}
]
}