Webhook media sosial: komen, sebutan dan mesej ke satu endpoint
easyCoexistence menghantar peristiwa media sosial ke endpoint HTTPS anda sendiri sebaik ia berlaku: komen, sebutan dan DM daripada Instagram dan Facebook, serta komen daripada TikTok. Setiap peristiwa tiba dalam satu sampul, dengan peristiwa rangkaian di dalamnya tidak diubah, ditandatangani bagi setiap akaun dengan X-EC-Signature. Hidupkan bagi setiap akaun dengan set_social_webhook_destination daripada Claude atau ChatGPT, atau dengan Partner API. Mesej nombor WhatsApp juga sampai ke pelayan anda.
- Komen, sebutan dan DM sebaik berlaku
- Satu sampul, ditandatangani bagi setiap akaun
- Ditetapkan daripada Claude, ChatGPT atau Partner API
Tiada caj selama 3 hari. Batalkan pada bila-bila masa.
Berapa kali easyCoexistence menghantar setiap peristiwa media sosial yang dimajukan; ia tidak menyimpan salinan, jadi tiada penghantaran semula kemudian.
Selepas berapa lama webhook comment.update TikTok melaporkan komen yang dicipta, dipadam atau bertukar keterlihatan pada video awam akaun yang dimiliki.
Di mana aplikasi pada Instagram Login menerima @sebutan: dalam pemberitahuan webhook komen, bukan sebagai medan tersendiri.
Apa yang dilaporkan oleh pemberitahuan tolak YouTube bagi saluran: muat naik baharu, tajuk baharu atau penerangan baharu.
Berapa lama Meta terus mencuba semula webhook WhatsApp yang tidak diterima pelayan anda, yang boleh menghantar pendua.
Peristiwa apa yang dihantar oleh setiap rangkaian?
Instagram, Facebook dan TikTok menolak peristiwa ke easyCoexistence, yang kemudian menghantarnya ke URL yang anda tetapkan bagi akaun tersebut. Instagram menghantar komen baharu, dengan sebutan @ tiba di dalam pemberitahuan komen, dan DM. Halaman Facebook menghantar aktiviti suapan, yang merangkumi komen baharu, serta mesej Messenger dan sebutan halaman. TikTok menghantar comment.update, yang dicetuskan apabila komen dicipta, dipadam atau bertukar keterlihatan.
YouTube dan LinkedIn tidak menghantar sebarang peristiwa komen atau mesej kepada easyCoexistence, jadi ejen membaca komen mereka atas permintaan. Nombor WhatsApp berfungsi pada laluannya sendiri: Meta menghantar mesejnya terus ke pelayan anda, atau easyCoexistence memajukannya dengan tandatangan apabila nombor berjalan dalam mod diurus.
| 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 |
Bagaimana rupa peristiwa yang dimajukan?
Sampul JSON yang sama pada setiap rangkaian, dihantar dengan Content-Type application/json: platform, iaitu rangkaian; account_id, ID yang digunakan oleh alat MCP dan Partner API; external_id, ID akaun pada rangkaian; dan entry, peristiwa rangkaian itu sendiri seperti yang tiba. Bagi Instagram dan Facebook, entry ialah entri webhook Meta, dengan changes bagi komen dan sebutan, serta messaging bagi DM. Bagi TikTok ia memuatkan peristiwa comment.update, dengan comment_id, video_id dan parent_comment_id sebagai rentetan, supaya ID 64-bit tidak dibundarkan. Mesej Messenger tiba seperti ini:
{
"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?" }
}
]
}
}Bagaimana anda mengesahkan X-EC-Signature?
Dengan rahsia penandatanganan yang dikembalikan apabila anda menetapkan destinasi, unik bagi akaun itu dan dipaparkan sekali sahaja. Header berbunyi t=<unix>,v1=<hex>, dan v1 ialah HMAC-SHA256 bagi cap masa, titik dan badan permintaan mentah, dengan kunci rahsia itu. Baca badan sebagai bait sebelum menghuraikannya, tolak cap masa yang lebih daripada 5 minit daripada jam anda, cari rahsia melalui account_id peristiwa dan bandingkan dua digest dalam masa malar. Kemudian balas 2xx dan letakkan kerja dalam barisan gilir. Dalam PHP, ini memerlukan beberapa baris sahaja:
<?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 resentBagaimana anda menghidupkan pemajuan bagi sesuatu akaun?
Daripada pembantu atau daripada bahagian belakang aplikasi anda. Minta Claude atau ChatGPT menjalankan set_social_webhook_destination dengan akaun dan URL HTTPS anda, atau panggil PUT /api/v1/channels/:id/webhook pada Partner API dengan kunci ec_live_ anda dan badan yang memuatkan url. Kedua-duanya mengembalikan signing_secret akaun sekali sahaja, jadi simpannya dengan account_id ketika itu. Memanggil mana-mana satu semula mengeluarkan rahsia baharu, dan url bernilai null akan mematikan pemajuan.
URL mesti HTTPS pada hos awam: alamat persendirian ditolak semasa anda menetapkannya dan sekali lagi semasa penghantaran. Satu endpoint boleh melayani banyak akaun, kerana setiap peristiwa menyatakan account_id-nya. Bagi nombor WhatsApp, set_webhook_destination menghalakan penghantaran Meta kepada anda, dan set_inbound_mode dengan forward_url memajukannya dengan tandatangan sebaliknya.
Apa yang berlaku apabila endpoint anda perlahan atau tidak berfungsi?
Peristiwa itu tidak dihantar semula. easyCoexistence mencuba sekali, menunggu sehingga 8 saat untuk jawapan, tidak mengikut sebarang pengalihan hala dan tidak menyimpan salinan, kerana mencuba semula bermakna menyimpan komen dan mesej pelanggan anda. Balas 2xx sebaik tandatangan disahkan, buat kerja yang perlahan daripada barisan gilir, dan buang pendua berdasarkan ID rangkaian itu sendiri, seperti ID komen atau mid mesej, sekiranya peristiwa tiba dua kali.
WhatsApp berbeza. Dalam mod terus, Meta mencuba semula penghantaran yang tidak diterima pelayan anda sehingga 7 hari. Dalam mod diurus, easyCoexistence meletakkan mesej dalam barisan gilir untuk URL pemajuan anda dan mencuba semula dengan jeda berperingkat. Peristiwa status Partner, seperti sambungan yang terputus, dicuba semula selama kira-kira 33 jam.
Bagaimana komen YouTube dan LinkedIn sampai kepada ejen?
Dengan membacanya mengikut jadual. Pemberitahuan tolak YouTube melaporkan muat naik baharu, tajuk baharu atau penerangan baharu, bukan komen, dan easyCoexistence tidak menerima peristiwa komen daripada LinkedIn, jadi kedua-duanya tidak memajukan apa-apa. Ejen menyemak sebaliknya: list_youtube_comments mengembalikan benang video atau keseluruhan saluran, termasuk yang ditahan untuk semakan, dan list_linkedin_comments mengembalikan komen bagi satu siaran atau balasan di bawah satu komen. Dalam n8n, Make atau Zapier, pencetus jadual memulakan semakan; dalam kod anda sendiri, tugas cron mengambil bukti kelayakan saluran dan memanggil endpoint commentThreads YouTube atau endpoint comments LinkedIn secara terus.
Cara menetapkannya
- 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.
Kesilapan biasa
- Menyemak HMAC ke atas JSON yang telah dihuraikan. Tandatangan merangkumi badan mentah bait demi bait, dan menyerialkan semula objek yang dihuraikan mengubah bait tersebut, jadi sahkan sebelum menghurai.
- Menggunakan satu rahsia untuk setiap akaun. Setiap akaun menandatangani dengan rahsianya sendiri, jadi cari melalui account_id peristiwa sebelum membandingkan v1.
- Menetapkan destinasi semula tanpa mengemas kini endpoint anda. Setiap panggilan mengeluarkan rahsia baharu dan yang lama berhenti menandatangani serta-merta, jadi simpan yang baharu segera.
- Memberi URL yang mengubah hala. Pemajuan tidak mengikut sebarang pengalihan hala, jadi pemindahan ke laluan atau hos baharu akan kehilangan peristiwa; tetapkan alamat akhir.
easyCoexistence menghantar komen, sebutan dan DM Instagram dan Facebook, serta komen TikTok, ke endpoint anda sebaik berlaku, ditandatangani bagi setiap akaun, dan menghalakan mesej WhatsApp ke pelayan anda, supaya ejen AI anda mendengar daripada pelanggan melalui API rasmi setiap rangkaian, dengan setiap sambungan dipantau 24/7. US$ 9 to US$ 0.75 setiap sambungan sebulan, berkurang apabila anda menambah sambungan, dengan 3 hari percubaan percuma.
Soalan lazim
Bagaimana mesej nombor WhatsApp sampai ke endpoint saya?
Dengan salah satu daripada dua cara. set_webhook_destination membolehkan Meta menghantarnya terus ke pelayan anda, manakala set_inbound_mode dengan forward_url membolehkan easyCoexistence memajukannya dengan tandatangan X-EC-Signature, dan mencuba semula dengan jeda berperingkat.
Bolehkah peristiwa yang sama tiba dua kali?
Boleh, jadi buang pendua berdasarkan ID rangkaian itu sendiri, seperti ID komen atau mid mesej. Percubaan semula Meta bagi penghantaran WhatsApp yang tidak diterima pelayan anda, sehingga 7 hari, juga boleh membawa pendua.
Bolehkah satu endpoint menerima peristiwa daripada beberapa akaun?
Boleh. Setiap peristiwa membawa platform dan account_id, jadi satu URL boleh melayani banyak akaun, selagi ia menyemak setiap tandatangan dengan rahsia akaun itu sendiri.
Berapa kos easyCoexistence untuk webhook media sosial?
US$ 9 to US$ 0.75 setiap sambungan sebulan, berkurang apabila anda menambah sambungan dan sama bagi setiap rangkaian. Pemajuan, pelayan MCP dan Partner API disertakan, dengan 3 hari percubaan percuma.
Teruskan membaca
Sambungkan saluran pertama anda dalam masa dua minit.
Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.
- 3 hari percuma
- Batal bila-bila masa
- API rasmi sahaja
- Dipantau 24/7
Disahkan pada