TikTok のコメント Webhook イベント
TikTok の API for Business は、アカウントの写真投稿と公開動画に対するコメントや返信が、作成、削除、非表示、友達のみに設定、または公開に設定されてから 5 分以内に comment.update Webhook を送信します。各イベントは、コメント、投稿、操作、コメントした人の識別子とテキストを含み、Tiktok-Signature ヘッダーで署名されています。
easyCoexistence は、アカウントの各 TikTok コメントイベントを、届き次第あなたの HTTPS エンドポイントへ転送します。
コメントや返信の作成、削除、表示設定の変更後、comment.update が送信されるまでの時間。
コールバックが HTTP 200 で応答しなかった配信を、TikTok が指数バックオフで再試行する期間。
comment.update イベントを送信させるために、アカウントが許可し、有効なまま保つ必要があるスコープ。
TikTok の配信保証。同じイベントが複数回届く場合があるため、処理は冪等にしてください。
comment.update は何を通知しますか?
アカウントの写真投稿と公開動画に対するコメントの変更を通知します。API で投稿したものも、TikTok アプリで投稿したものも対象です。comment_action は何が起きたかを示します:
- insert:コメントまたは返信が作成されました。
- delete:削除されました。
set_to_hidden:ユーザーによるか、モデレーションを通じて非表示にされました。set_to_friends_only:友達のみに表示されるように設定されました。set_to_public:非表示または友達のみの状態から、全員に表示される状態になりました。
イベントには何が含まれますか?
TikTok は JSON を送信します。含まれるのは client_key、event、create_time、アカウント ID である user_openid、そして直列化された JSON 文字列の content です。content の中には、comment_id と video_id、返信の場合は parent_comment_id、comment_type(comment または reply)、comment_action、タイムスタンプ、コメントした人の unique_identifier、テキストがあります。ID は double で正確に保持できないほど大きな JSON 数値なので、生の文字列から読み取ってください。
イベントはどのようにエンドポイントに届きますか?
TikTok は Webhook を開発者アプリに送信し、アプリ全体で 1 つのコールバック URL を使います。easyCoexistence がそれらを受け取り、接続済みアカウントの comment.update を、そのアカウント専用のシークレットで署名したうえで、設定された HTTPS エンドポイントへ 1 回だけ、届き次第転送します。エンドポイントは Claude または ChatGPT から set_social_webhook_destination で、または Partner API の PUT /channels/:id/webhook で設定します。シークレットは一度だけ表示され、URL を null にすると転送は停止します。
転送されたイベントはどのような形式ですか?
POST リクエストで、platform、list_social_accounts が接続に対して返す account_id、TikTok の open_id である外部 ID の external_id、そして entry を送信します。entry にはイベント名、create_time、content が含まれます。content はすでに解析済みで、ID は文字列に変換されているため、丸められることはありません。
{
"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>"
}
}
}転送されたイベントを検証するにはどうすればよいですか?
転送される配信には X-EC-Signature ヘッダーが付きます。値は t=<unix>,v1=<hex> の形式で、v1 は、タイムスタンプ、ドット、生のボディを連結した文字列に対する HMAC-SHA256 の値です。鍵はアカウントの署名用シークレットです。届いたままのボディを使って再計算し、2 つの値を定数時間で比較してください。5 分より古いタイムスタンプは拒否してください。
配信は再試行されますか?
easyCoexistence による再試行は行いません。各イベントは 1 回だけメモリ上で転送され、再試行用のコピーは保持しません。転送は 8 秒間応答を待ち、リダイレクトには従いません。上流の TikTok は自身の配信を最長 72 時間まで再試行し、少なくとも 1 回の配信を保証しています。そのため、同じイベントが 2 回届くことがあります。comment_id と comment_action の組み合わせで重複を除去してください。
よくある間違い
- ID を数値として解析すること。comment_id と video_id は double で正確に保持できる値より大きいため、easyCoexistence は文字列として転送します。文字列のまま扱ってください。
- 解析済みのボディのコピーに対して署名を計算すること。HMAC は届いたままの生のボディに対して計算されるため、再シリアライズすると一致しなくなります。
- 重複したイベントを 2 回処理すること。TikTok は少なくとも 1 回配信するため、処理する前に comment_id と comment_action をキーにしてください。
- リダイレクトするアドレスを宛先に指定すること。転送はリダイレクトに従わないため、最終的な HTTPS URL を指定してください。
署名はアカウントごとのシークレットで行われ、コピーは保持しません。Claude または ChatGPT から set_social_webhook_destination で、または Partner API で有効にできます。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
どの TikTok Webhook イベントが転送されますか?
comment.update です。接続したアカウントの投稿に対するコメントと返信について、作成、削除、非表示、友達のみ、公開設定の変更が対象です。
TikTok の投稿に関するイベントも転送されますか?
いいえ。転送されるのはコメントのイベントです。投稿の公開状況は、代わりに get_tiktok_publish_status で確認してください。
TikTok のコメントイベントはどのくらい早く届きますか?
TikTok は変更から 5 分以内に comment.update を送信し、easyCoexistence は届き次第すぐに転送します。
TikTok のコメントイベントにテキストは含まれますか?
TikTok は、content 内に text フィールドがあると文書化しています。コメントと投稿の ID、操作、コメントした人の unique_identifier と並んで含まれます。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日