TikTok-kommenttien webhook-tapahtumat
TikTokin API for Business lähettää comment.update-webhookin enintään viiden minuutin kuluessa siitä, kun kommentti tai vastaus luodaan, poistetaan, piilotetaan, asetetaan vain ystäville tai julkiseksi tilin valokuvajulkaisuissa ja julkisissa videoissa. Jokainen tapahtuma nimeää kommentin, julkaisun, toiminnon, kommentoijan tunnisteen ja tekstin, ja se on allekirjoitettu Tiktok-Signature-otsakkeella.
easyCoexistence välittää jokaisen TikTok-kommenttitapahtuman tilin osalta HTTPS-päätepisteeseesi heti, kun se saapuu, allekirjoitettuna tilikohtaisella avaimella eikä kopiota tallentaen.
Aika, jonka kuluessa comment.update lähtee kommentin tai vastauksen luomisen, poistamisen tai näkyvyyden muutoksen jälkeen.
Kuinka kauan TikTok yrittää toimitusta uudelleen, jota sen takaisinkutsu ei vastannut HTTP 200 -vastauksella, eksponentiaalisesti kasvavin välein.
Oikeudet, jotka tilillä täytyy olla myönnettynä ja voimassa, jotta sen comment.update-tapahtumat lähetetään.
TikTokin toimitustakuu: sama tapahtuma voi saapua useammin kuin kerran, joten käsittelyn tulee olla idempotentti.
Mitä comment.update raportoi?
Muutokset tilin valokuvajulkaisujen ja julkisten videojulkaisujen kommentteihin, riippumatta siitä, julkaistiinko ne API:n kautta vai TikTok-sovelluksessa. comment_action kertoo, mitä tapahtui:
- insert: kommentti tai vastaus luotiin.
- delete: se poistettiin.
set_to_hidden: se piilotettiin joko käyttäjän tai moderoinnin toimesta.set_to_friends_only: se asetettiin näkyväksi vain ystäville.set_to_public: se siirtyi piilotetusta tai vain ystäville näkyvästä kaikille näkyväksi.
Mitä tapahtuma sisältää?
TikTok lähettää JSON-muotoisen viestin, jossa ovat client_key, event, create_time, user_openid, joka on tilin tunnus, ja content, sarjallistettu JSON-merkkijono. Content sisältää kentät comment_id ja video_id, vastauksille parent_comment_id, comment_type (comment tai reply), comment_action, aikaleiman, kommentoijan unique_identifier-tunnisteen ja tekstin. Tunnukset ovat JSON-numeroita, jotka ovat liian suuria double-tyypin tarkaan esitykseen, joten lue ne raakamerkkijonosta.
Miten tapahtumat saapuvat päätepisteeseesi?
TikTok lähettää webhookit kehittäjäsovellukselle yhden takaisinkutsu-URL:n kautta koko sovellukselle. easyCoexistence vastaanottaa ne ja välittää jokaisen yhdistetyn tilin comment.update-tapahtuman sinun sille asettamaasi HTTPS-päätepisteeseen kerran, heti kun se saapuu, allekirjoitettuna kyseisen tilin omalla salaisuudella. Aseta päätepiste set_social_webhook_destination-työkalulla Claudesta tai ChatGPT:stä, tai Partner API:n kautta PUT /channels/:id/webhook -pyynnöllä. Salaisuus näytetään kerran, ja null-URL kytkee välityksen pois päältä.
Miltä välitetty tapahtuma näyttää?
POST-pyyntö, jossa ovat platform, account_id, jonka list_social_accounts antaa yhteydelle, tilin external_id, joka on TikTokin open_id, sekä entry: tapahtuman nimi, create_time ja content. Content on jo jäsennetty, ja sen tunnukset on muutettu merkkijonoiksi, joten mikään ei pyöristy.
{
"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>"
}
}
}Miten välitetty tapahtuma tarkistetaan?
Jokaisessa välitetyssä toimituksessa on X-EC-Signature-otsake muodossa t=<unix>,v1=<hex>, jossa v1 on aikaleiman, pisteen ja raakan rungon HMAC-SHA256, avaimena tilin allekirjoitusavain. Laske allekirjoitus uudelleen rungosta täsmälleen sellaisena kuin se saapui, vertaa molempia vakioajassa ja hylkää aikaleima, joka on yli 5 minuuttia vanha.
Yritetäänkö toimitus uudelleen?
Ei easyCoexistencen toimesta. Jokainen tapahtuma välitetään kerran muistissa, eikä sitä ole tallennettu uusintaa varten. Välitys odottaa vastausta 8 sekuntia eikä seuraa uudelleenohjauksia. TikTok yrittää omia toimituksiaan uudelleen jopa 72 tuntia ja lupaa vähintään yhden toimituksen, joten sama tapahtuma voi tulla kahdesti. Poista kaksoiskappaleet kenttien comment_id ja comment_action perusteella.
Yleiset virheet
- Tunnusten jäsentäminen numeroiksi. comment_id ja video_id ovat suurempia kuin double tarkasti esittää. easyCoexistence välittää ne merkkijonoina, joten pidä ne sellaisina.
- Allekirjoituksen laskeminen jäsennetystä kopiosta rungosta. HMAC kattaa raakan rungon sellaisena kuin se toimitettiin, ja sen uudelleen sarjallistaminen rikkoo vastaavuuden.
- Toistuvan tapahtuman käsittely kahdesti. TikTok toimittaa vähintään kerran, joten tunnista tapahtuma kenttien comment_id ja comment_action perusteella ennen toimintaa.
- Päätepisteen osoittaminen osoitteeseen, joka uudelleenohjaa. Välitys ei seuraa uudelleenohjauksia, joten anna lopullinen HTTPS-URL.
Kytke se päälle set_social_webhook_destination-työkalulla Claudesta tai ChatGPT:stä, tai Partner API:n kautta. US$ 9–US$ 0,75 per yhteys kuukaudessa, hinta laskee yhteyksiä lisättäessä, ensimmäiset 3 päivää ovat ilmaisia.
Usein kysytyt kysymykset
Mitä TikTok-webhook-tapahtumia välitetään?
comment.update kommenteille ja vastauksille yhdistetyn tilin julkaisuissa: luotu, poistettu, piilotettu, asetettu vain ystäville tai julkiseksi.
Välitetäänkö myös TikTokin julkaisutapahtumia?
Ei. Välitys kattaa kommenttitapahtumat. Seuraa julkaisun etenemistä sen sijaan get_tiktok_publish_status-työkalulla.
Kuinka nopeasti TikTokin kommenttitapahtuma saapuu?
TikTok lähettää comment.update-tapahtuman viiden minuutin kuluessa muutoksesta, ja easyCoexistence välittää sen heti, kun se saapuu.
Sisältääkö TikTokin kommenttitapahtuma tekstin?
TikTok dokumentoi tekstikentän tapahtuman content-osiossa kommentti- ja julkaisutunnusten, toiminnon ja kommentoijan unique_identifier-tunnisteen rinnalla.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu