Event webhook komentar TikTok
API for Business milik TikTok mengirim webhook comment.update dalam lima menit setelah komentar atau balasan dibuat, dihapus, disembunyikan, diatur hanya untuk teman, atau dibuat publik pada postingan foto dan video publik sebuah akun. Setiap event menyebutkan komentar, postingan, tindakan, pengenal pengomentar, dan teksnya, serta ditandatangani dengan header Tiktok-Signature.
easyCoexistence meneruskan setiap event komentar TikTok untuk akun ke endpoint HTTPS Anda begitu tiba, ditandatangani dengan rahasia untuk akun tersebut dan tanpa salinan yang disimpan.
Waktu maksimal comment.update terpicu setelah komentar atau balasan dibuat, dihapus, atau berubah visibilitasnya.
Lama TikTok mencoba kembali pengiriman yang callback-nya tidak dijawab dengan HTTP 200, dengan jeda yang bertambah secara eksponensial.
Cakupan izin yang harus diberikan dan tetap berlaku agar event comment.update akun dapat dikirim.
Janji pengiriman TikTok, sehingga event yang sama dapat tiba lebih dari sekali dan penanganannya sebaiknya idempoten.
Apa yang dilaporkan comment.update?
Perubahan pada komentar di postingan foto dan video publik akun, baik yang diterbitkan melalui API maupun di aplikasi TikTok. comment_action menjelaskan apa yang terjadi:
- insert: komentar atau balasan dibuat.
- delete: komentar dihapus.
set_to_hidden: komentar disembunyikan, oleh pengguna atau melalui moderasi.set_to_friends_only: komentar diatur agar hanya terlihat oleh teman.set_to_public: komentar berpindah dari tersembunyi atau hanya teman menjadi terlihat oleh semua orang.
Apa saja yang dibawa sebuah event?
TikTok mengirim JSON berisi client_key, event, create_time, user_openid yang merupakan ID akun, dan content, berupa string JSON yang diserialisasi. Di dalam content: comment_id dan video_id, parent_comment_id untuk balasan, comment_type (comment atau reply), comment_action, stempel waktu, unique_identifier pengomentar, dan teksnya. ID tersebut juga berupa angka JSON yang terlalu besar untuk disimpan tepat di double, jadi bacalah dari string mentahnya.
Bagaimana event sampai ke endpoint Anda?
TikTok mengirim webhook ke aplikasi developer, melalui satu callback URL untuk seluruh aplikasi. easyCoexistence menerimanya dan meneruskan setiap comment.update untuk akun yang terhubung ke endpoint HTTPS yang Anda atur untuknya, sekali, begitu tiba, ditandatangani dengan rahasia milik akun tersebut. Atur endpoint dengan set_social_webhook_destination dari Claude atau ChatGPT, atau dengan Partner API melalui PUT /channels/:id/webhook; rahasianya hanya ditampilkan sekali, dan URL bernilai null mematikan penerusan.
Seperti apa bentuk event yang diteruskan?
Sebuah POST berisi platform, account_id yang diberikan list_social_accounts untuk koneksi tersebut, external_id akun yang merupakan open_id TikTok, dan entry: nama event, create_time dan content, dengan content sudah diurai dan ID-nya diubah menjadi string sehingga tidak ada yang terbulatkan.
{
"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 cara memverifikasi event yang diteruskan?
Setiap pengiriman yang diteruskan membawa header X-EC-Signature, t=<unix>,v1=<hex>, dengan v1 adalah HMAC-SHA256 dari stempel waktu, titik, lalu body mentah, dengan kunci rahasia penandatanganan akun. Hitung ulang di atas body persis seperti saat tiba, bandingkan keduanya dengan waktu konstan, dan tolak stempel waktu yang lebih dari 5 menit.
Apakah pengiriman dicoba ulang?
Tidak oleh easyCoexistence. Setiap event diteruskan sekali, dari memori, tanpa salinan yang disimpan untuk dicoba ulang; penerusan menunggu jawaban selama 8 detik dan tidak mengikuti redirect. Di hulu, TikTok mencoba ulang pengirimannya sendiri hingga 72 jam dan menjanjikan minimal satu kali, sehingga event yang sama bisa sampai dua kali: deduplikasi berdasarkan comment_id bersama comment_action.
Kesalahan umum
- Menguraikan ID sebagai angka. comment_id dan video_id lebih besar dari yang dapat ditampung double secara tepat; easyCoexistence meneruskannya sebagai string, jadi pertahankan bentuk itu.
- Menghitung tanda tangan atas salinan body yang sudah diurai. HMAC mencakup body mentah seperti yang dikirim, dan serialisasi ulang akan merusak kecocokan.
- Menangani event yang berulang dua kali. TikTok mengirim minimal satu kali, jadi gunakan comment_id dan comment_action sebagai kunci sebelum bertindak.
- Mengarahkan tujuan ke alamat yang melakukan redirect. Penerusan tidak mengikuti redirect, jadi berikan URL HTTPS final.
Aktifkan dengan set_social_webhook_destination dari Claude atau ChatGPT, atau dengan Partner API. Mulai dari US$ 9 turun hingga US$ 0.75 per koneksi per bulan, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Event webhook TikTok apa saja yang diteruskan?
comment.update, untuk komentar dan balasan pada postingan akun yang terhubung: dibuat, dihapus, disembunyikan, diatur hanya untuk teman, atau dibuat publik.
Apakah event publikasi TikTok juga diteruskan?
Tidak. Penerusan hanya membawa event komentar; pantau publikasi sebuah postingan dengan get_tiktok_publish_status.
Seberapa cepat event komentar TikTok tiba?
TikTok mengirim comment.update dalam lima menit setelah perubahan, dan easyCoexistence meneruskannya segera setelah masuk.
Apakah event komentar TikTok menyertakan teks?
TikTok mendokumentasikan field text dalam content event, di samping ID komentar dan postingan, tindakan, dan unique_identifier pengomentar.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada