Matukio ya webhook ya maoni ya TikTok
TikTok API for Business hutuma webhook ya comment.update ndani ya dakika tano baada ya maoni au jibu kuundwa, kufutwa, kufichwa, kuwekwa kwa marafiki pekee au kuwekwa hadharani kwenye picha na video za umma za akaunti. Kila tukio linataja maoni, chapisho, kitendo, kitambulisho cha mtoa maoni na maandishi, na limesainiwa kwa kichwa cha Tiktok-Signature.
easyCoexistence husambaza kila tukio la maoni la TikTok la akaunti kwa HTTPS endpoint yako kadri linavyofika, likisainiwa kwa siri ya akaunti hiyo na bila nakala inayohifadhiwa.
Muda ambao comment.update huwashwa baada ya maoni au jibu kuundwa, kufutwa au kubadilisha mwonekano.
Muda ambao TikTok hujaribu tena uwasilishaji ambao callback haikujibu kwa HTTP 200, kwa vipindi vinavyoongezeka kwa kasi.
Ruhusa ambayo akaunti lazima iwe imetoa, na kuendelea kuwa halali, ili matukio yake ya comment.update yatumwe.
Ahadi ya uwasilishaji ya TikTok, kwamba tukio hilo hilo linaweza kufika zaidi ya mara moja, hivyo ushughulikiaji unapaswa kuwa idempotent.
Je, comment.update huripoti nini?
Mabadiliko ya maoni kwenye picha na video za umma za akaunti, yaliyochapishwa kupitia API au kwenye programu ya TikTok. comment_action inaonyesha kilichotokea:
- insert: maoni au jibu liliundwa.
- delete: lilifutwa.
set_to_hidden: lilifichwa, na mtumiaji au kupitia usimamizi wa maudhui.set_to_friends_only: liliwekwa lionekane kwa marafiki pekee.set_to_public: lilitoka kufichwa au kwa marafiki pekee hadi kuonekana kwa kila mtu.
Tukio linabeba nini?
TikTok hutuma JSON yenye client_key, event, create_time, user_openid, ambayo ni kitambulisho cha akaunti, na content, mfuatano wa JSON uliopangwa. Ndani ya content: comment_id na video_id, parent_comment_id kwa majibu, comment_type (comment au reply), comment_action, muhuri wa muda, unique_identifier ya mtoa maoni na maandishi. Vitambulisho ni nambari za JSON kubwa mno kushikiliwa kwa usahihi na double, kwa hiyo visome kutoka mfuatano ghafi.
Matukio yanafikaje kwenye endpoint yako?
TikTok hutuma webhook kwa programu ya msanidi, kupitia callback URL moja kwa programu nzima. easyCoexistence hupokea matukio hayo na hupeleka kila comment.update ya akaunti iliyounganishwa kwa HTTPS endpoint uliyoiweka kwa ajili yake, mara moja, kadri inavyofika, ikisainiwa kwa siri ya akaunti hiyo. Weka endpoint kwa set_social_webhook_destination kutoka Claude au ChatGPT, au kwa Partner API kupitia PUT /channels/:id/webhook; siri huonyeshwa mara moja, na thamani ya null huzima usambazaji.
Tukio lililosambazwa linaonekanaje?
POST yenye platform, account_id ambayo list_social_accounts hutoa kwa muunganisho, external_id ya akaunti, ambayo ni open_id ya TikTok, na entry: jina la tukio, create_time na content, huku content ikiwa tayari imechambuliwa na vitambulisho vyake vimegeuzwa kuwa mifuatano ili hakuna kinachozungushwa.
{
"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>"
}
}
}Unathibitishaje tukio lililosambazwa?
Kila uwasilishaji uliosambazwa hubeba kichwa X-EC-Signature, t=<unix>,v1=<hex>, ambapo v1 ni HMAC-SHA256 ya muhuri wa muda, nukta na mwili ghafi, ukitumia siri ya kusaini ya akaunti. Hesabu upya kwenye mwili ulivyofika kwa usahihi, linganisha thamani hizo mbili kwa muda usiobadilika, na ukatae muhuri wa muda wenye umri wa zaidi ya dakika 5.
Je, uwasilishaji hujaribiwa tena?
Si kwa easyCoexistence. Kila tukio husambazwa mara moja tu, kwa kumbukumbu, bila nakala ya kujaribu tena; usambazaji husubiri jibu kwa sekunde 8 na haufuati URL za kuelekezwa upya. Upande wa juu, TikTok hujaribu tena uwasilishaji wake hadi saa 72 na inaahidi angalau mara moja, kwa hiyo tukio hilo hilo linaweza kukufikia mara mbili: ondoa marudio kwa comment_id pamoja na comment_action.
Makosa ya kawaida
- Kuchambua vitambulisho kama nambari. comment_id na video_id ni kubwa kuliko double inavyoweza kushikilia kwa usahihi; easyCoexistence huvisambaza kama mifuatano, kwa hiyo viweke hivyo.
- Kuhesabu sahihi juu ya nakala iliyochambuliwa ya mwili. HMAC inahusu mwili ghafi kama ulivyowasilishwa, na kuuandika upya kunavunja ulinganifu.
- Kushughulikia tukio lililorudiwa mara mbili. TikTok huwasilisha angalau mara moja, kwa hiyo tambua tukio kwa comment_id na comment_action kabla ya kuchukua hatua.
- Kuelekeza lengwa lako kwenye anwani inayohamisha. Usambazaji haufuati uhamisho huo, kwa hiyo weka URL ya mwisho ya HTTPS.
Liwashe kwa set_social_webhook_destination kutoka Claude au ChatGPT, au kwa Partner API. Kuanzia US$ 9 hadi US$ 0.75 kwa muunganisho kwa mwezi, kadri unavyoongeza miunganisho, pamoja na siku 3 za majaribio bila malipo.
Maswali yanayoulizwa mara kwa mara
Ni matukio gani ya webhook ya TikTok husambazwa?
comment.update, kwa maoni na majibu kwenye machapisho ya akaunti iliyounganishwa: yaliyoundwa, yaliyofutwa, yaliyofichwa, yaliyowekwa kwa marafiki pekee au kuwekwa hadharani.
Matukio ya uchapishaji wa TikTok nayo husambazwa?
Hapana. Usambazaji hubeba matukio ya maoni; fuatilia uchapishaji wa chapisho kwa get_tiktok_publish_status badala yake.
Tukio la maoni la TikTok hufika kwa haraka kiasi gani?
TikTok hutuma comment.update ndani ya dakika tano baada ya mabadiliko, na easyCoexistence huipeleka mara tu inapoingia.
Je, tukio la maoni la TikTok linajumuisha maandishi?
TikTok inaeleza sehemu ya text kwenye content ya tukio, pamoja na vitambulisho vya maoni na chapisho, kitendo na unique_identifier ya mtoa maoni.
Endelea kusoma
Unganisha chaneli yako ya kwanza ndani ya dakika mbili.
Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.
- Siku 3 bila malipo
- Ghairi wakati wowote
- API rasmi pekee
- Hufuatiliwa saa 24/7
Imethibitishwa kwenye