WhatsApp otomasyonlarınızı güvenceye alın: anahtarlar, webhook'lar ve imzalar
WhatsApp otomasyonunu dört noktada güvence altına alın: yalnızca AI yanıtları için kullanılan ve şifreli saklanan AI anahtarı; otomasyonun çağırdığı webhook, isteğe güvenmeden önce HMAC imzasını denetlemelidir; gelen mesajların yönlendirilmesi, döndürülebilen bir gizli anahtarla imzalanır; erişimi olan kişiler ve asistanlar da ihtiyaç duydukları kadarla sınırlı tutulur.
easyCoexistence, AI anahtarlarınızı şifreli saklar ve bir daha asla göstermez; her Webhook çağır isteğini ve yönlendirilen her mesajı, yalnızca sizin tuttuğunuz bir gizli anahtarla X-EC-Signature ile imzalar ve herkese açık HTTPS olmayan webhook adreslerini reddeder.
Kayıtlı AI anahtarları, imza gizli anahtarları ve numaranın Meta erişim token'ı durağan halde şifrelenir.
Kayıtlı bir AI anahtarından tekrar görebileceğiniz tek şey: "ile biter" ifadesi ve son dört karakteri.
Her imza gizli anahtarında rastgelelik vardır: whsec_ ön eki ve 24 rastgele bayt; her otomasyon ve her yönlendirme numarası için bir tane.
Webhook ve Yönlendirme URL'leri herkese açık HTTPS olmak zorundadır; özel ve dahili adresler kaydedilirken ve her gönderimden önce reddedilir.
İmzanın t değerinin yaşına önerilen bir sınır vardır; bu, tekrar oynatılan istekleri reddetmek içindir.
WhatsApp otomasyon kurulumunda neyi korumak gerekir?
Beş kimlik bilgisi vardır; her birinin kendi yeri ve sızarsa kendi düzeltmesi vardır. Bunlardan ikisi otomasyonların kendisine aittir: AI anahtarı ve Webhook çağır imza gizli anahtarı. Yönlendirme gizli anahtarı numaraya, erişim token'ı ve asistanınızın oturum açma bilgisi ise hesaba aittir. Hangisinin hangisi olduğunu bilmek, bir sorun çıktığında neyi yenileyeceğinizi gösterir.
AI anahtarları nasıl saklanır ve kullanılır?
Yalnızca panelden: Otomasyonlar sayfasındaki AI anahtarları düğmesi, ardından Test et ve kaydet. Anahtar önce sağlayıcının token harcamayan ücretsiz bir uç noktasıyla denetlenir; sağlayıcının reddettiği anahtar kaydedilmeden atılır. Çalışan bir anahtar AES-256-GCM ile durağan halde şifrelenir, yalnızca yapay zekâ adımlarınız ve ajanlarınız için o sağlayıcıyı çağırırken ve bir OpenAI ya da OpenRouter anahtarında sesli mesajları yazıya dökmek için çözülür ve sonradan yalnızca "1234 ile biter" olarak gösterilir. Hiçbir MCP aracı anahtarı kabul etmez ya da döndürmez; böylece asistanınızla yaptığınız bir sohbetten hiç geçmez.
Bir hesapta sağlayıcı başına tek anahtar bulunur ve yenisini kaydetmek eskisinin yerini alır. Otomasyonlar için sağlayıcıda ayrı bir anahtar oluşturun; sağlayıcı sunuyorsa harcama sınırıyla birlikte. Böylece diğer uygulamalarınızı bozmadan iptal edebilirsiniz. Sağlayıcı anahtarı bir gün reddederse, bu anahtarı kullanan otomasyonlar Duraklatıldı olarak görünür ve size bir e-posta gelir; çalışan bir anahtar kaydetmek onları kendiliğinden yeniden başlatır.
Webhook çağır isteğinin gerçek olduğunu nasıl doğrularsınız?
Başka bir şeyi okumadan önce imzayı denetleyin. Her istek X-EC-Signature başlığını taşır: t=<unix saniyesi>,v1=<"<t>.<ham gövde>" üzerinden hesaplanmış hex HMAC-SHA256>; anahtar, kaydettikten sonra düzenleyicideki adımdan kopyaladığınız o otomasyonun İmza gizli anahtarıdır. HMAC'i ham baytlar üzerinde yeniden hesaplayın, sabit süreli karşılaştırma yapın ve saatinizden 5 dakikadan fazla uzak bir t değerini reddedin. Gövde de üzerinde işlem yapmaya değer iki şey söyler. dry_run, istek Dene'den geldiğinde true olur; bu yüzden sipariş oluşturma gibi geri alınamaz her şeyi atlayın. run_id ise her çalıştırmaya özgüdür; işlediğiniz kimlikleri saklayın ve tekrar oynatılan bir isteği reddedin. 20 saniye içinde yanıt verin; {"reply": "..."} metni müşteriye olduğu gibi gönderilir, bu yüzden müşteri metnini asla denetimsiz geçirmeyin.
POST /hooks/whatsapp HTTP/1.1
Content-Type: application/json
User-Agent: easyCoexistence-automations/1
X-EC-Event: automation.step
X-EC-Signature: t=1794405732,v1=<64 hex characters>
{
"event": "automation.step",
"dry_run": false,
"automation": { "id": "a7d0c3e2-5b1f-4c8e-9a6d-2f4e8b1c7d90", "name": "Order status" },
"run_id": "e41b9f07-3c2a-4d6e-8f15-7a9c0b2d4e68",
"channel": { "type": "whatsapp", "connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
"connection": { "id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
"contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
"message": { "id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFjNFQjBDNzE4RjQ2QjI5RDkxQTNFAA==", "type": "text", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.000Z" },
"history": [
{ "direction": "in", "text": "Hi!", "at": "2026-11-11T14:01:40.120Z" },
{ "direction": "in", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.310Z" }
]
}
// Your answer, within 20 seconds (or {} to send nothing):
{ "reply": "Your order #1042 left the shop at 2:20 p.m." }Yönlendirme gizli anahtarları nasıl çalışır ve nasıl döndürülür?
"easyCoexistence üzerinden" olarak ayarlanmış bir numara, gelen mesajlarını kendi sisteminize yönlendirebilir. İlk kez bir Yönlendirme URL'si kaydettiğinizde bir gizli anahtar üretilir ve yalnızca bir kez gösterilir: "İmza gizli anahtarınız, yalnızca bir kez gösterilir. Şimdi kopyalayın:" Her yönlendirilen POST'u aynı X-EC-Signature düzeniyle imzalar. Numaranın sayfasında Yeni gizli anahtar ya da rotate_secret değeri true olarak ayarlanmış set_inbound_mode, bir yenisini üretir; bu da yine yalnızca bir kez gösterilir ve bundan sonra her şeyi imzalar, daha eski teslimatların yeniden denemeleri dahil. Ayrıca en az 24 karakterlik kendi gizli anahtarınızı da yazabilirsiniz; saklanır ve bir daha gösterilmez. Yönlendirmeyi durdurmak gizli anahtarı siler, bu yüzden daha sonra bir URL kaydetmek yeni bir anahtarla başlar.
Bir ekip üyesi ayrıldıktan sonra, bir gizli anahtar bir depoya, bir destek talebine ya da bir günlüğe düştüğünde ve barındırmayı değiştirdiğinizde döndürün. Bir Webhook çağır gizli anahtarı otomasyona aittir ve yalnızca hesap sahibi görür. Düzenleyicinin, "Sisteminiz bir URL'yi çağırır" tetikleyicisi altında Yeni gizli anahtar gösterdiği yerde bu düğme anahtarı değiştirir ve eskisi hemen çalışmaz olur; bu düğmesi olmayan bir otomasyonda otomasyonu yeniden oluşturun, alıcınızı yeni anahtara yönlendirin, sonra eski otomasyonu silin.
Otomasyonlar hangi adreslere istek gönderebilir?
Yalnızca herkese açık HTTPS adresleri. Bir Webhook çağır URL'si ya da Yönlendirme URL'si http:// ile başlarsa, localhost'a işaret ederse, özel bir ağ aralığına, .internal ya da .local adına ya da bir bulut meta veri adresine işaret ederse, kaydederken reddedilir. Ayrıca DNS çözümlemesinden sonra her istekten önce yeniden denetlenir; böylece herkese açık bir ad sonradan özel bir ağa yönlendirilemez. Yönlendirmeler takip edilmez: 301 ya da 302 adımı başarısız kılar, bu yüzden son adresi kaydedin.
Gizli anahtarları URL'nin kendisinde tutmayın. list_automations, her otomasyonun adımlarını, webhook URL'si dahil, hesabınıza bağlı her asistana döndürür; dolayısıyla sorgu dizesindeki bir token orada okunabilir. Bunun yerine kanıtı imza taşısın.
Erişimi en aza nasıl indirirsiniz?
Her kişiye ve her araca yalnızca işinin gerektirdiği erişimi verin ve artık kullanılmayanı kaldırın. Oturum açma, onaylar ve engellenen araçlarla birlikte bağlayıcı tarafı, WhatsApp'ı bir AI'ya güvenle bağlama sayfasında ele alınır; otomasyon tarafında şu alışkanlıklar en çok önem taşır:
get_api_credentials'ı yalnızca özel bir sohbette isteyin: numaranın erişim token'ı o dökümde kalır.- Token'ı üçüncü taraf bir araca vermek yerine Webhook çağır ya da Yönlendirme URL'sini tercih edin.
- Kullanımdan kaldırdığınız otomasyonları silin; bu, onların imza gizli anahtarlarını da devre dışı bırakır.
- Çalıştırma günlüklerinin müşteri mesajlarını ve yanıtlarını 30 gün tuttuğunu, Konuşmalar'ın ise sohbetleri saklama süreniz boyunca (30, 90 ya da 365 gün) tuttuğunu unutmayın; ikisi de panelden ve bağlı asistanınızdan okunabilir.
- Numara Doğrudan sisteminize ayarlıysa, geri çağırma URL'sinin yoluna uzun ve rastgele bir gizli anahtar koyun; çünkü Meta'nın imzası orada denetlenemez.
Yaygın hatalar
- Doğrulamayı, çerçevenizin yeniden serileştirdiği JSON üzerinde yapmak. Birçok ayrıştırıcı boşlukları, kaçış karakterlerini ya da anahtar sırasını değiştirir; yığınınızın ham istek baytlarını sunduğu yerlerde HMAC'i ham baytlar üzerinden hesaplayın.
- Test çağrılarında yan etkiler çalıştırmak. Dene, webhook'unuzu dry_run değeri true olarak çağırır; o anda oluşturulan bir sipariş, iade ya da CRM yazımı gerçektir.
- Zaman kazanmak için bir AI anahtarını asistanınızla yaptığınız bir sohbete yapıştırmak. Hiçbir araç bunu kabul etmez ve sohbet dökümünde kalır; AI anahtarlarını panelde kullanın.
- Yönlendirmeyi Webhook çağır gizli anahtarıyla ya da tersini yaparak doğrulamak. Bunlar ayrı gizli anahtarlardır: yönlendirmeler için numara başına bir, webhook çağrıları için otomasyon başına bir.
Numaranız Coexistence aracılığıyla Meta'nın resmi Cloud API'sinde kalır ve 7/24 izlenir. Bağlı numara başına ayda US$ 9'dan başlayıp numara eklendikçe US$ 0.75'e kadar düşer; ilk 3 gün ücretsiz deneme.
Sık sorulan sorular
easyCoexistence personeli ya da destek ekibi AI anahtarımı görebilir mi?
Anahtar kaydettikten sonra hiçbir yerde gösterilmez: ne panelde, ne MCP sonuçlarında, ne de destek asistanının okuduğu bilgilerde. Yalnızca sistem tarafından, AI yanıtı için sağlayıcınızı çağırdığı anda çözülür.
Otomasyon çalıştırma günlüklerimi kim okuyabilir?
easyCoexistence hesabınızda oturum açmış herkes, davet ettiğiniz kişiler dahil, Çalıştırmalar sekmesinde okuyabilir; hesaba bağlı herhangi bir asistan ise list_automation_runs ve get_automation_run ile okuyabilir. Günlükler müşterinin mesajını ve yanıtı içerir ve 30 gün sonra silinir.
Bir AI anahtarını güvenle nasıl kaldırırım?
Önce onu kullanan otomasyonları ve onunla çalışan her ajanı kapatın, sonra AI anahtarları altında Kaldır'ı seçin ve anahtarı sağlayıcıda iptal edin. Anahtar hâlâ kullanılırken kaldırılırsa, otomasyonlar bir sonraki AI yanıtında duraklatılır ve size bir e-posta gönderilir.
Dene, webhook'uma müşteri verisi gönderir mi?
Yalnızca yazdığınız örnek metni gönderir; dry_run değeri true ve geçmiş boş olarak. Gerçek çalıştırmalar gelen mesajı ve sohbetin en son 10 mesajına kadar olanı gönderir; bu yüzden uç noktanızı müşteri verisi işleyen bir uç nokta gibi ele alın.
Okumaya devam edin
Başlamaya hazır mısınız?
WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.
Ücretsiz denemeyi başlatınDoğrulama tarihi