अपने WhatsApp ऑटोमेशन सुरक्षित करें: कुंजियाँ, वेबहुक और हस्ताक्षर
WhatsApp ऑटोमेशन को चार बिंदुओं पर सुरक्षित करें: AI कुंजी, जो एन्क्रिप्टेड रहती है और केवल AI जवाबों के लिए इस्तेमाल होती है; वेबहुक, जिसे ऑटोमेशन कॉल करता है और जिसके अनुरोध पर भरोसा करने से पहले HMAC हस्ताक्षर जाँचना चाहिए; इनकमिंग मैसेज का फ़ॉरवर्ड, जो एक ऐसे सीक्रेट से हस्ताक्षरित है जिसे आप बदल सकते हैं; और वे लोग व असिस्टेंट जिनकी पहुँच है, जो केवल ज़रूरत भर तक सीमित रहें।
easyCoexistence आपकी AI कुंजियाँ एन्क्रिप्ट करके संग्रहीत करता है और उन्हें दोबारा कभी नहीं दिखाता।
सहेजी गई AI कुंजियों, हस्ताक्षर सीक्रेट और नंबर के Meta एक्सेस टोकन के लिए संग्रहीत अवस्था में एन्क्रिप्शन इस्तेमाल होता है।
सहेजी गई AI कुंजी का दोबारा दिखने वाला हिस्सा केवल उसके आख़िरी चार अक्षर हैं: "ending in"।
हर हस्ताक्षर सीक्रेट में यादृच्छिकता होती है: whsec_ के बाद 24 रैंडम बाइट, हर ऑटोमेशन और हर फ़ॉरवर्डिंग नंबर के लिए एक।
वेबहुक और फ़ॉरवर्ड यूआरएल सार्वजनिक HTTPS होने चाहिए; निजी और आंतरिक पते सेव करते समय और हर भेजने से पहले अस्वीकार होते हैं।
रीप्ले किए गए अनुरोधों को अस्वीकार करने के लिए हस्ताक्षर के t मान की उम्र पर एक सुझाई गई सीमा।
WhatsApp ऑटोमेशन सेटअप में किस चीज़ की सुरक्षा ज़रूरी है?
पाँच क्रेडेंशियल, हर एक की अपनी जगह और लीक होने पर अपना अलग उपाय। इनमें से दो सीधे ऑटोमेशन के हैं: AI कुंजी और Call my वेबहुक का हस्ताक्षर सीक्रेट; फ़ॉरवर्ड सीक्रेट नंबर का है; एक्सेस टोकन और आपके असिस्टेंट का लॉग इन खाते के हैं। कौन सा किसका है, यह जानने से पता चलता है कि कुछ गड़बड़ होने पर क्या बदलना है।
AI कुंजियाँ कैसे संग्रहीत और इस्तेमाल होती हैं?
केवल डैशबोर्ड से: ऑटोमेशन पेज पर AI keys बटन, फिर Test and save। कुंजी पहले प्रोवाइडर के एक मुफ़्त एंडपॉइंट से जाँची जाती है, जो कोई टोकन खर्च नहीं करता, और प्रोवाइडर जिस कुंजी को अस्वीकार करता है, वह बिना सहेजे हटा दी जाती है। काम करने वाली कुंजी AES-256-GCM से संग्रहीत अवस्था में एन्क्रिप्ट होती है, केवल आपके AI चरणों और एजेंटों के लिए उस प्रोवाइडर को कॉल करने हेतु, और OpenAI या OpenRouter कुंजी पर वॉइस मैसेज को लिखित रूप देने के लिए डिक्रिप्ट होती है, और बाद में केवल "ending in 1234" के रूप में दिखती है। कोई MCP टूल कुंजी स्वीकार या वापस नहीं करता, इसलिए वह आपके असिस्टेंट के साथ चैट से होकर नहीं गुज़रती।
खाते में प्रति प्रोवाइडर एक कुंजी होती है, और नई सहेजने पर पुरानी बदल जाती है। प्रोवाइडर पर ऑटोमेशन के लिए एक समर्पित कुंजी बनाएँ, जहाँ संभव हो खर्च की सीमा के साथ, ताकि आपके दूसरे ऐप्स बिगड़े बिना उसे रद्द किया जा सके। अगर प्रोवाइडर कभी उसे अस्वीकार करे, तो उसका उपयोग करने वाले ऑटोमेशन Paused दिखते हैं और आपको एक ईमेल मिलता है; काम करने वाली कुंजी सहेजने पर वे अपने आप फिर चल पड़ते हैं।
Call my वेबहुक अनुरोध असली है, यह कैसे जाँचें?
कुछ भी पढ़ने से पहले हस्ताक्षर जाँचें। हर अनुरोध में X-EC-Signature होता है: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">, जो उस ऑटोमेशन के Signing secret से बनाया जाता है, जिसे आप सेव के बाद एडिटर के चरण से कॉपी करते हैं। कच्चे बाइट पर HMAC दोबारा गणना करें, स्थिर समय में तुलना करें, और ऐसा t अस्वीकार करें जो आपकी घड़ी से 5 मिनट से अधिक दूर हो। बॉडी से दो बातें और मिलती हैं जिन पर कार्रवाई करनी चाहिए। dry_run तब true होता है जब अनुरोध Try it से आता है, इसलिए ऐसी कोई भी अपरिवर्तनीय कार्रवाई छोड़ दें, जैसे ऑर्डर बनाना। और run_id हर रन के लिए अलग होता है, इसलिए जिन्हें आप संभाल चुके हैं उनका रिकॉर्ड रखें और दोहराया गया अनुरोध अस्वीकार करें। 20 सेकंड के भीतर जवाब दें; {"reply": "..."} ग्राहक को जैसा लिखा है वैसा भेजा जाता है, इसलिए ग्राहक का टेक्स्ट बिना जाँचे कभी आगे न भेजें।
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." }फ़ॉरवर्ड सीक्रेट कैसे काम करते हैं, और उन्हें कैसे बदलें?
जिस नंबर पर Through easyCoexistence सेट है, वह अपने इनकमिंग मैसेज आपके अपने सिस्टम को फ़ॉरवर्ड कर सकता है। पहली बार फ़ॉरवर्ड यूआरएल सहेजने पर एक सीक्रेट बनता है और एक बार दिखाया जाता है, "Your signing secret, shown once. Copy it now:" के अंतर्गत; यह हर फ़ॉरवर्ड किए गए POST पर उसी X-EC-Signature योजना से हस्ताक्षर करता है। नंबर के पेज पर New secret, या set_inbound_mode में rotate_secret को true करके, प्रतिस्थापन बनता है, जो फिर एक बार दिखता है, और उसके बाद से हर चीज़ पर हस्ताक्षर करता है, पुराने डिलीवरी के रीट्राई समेत। आप अपना खुद का सीक्रेट भी टाइप कर सकते हैं, कम से कम 24 अक्षर का, जो सहेजा जाता है और फिर कभी नहीं दिखाया जाता। फ़ॉरवर्डिंग रोकने पर सीक्रेट हट जाता है, इसलिए बाद में यूआरएल सहेजने पर नया सीक्रेट बनता है।
जब कोई टीममेट एक्सेस छोड़े, जब कोई सीक्रेट रिपॉज़िटरी, टिकट या लॉग में पहुँच जाए, और जब आप होस्टिंग बदलें, तब रोटेट करें। Call my वेबहुक सीक्रेट ऑटोमेशन का होता है और केवल खाते का मालिक उसे देखता है। जहाँ एडिटर में New secret दिखता है, “Your system calls a URL” ट्रिगर के अंतर्गत, वह बटन उसे बदल देता है और पुराना तुरंत काम करना बंद कर देता है; जिस ऑटोमेशन में वह बटन नहीं है, उसमें ऑटोमेशन नए सिरे से बनाएँ, अपने रिसीवर को नए सीक्रेट पर ले जाएँ, फिर पुराना ऑटोमेशन हटाएँ।
ऑटोमेशन किन पतों पर कॉल कर सकते हैं?
केवल सार्वजनिक HTTPS पते। कोई Call my वेबहुक यूआरएल या फ़ॉरवर्ड यूआरएल, जो http:// से शुरू होता है, localhost की ओर इशारा करता है, निजी नेटवर्क रेंज में है, .internal या .local नाम है, या क्लाउड मेटाडेटा पता है, उसे सहेजते समय अस्वीकार कर दिया जाता है। हर अनुरोध से पहले DNS के बाद उसे फिर से जाँचा जाता है, ताकि कोई सार्वजनिक नाम बाद में किसी निजी नेटवर्क की ओर न मोड़ा जा सके। रीडायरेक्ट का पालन नहीं होता: 301 या 302 चरण को विफल कर देता है, इसलिए अंतिम पता सहेजें।
सीक्रेट को यूआरएल के भीतर न रखें। list_automations हर ऑटोमेशन के चरण, वेबहुक यूआरएल समेत, आपके खाते से जुड़े किसी भी असिस्टेंट को लौटाता है, इसलिए क्वेरी स्ट्रिंग में रखा टोकन वहाँ पढ़ा जा सकता है। प्रमाण का काम हस्ताक्षर को करने दें।
एक्सेस को न्यूनतम कैसे रखें?
हर व्यक्ति और हर टूल को केवल उतना एक्सेस दें जितना उसके काम के लिए ज़रूरी है, और जो अब उपयोग में नहीं है उसे हटाएँ। कनेक्टर वाला हिस्सा, यानी लॉग इन, पुष्टि और ब्लॉक किए गए टूल, उस पेज पर है जो WhatsApp को AI से सुरक्षित रूप से जोड़ने के बारे में है। ऑटोमेशन की तरफ़ ये आदतें सबसे ज़्यादा मायने रखती हैं:
get_api_credentialsकेवल निजी चैट में माँगें: तब नंबर का एक्सेस टोकन उस बातचीत के रिकॉर्ड में रहता है।- टोकन किसी तीसरे पक्ष के टूल को देने के बजाय Call my वेबहुक या फ़ॉरवर्ड यूआरएल को प्राथमिकता दें।
- जिन ऑटोमेशन को बंद कर दिया है, उन्हें हटाएँ; इससे उनके हस्ताक्षर सीक्रेट भी रद्द हो जाते हैं।
- याद रखें कि रन लॉग 30 दिनों तक ग्राहक के मैसेज और जवाब रखते हैं, और Conversations चैट को आपकी रिटेंशन अवधि (30, 90 या 365 दिन) तक रखती हैं, दोनों डैशबोर्ड में और आपके जुड़े असिस्टेंट के ज़रिए पढ़े जा सकते हैं।
- ऐसे नंबर पर जो Straight to your system पर सेट है, कॉलबैक यूआरएल के पथ में एक लंबा यादृच्छिक सीक्रेट रखें, क्योंकि वहाँ Meta का हस्ताक्षर जाँचा नहीं जा सकता।
आम गड़बड़ियाँ
- JSON पर हस्ताक्षर जाँचना, जिसे आपके फ़्रेमवर्क ने दोबारा सीरियलाइज़ किया हो। कई पार्सर स्पेसिंग, एस्केपिंग या कुंजियों का क्रम बदल देते हैं; जहाँ आपका स्टैक कच्चे अनुरोध बाइट दिखाता है, वहाँ HMAC उन्हीं पर गणना करें।
- टेस्ट कॉल पर साइड इफ़ेक्ट चलाना। Try it आपके वेबहुक को dry_run true के साथ कॉल करता है; उस समय बनाया गया ऑर्डर, रिफ़ंड या CRM लिखाई असली होती है।
- समय बचाने के लिए AI कुंजी को असिस्टेंट के साथ चैट में चिपकाना। कोई टूल उसे स्वीकार नहीं करता, और वह बातचीत के रिकॉर्ड में रह जाती है; AI कुंजियाँ डैशबोर्ड में इस्तेमाल करें।
- फ़ॉरवर्ड की जाँच Call my वेबहुक सीक्रेट से करना, या इसका उल्टा। ये अलग-अलग सीक्रेट हैं: फ़ॉरवर्ड के लिए हर नंबर पर एक, वेबहुक कॉल के लिए हर ऑटोमेशन पर एक।
हर Call my वेबहुक अनुरोध और हर फ़ॉरवर्ड किए गए मैसेज पर X-EC-Signature से हस्ताक्षर करता है, जिसका सीक्रेट केवल आपके पास होता है, और ऐसे वेबहुक पते अस्वीकार करता है जो सार्वजनिक HTTPS नहीं हैं। आपका नंबर Coexistence के ज़रिए Meta के आधिकारिक Cloud API पर रहता है, 24/7 निगरानी के साथ। प्रति नंबर प्रति माह US$ 9 से घटकर US$ 0.75 तक, जैसे-जैसे आप नंबर जोड़ते हैं वैसे-वैसे कम, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या easyCoexistence का स्टाफ़ या सपोर्ट मेरी AI कुंजी देख सकता है?
कुंजी सहेजने के बाद वह कहीं नहीं दिखती: न डैशबोर्ड में, न MCP परिणामों में, न उन तथ्यों में जिन्हें सपोर्ट असिस्टेंट पढ़ता है। उसे केवल सिस्टम डिक्रिप्ट करता है, ठीक उसी समय जब वह AI जवाब के लिए आपके प्रोवाइडर को कॉल करता है।
मेरे ऑटोमेशन रन लॉग कौन पढ़ सकता है?
कोई भी व्यक्ति जो आपके easyCoexistence खाते में लॉग इन है, उसमें आपके बुलाए लोग भी शामिल, Runs टैब में, और खाते से जुड़ा कोई भी असिस्टेंट, list_automation_runs और get_automation_run के ज़रिए। लॉग में ग्राहक का मैसेज और जवाब होता है, और वे 30 दिन बाद हटा दिए जाते हैं।
AI कुंजी सुरक्षित रूप से कैसे हटाएँ?
पहले उसका इस्तेमाल करने वाले ऑटोमेशन और उस पर चलने वाले किसी भी एजेंट को Switch Off करें, फिर AI keys के अंतर्गत Remove चुनें और प्रोवाइडर पर कुंजी रद्द करें। ऑटोमेशन चालू रहते हुए उसे हटाने पर वे अगले AI जवाब पर Paused हो जाते हैं और आपको एक ईमेल मिलता है।
क्या Try it मेरे वेबहुक को ग्राहक का डेटा भेजता है?
वह केवल वही सैंपल टेक्स्ट भेजता है जो आपने टाइप किया, dry_run true के साथ और खाली इतिहास के साथ। असली रन आने वाला मैसेज और चैट के हाल के मैसेज, अधिकतम 10, भेजते हैं, इसलिए अपने एंडपॉइंट को ग्राहक का डेटा संभालने वाला मानें।
पढ़ना जारी रखें
शुरू करने के लिए तैयार हैं?
WhatsApp Coexistence को महीनों में नहीं, मिनटों में कॉन्फ़िगर करें। ऐप्लिकेशन मोबाइल पर काम करता रहता है।
मुफ़्त ट्रायल शुरू करेंइस तारीख को सत्यापित