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
Nessun addebito per 3 giorni. Annulla quando vuoi.
Quante volte easyCoexistence invia ogni evento social inoltrato; non ne conserva copia, quindi nulla viene reinviato in seguito.
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à.
Dove le app su Instagram Login ricevono le @menzioni: all'interno della notifica del webhook dei commenti, non come campo proprio.
Cosa segnalano le notifiche push di YouTube per un canale: un nuovo caricamento, un nuovo titolo o una nuova descrizione.
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 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 |
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ì:
{
"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
// 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 resentCome 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
- 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.
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.
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