ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
easyCoexistence Επίσημα API

Συμβάντα webhook σχολίων της TikTok

Το API for Business της TikTok στέλνει ένα webhook comment.update μέσα σε πέντε λεπτά από τη δημιουργία, τη διαγραφή, την απόκρυψη, τον ορισμό μόνο για φίλους ή τη δημοσίευση ενός σχολίου ή μιας απάντησης σε φωτογραφίες και δημόσια βίντεο ενός λογαριασμού. Κάθε συμβάν ονομάζει το σχόλιο, την ανάρτηση, την ενέργεια, το αναγνωριστικό του σχολιαστή και το κείμενο, και υπογράφεται με την κεφαλίδα Tiktok-Signature.

Το easyCoexistence προωθεί κάθε συμβάν σχολίου της TikTok για τον λογαριασμό στο δικό σας endpoint HTTPS όπως φτάνει, υπογεγραμμένο με μυστικό για αυτόν τον λογαριασμό και χωρίς να κρατά αντίγραφο.

5 min

Χρόνος μέσα στον οποίο το comment.update ενεργοποιείται μετά τη δημιουργία, τη διαγραφή ή την αλλαγή ορατότητας ενός σχολίου ή μιας απάντησης.

72 hours

Πόσο καιρό επαναλαμβάνει η TikTok μια αποστολή που το callback της δεν απάντησε με HTTP 200, με εκθετική αναμονή.

comment.list

Το δικαίωμα που πρέπει να έχει χορηγήσει και να διατηρεί έγκυρο ο λογαριασμός, ώστε να στέλνονται τα συμβάντα comment.update.

At least once

Η υπόσχεση παράδοσης της TikTok, οπότε το ίδιο συμβάν μπορεί να φτάσει περισσότερες από μία φορά και ο χειρισμός πρέπει να είναι idempotent.

Τι αναφέρει το 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 και user_openid, που είναι το ID του λογαριασμού, και content, μια σειριοποιημένη συμβολοσειρά JSON. Μέσα στο content βρίσκονται τα comment_id και video_id, το parent_comment_id για τις απαντήσεις, το comment_type (comment ή reply), το comment_action, μια χρονική σήμανση, το unique_identifier του σχολιαστή και το κείμενο. Τα αναγνωριστικά είναι αριθμοί JSON πολύ μεγάλοι για να χωρέσουν ακριβώς σε double, γι' αυτό διαβάστε τα από την ακατέργαστη συμβολοσειρά.

Πώς φτάνουν τα συμβάντα στο endpoint σας;

Η TikTok στέλνει webhook στην εφαρμογή προγραμματιστή, μέσω ενός callback URL για όλη την εφαρμογή. Το easyCoexistence τα λαμβάνει και προωθεί κάθε comment.update για συνδεδεμένο λογαριασμό στο endpoint HTTPS που ορίζετε για αυτόν, μία φορά, όπως φτάνει, υπογεγραμμένο με το μυστικό του ίδιου λογαριασμού. Ορίστε το endpoint με το set_social_webhook_destination από το Claude ή το ChatGPT, ή με το Partner API μέσω του PUT /channels/:id/webhook. Το μυστικό εμφανίζεται μία μόνο φορά, και ένα null URL απενεργοποιεί την προώθηση.

Πώς μοιάζει ένα προωθημένο συμβάν;

Ένα POST με την πλατφόρμα, το account_id που δίνει το list_social_accounts για τη σύνδεση, το external_id του λογαριασμού, που είναι το open_id της TikTok, και το entry. Το entry περιλαμβάνει το όνομα του συμβάντος, το create_time και το content, με το content ήδη αναλυμένο και τα αναγνωριστικά του μετατραμμένα σε συμβολοσειρές, ώστε κανένα να μη στρογγυλοποιείται.

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

Πώς επαληθεύετε ένα προωθημένο συμβάν;

Κάθε προωθημένη παράδοση φέρει την κεφαλίδα X-EC-Signature, t=<unix>,v1=<hex>, όπου το v1 είναι HMAC-SHA256 της χρονικής σήμανσης, μιας τελείας και του ακατέργαστου σώματος, με κλειδί το μυστικό υπογραφής του λογαριασμού. Υπολογίστε το ξανά πάνω στο σώμα ακριβώς όπως έφτασε, συγκρίνετε τις δύο τιμές σε σταθερό χρόνο και απορρίψτε χρονική σήμανση που είναι παλαιότερη από 5 λεπτά.

Επαναλαμβάνεται μια παράδοση;

Όχι από το easyCoexistence. Κάθε συμβάν προωθείται μία φορά, στη μνήμη, χωρίς αντίγραφο για επανάληψη. Η προώθηση περιμένει 8 δευτερόλεπτα για απάντηση και δεν ακολουθεί ανακατευθύνσεις. Από την πλευρά της TikTok επαναλαμβάνονται οι δικές της παραδόσεις για έως 72 ώρες, και υπόσχεται τουλάχιστον μία, οπότε το ίδιο συμβάν μπορεί να φτάσει δύο φορές. Αφαιρέστε τα διπλότυπα με βάση το comment_id μαζί με το comment_action.

Συνηθισμένα λάθη

  • Ανάλυση των αναγνωριστικών ως αριθμών. Τα comment_id και video_id είναι μεγαλύτερα από όσα χωρά ακριβώς ένα double. Το easyCoexistence τα προωθεί ως συμβολοσειρές, οπότε κρατήστε τα έτσι.
  • Υπολογισμός της υπογραφής πάνω σε αναλυμένο αντίγραφο του σώματος. Το HMAC καλύπτει το ακατέργαστο σώμα όπως παραδόθηκε, και η σειριοποίηση από την αρχή καταστρέφει την αντιστοιχία.
  • Χειρισμός ενός επαναλαμβανόμενου συμβάντος δύο φορές. Η TikTok παραδίδει τουλάχιστον μία φορά, οπότε χρησιμοποιήστε ως κλειδί το comment_id και το comment_action πριν από κάθε ενέργεια.
  • Ο προορισμός δείχνει σε διεύθυνση που ανακατευθύνει. Η προώθηση δεν ακολουθεί ανακατευθύνσεις, οπότε δώστε το τελικό HTTPS URL.
Κάντε το με EasyCoexistence

Ενεργοποιήστε το με το set_social_webhook_destination από το Claude ή το ChatGPT, ή με το Partner API. Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση καθώς προσθέτετε συνδέσεις, και με τις πρώτες 3 ημέρες δωρεάν.

Συχνές ερωτήσεις

Ποια συμβάντα webhook της TikTok προωθούνται;

comment.update, για σχόλια και απαντήσεις στις αναρτήσεις του συνδεδεμένου λογαριασμού: δημιουργία, διαγραφή, απόκρυψη, ορισμός μόνο για φίλους ή δημοσίευση.

Προωθούνται και τα συμβάντα δημοσίευσης της TikTok;

Όχι. Η προώθηση μεταφέρει συμβάντα σχολίων. Για να παρακολουθήσετε τη δημοσίευση μιας ανάρτησης, χρησιμοποιήστε το get_tiktok_publish_status.

Πόσο γρήγορα φτάνει ένα συμβάν σχολίου της TikTok;

Η TikTok στέλνει το comment.update μέσα σε πέντε λεπτά από την αλλαγή, και το easyCoexistence το προωθεί αμέσως μόλις έρθει.

Περιλαμβάνει το συμβάν σχολίου της TikTok το κείμενο;

Η TikTok τεκμηριώνει ένα πεδίο text στο content του συμβάντος, δίπλα στα αναγνωριστικά σχολίου και ανάρτησης, στην ενέργεια και στο unique_identifier του σχολιαστή.

Συνεχίστε την ανάγνωση

Απαντήσεις και διαχείριση σχολίων TikTok μέσω του APIΠώς το API for Business του TikTok διαβάζει, απαντά, κρύβει και διαγράφει σχόλια, και πώς οι κανόνες απαντούν αυτόματα σε νέα σχόλια.TikTok API for Business έναντι του Content Posting APIΓιατί το API for Business της TikTok και όχι το developers.tiktok.com: σχόλια και webhook, στατιστικές, συνδέσεις λογαριασμών και ανανέωση tokens.Πώς ελέγχετε την κατάσταση δημοσίευσης μιας ανάρτησης στο TikTok μέσω του APIΠώς παρακολουθείτε ανάρτηση στο TikTok που δημοσιεύεται μέσω του API: share_id, PROCESSING_DOWNLOAD, PUBLISH_COMPLETE, FAILED, τα post IDs και αιτίες αποτυχίας.TikTok Analytics API: μετρήσεις λογαριασμού και βίντεοΟι μετρήσεις TikTok του API for Business: ακόλουθοι, προβολές και likes ανά ημέρα για λογαριασμό, και προβολές, likes, σχόλια και κοινοποιήσεις ανά βίντεο.TikTok σφάλμα 40001: καμία άδεια για τη λειτουργίαΤο σφάλμα TikTok 40001 σημαίνει ότι η κλήση δεν έχει άδεια για τη λειτουργία. Πώς ελέγχετε την άδεια TikTok Accounts και τα scopes του token.

Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.

Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.

  • 3 ημέρες δωρεάν
  • Ακύρωση ανά πάσα στιγμή
  • Μόνο επίσημα API
  • Παρακολούθηση 24/7

Επαληθεύτηκε στις