AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Einrichtung der TikTok API for Business Webhooks

Die API for Business von TikTok sendet Webhooks an eine Callback-URL pro Entwickler-App und Ereignistyp. Festgelegt wird sie mit POST /business/webhook/update/ über app_id und secret der App. event_type VIDEO abonniert die vier Ereignisse zur Veröffentlichung eines Beitrags, COMMENT abonniert comment.update. Jede Zustellung ist ein HTTPS-POST, der im Header Tiktok-Signature mit einem HMAC-SHA256 signiert ist, dessen Schlüssel das App-Secret ist.

easyCoexistence hält den Webhook für Kommentare von TikTok für die eigene App abonniert, prüft die Signatur von TikTok und leitet jedes Kommentar-Ereignis für Ihr Konto an Ihren HTTPS-Endpoint weiter, signiert mit einem eigenen Secret.

72 hours

Wie lange TikTok eine Zustellung wiederholt, die nicht mit HTTP 200 beantwortet wurde, mit exponentiell steigenden Pausen, bevor sie verworfen wird.

100

Höchstzahl an Beitrags-IDs, die eine item_list enthalten kann, um comment.update-Ereignisse auf bestimmte Beiträge zu begrenzen.

v1.0

Aktueller Wert des Headers webhook-schema-version, den TikTok bei jeder Zustellung sendet.

No permission

Was die Referenz von TikTok für die Endpoints der Webhook-Konfiguration auflistet, die sich mit App-ID und Secret authentifizieren.

HMAC-SHA256

Algorithmus hinter Tiktok-Signature: der Zeitstempel, ein Punkt und der Body, geschlüsselt mit dem App-Secret und hex-kodiert.

Business Comment

App-Berechtigung unter TikTok-Konten, die für comment.update nötig ist; Ereignisse zur Veröffentlichung benötigen Business Content.

Welche Webhook-Ereignisse kann eine App für TikTok-Konten empfangen?

Zwei Kategorien, jede als eigener event_type abonniert. VIDEO umfasst Beiträge, die über /business/video/publish/ oder /business/photo/publish/ veröffentlicht wurden, und COMMENT umfasst Kommentare zu den Foto-Beiträgen und öffentlichen Video-Beiträgen des Kontos, unabhängig davon, ob sie über die API oder in der TikTok-App veröffentlicht wurden:

post.publish.failedVIDEO: the post broke a format rule or its URL was blocked before the download finished
post.publish.completeVIDEO: the file met the format rules and downloaded without problems
post.publish.publicly_availableVIDEO: moderation passed and the post is public, with its post_id
post.publish.no_longer_publicly_availableVIDEO: later moderation, or the owner, took the post out of public view
comment.updateCOMMENT: a comment or reply created, deleted, hidden, set to friends only or made public

Was braucht die App vor dem Abonnieren?

Zugang zur API for Business, eine Entwickler-App und TikTok-Konten, die sie autorisiert haben. Der Abonnement-Leitfaden von TikTok ergänzt eine Berechtigung für jede Kategorie, und das Kommentar-Ereignis benötigt einen Scope von jedem Inhaber:

  • Ereignisse zur Veröffentlichung: die Berechtigung TikTok-Konten, Business Content auf der App.
  • Kommentar-Ereignisse: die Berechtigung TikTok-Konten, Business Comment auf der App.
  • comment.update: der Scope comment.list, vom Inhaber erteilt und gültig gehalten.
  • Eine Callback-URL über HTTPS, die sofort mit HTTP 200 antwortet.

Wie abonnieren Sie?

Mit einem POST an /business/webhook/update/, einmal pro event_type. Der Body enthält app_id und secret, den event_type, VIDEO oder COMMENT, und callback_url; bei COMMENT kann er zusätzlich item_list enthalten. Die Antwort spiegelt app_id, event_type, callback_url und, falls eine gesetzt ist, item_list. Ein erneuter Aufruf für denselben event_type ersetzt die Callback-URL.

Subscribe the app to comment events
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/webhook/update/' \
  -H 'Content-Type: application/json' \
  -d '{
    "app_id": "<APP_ID>",
    "secret": "<APP_SECRET>",
    "event_type": "COMMENT",
    "callback_url": "https://hooks.example.com/tiktok/"
  }'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": { "app_id": "<APP_ID>", "callback_url": "https://hooks.example.com/tiktok/", "event_type": "COMMENT" }
}

Wie grenzt item_list Kommentar-Ereignisse ein?

Es begrenzt comment.update auf die genannten Beiträge, bis zu 100 IDs aus /business/video/list/, und die erste Liste legt den Modus der App von da an fest:

  • Erster COMMENT-Aufruf mit item_list: Ereignisse kommen nur für die aufgelisteten Beiträge.
  • Spätere Aufrufe mit item_list: die neuen Beiträge kommen zu den bereits aufgelisteten hinzu.
  • COMMENT-Aufruf ohne item_list, zuvor nichts gesetzt: Ereignisse kommen für die Beiträge der Konten, die die App autorisiert haben.
  • COMMENT-Aufruf ohne item_list, sobald eine Liste existiert: die konfigurierten Beiträge bleiben unverändert.

Wie prüfen oder entfernen Sie ein Abonnement?

GET /business/webhook/list/ mit app_id, secret und event_type liefert die Konfiguration: callback_url erscheint nur, wenn für diesen Ereignistyp eine existiert, und item_list nur, wenn eine gesetzt wurde. POST /business/webhook/delete/ mit app_id, secret und event_type entfernt es; bei COMMENT entfernt ein item_list im Delete-Aufruf nur diese Beiträge, ohne item_list stoppen die Kommentar-Ereignisse für alle Beiträge.

Was muss die Callback-URL leisten?

Sofort antworten. TikTok sendet JSON über HTTPS per POST und wertet alles außer HTTP 200 als fehlgeschlagene Zustellung. Es wiederholt mit exponentiellem Backoff bis zu 72 Stunden lang, bevor das Ereignis verworfen wird. Die Zustellung erfolgt mindestens einmal, daher kann dasselbe Ereignis zweimal ankommen, und die Verarbeitung muss idempotent sein. Jede Anfrage trägt drei Header, die sich zu protokollieren lohnen: tiktok-signature, webhook-schema-version und x-tt-logid, sowie einen Body mit client_key, event, create_time in Sekunden, user_openid, der business_id des Kontos, und content, einem serialisierten JSON-String.

Wie prüfen Sie Tiktok-Signature?

Teilen Sie den Header t=<unix>,s=<hex> an den Kommas und dann am Gleichheitszeichen. Bilden Sie die signierte Nachricht aus dem Wert von t, einem Punkt und dem Request-Body, berechnen Sie darüber einen HMAC-SHA256, geschlüsselt mit dem App-Secret, hex-kodieren Sie ihn und vergleichen Sie ihn mit s. Prüfen Sie danach das Alter von t: TikTok signiert die Zustellzeit gegen Replay-Angriffe, und das Beispiel von TikTok akzeptiert eine Verzögerung von 5 Sekunden. Mit dem rohen Body, wie er empfangen wurde, vermeiden Sie, dass das JSON neu und anders serialisiert wird.

Verify a TikTok webhook in Python
import hashlib, hmac, time

def verify_tiktok(raw_body: bytes, header: str, app_secret: str, max_age: int = 300) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
    t, s = parts.get("t", ""), parts.get("s", "")
    if not t.isdigit():
        return False
    expected = hmac.new(app_secret.encode(), t.encode() + b"." + raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, s) and abs(time.time() - int(t)) <= max_age

Wie empfangen Sie TikTok-Ereignisse über easyCoexistence?

Indem Sie dem Konto ein Ziel geben. easyCoexistence hält die eigene App für COMMENT abonniert, prüft die Signatur von TikTok, antwortet TikTok sofort und sendet jedes comment.update für ein verbundenes Konto per POST an den dafür festgelegten HTTPS-Endpoint. Aus Claude oder ChatGPT nimmt set_social_webhook_destination die account_id und eine url, oder null zum Beenden, und gibt ein Signing-Secret zurück, das nur einmal angezeigt wird; ein erneuter Aufruf stellt ein neues aus. Ereignisse zur Veröffentlichung werden nicht weitergeleitet: get_tiktok_publish_status verfolgt stattdessen einen Beitrag.

Set a destination through MCP
set_social_webhook_destination { "account_id": "<ACCOUNT_ID>", "url": "https://hooks.example.com/tiktok/" }
=> {
  "url": "https://hooks.example.com/tiktok/",
  "signing_secret": "whsec_<SECRET>",
  "note": "Shown once: store it as a secret. ..."
}

Wie setzen Sie es mit der Partner API?

Mit PUT /channels/{id}/webhook auf https://easycoexistence.com/api/v1, Ihrem ec_live_-Schlüssel als Bearer-Token und einem Body {"url": "https://..."}. Die Antwort enthält webhook_url, signing_secret und einen Hinweis; {"url": null} beendet die Weiterleitung. Die URL muss HTTPS auf einem öffentlichen Host verwenden. Ein unbekannter Kanal liefert 404 not_found, ein entfernter 409 removed und ein gesperrter 402 suspended.

Set a destination with the Partner API
curl -X PUT "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/webhook" \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://hooks.example.com/tiktok/"}'

{ "webhook_url": "https://hooks.example.com/tiktok/", "signing_secret": "whsec_<SECRET>", "note": "..." }

Wie unterscheiden sich die beiden Zustellungen?

Eine Weiterleitung von easyCoexistence ist anders signiert und aufgebaut als die eigene Zustellung von TikTok, daher braucht ein Empfänger, der für eine geschrieben ist, Anpassungen für die andere. Die weitergeleitete Payload behält die Kommentarfelder von TikTok bei, mit geparstem content und IDs als Strings; was sich ändert, ist, wie jede Zustellung signiert, eingegrenzt und wiederholt wird:

TikTok to your appeasyCoexistence to your endpoint
HeaderTiktok-Signature: t=<unix>,s=<hex>X-EC-Signature: t=<unix>,v1=<hex>
KeyThe developer app's secretThe account's signing secret, shown once
EventsVIDEO and COMMENT, per appcomment.update, per connected account
Bodyclient_key, event, create_time, user_openid, content as a stringplatform, account_id, external_id, entry with content parsed
RetriesUp to 72 hoursNone: one attempt, 8 seconds, no redirects

So richten Sie es ein

  1. Grant the permissionsGive the developer app Business Content for publishing events and Business Comment for comment events, and have owners grant comment.list.
  2. Build the callbackServe an HTTPS endpoint that checks Tiktok-Signature and replies 200 before doing any work.
  3. Subscribe each event typeCall /business/webhook/update/ with app_id, secret, event_type and callback_url, once for VIDEO and once for COMMENT.
  4. Confirm the configurationCall /business/webhook/list/ for each event_type and check that the callback_url, and any item_list, came back.
  5. Handle repeatsKey each event on its content, such as comment_id with comment_action, or publish_id with the event name, before acting on it.

Häufige Fehler

  • Verarbeitung vor der Antwort. TikTok erwartet ein sofortiges 200 und wiederholt Zustellungen, deren Empfang nicht bestätigt wurde. Stellen Sie die Arbeit daher in eine Warteschlange und antworten Sie zuerst.
  • item_list beim ersten COMMENT-Abonnement aus Versehen gesetzt. Danach meldet TikTok Kommentar-Ereignisse nur noch für die aufgelisteten Beiträge.
  • Mit dem Access-Token verifizieren. TikTok signiert Webhooks mit dem App-Secret, demselben, das /business/webhook/update/ entgegennimmt.
  • Zwei Umgebungen auf dieselbe App zeigen lassen. Jeder Ereignistyp behält eine callback_url pro App, und ein neuer Aufruf von /business/webhook/update/ ersetzt sie.
Mit EasyCoexistence

Einrichten mit set_social_webhook_destination aus Claude oder ChatGPT oder mit PUT /channels/{id}/webhook. Von US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit einer kostenlosen Testphase von 3 Tagen.

Häufig gestellte Fragen

Welche Header trägt eine TikTok-Webhook-Zustellung?

tiktok-signature, webhook-schema-version, derzeit v1.0, und x-tt-logid, die ID der Zustellung. Der JSON-Body enthält client_key, event, create_time, user_openid und content.

Sendet TikTok einen Webhook, wenn ein Video veröffentlicht wird?

Ja, mit event_type VIDEO: zuerst post.publish.complete, sobald TikTok die Datei heruntergeladen und geprüft hat, danach post.publish.publicly_available mit der post_id, sobald der Beitrag öffentlich ist.

Wie lange wiederholt TikTok einen fehlgeschlagenen Webhook?

Bis zu 72 Stunden mit exponentiellem Backoff, danach wird das Ereignis verworfen. Die Zustellung erfolgt mindestens einmal, rechnen Sie daher mit Duplikaten.

Kann ich meinen eigenen Callback in der TikTok-App von easyCoexistence registrieren?

Nein. Die Webhook-Einstellungen der App bleiben bei easyCoexistence. set_social_webhook_destination schickt stattdessen die Kommentar-Ereignisse des Kontos an Sie.

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