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

Τα 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 ημέρες. Ακυρώστε οποιαδήποτε στιγμή.

Μόνο επίσημα APIMCP για Claude και ChatGPTΚάθε σύνδεση υπό παρακολούθηση 24/73 ημέρες δωρεάν
1 attempt

Πόσες φορές το easyCoexistence στέλνει κάθε προωθημένο γεγονός social media· δεν κρατά αντίγραφο, οπότε τίποτα δεν ξαναστέλνεται αργότερα.

Within 5 minutes

Πόσο γρήγορα το comment.update webhook του TikTok αναφέρει ότι ένα σχόλιο δημιουργήθηκε, διαγράφηκε ή άλλαξε ορατότητα στα δημόσια βίντεο ενός ιδιόκτητου λογαριασμού.

In comments

Πού λαμβάνουν οι εφαρμογές στο Instagram Login τις αναφορές @mention: μέσα στην ειδοποίηση webhook των σχολίων, και όχι ως δικό τους πεδίο.

3 events

Τι αναφέρουν οι push ειδοποιήσεις του YouTube για ένα κανάλι: ένα νέο ανέβασμα, έναν νέο τίτλο ή μια νέα περιγραφή.

7 days

Για πόσο χρονικό διάστημα η 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 arrivesSent by
InstagramComments, mentions and DMseasyCoexistence, signed per account
FacebookFeed activity, Messenger and mentionseasyCoexistence, signed per account
TikTokcomment.update eventseasyCoexistence, signed per account
WhatsAppMessages and echoes from the appMeta directly, or easyCoexistence in managed mode
YouTubeNo comment eventsRead with list_youtube_comments
LinkedInNo comment eventsRead 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 φτάνει ως εξής:

A forwarded Messenger message, trimmed
{
  "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: verifying a forwarded event
<?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.

Πώς να το ρυθμίσετε

  1. 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.
  2. Store the secretSave the signing_secret from the response against that account_id, since it is shown only once.
  3. Verify each deliveryCheck that the timestamp is fresh and that v1 matches an HMAC-SHA256 of the timestamp, a dot and the raw body.
  4. 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

Το 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 ημέρες δωρεάν.

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

Το API σχολίων social media για Instagram, TikTok, Facebook, YouTube και LinkedInΔιαβάστε, απαντήστε και διαχειριστείτε σχόλια σε Instagram, Facebook, TikTok, YouTube και LinkedIn από Claude, ChatGPT ή τον κώδικά σας, μέσω επίσημων API.API DM για κοινωνικά δίκτυα: μηνύματα Instagram, Messenger και WhatsApp σε ένα APIΑπαντήστε σε DM του Instagram, μηνύματα Messenger και WhatsApp από το Claude, το ChatGPT ή τον κώδικά σας, με templates και αυτοματισμούς, μέσω των API της Meta.Πώς λαμβάνετε τα μηνύματα WhatsApp και τα σχόλια των πελατών σας μέσω του webhookΈνα webhook για κάθε σύνδεση: μηνύματα WhatsApp απευθείας από τη Meta, με μυστικό στο URL, και σχόλια και DMs υπογεγραμμένα με X-EC-Signature.Αυτοματισμός n8n για social media: Instagram, TikTok, Facebook και άλλαΑυτοματοποιήστε Instagram, TikTok, Facebook και YouTube στο n8n: υπογεγραμμένα συμβάντα σε κόμβο Webhook και AI Agent με 35+ εργαλεία MCP.Δημοσιεύστε σε Instagram, TikTok και Facebook από Node.js με ένα APIΔημοσιεύστε, προγραμματίστε και απαντήστε σε Instagram, Facebook, TikTok, YouTube και LinkedIn από Node.js με fetch, και με MCP εργαλεία για τον AI agent σας.Ανάρτηση σε Instagram, TikTok και Facebook από Python με ένα APIΔημοσιεύστε, διαβάστε σχόλια και απαντήστε σε DMs σε Instagram, Facebook, TikTok, YouTube και LinkedIn από Python, μέσω των επίσημων API κάθε δικτύου.

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

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

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

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