Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

TikTok webhook događaji za komentare

TikTokov API za firme šalje comment.update webhook u roku od pet minuta nakon što se komentar ili odgovor na foto objavama i javnim video objavama naloga kreira, obriše, sakrije, postavi samo za prijatelje ili učini javnim. Svaki događaj imenuje komentar, objavu, radnju, identifikator autora komentara i tekst i potpisan je zaglavljem Tiktok-Signature.

easyCoexistence prosleđuje svaki TikTok događaj o komentarima za nalog na vaš HTTPS endpoint čim stigne, potpisan tajnim ključem za taj nalog i bez čuvanja kopije.

5 min

Vreme u kojem se comment.update aktivira nakon što je komentar ili odgovor kreiran, obrisan ili promenio vidljivost.

72 hours

Koliko dugo TikTok ponavlja isporuku koju povratni poziv nije potvrdio odgovorom HTTP 200, uz eksponencijalno produžavanje pauze.

comment.list

Obim dozvola koje nalog mora da odobri i zadrži važećim da bi se slali njegovi comment.update događaji.

At least once

Obećanje TikToka o isporuci, pa isti događaj može stići više puta, zato obrada mora biti idempotentna.

Šta izveštava comment.update?

Promene komentara na foto objavama i javnim video objavama naloga, bilo da su objavljene preko API-ja ili u TikTok aplikaciji. comment_action kaže šta se dogodilo:

  • insert: komentar ili odgovor je kreiran.
  • delete: obrisan je.
  • set_to_hidden: sakriven je, od strane korisnika ili kroz moderaciju.
  • set_to_friends_only: postavljen je da bude vidljiv samo prijateljima.
  • set_to_public: prešao je iz skrivenog ili samo za prijatelje u vidljiv svima.

Šta nosi događaj?

TikTok šalje JSON sa client_key, event, create_time, user_openid, što je ID naloga, i content, serijalizovanim JSON stringom. Unutar content: comment_id i video_id, parent_comment_id za odgovore, comment_type (comment ili reply), comment_action, vremenska oznaka, unique_identifier autora komentara i tekst. ID-jevi su JSON brojevi veći nego što double može tačno da sačuva, pa ih čitajte iz sirovog stringa.

Kako događaji stižu do vašeg endpointa?

TikTok šalje webhook-ove aplikaciji za programere, kroz jedan URL za povratni poziv za celu aplikaciju. easyCoexistence ih prima i prosleđuje svaki comment.update za povezani nalog na HTTPS endpoint koji ste za njega postavili, jednom, čim stigne, potpisan tajnim ključem tog naloga. Endpoint postavite pomoću set_social_webhook_destination iz Claude-a ili ChatGPT-ja, ili preko Partner API-ja kroz PUT /channels/:id/webhook; tajni ključ se prikazuje jednom, a null URL isključuje prosleđivanje.

Kako izgleda prosleđeni događaj?

POST sa platformom, account_id koji list_social_accounts daje vezi, external_id naloga, što je TikTokov open_id, i entry: ime događaja, create_time i content, pri čemu je content već parsiran, a njegovi ID-jevi pretvoreni u stringove da se ništa ne zaokruži.

A forwarded comment.update event
{
  "platform": "tiktok",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<TIKTOK_OPEN_ID>",
  "entry": {
    "event": "comment.update",
    "create_time": 1793318400,
    "content": {
      "comment_id": "<COMMENT_ID>",
      "video_id": "<VIDEO_ID>",
      "parent_comment_id": null,
      "comment_type": "comment",
      "comment_action": "insert",
      "timestamp": 1793318399000,
      "unique_identifier": "<UNIQUE_IDENTIFIER>",
      "text": "<COMMENT_TEXT>"
    }
  }
}

Kako proveriti prosleđeni događaj?

Svaka prosleđena isporuka nosi zaglavlje X-EC-Signature, t=<unix>,v1=<hex>, gde je v1 HMAC-SHA256 vremenske oznake, tačke i sirovog tela, ključem tajnog ključa naloga. Ponovo izračunajte potpis nad telom tačno onako kako je stiglo, uporedite ih u konstantnom vremenu i odbijte vremensku oznaku stariju od 5 minuta.

Da li se isporuka ponavlja?

Ne od strane easyCoexistence. Svaki događaj se prosleđuje jednom, u memoriji, bez kopije za ponovni pokušaj; prosleđivanje čeka 8 sekundi na odgovor i ne prati preusmeravanja. Uzvodno, TikTok ponavlja sopstvene isporuke do 72 sata i obećava najmanje jednu, pa isti događaj može stići dvaput: uklonite duplikate po comment_id zajedno sa comment_action.

Česte greške

  • Parsiranje ID-jeva kao brojeva. comment_id i video_id su veći od onoga što double tačno čuva; easyCoexistence ih prosleđuje kao stringove, pa ih tako i ostavite.
  • Računanje potpisa nad parsiranom kopijom tela. HMAC pokriva sirovo telo kako je isporučeno, a ponovna serijalizacija narušava podudaranje.
  • Obrada ponovljenog događaja dvaput. TikTok isporučuje najmanje jednom, pa pre radnje proverite po comment_id i comment_action.
  • Usmeravanje odredišta na adresu koja preusmerava. Prosleđivanje ne prati preusmeravanja, zato navedite konačni HTTPS URL.
Ovo radite uz EasyCoexistence

Uključite ga pomoću set_social_webhook_destination iz Claude-a ili ChatGPT-ja, ili preko Partner API-ja. Od US$ 9 do US$ 0.75 po vezi mesečno, a cena pada kako dodajete veze, uz prva 3 dana besplatno.

Često postavljana pitanja

Koji TikTok webhook događaji se prosleđuju?

comment.update, za komentare i odgovore na objavama povezanog naloga: kreirani, obrisani, sakriveni, postavljeni samo za prijatelje ili učinjeni javnim.

Da li se prosleđuju i događaji objavljivanja na TikToku?

Ne. Prosleđivanje nosi događaje o komentarima; objavljivanje objave umesto toga pratite pomoću get_tiktok_publish_status.

Koliko brzo stiže događaj o TikTok komentaru?

TikTok šalje comment.update u roku od pet minuta od promene, a easyCoexistence ga prosleđuje čim stigne.

Da li događaj o TikTok komentaru sadrži tekst?

TikTok dokumentuje polje text u sadržaju događaja, pored ID-jeva komentara i objave, radnje i unique_identifier autora komentara.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na