InloggenGratis proefperiode starten
easyCoexistence Officiële API's

TikTok-reactie-webhook-gebeurtenissen

Voor elke reactie of elk antwoord op foto-posts en openbare video's van een account die wordt aangemaakt, verwijderd, verborgen, ingesteld op alleen vrienden of openbaar gemaakt, stuurt de TikTok-API voor bedrijven binnen vijf minuten een comment.update-webhook. Elke gebeurtenis noemt de reactie, de post, de actie, de identifier van de reageerder en de tekst, en is ondertekend met een Tiktok-Signature-header.

easyCoexistence stuurt elke TikTok-reactiegebeurtenis voor het account zodra hij binnenkomt door naar jouw HTTPS-endpoint, ondertekend met een geheim voor dat account en zonder kopie.

5 min

Tijd waarbinnen comment.update wordt verstuurd nadat een reactie of antwoord is aangemaakt, verwijderd of van zichtbaarheid is veranderd.

72 hours

Hoe lang TikTok een levering opnieuw probeert wanneer de callback niet met HTTP 200 antwoordt, met exponentieel oplopende wachttijden.

comment.list

Scope die het account moet hebben verleend en geldig moet houden, zodat comment.update-gebeurtenissen worden verzonden.

At least once

Leveringsbelofte van TikTok: dezelfde gebeurtenis kan meer dan eenmaal aankomen, dus de verwerking moet idempotent zijn.

Wat meldt comment.update?

Wijzigingen aan reacties op de foto-posts en openbare video-posts van het account, of ze nu via de API of in de TikTok-app zijn geplaatst. comment_action geeft aan wat er gebeurde:

  • insert: een reactie of antwoord is aangemaakt.
  • delete: het is verwijderd.
  • set_to_hidden: het is verborgen, door een gebruiker of via moderatie.
  • set_to_friends_only: het is ingesteld op zichtbaar voor alleen vrienden.
  • set_to_public: het ging van verborgen of alleen vrienden naar zichtbaar voor iedereen.

Wat bevat een gebeurtenis?

TikTok stuurt JSON met client_key, event, create_time, user_openid, dat de ID van het account is, en content, een geserialiseerde JSON-string. In content staan comment_id en video_id, parent_comment_id voor antwoorden, comment_type (comment of reply), comment_action, een tijdstempel, de unique_identifier van de reageerder en de tekst. De ID's zijn JSON-getallen die te groot zijn om exact in een double te passen, dus lees ze uit de ruwe string.

Hoe bereiken gebeurtenissen jouw endpoint?

TikTok stuurt webhooks naar de developer-app, via één callback-URL voor de hele app. easyCoexistence ontvangt ze en stuurt elke comment.update voor een verbonden account door naar het HTTPS-endpoint dat je ervoor instelt, eenmaal, zodra hij binnenkomt, ondertekend met het eigen geheim van dat account. Stel het endpoint in met set_social_webhook_destination vanuit Claude of ChatGPT, of met de Partner API via PUT /channels/:id/webhook. Het geheim wordt één keer getoond, en een null-URL zet het doorsturen uit.

Hoe ziet een doorgestuurde gebeurtenis eruit?

Een POST met het platform, de account_id die list_social_accounts aan de verbinding geeft, de external_id van het account, dat TikTok's open_id is, en entry: de naam van de gebeurtenis, create_time en content. Content is al geparseerd en de ID's zijn als strings omgezet, zodat niets wordt afgerond.

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

Hoe verifieer je een doorgestuurde gebeurtenis?

Elke doorgestuurde levering draagt een X-EC-Signature-header, t=<unix>,v1=<hex>, waarin v1 een HMAC-SHA256 is van de tijdstempel, een punt en de ruwe body, gesleuteld met het ondertekeningsgeheim van het account. Bereken de signatuur opnieuw over de body precies zoals die binnenkwam, vergelijk de twee in constante tijd, en weiger een tijdstempel die ouder is dan 5 minuten.

Wordt een levering opnieuw geprobeerd?

Niet door easyCoexistence. Elke gebeurtenis wordt eenmaal doorgestuurd, in het geheugen, zonder kopie om opnieuw van te proberen. Het doorsturen wacht 8 seconden op een antwoord en volgt geen omleidingen. Stroomopwaarts probeert TikTok zijn eigen leveringen tot 72 uur opnieuw en belooft minstens één, dus dezelfde gebeurtenis kan twee keer bij jou aankomen: dedupliceer op comment_id samen met comment_action.

Veelgemaakte fouten

  • ID's als getallen parsen. comment_id en video_id zijn groter dan een double exact kan bevatten; easyCoexistence stuurt ze als strings door, dus houd ze zo.
  • De signatuur berekenen over een geparseerde kopie van de body. De HMAC dekt de ruwe body zoals die is afgeleverd, en opnieuw serialiseren breekt de match.
  • Een herhaalde gebeurtenis twee keer verwerken. TikTok levert minstens één keer, dus sleutel op comment_id en comment_action voordat je handelt.
  • Het endpoint laten verwijzen naar een adres dat doorverwijst. Doorsturen volgt geen omleidingen, dus geef de uiteindelijke HTTPS-URL op.
Dit doen met EasyCoexistence

Zet het aan met set_social_webhook_destination vanuit Claude of ChatGPT, of met de Partner API. Van US$ 9 tot US$ 0.75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen gratis.

Veelgestelde vragen

Welke TikTok-webhookgebeurtenissen worden doorgestuurd?

comment.update, voor reacties en antwoorden op de posts van het verbonden account: aangemaakt, verwijderd, verborgen, ingesteld op alleen vrienden of openbaar gemaakt.

Worden TikTok-publicatiegebeurtenissen ook doorgestuurd?

Nee. Doorsturen betreft reactiegebeurtenissen; volg de publicatie van een post in plaats daarvan met get_tiktok_publish_status.

Hoe snel komt een TikTok-reactiegebeurtenis binnen?

TikTok stuurt comment.update binnen vijf minuten na de wijziging, en easyCoexistence stuurt die door zodra hij binnenkomt.

Bevat een TikTok-reactiegebeurtenis de tekst?

TikTok documenteert een text-veld in de content van de gebeurtenis, naast de reactie- en post-ID's, de actie en de unique_identifier van de reageerder.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op