Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Peristiwa webhook komen TikTok

API for Business TikTok menghantar webhook comment.update dalam masa lima minit selepas komen atau balasan dibuat, dipadam, disembunyikan, ditetapkan kepada rakan sahaja atau dijadikan awam pada siaran foto dan video awam sesebuah akaun. Setiap peristiwa menyatakan komen, siaran, tindakan, pengecam pengomen dan teksnya, serta ditandatangani dengan header Tiktok-Signature.

easyCoexistence meneruskan setiap peristiwa komen TikTok bagi akaun kepada endpoint HTTPS anda sebaik tiba, ditandatangani dengan rahsia bagi akaun itu dan tanpa salinan disimpan.

5 min

Masa dalam mana comment.update dicetuskan selepas komen atau balasan dibuat, dipadam atau berubah keterlihatan.

72 hours

Berapa lama TikTok mencuba semula penghantaran yang panggil balik tidak jawab dengan HTTP 200, dengan jeda makin meningkat secara eksponen.

comment.list

Skop yang mesti diberikan dan kekal sah oleh akaun, supaya peristiwa comment.update dihantar.

At least once

Janji penghantaran TikTok, supaya peristiwa yang sama boleh tiba lebih daripada sekali, jadi pengendalian perlu idempoten.

Apakah yang dilaporkan oleh comment.update?

Perubahan pada komen di siaran foto dan siaran video awam akaun, sama ada diterbitkan melalui API atau dalam aplikasi TikTok. comment_action menyatakan apa yang berlaku:

  • insert: komen atau balasan dibuat.
  • delete: ia dipadam.
  • set_to_hidden: ia disembunyikan, oleh pengguna atau melalui moderasi.
  • set_to_friends_only: ia ditetapkan supaya kelihatan kepada rakan sahaja.
  • set_to_public: ia bertukar daripada tersembunyi atau rakan sahaja kepada kelihatan kepada semua.

Apakah yang dibawa oleh sesuatu peristiwa?

TikTok menghantar JSON dengan client_key, event, create_time, user_openid, iaitu ID akaun, dan content, rentetan JSON yang dibersirikan. Di dalam content: comment_id dan video_id, parent_comment_id bagi balasan, comment_type (comment atau reply), comment_action, cap masa, unique_identifier pengomen dan teksnya. ID ini juga nombor JSON yang terlalu besar untuk disimpan tepat dalam double, jadi bacalah daripada rentetan mentah.

Bagaimana peristiwa sampai ke endpoint anda?

TikTok menghantar webhook kepada aplikasi pemaju, melalui satu URL panggil balik bagi keseluruhan aplikasi. easyCoexistence menerimanya dan meneruskan setiap comment.update bagi akaun yang disambungkan kepada endpoint HTTPS yang anda tetapkan untuknya, sekali sahaja, sebaik tiba, ditandatangani dengan rahsia akaun itu sendiri. Tetapkan endpoint dengan set_social_webhook_destination daripada Claude atau ChatGPT, atau dengan Partner API melalui PUT /channels/:id/webhook; rahsia dipaparkan sekali sahaja, dan URL null mematikan penerusan.

Bagaimana rupa peristiwa yang diteruskan?

Satu POST dengan platform, account_id yang diberikan oleh list_social_accounts bagi sambungan itu, external_id akaun, iaitu open_id TikTok, dan entry: nama peristiwa, create_time dan content, dengan content sudah dihuraikan dan ID-nya ditukar kepada rentetan supaya tiada yang dibundarkan.

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>"
    }
  }
}

Bagaimana anda mengesahkan peristiwa yang diteruskan?

Setiap penghantaran yang diteruskan membawa header X-EC-Signature, t=<unix>,v1=<hex>, dengan v1 ialah HMAC-SHA256 bagi cap masa, titik dan badan mentah, dikunci dengan rahsia tandatangan akaun. Kira semula ke atas badan tepat seperti ia tiba, bandingkan kedua-duanya dalam masa malar, dan tolak cap masa yang lebih lima minit lama.

Adakah penghantaran dicuba semula?

Tidak oleh easyCoexistence. Setiap peristiwa diteruskan sekali, dalam memori, tanpa salinan disimpan untuk dicuba semula; penerusan menunggu 8 saat untuk jawapan dan tidak mengikut pengalihan. Di hulu, TikTok mencuba semula penghantarannya sendiri sehingga 72 jam dan berjanji sekurang-kurangnya satu, jadi peristiwa yang sama boleh sampai kepada anda dua kali: nyahduplikasi berdasarkan comment_id bersama comment_action.

Kesilapan biasa

  • Menghuraikan ID sebagai nombor. comment_id dan video_id lebih besar daripada yang dapat disimpan tepat oleh double; easyCoexistence meneruskannya sebagai rentetan, jadi kekalkan begitu.
  • Mengira tandatangan ke atas salinan badan yang telah dihuraikan. HMAC meliputi badan mentah seperti yang dihantar, dan menyerikan semula akan memecahkan padanan.
  • Mengendalikan peristiwa berulang dua kali. TikTok menghantar sekurang-kurangnya sekali, jadi kunci pada comment_id dan comment_action sebelum bertindak.
  • Menunjuk destinasi ke alamat yang mengalih hala. Penerusan tidak mengikut pengalihan, jadi berikan URL HTTPS akhir.
Menggunakan EasyCoexistence untuk ini

Aktifkan dengan set_social_webhook_destination daripada Claude atau ChatGPT, atau dengan Partner API. US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, menurun apabila sambungan ditambah, dengan 3 hari pertama percuma.

Soalan lazim

Peristiwa webhook TikTok manakah yang diteruskan?

comment.update, bagi komen dan balasan pada siaran akaun yang disambungkan: dibuat, dipadam, disembunyikan, ditetapkan kepada rakan sahaja atau dijadikan awam.

Adakah peristiwa penerbitan TikTok turut diteruskan?

Tidak. Penerusan membawa peristiwa komen; ikuti penerbitan siaran dengan get_tiktok_publish_status.

Seberapa cepat peristiwa komen TikTok tiba?

TikTok menghantar comment.update dalam masa lima minit selepas perubahan, dan easyCoexistence meneruskannya sebaik sahaja ia tiba.

Adakah peristiwa komen TikTok menyertakan teks?

TikTok mendokumentasikan medan teks dalam content peristiwa, di sebelah ID komen dan siaran, tindakan serta unique_identifier pengomen.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada