Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

TikTok webhook događaji za komentare

TikTokov API za poslovanje šalje webhook comment.update unutar pet minuta od toga da je komentar ili odgovor na fotografijama i javnim videozapisima računa stvoren, izbrisan, sakriven, postavljen na samo prijatelje ili učinjen javnim. Svaki događaj navodi komentar, objavu, radnju, identifikator autora komentara i tekst te je potpisan zaglavljem Tiktok-Signature.

easyCoexistence prosljeđuje svaki TikTok događaj o komentarima za račun na vaš HTTPS endpoint čim stigne, potpisan tajnom za taj račun i bez zadržane kopije.

5 min

Vrijeme u kojem se comment.update aktivira nakon što se komentar ili odgovor stvori, izbriše ili promijeni vidljivost.

72 hours

Koliko dugo TikTok ponavlja isporuku koju callback nije potvrdio odgovorom HTTP 200, s eksponencijalnim produljenjem razmaka.

comment.list

Opseg dozvola koji račun mora odobriti i zadržati valjanim da bi se događaji comment.update slali.

At least once

Obećanje isporuke TikToka, zbog kojeg isti događaj može stići više puta pa obrada treba biti idempotentna.

Što javlja comment.update?

Promjene komentara na fotografijama i javnim videozapisima računa, bez obzira jesu li objavljeni putem API-ja ili u aplikaciji TikTok. comment_action kaže što se dogodilo:

  • insert: komentar ili odgovor je stvoren.
  • delete: izbrisan je.
  • set_to_hidden: sakriven je, bilo od korisnika bilo putem moderiranja.
  • set_to_friends_only: postavljen je tako da ga vide samo prijatelji.
  • set_to_public: prešao je iz skrivenog ili samo za prijatelje u vidljiv svima.

Što sadrži događaj?

TikTok šalje JSON s poljima client_key, event, create_time, user_openid, što je ID računa, i content, serijaliziranim JSON nizom. U content su 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 u JSON-u prevelike brojke da bi ih double točno sadržavao, zato ih čitajte iz neobrađenog niza.

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

TikTok šalje webhookove razvojnoj aplikaciji, kroz jedan callback URL za cijelu aplikaciju. easyCoexistence ih prima i za svaki povezani račun prosljeđuje comment.update na HTTPS endpoint koji ste za njega postavili, jednom, čim stigne, potpisan tajnom tog računa. Endpoint postavite pomoću set_social_webhook_destination iz Claudea ili ChatGPT-ja ili pomoću Partner API-ja putem PUT /channels/:id/webhook; tajna se prikazuje jednom, a URL vrijednosti null isključuje prosljeđivanje.

Kako izgleda prosljeđeni događaj?

POST s platformom, account_id koji list_social_accounts daje za vezu, external_id računa, što je TikTokov open_id, i entry: naziv događaja, create_time i content, pri čemu je content već raščlanjen, a ID-jevi pretvoreni u nizove kako se ništa ne bi zaokružilo.

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 provjeriti prosljeđeni događaj?

Svaka prosljeđena isporuka nosi zaglavlje X-EC-Signature, t=<unix>,v1=<hex>, gdje je v1 HMAC-SHA256 vremenske oznake, točke i neobrađenog tijela, s ključem za potpisivanje tog računa. Ponovno izračunajte potpis nad tijelom točno kako je stiglo, usporedite ih u konstantnom vremenu i odbijte vremensku oznaku stariju od 5 minuta.

Ponavlja li se isporuka?

Ne, easyCoexistence ne ponavlja isporuku. Svaki događaj se prosljeđuje jednom, u memoriji, bez zadržane kopije iz koje bi se mogao ponoviti; prosljeđivanje čeka 8 sekundi na odgovor i ne slijedi preusmjeravanja. Uzvodno TikTok ponavlja vlastite isporuke do 72 sata i obećava barem jednu, pa isti događaj može doći dvaput: deduplicirajte prema comment_id zajedno s comment_action.

Uobičajene pogreške

  • Raščlanjivanje ID-jeva kao brojeva. comment_id i video_id su veći nego što double može točno sadržavati; easyCoexistence ih prosljeđuje kao nizove, zato ih tako i zadržite.
  • Računanje potpisa nad raščlanjenom kopijom tijela. HMAC pokriva neobrađeno tijelo kako je isporučeno, a ponovna serijalizacija narušava podudaranje.
  • Dvostruka obrada ponovljenog događaja. TikTok isporučuje barem jednom, pa prije djelovanja provjerite comment_id i comment_action.
  • Odredište koje preusmjerava. Prosljeđivanje ne slijedi preusmjeravanja, zato unesite konačni HTTPS URL.
Radite ovo uz EasyCoexistence

Uključite ga pomoću set_social_webhook_destination iz Claudea ili ChatGPT-ja ili putem Partner API-ja. Od US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako dodajete veze, a prva 3 dana su besplatna.

Često postavljana pitanja

Koji se TikTok webhook događaji prosljeđuju?

comment.update, za komentare i odgovore na objave povezanog računa: stvoreni, izbrisani, sakriveni, postavljeni na samo prijatelje ili učinjeni javnim.

Prosljeđuju li se i događaji objave na TikToku?

Ne. Prosljeđivanje nosi događaje o komentarima; objavu pratite pomoću get_tiktok_publish_status.

Koliko brzo stiže događaj o komentaru na TikToku?

TikTok šalje comment.update unutar pet minuta od promjene, a easyCoexistence ga prosljeđuje čim stigne.

Sadrži li događaj o komentaru na TikToku tekst?

TikTok u sadržaju događaja dokumentira polje text, uz ID-jeve komentara i objave, radnju i unique_identifier autora komentara.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na