Komentarze w skrzynce
Wyświetl komentarze pod swoimi postami na Facebooku, Instagramie, Threads, YouTube, LinkedInie, Bluesky i Mastodonie, a potem odpowiadaj na nie, ukrywaj je, polubiaj, usuwaj lub oznaczaj jako załatwione.
https://post.adaptlypost.com/post/api/v1/inbox/commentsZwraca komentarze do postów kont, od najnowszych. Odpowiedź: { comments, 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 |
postId | string | Tylko komentarze do tego posta AdaptlyPost, według jego id z /social-posts |
platformPostId | string | Tylko komentarze do tego posta, według id posta na platformie |
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 komentarza
| Pole | Opis |
|---|---|
id | Id komentarza. 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 |
postId | Id posta AdaptlyPost lub null, jeśli post nie został opublikowany przez AdaptlyPost |
platformPostId | Id posta na platformie, którego dotyczy komentarz |
postText | Tekst tego posta |
postPermalink | Link do tego posta |
platformCommentId | Id komentarza na platformie |
parentPlatformCommentId | Id komentarza na platformie, na który odpowiada ten komentarz, lub null dla komentarza najwyższego poziomu |
isReply | True, gdy komentarz odpowiada na inny komentarz |
author | Autor: id (identyfikator użytkownika na platformie), name, username i avatarUrl. id, username i avatarUrl mogą mieć wartość null |
text | Tekst komentarza |
permalink | Publiczny link na platformie lub null, jeśli platforma go nie podaje |
likeCount | Liczba polubień komentarza lub null, jeśli platforma jej nie podaje |
createdAt | Moment utworzenia na platformie |
status | UNREAD, READ lub DONE. Ten stan jest przechowywany tylko w AdaptlyPost; platforma go nie widzi |
isHidden | True, gdy komentarz jest ukryty na platformie |
isOwn | True, gdy napisało go to konto |
replied | True, gdy konto ma pod nim odpowiedź, wysłaną z AdaptlyPost lub z aplikacji platformy |
repliedAt | Moment ostatniej odpowiedzi konta lub null |
likedByAccount | True, gdy konto go polubiło |
capabilities | canReply, canHide, canDelete i canLike: działania dozwolone dla tego komentarza. Należy je sprawdzić przed wywołaniem akcji |
Odczyt wątku
https://post.adaptlypost.com/post/api/v1/inbox/comments/:idZwraca { comment, parent, replies }: komentarz, komentarz, na który odpowiada (null dla komentarza najwyższego poziomu), oraz odpowiedzi pod nim. Nieznane id zwraca 404 inbox_item_not_found.
Odpowiedź na komentarz
https://post.adaptlypost.com/post/api/v1/inbox/comments/:id/replyPublikuje odpowiedź z konta pod komentarzem i zwraca 201 z nową odpowiedzią jako komentarzem.
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: LinkedIn 1250, Threads 500, Bluesky 300, Mastodon 500, YouTube 10000, Facebook 8000 i Instagram 2200 znaków |
Ukrywanie, polubienia i usuwanie
Każde działanie zwraca 400 inbox_action_unsupported, gdy platforma lub komentarz na nie nie pozwala. Pole capabilities komentarza informuje o tym z wyprzedzeniem.
https://post.adaptlypost.com/post/api/v1/inbox/comments/:id/hideUkrywa komentarz na platformie i zwraca 200 z komentarzem.
https://post.adaptlypost.com/post/api/v1/inbox/comments/:id/unhidePonownie pokazuje ukryty komentarz i zwraca 200 z komentarzem.
https://post.adaptlypost.com/post/api/v1/inbox/comments/:id/likePolubia komentarz z konta i zwraca 200 z komentarzem.
https://post.adaptlypost.com/post/api/v1/inbox/comments/:id/likeUsuwa polubienie konta i zwraca 200 z komentarzem.
https://post.adaptlypost.com/post/api/v1/inbox/comments/:idUsuwa komentarz na platformie i ze skrzynki AdaptlyPost, zwraca 200 { "deleted": true }.
Usuwanie i polubienia na platformach
Co każda platforma pozwala kontu usuwać i polubiać. Na Threads usuwanie wymaga uprawnienia threads_delete, więc starsze połączenie Threads zwraca 403 inbox_reconnect_required do czasu ponownego połączenia.
| Platforma | Usuwanie | Polubienie i cofnięcie polubienia |
|---|---|---|
FACEBOOK | Dowolny komentarz do postów Strony | Tak |
INSTAGRAM | Dowolny komentarz do postów konta | Nie |
YOUTUBE | Tylko własne komentarze kanału | Nie |
THREADS | Tylko własne odpowiedzi konta | Nie |
BLUESKY | Tylko własne odpowiedzi konta | Tak |
MASTODON | Tylko własne odpowiedzi konta | Tak, jako ulubione |
LINKEDIN | Dowolny komentarz do postów organizacji | Tak |
Oznaczanie jako przeczytane lub załatwione
https://post.adaptlypost.com/post/api/v1/inbox/comments/statusUstawia status maksymalnie 100 komentarzy i zwraca { comments, 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/comments?statuses=UNREAD&platforms=INSTAGRAM,FACEBOOK&limit=25' \
--header 'Authorization: Bearer <api-key>'curl --request GET \
--url https://post.adaptlypost.com/post/api/v1/inbox/comments/cmt_8f2a1c40 \
--header 'Authorization: Bearer <api-key>'
200
{
"comment": { "id": "cmt_8f2a1c40", "isReply": false, "...": "..." },
"parent": null,
"replies": [
{ "id": "cmt_9b31d7e2", "isReply": true, "isOwn": true, "...": "..." }
]
}curl --request POST \
--url https://post.adaptlypost.com/post/api/v1/inbox/comments/cmt_8f2a1c40/reply \
--header 'Authorization: Bearer <api-key>' \
--header 'Content-Type: application/json' \
--data '{ "text": "Thanks Ana, the new plan starts on Monday." }'curl --request POST \
--url https://post.adaptlypost.com/post/api/v1/inbox/comments/cmt_8f2a1c40/hide \
--header 'Authorization: Bearer <api-key>'
curl --request POST \
--url https://post.adaptlypost.com/post/api/v1/inbox/comments/cmt_8f2a1c40/like \
--header 'Authorization: Bearer <api-key>'
curl --request DELETE \
--url https://post.adaptlypost.com/post/api/v1/inbox/comments/cmt_8f2a1c40 \
--header 'Authorization: Bearer <api-key>'curl --request POST \
--url https://post.adaptlypost.com/post/api/v1/inbox/comments/status \
--header 'Authorization: Bearer <api-key>' \
--header 'Content-Type: application/json' \
--data '{ "ids": ["cmt_8f2a1c40", "cmt_7c02e9a1"], "status": "DONE" }'{
"comments": [
{
"id": "cmt_8f2a1c40",
"accountId": "conn_ig_001",
"platform": "INSTAGRAM",
"accountName": "adaptlypost",
"postId": "cmm0z0k3q0000i0r5mxn0hfhs",
"platformPostId": "18034417852490123",
"postText": "Plan a week of posts in one sitting",
"postPermalink": "https://www.instagram.com/p/C9x2Lm0tQ1a/",
"platformCommentId": "17890455123456789",
"parentPlatformCommentId": null,
"isReply": false,
"author": {
"id": "17841400000000001",
"name": "Ana Souza",
"username": "ana.souza",
"avatarUrl": null
},
"text": "Does this work with Reels too?",
"permalink": null,
"likeCount": 2,
"createdAt": "2026-11-08T09:12:44.000Z",
"status": "UNREAD",
"isHidden": false,
"isOwn": false,
"replied": false,
"repliedAt": null,
"likedByAccount": false,
"capabilities": {
"canReply": true,
"canHide": true,
"canDelete": true,
"canLike": false
}
}
],
"total": 12,
"hasMore": false,
"nextCursor": null
}