Συμβάντα webhook σχολίων της TikTok
Το API for Business της TikTok στέλνει ένα webhook comment.update μέσα σε πέντε λεπτά από τη δημιουργία, τη διαγραφή, την απόκρυψη, τον ορισμό μόνο για φίλους ή τη δημοσίευση ενός σχολίου ή μιας απάντησης σε φωτογραφίες και δημόσια βίντεο ενός λογαριασμού. Κάθε συμβάν ονομάζει το σχόλιο, την ανάρτηση, την ενέργεια, το αναγνωριστικό του σχολιαστή και το κείμενο, και υπογράφεται με την κεφαλίδα Tiktok-Signature.
Το easyCoexistence προωθεί κάθε συμβάν σχολίου της TikTok για τον λογαριασμό στο δικό σας endpoint HTTPS όπως φτάνει, υπογεγραμμένο με μυστικό για αυτόν τον λογαριασμό και χωρίς να κρατά αντίγραφο.
Χρόνος μέσα στον οποίο το comment.update ενεργοποιείται μετά τη δημιουργία, τη διαγραφή ή την αλλαγή ορατότητας ενός σχολίου ή μιας απάντησης.
Πόσο καιρό επαναλαμβάνει η TikTok μια αποστολή που το callback της δεν απάντησε με HTTP 200, με εκθετική αναμονή.
Το δικαίωμα που πρέπει να έχει χορηγήσει και να διατηρεί έγκυρο ο λογαριασμός, ώστε να στέλνονται τα συμβάντα comment.update.
Η υπόσχεση παράδοσης της 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 ήδη αναλυμένο και τα αναγνωριστικά του μετατραμμένα σε συμβολοσειρές, ώστε κανένα να μη στρογγυλοποιείται.
{
"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.
Ενεργοποιήστε το με το 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 του σχολιαστή.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις