Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

TikTok comment webhook events

Ipinapadala ng API for Business ng TikTok ang isang comment.update webhook sa loob ng limang minuto matapos malikha, mabura, maitago, gawing friends only, o gawing public ang comment o reply sa photo posts at public video ng isang account. Bawat event ay nagsasabi ng comment, post, action, identifier ng commenter, at text, at naka-sign ng Tiktok-Signature header.

Ipinapasa ng easyCoexistence ang bawat TikTok comment event ng account sa inyong HTTPS endpoint habang dumarating, naka-sign gamit ang secret ng account na iyon at walang kopyang itinatabi.

5 min

Oras bago ma-trigger ang comment.update matapos malikha, mabura, o magbago ang visibility ng comment o reply.

72 hours

Gaano katagal muling sinusubukan ng TikTok ang delivery na hindi sinagot ng callback ng HTTP 200, na may exponential backoff.

comment.list

Scope na dapat naibigay at nananatiling valid ng account para maipadala ang mga comment.update event.

At least once

Pangako ng TikTok sa delivery, kaya maaaring dumating nang higit sa isang beses ang parehong event at dapat idempotent ang pag-handle.

Ano ang iniuulat ng comment.update?

Mga pagbabago sa comment ng photo post at public video post ng account, anuman ang na-publish sa pamamagitan ng API o sa TikTok app. Sinasabi ng comment_action kung ano ang nangyari:

  • insert: nalikha ang comment o reply.
  • delete: nabura ito.
  • set_to_hidden: naitago ito, ng user o sa pamamagitan ng moderation.
  • set_to_friends_only: ginawa itong nakikita ng friends lang.
  • set_to_public: lumipat mula sa hidden o friends only patungong nakikita ng lahat.

Ano ang laman ng event?

Nagpo-post ang TikTok ng JSON na may client_key, event, create_time, user_openid, na siyang ID ng account, at content, isang serialized JSON string. Sa loob ng content: comment_id at video_id, parent_comment_id para sa reply, comment_type (comment o reply), comment_action, timestamp, unique_identifier ng commenter, at ang text. Ang mga ID ay masyadong malaki para ma-hold nang eksakto ng double, kaya basahin ang mga ito mula sa raw string.

Paano nakakarating ang event sa inyong endpoint?

Nagpapadala ang TikTok ng webhook sa developer app, sa iisang callback URL para sa buong app. Tinatanggap ito ng easyCoexistence at ipinapasa ang bawat comment.update ng connected account sa HTTPS endpoint na itinakda ninyo para dito, isang beses, habang dumarating, naka-sign gamit ang sariling secret ng account na iyon. Itakda ang endpoint gamit ang set_social_webhook_destination mula sa Claude o ChatGPT, o gamit ang Partner API sa PUT /channels/:id/webhook; ipinapakita ang secret nang isang beses, at ang null na URL ay nagpapatay ng forwarding.

Ano ang itsura ng naipasa na event?

Isang POST na may platform, ang account_id na ibinibigay ng list_social_accounts para sa connection, ang external_id ng account, na open_id ng TikTok, at entry: ang pangalan ng event, create_time, at content, na naka-parse na at ang mga ID ay ginawang string para walang na-round.

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

Paano ninyo i-verify ang naipasang event?

Ang bawat naipasang delivery ay may X-EC-Signature header, t=<unix>,v1=<hex>, kung saan ang v1 ay HMAC-SHA256 ng timestamp, tuldok, at raw body, na naka-key sa signing secret ng account. I-recompute ito sa body nang eksakto kung paano ito dumating, ikumpara ang dalawa sa constant time, at tanggihan ang timestamp na mahigit 5 minuto na ang edad.

Inuulit ba ang delivery?

Hindi ng easyCoexistence. Bawat event ay ipinapasa nang isang beses, nasa memory lang, at walang kopyang itinatabi para ulitin; naghihintay ang forward ng 8 segundo para sa sagot at hindi sumusunod sa redirect. Sa panig ng TikTok, muling sinusubukan ang sarili nitong delivery hanggang 72 oras at nangangako ng hindi bababa sa isa, kaya maaaring dumating sa inyo nang dalawang beses ang parehong event: i-deduplicate sa comment_id kasama ang comment_action.

Mga karaniwang pagkakamali

  • Pag-parse ng ID bilang number. Mas malaki ang comment_id at video_id kaysa sa kayang hawakan nang eksakto ng double; ipinapasa ito ng easyCoexistence bilang string, kaya panatilihin ito nang ganoon.
  • Pagkuha ng signature sa naka-parse na kopya ng body. Sakop ng HMAC ang raw body gaya ng pagdating nito, at ang muling pag-serialize ay sisira sa pagtutugma.
  • Pag-handle sa paulit-ulit na event nang dalawang beses. Hindi bababa sa isang beses ang delivery ng TikTok, kaya i-key sa comment_id at comment_action bago kumilos.
  • Pagturo ng destination sa address na nagre-redirect. Hindi sumusunod sa redirect ang forwarding, kaya ibigay ang huling HTTPS URL.
Ginagawa ito gamit ang EasyCoexistence

I-on ito gamit ang set_social_webhook_destination mula sa Claude o ChatGPT, o gamit ang Partner API. Mula US$ 9 hanggang US$ 0.75 kada connection kada buwan, bumababa habang dumarami ang connection, at may free trial sa unang 3 araw.

Mga madalas itanong

Aling TikTok webhook events ang ipinapasa?

comment.update, para sa mga comment at reply sa post ng connected account: nalikha, nabura, naitago, ginawang friends only, o ginawang public.

Ipinapasa rin ba ang TikTok publishing events?

Hindi. Ang forwarding ay para sa comment events; para sundan ang publishing ng post, gamitin na lang ang get_tiktok_publish_status.

Gaano kabilis dumarating ang TikTok comment event?

Nagpapadala ang TikTok ng comment.update sa loob ng limang minuto mula sa pagbabago, at ipinapasa ito ng easyCoexistence sa sandaling dumating.

Kasama ba sa TikTok comment event ang text?

Dokumentado ng TikTok ang text field sa content ng event, kasama ang comment at post ID, ang action, at ang unique_identifier ng commenter.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong