REST APIGET

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.

GEThttps://post.adaptlypost.com/post/api/v1/inbox/comments

Zwraca komentarze do postów kont, od najnowszych. Odpowiedź: { comments, total, hasMore, nextCursor }.

Klucz API (token Bearer)
Uprawnienie:inbox.readRole i uprawnienia

Każda rola ma inbox.read, więc skrzynkę może odczytać każdy ważny klucz.

Parametry zapytania

ParametrTypOpis
accountIdsstring[]Tylko te konta, według id z GET /social-accounts. Klucz można powtórzyć lub rozdzielić wartości przecinkami. Do 50
platformsPlatformType[]Tylko te platformy. Klucz można powtórzyć lub rozdzielić wartości przecinkami
statusesInboxStatus[]Tylko elementy w tych stanach: UNREAD, READ lub DONE. Klucz można powtórzyć lub rozdzielić wartości przecinkami
sincestring (ISO 8601)Tylko elementy utworzone na platformie w tym momencie lub później
searchstringWyszukiwany tekst
postIdstringTylko komentarze do tego posta AdaptlyPost, według jego id z /social-posts
platformPostIdstringTylko komentarze do tego posta, według id posta na platformie
limitnumberElementy na stronę, od 1 do 100. Domyślnie 25
cursorstringnextCursor 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

PoleOpis
idId komentarza. Używane w poniższych endpointach
accountIdKonto, do którego należy element: jego id z GET /social-accounts
platformPlatforma jako PlatformType
accountNameWyświetlana nazwa tego konta
postIdId posta AdaptlyPost lub null, jeśli post nie został opublikowany przez AdaptlyPost
platformPostIdId posta na platformie, którego dotyczy komentarz
postTextTekst tego posta
postPermalinkLink do tego posta
platformCommentIdId komentarza na platformie
parentPlatformCommentIdId komentarza na platformie, na który odpowiada ten komentarz, lub null dla komentarza najwyższego poziomu
isReplyTrue, gdy komentarz odpowiada na inny komentarz
authorAutor: id (identyfikator użytkownika na platformie), name, username i avatarUrl. id, username i avatarUrl mogą mieć wartość null
textTekst komentarza
permalinkPubliczny link na platformie lub null, jeśli platforma go nie podaje
likeCountLiczba polubień komentarza lub null, jeśli platforma jej nie podaje
createdAtMoment utworzenia na platformie
statusUNREAD, READ lub DONE. Ten stan jest przechowywany tylko w AdaptlyPost; platforma go nie widzi
isHiddenTrue, gdy komentarz jest ukryty na platformie
isOwnTrue, gdy napisało go to konto
repliedTrue, gdy konto ma pod nim odpowiedź, wysłaną z AdaptlyPost lub z aplikacji platformy
repliedAtMoment ostatniej odpowiedzi konta lub null
likedByAccountTrue, gdy konto go polubiło
capabilitiescanReply, canHide, canDelete i canLike: działania dozwolone dla tego komentarza. Należy je sprawdzić przed wywołaniem akcji

Odczyt wątku

GEThttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id

Zwraca { 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.

Klucz API (token Bearer)
Uprawnienie:inbox.readRole i uprawnienia

Odpowiedź na komentarz

POSThttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id/reply

Publikuje odpowiedź z konta pod komentarzem i zwraca 201 z nową odpowiedzią jako komentarzem.

Klucz API (token Bearer)
Uprawnienie:inbox.replyRole i uprawnienia

Zapisy wymagają inbox.reply (Administrator i Edytor) oraz aktywnego planu AdaptlyPost. Bez planu zwracają 403 subscription_required.

Parametry treści żądania

ParametrTypOpis
textWYMAGANEstringOdpowiedź. 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.

POSThttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id/hide

Ukrywa komentarz na platformie i zwraca 200 z komentarzem.

Klucz API (token Bearer)
Uprawnienie:inbox.replyRole i uprawnienia
POSThttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id/unhide

Ponownie pokazuje ukryty komentarz i zwraca 200 z komentarzem.

Klucz API (token Bearer)
Uprawnienie:inbox.replyRole i uprawnienia
POSThttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id/like

Polubia komentarz z konta i zwraca 200 z komentarzem.

Klucz API (token Bearer)
Uprawnienie:inbox.replyRole i uprawnienia
DELETEhttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id/like

Usuwa polubienie konta i zwraca 200 z komentarzem.

Klucz API (token Bearer)
Uprawnienie:inbox.replyRole i uprawnienia
DELETEhttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id

Usuwa komentarz na platformie i ze skrzynki AdaptlyPost, zwraca 200 { "deleted": true }.

Klucz API (token Bearer)
Uprawnienie:inbox.replyRole i uprawnienia

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.

PlatformaUsuwaniePolubienie i cofnięcie polubienia
FACEBOOKDowolny komentarz do postów StronyTak
INSTAGRAMDowolny komentarz do postów kontaNie
YOUTUBETylko własne komentarze kanałuNie
THREADSTylko własne odpowiedzi kontaNie
BLUESKYTylko własne odpowiedzi kontaTak
MASTODONTylko własne odpowiedzi kontaTak, jako ulubione
LINKEDINDowolny komentarz do postów organizacjiTak

Oznaczanie jako przeczytane lub załatwione

POSThttps://post.adaptlypost.com/post/api/v1/inbox/comments/status

Ustawia status maksymalnie 100 komentarzy i zwraca { comments, unreadCount }.

Klucz API (token Bearer)
Uprawnienie:inbox.replyRole i uprawnienia

Parametry treści żądania

ParametrTypOpis
idsWYMAGANEstring[]Od 1 do 100 id z listy
statusWYMAGANEInboxStatusUNREAD, READ lub DONE

Odmowy

Odrzucone wywołanie zwraca { statusCode, error, code, message }. Logikę należy opierać na code. message opisuje odmowę słownie.

KodStatusKiedy i co zrobić
inbox_item_not_found404Id nie istnieje lub należy do innego obszaru roboczego. Należy przerwać
inbox_action_unsupported400Platforma lub ten element nie pozwala na ukrycie, usunięcie lub polubienie. Możliwości opisuje capabilities. Należy przerwać
inbox_reconnect_required403Połą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_invalid400Tekst jest pusty lub przekracza limit. Komunikat podaje limit. Należy poprawić tekst
inbox_messaging_window_closed400Facebook lub Instagram: minęło 24-godzinne okno na odpowiedź. Należy przerwać
inbox_rate_limited429Platforma ograniczyła liczbę zapytań AdaptlyPost. Należy ponowić po pewnym czasie
inbox_platform_error503Błąd platformy. Należy ponowić później
permission_denied403Rola klucza nie ma inbox.read ani inbox.reply. Nie należy ponawiać
subscription_required403Zapis bez aktywnego planu AdaptlyPost. Nie należy ponawiać
Lista nieprzeczytanych komentarzy
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>'
Odczyt wątku komentarza
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, "...": "..." }
  ]
}
Odpowiedź na komentarz
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." }'
Ukrycie, polubienie lub usunięcie komentarza
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>'
Oznaczenie komentarzy jako załatwione
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" }'
200
{
  "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
}