Webhook media sosial: komentar, mention, dan pesan ke satu endpoint
easyCoexistence meneruskan event media sosial ke endpoint HTTPS Anda sendiri saat terjadi: komentar, mention, dan DM dari Instagram dan Facebook, serta komentar dari TikTok. Setiap event tiba dalam satu amplop, dengan event dari jaringan tetap utuh di dalamnya, dan ditandatangani per akun dengan X-EC-Signature. Aktifkan per akun dengan set_social_webhook_destination dari Claude atau ChatGPT, atau dengan Partner API. Pesan dari nomor WhatsApp juga sampai ke server Anda.
- Komentar, mention, dan DM saat terjadi
- Satu amplop, ditandatangani untuk setiap akun
- Diatur dari Claude, ChatGPT, atau Partner API
Tidak ada biaya selama 3 hari. Batalkan kapan saja.
Berapa kali easyCoexistence mengirim setiap event media sosial yang diteruskan; ia tidak menyimpan salinan, sehingga tidak ada pengiriman ulang nanti.
Seberapa cepat webhook comment.update TikTok melaporkan komentar yang dibuat, dihapus, atau berubah visibilitasnya pada video publik akun yang dimiliki.
Di mana aplikasi di Instagram Login menerima @mention: di dalam notifikasi webhook komentar, bukan sebagai field tersendiri.
Apa yang dilaporkan notifikasi push YouTube untuk sebuah saluran: unggahan baru, judul baru, atau deskripsi baru.
Berapa lama Meta terus mencoba kembali webhook WhatsApp yang tidak diterima server Anda, yang bisa menghasilkan duplikat.
Event apa yang dikirim setiap jaringan?
Instagram, Facebook, dan TikTok mendorong event ke easyCoexistence, yang meneruskan setiap event ke URL yang Anda atur untuk akun tersebut. Instagram mengirim komentar baru, dengan @mention tiba di dalam notifikasi komentar, dan DM. Halaman Facebook mengirim aktivitas feed, yang mencakup komentar baru, serta pesan Messenger dan mention terhadap Halaman tersebut. TikTok mengirim comment.update, yang dipicu saat komentar dibuat, dihapus, atau berubah visibilitasnya.
YouTube dan LinkedIn tidak mengirim event komentar atau pesan ke easyCoexistence, sehingga agen membaca komentar mereka atas permintaan. Nomor WhatsApp bekerja lewat jalurnya sendiri: Meta mengirim pesannya langsung ke server Anda, atau easyCoexistence meneruskannya secara bertanda tangan ketika nomor berjalan dalam mode terkelola.
| 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 |
Seperti apa bentuk event yang diteruskan?
Amplop JSON yang sama di setiap jaringan, dikirim dengan Content-Type application/json: platform, yaitu jaringannya; account_id, ID yang digunakan alat MCP dan Partner API; external_id, ID akun di jaringan tersebut; dan entry, event asli dari jaringan sebagaimana diterimanya. Untuk Instagram dan Facebook, entry adalah entry webhook Meta, dengan changes untuk komentar dan mention serta messaging untuk DM. Untuk TikTok, isinya event comment.update, dengan comment_id, video_id, dan parent_comment_id sebagai string, sehingga ID 64-bit tidak dibulatkan. Pesan 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 cara memverifikasi X-EC-Signature?
Dengan signing secret yang dikembalikan saat Anda mengatur tujuan, unik untuk akun tersebut dan hanya ditampilkan sekali. Header berbunyi t=<unix>,v1=<hex>, dan v1 adalah HMAC-SHA256 dari timestamp, titik, lalu isi permintaan mentah, dengan signing secret sebagai kuncinya. Baca isi sebagai byte sebelum mengurainya, tolak timestamp yang berselisih lebih dari 5 menit dari jam Anda, cari secret berdasarkan account_id event, lalu bandingkan kedua digest dalam waktu konstan. Setelah itu balas 2xx dan masukkan pekerjaannya ke antrean. Dalam PHP, caranya hanya beberapa baris:
<?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 cara mengaktifkan penerusan untuk sebuah akun?
Dari asisten atau dari backend Anda. Minta Claude atau ChatGPT menjalankan set_social_webhook_destination dengan akun dan URL HTTPS Anda, atau panggil PUT /api/v1/channels/:id/webhook pada Partner API dengan kunci ec_live_ Anda dan isi permintaan yang berisi url. Keduanya mengembalikan signing_secret akun satu kali, jadi simpan terhadap account_id saat itu juga. Memanggil salah satunya lagi akan menerbitkan signing secret baru, dan url bernilai null menonaktifkan penerusan.
URL harus HTTPS di host publik: alamat privat ditolak saat Anda mengaturnya dan sekali lagi saat pengiriman. Satu endpoint bisa melayani banyak akun, karena setiap event menyebut account_id-nya. Untuk nomor WhatsApp, set_webhook_destination mengarahkan pengiriman Meta ke Anda, dan set_inbound_mode dengan forward_url meneruskannya secara bertanda tangan.
Apa yang terjadi saat endpoint Anda lambat atau mati?
Event tidak dikirim ulang. easyCoexistence melakukan satu percobaan, menunggu jawaban hingga 8 detik, tidak mengikuti redirect, dan tidak menyimpan salinan, karena mencoba kembali berarti menyimpan komentar dan pesan pelanggan Anda. Balas 2xx segera setelah tanda tangan terverifikasi, kerjakan pekerjaan lambat dari antrean, dan deduplikasi berdasarkan ID milik jaringan, seperti ID komentar atau mid pesan, untuk berjaga-jaga jika event tiba dua kali.
WhatsApp berbeda. Dalam mode langsung, Meta mencoba kembali pengiriman yang tidak diterima server Anda hingga 7 hari. Dalam mode terkelola, easyCoexistence mengantrekan pesan untuk forward URL Anda dan mencoba kembali dengan backoff. Event status Partner, seperti koneksi yang terputus, dicoba kembali selama sekitar 33 jam.
Bagaimana komentar YouTube dan LinkedIn sampai ke agen?
Dengan membacanya sesuai jadwal. Notifikasi push YouTube melaporkan unggahan baru, judul baru, atau deskripsi baru, bukan komentar, dan easyCoexistence tidak menerima event komentar dari LinkedIn, sehingga keduanya tidak meneruskan apa pun. Agen yang mengecek sebagai gantinya: list_youtube_comments mengembalikan thread video, atau seluruh thread saluran, termasuk yang ditahan untuk ditinjau, dan list_linkedin_comments mengembalikan komentar sebuah postingan atau balasan di bawahnya. Di n8n, Make, atau Zapier, pemicu jadwal memulai pengecekan; di kode Anda sendiri, cron job mengambil kredensial saluran dan memanggil endpoint commentThreads YouTube atau endpoint comments LinkedIn secara langsung.
Cara mengonfigurasi
- 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.
Kesalahan umum
- Memeriksa HMAC pada JSON yang sudah diurai. Tanda tangan mencakup isi mentah byte demi byte, dan membuat ulang serialisasi objek yang sudah diurai mengubah byte tersebut, jadi verifikasi sebelum mengurai.
- Memakai satu secret untuk semua akun. Setiap akun menandatangani dengan signing secret-nya sendiri, jadi cari berdasarkan account_id event sebelum membandingkan v1.
- Mengatur tujuan lagi tanpa memperbarui endpoint Anda. Setiap pemanggilan menerbitkan signing secret baru dan yang lama langsung berhenti menandatangani, jadi simpan yang baru segera.
- Memberi URL yang melakukan redirect. Penerusan tidak mengikuti redirect, sehingga pindah ke path atau host baru kehilangan event; atur alamat akhirnya.
easyCoexistence mengirim komentar, mention, dan DM Instagram dan Facebook, serta komentar TikTok, ke endpoint Anda saat terjadi, ditandatangani per akun, dan meneruskan pesan WhatsApp ke server Anda, sehingga agen AI Anda mendengar dari pelanggan melalui API resmi setiap jaringan, dengan setiap koneksi dipantau 24/7. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Bagaimana pesan dari nomor WhatsApp sampai ke endpoint saya?
Dengan dua cara. set_webhook_destination membuat Meta mengirimkannya langsung ke server Anda, sementara set_inbound_mode dengan forward_url membuat easyCoexistence meneruskannya secara bertanda tangan dengan X-EC-Signature, dan mencoba kembali dengan backoff.
Bisakah event yang sama tiba dua kali?
Bisa, jadi deduplikasi berdasarkan ID milik jaringan, seperti ID komentar atau mid pesan. Percobaan ulang Meta untuk pengiriman WhatsApp yang tidak diterima server Anda, hingga 7 hari, juga bisa menghasilkan duplikat.
Bisakah satu endpoint menerima event dari beberapa akun?
Bisa. Setiap event membawa platform dan account_id, jadi satu URL dapat melayani banyak akun, selama ia memeriksa setiap tanda tangan dengan signing secret milik akun tersebut.
Berapa biaya easyCoexistence untuk webhook media sosial?
US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi dan sama di setiap jaringan. Penerusan, server MCP, dan Partner API termasuk, dengan 3 hari pertama gratis.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada