Τα webhooks κοινωνικών δικτύων: σχόλια, αναφορές και μηνύματα σε ένα endpoint
Το easyCoexistence προωθεί τα γεγονότα social media στο δικό σας endpoint HTTPS καθώς συμβαίνουν: σχόλια, αναφορές και DMs από το Instagram και το Facebook, και σχόλια από το TikTok. Κάθε γεγονός φτάνει σε έναν φάκελο, με το γεγονός του δικτύου μέσα αμετάβλητο, υπογεγραμμένο ανά λογαριασμό με X-EC-Signature. Ενεργοποιήστε το ανά λογαριασμό με το set_social_webhook_destination από το Claude ή το ChatGPT, ή με το Partner API. Τα μηνύματα ενός αριθμού WhatsApp φτάνουν επίσης στον διακομιστή σας.
- Σχόλια, αναφορές και DMs καθώς συμβαίνουν
- Ένας φάκελος, υπογεγραμμένος για κάθε λογαριασμό
- Ρύθμιση από το Claude, το ChatGPT ή το Partner API
Καμία χρέωση για 3 ημέρες. Ακυρώστε οποιαδήποτε στιγμή.
Πόσες φορές το easyCoexistence στέλνει κάθε προωθημένο γεγονός social media· δεν κρατά αντίγραφο, οπότε τίποτα δεν ξαναστέλνεται αργότερα.
Πόσο γρήγορα το comment.update webhook του TikTok αναφέρει ότι ένα σχόλιο δημιουργήθηκε, διαγράφηκε ή άλλαξε ορατότητα στα δημόσια βίντεο ενός ιδιόκτητου λογαριασμού.
Πού λαμβάνουν οι εφαρμογές στο Instagram Login τις αναφορές @mention: μέσα στην ειδοποίηση webhook των σχολίων, και όχι ως δικό τους πεδίο.
Τι αναφέρουν οι push ειδοποιήσεις του YouTube για ένα κανάλι: ένα νέο ανέβασμα, έναν νέο τίτλο ή μια νέα περιγραφή.
Για πόσο χρονικό διάστημα η Meta επαναδοκιμάζει ένα webhook WhatsApp που ο διακομιστής σας δεν αποδέχτηκε, κάτι που μπορεί να φέρει διπλότυπα.
Ποια γεγονότα στέλνει κάθε δίκτυο;
Το Instagram, το Facebook και το TikTok στέλνουν γεγονότα στο easyCoexistence, το οποίο προωθεί κάθε ένα στο URL που ορίζετε για αυτόν τον λογαριασμό. Το Instagram στέλνει νέα σχόλια, με τις αναφορές @mention να φτάνουν μέσα στην ειδοποίηση των σχολίων, και DMs. Η σελίδα του Facebook στέλνει δραστηριότητα feed, που καλύπτει τα νέα σχόλια, καθώς και μηνύματα Messenger και αναφορές της σελίδας. Το TikTok στέλνει comment.update, που ενεργοποιείται όταν ένα σχόλιο δημιουργείται, διαγράφεται ή αλλάζει ορατότητα.
Το YouTube και το LinkedIn δεν στέλνουν στο easyCoexistence γεγονότα σχολίων ή μηνυμάτων, οπότε ένας πράκτορας διαβάζει τα σχόλιά τους κατ' αίτηση. Ένας αριθμός WhatsApp λειτουργεί στη δική του διαδρομή: η Meta παραδίδει τα μηνύματά της απευθείας στον διακομιστή σας, ή το easyCoexistence τα προωθεί υπογεγραμμένα όταν ο αριθμός λειτουργεί σε managed mode.
| What arrives | Sent by | |
|---|---|---|
| Comments, mentions and DMs | easyCoexistence, signed per account | |
| Feed activity, Messenger and mentions | easyCoexistence, signed per account | |
| TikTok | comment.update events | easyCoexistence, signed per account |
| Messages and echoes from the app | Meta directly, or easyCoexistence in managed mode | |
| YouTube | No comment events | Read with list_youtube_comments |
| No comment events | Read with list_linkedin_comments |
Πώς μοιάζει ένα προωθημένο γεγονός;
Ο ίδιος φάκελος JSON σε κάθε δίκτυο, αποστέλλεται με Content-Type application/json: platform, το δίκτυο· account_id, το ID που χρησιμοποιούν τα εργαλεία MCP και το Partner API· external_id, το ID του λογαριασμού στο δίκτυο· και entry, το δικό του γεγονός του δικτύου όπως έφτασε. Για Instagram και Facebook, το entry είναι η καταχώριση webhook της Meta, με changes για σχόλια και αναφορές και messaging για DMs. Για TikTok περιέχει το γεγονός comment.update, με comment_id, video_id και parent_comment_id ως strings, ώστε τα 64-bit IDs να μην στρογγυλοποιούνται. Ένα μήνυμα Messenger φτάνει ως εξής:
{
"platform": "facebook",
"account_id": "<ACCOUNT_ID>",
"external_id": "<PAGE_ID>",
"entry": {
"id": "<PAGE_ID>",
"time": 1793318400512,
"messaging": [
{
"sender": { "id": "<PAGE_SCOPED_ID>" },
"recipient": { "id": "<PAGE_ID>" },
"timestamp": 1793318399870,
"message": { "mid": "<MESSAGE_ID>", "text": "Are you open on Sunday?" }
}
]
}
}Πώς επαληθεύετε το X-EC-Signature;
Με το signing secret που επιστρέφεται όταν ορίζετε τον προορισμό, μοναδικό για αυτόν τον λογαριασμό και εμφανίζεται μία φορά. Η κεφαλίδα έχει τη μορφή t=<unix>,v1=<hex>, και το v1 είναι HMAC-SHA256 του timestamp, μιας τελείας και του ακατέργαστου σώματος του αιτήματος, με κλειδί αυτό το secret. Διαβάστε το σώμα ως bytes πριν το αναλύσετε, απορρίψτε timestamp που απέχει περισσότερο από 5 λεπτά από το ρολόι σας, αναζητήστε το secret με βάση το account_id του γεγονότος και συγκρίνετε τα δύο digests σε σταθερό χρόνο. Μετά απαντήστε 2xx και βάλτε τη δουλειά σε ουρά. Σε PHP, αυτό χρειάζεται μερικές γραμμές:
<?php
// POST /hooks/social: one endpoint for the events of each account
$raw = file_get_contents('php://input'); // the exact bytes that were signed
parse_str(str_replace(',', '&', $_SERVER['HTTP_X_EC_SIGNATURE'] ?? ''), $sig);
$event = json_decode($raw, true); // platform, account_id, external_id, entry
$secret = secret_for($event['account_id'] ?? ''); // the signing_secret stored for that account
$fresh = ctype_digit($sig['t'] ?? '') && abs(time() - (int) $sig['t']) <= 300;
$expected = hash_hmac('sha256', ($sig['t'] ?? '') . '.' . $raw, (string) $secret);
if (!$secret || !$fresh || !hash_equals($expected, $sig['v1'] ?? '')) {
http_response_code(401);
exit;
}
http_response_code(204);
enqueue($event); // keep this quick: the forward waits 8 seconds and is never resentΠώς ενεργοποιείτε την προώθηση για έναν λογαριασμό;
Από έναν βοηθό ή από το backend σας. Ζητήστε από το Claude ή το ChatGPT να εκτελέσει το set_social_webhook_destination με τον λογαριασμό και το HTTPS URL σας, ή καλέστε το PUT /api/v1/channels/:id/webhook στο Partner API με το κλειδί σας ec_live_ και σώμα που περιέχει το url. Και οι δύο επιστρέφουν το signing_secret του λογαριασμού μία φορά, οπότε αποθηκεύστε το δίπλα στο account_id εκείνη τη στιγμή. Η νέα κλήση εκδίδει νέο secret, και ένα url με τιμή null απενεργοποιεί την προώθηση.
Το URL πρέπει να είναι HTTPS σε δημόσιο host: μια ιδιωτική διεύθυνση απορρίπτεται όταν την ορίζετε και ξανά κατά την παράδοση. Ένα endpoint μπορεί να εξυπηρετεί πολλούς λογαριασμούς, καθώς κάθε γεγονός αναφέρει το account_id του. Για έναν αριθμό WhatsApp, το set_webhook_destination δρομολογεί τις παραδόσεις της Meta σε εσάς, ενώ το set_inbound_mode με forward_url τις προωθεί υπογεγραμμένες.
Τι συμβαίνει όταν το endpoint σας είναι αργό ή εκτός λειτουργίας;
Το γεγονός δεν ξαναστέλνεται. Το easyCoexistence κάνει μία προσπάθεια, περιμένει έως 8 δευτερόλεπτα για απάντηση, δεν ακολουθεί ανακατευθύνσεις και δεν κρατά αντίγραφο, γιατί η επανάληψη θα σήμαινε αποθήκευση των σχολίων και μηνυμάτων των πελατών σας. Απαντήστε 2xx μόλις η υπογραφή επαληθευτεί, κάντε τις αργές εργασίες από ουρά, και αφαιρέστε διπλότυπα με βάση τα δικά του IDs του δικτύου, όπως ένα comment ID ή ένα message mid, σε περίπτωση που ένα γεγονός φτάσει δύο φορές.
Το WhatsApp διαφέρει. Στην άμεση λειτουργία, η Meta επαναδοκιμάζει μια παράδοση που ο διακομιστής σας δεν αποδέχτηκε για έως 7 ημέρες. Στη managed λειτουργία, το easyCoexistence βάζει σε ουρά τα μηνύματα για το forward URL σας και επαναδοκιμάζει με αυξανόμενη αναμονή. Τα γεγονότα κατάστασης Partner, όπως μια πτώση σύνδεσης, επαναδοκιμάζονται για περίπου 33 ώρες.
Πώς φτάνουν τα σχόλια του YouTube και του LinkedIn σε έναν πράκτορα;
Με ανάγνωση σε χρονοδιάγραμμα. Οι push ειδοποιήσεις του YouTube αναφέρουν νέο ανέβασμα, νέο τίτλο ή νέα περιγραφή, όχι σχόλια, και το easyCoexistence δεν λαμβάνει γεγονότα σχολίων από το LinkedIn, οπότε κανένα από τα δύο δεν προωθεί τίποτα. Ο πράκτορας ελέγχει αντί γι' αυτό: το list_youtube_comments επιστρέφει τα threads ενός βίντεο ή ολόκληρου του καναλιού, συμπεριλαμβανομένων εκείνων που περιμένουν έγκριση, και το list_linkedin_comments επιστρέφει τα σχόλια μιας ανάρτησης ή τις απαντήσεις κάτω από ένα σχόλιο. Στο n8n, στο Make ή στο Zapier, ένα trigger χρονοδιαγράμματος ξεκινά τον έλεγχο· στον δικό σας κώδικα, ένα cron job ανακτά τα στοιχεία πρόσβασης του καναλιού και καλεί απευθείας το commentThreads του YouTube ή το comments endpoint του LinkedIn.
Πώς να το ρυθμίσετε
- Set the destinationRun set_social_webhook_destination with the account and an HTTPS URL, or call PUT /api/v1/channels/:id/webhook with your ec_live_ key.
- Store the secretSave the signing_secret from the response against that account_id, since it is shown only once.
- Verify each deliveryCheck that the timestamp is fresh and that v1 matches an HMAC-SHA256 of the timestamp, a dot and the raw body.
- Acknowledge, then workAnswer 2xx straight away and hand the event to a queue, because easyCoexistence sends it only once.
Συνηθισμένα λάθη
- Έλεγχος του HMAC πάνω σε JSON που έχει ήδη αναλυθεί. Η υπογραφή καλύπτει το ακατέργαστο σώμα byte προς byte, και η εκ νέου σειριοποίηση του αναλυμένου αντικειμένου αλλάζει αυτά τα bytes, οπότε επαληθεύστε πριν αναλύσετε.
- Χρήση ενός secret για όλους τους λογαριασμούς. Κάθε λογαριασμός υπογράφει με το δικό του secret, οπότε αναζητήστε το με βάση το account_id του γεγονότος πριν συγκρίνετε το v1.
- Νέα ρύθμιση προορισμού χωρίς ενημέρωση του endpoint σας. Κάθε κλήση εκδίδει νέο secret και το παλιό σταματά να υπογράφει αμέσως, οπότε αποθηκεύστε το νέο αμέσως.
- Ορισμός URL που κάνει ανακατεύθυνση. Οι προωθήσεις δεν ακολουθούν ανακατευθύνσεις, οπότε μια μετακίνηση σε νέα διαδρομή ή host χάνει το γεγονός· ορίστε την τελική διεύθυνση.
Το easyCoexistence στέλνει σχόλια, αναφορές και DMs από το Instagram και το Facebook, και σχόλια από το TikTok, στο endpoint σας καθώς συμβαίνουν, υπογεγραμμένα ανά λογαριασμό, και δρομολογεί τα μηνύματα WhatsApp στον διακομιστή σας, ώστε οι πράκτορες AI σας να ακούνε τους πελάτες μέσω του επίσημου API κάθε δικτύου, με κάθε σύνδεση παρακολουθούμενη 24/7. Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Πώς φτάνουν τα μηνύματα ενός αριθμού WhatsApp στο endpoint μου;
Με έναν από δύο τρόπους. Το set_webhook_destination κάνει τη Meta να τα παραδίδει απευθείας στον διακομιστή σας, ενώ το set_inbound_mode με forward_url κάνει το easyCoexistence να τα προωθεί υπογεγραμμένα με X-EC-Signature, με επαναδοκιμές με αυξανόμενη αναμονή.
Μπορεί το ίδιο γεγονός να φτάσει δύο φορές;
Μπορεί, γι' αυτό αφαιρέστε διπλότυπα με βάση τα IDs του ίδιου του δικτύου, όπως ένα comment ID ή ένα message mid. Οι επαναδοκιμές της Meta για μια παράδοση WhatsApp που ο διακομιστής σας δεν αποδέχτηκε, έως 7 ημέρες, μπορούν επίσης να φέρουν διπλότυπα.
Μπορεί ένα endpoint να λαμβάνει γεγονότα από πολλούς λογαριασμούς;
Ναι. Κάθε γεγονός φέρει platform και account_id, οπότε ένα URL μπορεί να εξυπηρετεί πολλούς λογαριασμούς, αρκεί να ελέγχει κάθε υπογραφή με το δικό του secret του λογαριασμού.
Πόσο κοστίζει το easyCoexistence για τα webhooks social media;
Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις και η ίδια τιμή σε κάθε δίκτυο. Η προώθηση, ο διακομιστής MCP και το Partner API περιλαμβάνονται, με τις πρώτες 3 ημέρες δωρεάν.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις