AccediInizia la prova gratuita
easyCoexistence API ufficiali

Webhook dei social media: commenti, menzioni e messaggi verso un solo endpoint

easyCoexistence inoltra al tuo endpoint HTTPS gli eventi dei social media in tempo reale: commenti, menzioni e DM di Instagram e Facebook, e commenti di TikTok. Ogni evento arriva in un'unica busta, con l'evento originale del social lasciato invariato, firmata per account con X-EC-Signature. Attivalo per account con set_social_webhook_destination da Claude o ChatGPT, oppure con la Partner API. Anche i messaggi di un numero WhatsApp arrivano al tuo server.

  • Commenti, menzioni e DM in tempo reale
  • Un'unica busta, firmata per ogni account
  • Impostazione da Claude, ChatGPT o dalla Partner API
Inizia la prova gratuita

Nessun addebito per 3 giorni. Annulla quando vuoi.

Solo API ufficialiMCP per Claude e ChatGPTOgni connessione monitorata 24/73 giorni gratis
1 attempt

Quante volte easyCoexistence invia ogni evento social inoltrato; non ne conserva copia, quindi nulla viene reinviato in seguito.

Within 5 minutes

Quanto tempo impiega il webhook comment.update di TikTok a segnalare un commento creato, eliminato o con visibilità modificata sui video pubblici di un account di proprietà.

In comments

Dove le app su Instagram Login ricevono le @menzioni: all'interno della notifica del webhook dei commenti, non come campo proprio.

3 events

Cosa segnalano le notifiche push di YouTube per un canale: un nuovo caricamento, un nuovo titolo o una nuova descrizione.

7 days

Per quanto tempo Meta continua a ritentare un webhook WhatsApp che il tuo server non ha accettato, cosa che può produrre duplicati.

Quali eventi invia ciascun social?

Instagram, Facebook e TikTok inviano eventi a easyCoexistence, che li passa all'URL impostato per quell'account. Instagram invia i nuovi commenti, con le @menzioni che arrivano all'interno della notifica dei commenti, e i DM. Una Pagina Facebook invia l'attività del feed, che comprende i nuovi commenti, oltre ai messaggi di Messenger e alle menzioni della Pagina. TikTok invia comment.update, attivato quando un commento viene creato, eliminato o cambia visibilità.

YouTube e LinkedIn non inviano a easyCoexistence eventi di commenti o messaggi, quindi un agente legge i loro commenti su richiesta. Un numero WhatsApp segue un percorso proprio: Meta consegna i suoi messaggi direttamente al tuo server, oppure easyCoexistence li inoltra firmati quando il numero è in modalità gestita.

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

Com'è fatto un evento inoltrato?

La stessa busta JSON per ogni social, inviata con Content-Type application/json: platform, il social; account_id, l'ID che usano gli strumenti MCP e la Partner API; external_id, l'ID dell'account sul social; e entry, l'evento originale del social così come è arrivato. Per Instagram e Facebook, entry è la voce del webhook di Meta, con changes per commenti e menzioni e messaging per i DM. Per TikTok contiene l'evento comment.update, con comment_id, video_id e parent_comment_id come stringhe, così gli ID a 64 bit non vengono arrotondati. Un messaggio di Messenger arriva così:

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

Come verifichi X-EC-Signature?

Con il segreto di firma restituito quando imposti la destinazione, unico per quell'account e mostrato una sola volta. L'intestazione è t=<unix>,v1=<hex>, e v1 è un HMAC-SHA256 del timestamp, di un punto e del corpo grezzo della richiesta, con chiave quel segreto. Leggi il corpo come byte prima di analizzarlo, rifiuta un timestamp che differisce di più di 5 minuti dal tuo orologio, cerca il segreto tramite account_id dell'evento e confronta i due digest in tempo costante. Poi rispondi 2xx e metti il lavoro in coda. In PHP bastano poche righe:

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

Come attivi l'inoltro per un account?

Da un assistente o dal tuo backend. Chiedi a Claude o ChatGPT di eseguire set_social_webhook_destination con l'account e il tuo URL HTTPS, oppure chiama PUT /api/v1/channels/:id/webhook sulla Partner API con la tua chiave ec_live_ e un corpo che contenga url. Entrambi restituiscono una sola volta il signing_secret dell'account, quindi conservalo subito associandolo a account_id. Richiamare uno dei due comandi genera un nuovo segreto, e un url null disattiva l'inoltro.

L'URL deve essere HTTPS su un host pubblico: un indirizzo privato viene rifiutato al momento dell'impostazione e di nuovo alla consegna. Un solo endpoint può servire molti account, dato che ogni evento indica il proprio account_id. Per un numero WhatsApp, set_webhook_destination instrada le consegne di Meta verso di te, mentre set_inbound_mode con un forward_url le inoltra firmate.

Cosa succede se il tuo endpoint è lento o non risponde?

L'evento non viene reinviato. easyCoexistence fa un solo tentativo, attende fino a 8 secondi una risposta, non segue i reindirizzamenti e non conserva copie, perché ritentare significherebbe memorizzare commenti e messaggi dei tuoi clienti. Rispondi 2xx appena la firma è verificata, svolgi il lavoro lento da una coda e deduplica sugli ID del social stesso, come l'ID di un commento o il mid di un messaggio, nel caso un evento arrivi due volte.

WhatsApp è diverso. In modalità diretta, Meta ritenta per fino a 7 giorni una consegna che il tuo server non ha accettato. In modalità gestita, easyCoexistence mette in coda i messaggi per il tuo URL di inoltro e ritenta con backoff. Gli eventi di stato Partner, come una connessione che cade, vengono ritentati per circa 33 ore.

Come arrivano i commenti di YouTube e LinkedIn a un agente?

Leggendoli secondo una pianificazione. Le notifiche push di YouTube segnalano un nuovo caricamento, un nuovo titolo o una nuova descrizione, non commenti, e easyCoexistence non riceve eventi di commenti da LinkedIn, quindi nessuno dei due inoltra nulla. Un agente controlla invece: list_youtube_comments restituisce i thread di un video o dell'intero canale, comprese le risposte in attesa di revisione, e list_linkedin_comments restituisce i commenti di un post o le risposte sotto uno di essi. In n8n, Make o Zapier un trigger a pianificazione avvia il controllo; nel tuo codice, un job cron recupera le credenziali del canale e chiama direttamente l'endpoint commentThreads di YouTube o l'endpoint comments di LinkedIn.

Come configurarlo

  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.

Errori comuni

  • Verificare l'HMAC sul JSON già analizzato. La firma copre il corpo grezzo byte per byte, e riserializzare l'oggetto analizzato cambia quei byte, quindi verifica prima di analizzare.
  • Usare un solo segreto per tutti gli account. Ogni account firma con il proprio segreto, quindi cercalo tramite account_id dell'evento prima di confrontare v1.
  • Ripetere l'impostazione della destinazione senza aggiornare il tuo endpoint. Ogni chiamata genera un nuovo segreto e il vecchio smette subito di firmare, quindi salva subito il nuovo.
  • Indicare un URL che reindirizza. Gli inoltri non seguono i reindirizzamenti, quindi uno spostamento verso un nuovo percorso o host fa perdere l'evento; imposta l'indirizzo finale.
Farlo con EasyCoexistence

easyCoexistence invia al tuo endpoint i commenti, le menzioni e i DM di Instagram e Facebook, e i commenti di TikTok, in tempo reale, firmati per account, e instrada i messaggi WhatsApp verso il tuo server, così i tuoi agenti AI ricevono i messaggi dei clienti da ogni social tramite le API ufficiali di ciascuna piattaforma, con ogni connessione monitorata 24/7. Da US$ 9 a US$ 0,75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni, e i primi 3 giorni gratuiti.

Domande frequenti

In che modo i messaggi di un numero WhatsApp arrivano al mio endpoint?

In due modi. set_webhook_destination fa consegnare i messaggi da Meta direttamente al tuo server, mentre set_inbound_mode con un forward_url fa inoltrare da easyCoexistence i messaggi firmati con X-EC-Signature, con nuovi tentativi a backoff.

Lo stesso evento può arrivare due volte?

Sì, quindi deduplica sugli ID del social stesso, come l'ID di un commento o il mid di un messaggio. Anche i tentativi di Meta per una consegna WhatsApp che il tuo server non ha accettato, fino a 7 giorni, possono generare duplicati.

Un solo endpoint può ricevere eventi da più account?

Sì. Ogni evento riporta platform e account_id, quindi un solo URL può servire molti account, purché verifichi ogni firma con il segreto di quell'account.

Quanto costa easyCoexistence per i webhook dei social media?

Da US$ 9 a US$ 0,75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni, uguale su ogni social. Inoltro, server MCP e Partner API sono inclusi, con i primi 3 giorni gratuiti.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il