AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

TikTok-Kommentar-Webhook-Events

Die TikTok API for Business sendet einen comment.update-Webhook innerhalb von fünf Minuten, nachdem ein Kommentar oder eine Antwort auf Fotobeiträgen und öffentlichen Videos eines Kontos erstellt, gelöscht, ausgeblendet, nur für Freunde sichtbar gesetzt oder öffentlich gemacht wurde. Jedes Event nennt den Kommentar, den Beitrag, die Aktion, die Kennung des Kommentierenden und den Text und ist mit einem Tiktok-Signature-Header signiert.

easyCoexistence leitet jedes TikTok-Kommentar-Event des Kontos an Ihren HTTPS-Endpoint weiter, sobald es eintrifft, signiert mit einem Geheimschlüssel für dieses Konto und ohne gespeicherte Kopie.

5 min

Zeitspanne, binnen der comment.update nach dem Erstellen, Löschen oder einer Sichtbarkeitsänderung eines Kommentars oder einer Antwort ausgelöst wird.

72 hours

Wie lange TikTok eine Zustellung wiederholt, die der Callback nicht mit HTTP 200 beantwortet hat, mit exponentiell wachsenden Abständen.

comment.list

Berechtigung, die das Konto erteilt haben und gültig halten muss, damit seine comment.update-Events gesendet werden.

At least once

TikToks Zustellungsversprechen: dasselbe Event kann mehrfach ankommen, deshalb sollte die Verarbeitung idempotent sein.

Was meldet comment.update?

Änderungen an Kommentaren auf Fotobeiträgen und öffentlichen Videobeiträgen des Kontos, unabhängig davon, ob sie über die API oder in der TikTok-App veröffentlicht wurden. comment_action zeigt, was geschehen ist:

  • insert: ein Kommentar oder eine Antwort wurde erstellt.
  • delete: er wurde gelöscht.
  • set_to_hidden: er wurde ausgeblendet, durch einen Nutzer oder über Moderation.
  • set_to_friends_only: er wurde auf nur für Freunde sichtbar gesetzt.
  • set_to_public: er wechselte von ausgeblendet oder nur für Freunde sichtbar zu für alle sichtbar.

Was enthält ein Event?

TikTok sendet JSON mit client_key, event, create_time, user_openid, der Konto-ID, und content, einem serialisierten JSON-String. In content stehen comment_id und video_id, parent_comment_id bei Antworten, comment_type (comment oder reply), comment_action, ein Zeitstempel, die unique_identifier des Kommentierenden und der Text. Die IDs sind JSON-Zahlen, die ein double nicht exakt speichern kann; lesen Sie sie deshalb aus dem rohen String.

Wie gelangen Events an Ihren Endpoint?

TikTok sendet Webhooks an die Entwickler-App, über eine einzige Callback-URL für die gesamte App. easyCoexistence empfängt sie und leitet jedes comment.update eines verbundenen Kontos einmal, sobald es eintrifft, an den HTTPS-Endpoint weiter, den Sie dafür festlegen, signiert mit dem eigenen Geheimschlüssel dieses Kontos. Den Endpoint setzen Sie mit set_social_webhook_destination aus Claude oder ChatGPT oder mit der Partner API über PUT /channels/:id/webhook; der Geheimschlüssel wird nur einmal angezeigt, und eine null-URL schaltet die Weiterleitung ab.

Wie sieht ein weitergeleitetes Event aus?

Ein POST mit der platform, der account_id, die list_social_accounts für die Verbindung liefert, der external_id des Kontos, also der open_id von TikTok, und entry: der Name des Events, create_time und content, wobei content bereits geparst ist und seine IDs als Strings vorliegen, damit keine gerundet wird.

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

Wie prüfen Sie ein weitergeleitetes Event?

Jede weitergeleitete Zustellung trägt einen X-EC-Signature-Header, t=<unix>,v1=<hex>, wobei v1 ein HMAC-SHA256 aus dem Zeitstempel, einem Punkt und dem rohen Body ist, mit dem Geheimschlüssel des Kontos als Schlüssel. Berechnen Sie ihn über den Body genau so nach, wie er angekommen ist, vergleichen Sie beide Werte in konstanter Zeit und weisen Sie einen Zeitstempel ab, der älter als 5 Minuten ist.

Wird eine Zustellung wiederholt?

Nicht durch easyCoexistence. Jedes Event wird einmal im Speicher weitergeleitet, ohne Kopie, von der aus wiederholt werden könnte; die Weiterleitung wartet 8 Sekunden auf eine Antwort und folgt keinen Weiterleitungen. Auf Seiten von TikTok wiederholt sich die Zustellung bis zu 72 Stunden lang, und TikTok verspricht mindestens eine Zustellung, daher kann dasselbe Event zweimal bei Ihnen ankommen. Deduplizieren Sie anhand von comment_id zusammen mit comment_action.

Häufige Fehler

  • IDs als Zahlen parsen. comment_id und video_id sind größer, als ein double exakt speichern kann; easyCoexistence leitet sie als Strings weiter, belassen Sie sie also so.
  • Die Signatur über eine geparste Kopie des Body berechnen. Der HMAC bezieht sich auf den rohen Body, wie er zugestellt wurde; eine erneute Serialisierung bricht die Übereinstimmung.
  • Ein wiederholtes Event zweimal verarbeiten. TikTok liefert mindestens einmal, also anhand von comment_id und comment_action prüfen, bevor Sie handeln.
  • Den Endpoint auf eine Adresse richten, die weiterleitet. Die Zustellung folgt keinen HTTP-Weiterleitungen, geben Sie daher die endgültige HTTPS-URL an.
Mit EasyCoexistence

Aktivieren Sie es mit set_social_webhook_destination aus Claude oder ChatGPT oder über die Partner API. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit kostenloser Testphase von 3 Tagen.

Häufig gestellte Fragen

Welche TikTok-Webhook-Events werden weitergeleitet?

comment.update, für Kommentare und Antworten auf den Beiträgen des verbundenen Kontos: erstellt, gelöscht, ausgeblendet, nur für Freunde sichtbar oder öffentlich gemacht.

Werden auch TikTok-Veröffentlichungs-Events weitergeleitet?

Nein. Die Weiterleitung umfasst Kommentar-Events; verfolgen Sie die Veröffentlichung eines Beitrags stattdessen mit get_tiktok_publish_status.

Wie schnell kommt ein TikTok-Kommentar-Event an?

TikTok sendet comment.update innerhalb von fünf Minuten nach der Änderung, und easyCoexistence leitet es weiter, sobald es eingeht.

Enthält ein TikTok-Kommentar-Event den Text?

TikTok dokumentiert ein text-Feld im content des Events, neben den Kommentar- und Beitrags-IDs, der Aktion und der unique_identifier des Kommentierenden.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am