Sosyal medya webhook'ları: yorumlar, bahsetmeler ve mesajlar tek uç noktaya
easyCoexistence sosyal medya olaylarını gerçekleştikleri anda kendi HTTPS uç noktanıza iletir: Instagram ve Facebook'tan yorumlar, bahsetmeler ve DM'ler, TikTok'tan ise yorumlar. Her biri tek bir zarfta gelir; ağın olayı içindeki hâliyle değişmeden yer alır ve her hesap için X-EC-Signature ile ayrı ayrı imzalanır. Bunu, Claude veya ChatGPT'den set_social_webhook_destination ile ya da Partner API ile hesap bazında açabilirsiniz. Bir WhatsApp numarasının mesajları da sunucunuza ulaşır.
- Yorumlar, bahsetmeler ve DM'ler gerçekleştikleri anda
- Her hesap için imzalanmış tek zarf
- Claude, ChatGPT veya Partner API'den ayarlanır
3 gün boyunca hiçbir ücret alınmaz. İstediğiniz zaman iptal edin.
easyCoexistence'ın iletilen her sosyal olayı kaç kez gönderdiği; hiçbir kopya tutmadığı için sonradan yeniden gönderme yapılmaz.
TikTok'un comment.update webhook'unun, sahip olunan bir hesabın herkese açık videolarındaki bir yorumun oluşturulduğunu, silindiğini veya görünürlüğünün değiştiğini ne kadar hızlı bildirdiği.
Instagram Login uygulamalarının @bahsetmeleri nerede aldığı: kendi alanları olarak değil, yorum webhook bildiriminin içinde.
YouTube'un push bildirimlerinin bir kanal için bildirdikleri: yeni bir yükleme, yeni bir başlık veya yeni bir açıklama.
Meta'nın, sunucunuzun kabul etmediği bir WhatsApp webhook'unu ne kadar süre yeniden denediği; bu da yinelenen teslimatlara yol açabilir.
Her ağ hangi olayları gönderir?
Instagram, Facebook ve TikTok olayları easyCoexistence'a iletir; easyCoexistence da her birini o hesap için ayarladığınız URL'ye aktarır. Instagram yeni yorumları gönderir; @bahsetmeler yorum bildirimi içinde gelir, ayrıca DM'leri de gönderir. Bir Facebook Sayfası, yeni yorumları da kapsayan akış etkinliğini, Messenger mesajlarını ve Sayfanın bahsetmelerini gönderir. TikTok, bir yorum oluşturulduğunda, silindiğinde veya görünürlüğü değiştiğinde tetiklenen comment.update olayını gönderir.
YouTube ve LinkedIn, easyCoexistence'a hiçbir yorum veya mesaj olayı göndermez; bu nedenle bir yapay zekâ ajanı onların yorumlarını isteği üzerine okur. Bir WhatsApp numarası kendi yolunda çalışır: Meta mesajlarını doğrudan sunucunuza teslim eder ya da numara yönetilen modda çalıştığında easyCoexistence bunları imzalayarak iletir.
| 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 |
Yönlendirilmiş bir olay nasıl görünür?
Her ağda aynı JSON zarfı, Content-Type application/json başlığıyla gönderilir: platform, ağın adı; account_id, MCP araçlarının ve Partner API'nin kullandığı kimlik; external_id, hesabın ağdaki kimliği; ve entry, ağın geldiği hâliyle kendi olayı. Instagram ve Facebook için entry, Meta'nın webhook girişidir; yorumlar ve bahsetmeler için changes, DM'ler için messaging içerir. TikTok için comment_id, video_id ve parent_comment_id dizge olarak yer alan comment.update olayını taşır; böylece 64 bit kimlikler yuvarlanmaz. Bir Messenger mesajı şöyle gelir:
{
"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 nasıl doğrulanır?
Hedefi ayarladığınızda döndürülen imzalama sırrıyla; bu sır hesaba özeldir ve yalnızca bir kez gösterilir. Başlık t=<unix>,v1=<hex> biçimindedir; v1, zaman damgası, bir nokta ve ham istek gövdesinin HMAC-SHA256 değeridir ve bu sırla anahtarlanmıştır. Gövdeyi ayrıştırmadan önce bayt olarak okuyun, saatinizden 5 dakikadan fazla uzaklaşan zaman damgasını reddedin, sırrı olayın account_id alanına göre bulun ve iki özeti sabit zamanlı karşılaştırmayla kıyaslayın. Ardından 2xx ile yanıt verin ve işi bir kuyruğa alın. PHP'de bu birkaç satır tutar:
<?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 resentBir hesap için iletimi nasıl açarsınız?
Bir asistandan ya da kendi arka ucunuzdan. Claude veya ChatGPT'den hesabı ve HTTPS URL'nizi vererek set_social_webhook_destination çalıştırmasını isteyin ya da Partner API'de ec_live_ anahtarınız ve url alanı içeren bir gövdeyle PUT /api/v1/channels/:id/webhook çağrısı yapın. İkisi de hesabın signing_secret değerini yalnızca bir kez döndürür; bu nedenle o anda account_id alanıyla eşleşecek şekilde saklayın. Bunları yeniden çağırmak yeni bir sır üretir; url değeri null olursa iletim kapanır.
URL, herkese açık bir sunucuda HTTPS olmalıdır: özel bir adres, ayarlanırken ve teslim anında reddedilir. Her olay account_id alanını belirttiği için tek bir uç nokta birçok hesaba hizmet verebilir. Bir WhatsApp numarası için set_webhook_destination, Meta'nın teslimatlarını size yönlendirir; set_inbound_mode ile forward_url vermek ise bunları imzalanmış olarak iletir.
Uç noktanız yavaş ya da kapalıysa ne olur?
Olay bir daha gönderilmez. easyCoexistence tek bir deneme yapar, yanıt için en fazla 8 saniye bekler, hiçbir yönlendirmeyi izlemez ve kopya tutmaz; çünkü yeniden denemek, müşterilerinizin yorum ve mesajlarını saklamak anlamına gelir. İmza doğrulanır doğrulanmaz 2xx ile yanıt verin, yavaş işleri bir kuyruktan yapın ve bir olay iki kez gelirse diye ağın kendi kimliklerine göre tekilleştirin; örneğin bir yorum kimliği ya da bir mesaj mid değeri.
WhatsApp farklıdır. Doğrudan modda Meta, sunucunuzun kabul etmediği bir teslimatı 7 güne kadar yeniden dener. Yönetilen modda easyCoexistence mesajları iletme URL'si için kuyruğa alır ve artan aralıklarla yeniden dener. Partner durum olayları, örneğin bir bağlantının düşmesi, yaklaşık 33 saat boyunca yeniden denenir.
YouTube ve LinkedIn yorumları bir ajana nasıl ulaşır?
Bunu zamanlanmış okuyarak yaparlar. YouTube'un push bildirimleri yorumları değil, yeni bir yüklemeyi, yeni bir başlığı veya yeni bir açıklamayı bildirir; LinkedIn'den de easyCoexistence hiçbir yorum olayı almaz, bu yüzden ikisi de bir şey iletmez. Bunun yerine ajan kontrol eder: list_youtube_comments bir videonun ya da tüm kanalın yorum dizilerini döndürür, onay bekleyenler de dahil. list_linkedin_comments ise bir gönderinin yorumlarını ya da birinin altındaki yanıtları döndürür. n8n, Make ya da Zapier'de bir zamanlama tetikleyicisi kontrolü başlatır; kendi kodunuzda ise bir cron işi kanalın kimlik bilgilerini alır ve doğrudan YouTube'un commentThreads ya da LinkedIn'in comments uç noktasını çağırır.
Nasıl kurulur
- 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.
Yaygın hatalar
- Ayrıştırılmış JSON üzerinden HMAC kontrolü yapmak. İmza, ham gövdeyi bayt bayt kapsar; ayrıştırılmış nesneyi yeniden serileştirmek bu baytları değiştirir, bu nedenle ayrıştırmadan önce doğrulayın.
- Her hesap için tek sır kullanmak. Her hesap kendi sırrıyla imzalar; bu nedenle v1 ile karşılaştırmadan önce sırrı olayın account_id alanına göre bulun.
- Uç noktanızı güncellemeden hedefi yeniden ayarlamak. Her çağrı yeni bir sır üretir ve eski sır hemen imzalamayı bırakır; bu nedenle yeni sırrı hemen saklayın.
- Yönlendirme yapan bir URL vermek. İletimler yönlendirmeleri izlemez; bu yüzden yeni bir yola ya da sunucuya geçiş olayı kaybettirir. Son adresi girin.
easyCoexistence, Instagram ve Facebook yorumlarını, bahsetmelerini ve DM'lerini ile TikTok yorumlarını gerçekleştiği anda uç noktanıza gönderir, hesap başına imzalar ve WhatsApp mesajlarını sunucunuza yönlendirir; böylece yapay zekâ ajanlarınız müşterilerden her ağın resmi API'si üzerinden haber alır ve her bağlantı 7/24 izlenir. Bağlantı başına ayda US$ 9'dan US$ 0.75'e kadar, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz deneme ile.
Sık sorulan sorular
Bir WhatsApp numarasının mesajları uç noktama nasıl ulaşır?
İki yoldan biriyle. set_webhook_destination, Meta'nın mesajlarını doğrudan sunucunuza teslim etmesini sağlar; set_inbound_mode ile forward_url vermek ise easyCoexistence'ın bunları X-EC-Signature ile imzalayıp artan aralıklarla yeniden deneyerek iletmesini sağlar.
Aynı olay iki kez gelebilir mi?
Evet, bu yüzden ağın kendi kimliklerine göre tekilleştirin; örneğin bir yorum kimliği ya da bir mesaj mid değeri. Sunucunuzun kabul etmediği bir WhatsApp teslimatına ilişkin Meta'nın 7 güne kadar süren yeniden denemeleri de yinelenmelere yol açabilir.
Tek bir uç nokta birden fazla hesabın olaylarını alabilir mi?
Evet. Her olay platform ve account_id taşır; bu nedenle tek bir URL birçok hesaba hizmet verebilir, yeter ki her imzayı o hesabın kendi sırrıyla doğrulasın.
easyCoexistence sosyal medya webhook'ları için ne kadar tutar?
Bağlantı başına ayda US$ 9'dan US$ 0.75'e kadar, bağlantı ekledikçe düşer; her ağda aynıdır. İletim, MCP sunucusu ve Partner API dahildir; ilk 3 gün ücretsiz deneme sunulur.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi