Wzmianki w skrzynce
Wyświetl posty i komentarze wspominające twoje konta na Facebooku, Instagramie, Threads, Bluesky i Mastodonie, odpowiadaj na nie i oznaczaj je jako przeczytane.
https://post.adaptlypost.com/post/api/v1/inbox/mentionsZwraca posty i komentarze wspominające konta, od najnowszych. Odpowiedź: { mentions, total, hasMore, nextCursor }.
Każda rola ma inbox.read, więc skrzynkę może odczytać każdy ważny klucz.
Parametry zapytania
| Parametr | Typ | Opis |
|---|---|---|
accountIds | string[] | Tylko te konta, według id z GET /social-accounts. Klucz można powtórzyć lub rozdzielić wartości przecinkami. Do 50 |
platforms | PlatformType[] | Tylko te platformy. Klucz można powtórzyć lub rozdzielić wartości przecinkami |
statuses | InboxStatus[] | Tylko elementy w tych stanach: UNREAD, READ lub DONE. Klucz można powtórzyć lub rozdzielić wartości przecinkami |
since | string (ISO 8601) | Tylko elementy utworzone na platformie w tym momencie lub później |
search | string | Wyszukiwany tekst |
limit | number | Elementy na stronę, od 1 do 100. Domyślnie 25 |
cursor | string | nextCursor poprzedniej strony. Na ostatniej stronie nextCursor ma wartość null |
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.Pola wzmianki
| Pole | Opis |
|---|---|
id | Id wzmianki. Używane w poniższych endpointach |
accountId | Konto, do którego należy element: jego id z GET /social-accounts |
platform | Platforma jako PlatformType |
accountName | Wyświetlana nazwa tego konta |
platformMentionId | Id posta lub komentarza na platformie, który wspomina konto |
author | Autor: id (identyfikator użytkownika na platformie), name, username i avatarUrl. id, username i avatarUrl mogą mieć wartość null |
text | Tekst wspominający konto |
permalink | Publiczny link na platformie lub null, jeśli platforma go nie podaje |
thumbnailUrl | Obraz posta lub null |
createdAt | Moment utworzenia na platformie |
status | UNREAD, READ lub DONE. Ten stan jest przechowywany tylko w AdaptlyPost; platforma go nie widzi |
replied | True, gdy konto odpowiedziało przez AdaptlyPost |
repliedAt | Moment ostatniej odpowiedzi konta lub null |
capabilities | canReply: false, gdy platforma nie pozwala kontu odpowiedzieć, jak w przypadku wzmianek na Instagramie |
replies | Odpowiedzi wysłane przez AdaptlyPost, od najstarszych, każda z id, text, permalink i createdAt. Odpowiedzi napisane w aplikacji platformy nie są wymieniane |
Odpowiedź na wzmiankę
https://post.adaptlypost.com/post/api/v1/inbox/mentions/:id/replyOdpowiada z danego konta na post lub komentarz, który je wspomina, i zwraca 201 ze wzmianką. Na Mastodonie odpowiedź zachowuje widoczność oryginalnego posta.
Zapisy wymagają inbox.reply (Administrator i Edytor) oraz aktywnego planu AdaptlyPost. Bez planu zwracają 403 subscription_required.
Parametry treści żądania
| Parametr | Typ | Opis |
|---|---|---|
textWYMAGANE | string | Odpowiedź. Obowiązuje limit komentarzy platformy: Threads 500, Bluesky 300, Mastodon 500 i Facebook 8000 znaków |
Oznaczanie jako przeczytane lub załatwione
https://post.adaptlypost.com/post/api/v1/inbox/mentions/statusUstawia status maksymalnie 100 wzmianek i zwraca { mentions, unreadCount }.
Parametry treści żądania
| Parametr | Typ | Opis |
|---|---|---|
idsWYMAGANE | string[] | Od 1 do 100 id z listy |
statusWYMAGANE | InboxStatus | UNREAD, READ lub DONE |
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/mentions?statuses=UNREAD&since=2026-11-01T00:00:00Z' \
--header 'Authorization: Bearer <api-key>'curl --request POST \
--url https://post.adaptlypost.com/post/api/v1/inbox/mentions/mnt_41c7e0b2/reply \
--header 'Authorization: Bearer <api-key>' \
--header 'Content-Type: application/json' \
--data '{ "text": "Thanks for the shout-out!" }'curl --request POST \
--url https://post.adaptlypost.com/post/api/v1/inbox/mentions/status \
--header 'Authorization: Bearer <api-key>' \
--header 'Content-Type: application/json' \
--data '{ "ids": ["mnt_41c7e0b2"], "status": "READ" }'{
"mentions": [
{
"id": "mnt_41c7e0b2",
"accountId": "conn_bsky_001",
"platform": "BLUESKY",
"accountName": "adaptlypost.com",
"platformMentionId": "at://did:plc:4k2x.../app.bsky.feed.post/3lb2x7q",
"author": {
"id": "did:plc:7f3q2m",
"name": "Marta Nowak",
"username": "marta.bsky.social",
"avatarUrl": null
},
"text": "Scheduling a month of posts with @adaptlypost.com took me 20 minutes",
"permalink": "https://bsky.app/profile/marta.bsky.social/post/3lb2x7q",
"thumbnailUrl": null,
"createdAt": "2026-11-07T18:03:10.000Z",
"status": "UNREAD",
"replied": false,
"repliedAt": null,
"capabilities": { "canReply": true },
"replies": []
}
],
"total": 3,
"hasMore": false,
"nextCursor": null
}