WhatsApp ऑटोमेशन संदर्भ: ट्रिगर, चरण, वेरिएबल और सीमाएँ
easyCoexistence पर WhatsApp नंबर के ऑटोमेशन आने वाले मैसेज, टैग पाने वाले कॉन्टैक्ट, या आपके सिस्टम की कॉल से शुरू होते हैं। मैसेज के चार मैच हैं: Every message, Has keyword, First message और After hours। इसके बाद चरण आते हैं, एक लाइन में 30 तक और कुल 60, ब्रांच, सवालों और AI एजेंट के साथ। एक मैसेज पर अधिकतम एक ही ऑटोमेशन चलता है, और कीवर्ड नियम पहले देखे जाते हैं।
एक लाइन में चरण, कुल 60, ब्रांच 4 स्तर तक नेस्टेड; Stop और Go back to a step केवल लाइन का अंत कर सकते हैं।
प्रति ऑटोमेशन हर कीवर्ड 100 अक्षर तक का हो सकता है; कोई एक भी काफ़ी है, और बड़े-छोटे अक्षर मायने नहीं रखते।
Reply with AI चरण के निर्देशों में अनुमत अक्षर, और इसके जवाब 50 से 2,000 टोकन तक सीमित हैं।
सबसे लंबा अकेला Wait चरण 23 घंटे का है, ताकि अगला टेक्स्ट चरण अब भी Meta की 24 घंटे की विंडो के भीतर पड़े।
Call my वेबहुक के विफल होने से पहले आपके वेबहुक को जवाब देने का समय; जवाब में reply फ़ील्ड ग्राहक को भेजा जाता है।
रन रिटेंशन, हर शुरुआती मैसेज और जवाब के साथ; मैसेज टेक्स्ट आपके चुने गए रिटेंशन के बाद हट जाता है (30, 90 या 365 दिन, डिफ़ॉल्ट 90)।
कौन-से ट्रिगर और मैच WhatsApp ऑटोमेशन में इस्तेमाल हो सकते हैं?
मुख्य ट्रिगर है, “A message arrives” (message_received), जो तब चलता है जब कोई ग्राहक नंबर पर लिखता है: टेक्स्ट, फ़ोटो, वीडियो, दस्तावेज़, ऑडियो, स्टिकर, लोकेशन, कॉन्टैक्ट कार्ड, बटन और लिस्ट के जवाब, और ऑर्डर। वॉइस नोट आपकी OpenAI या OpenRouter कुंजी पर लिखित रूप में बदला जाता है और "[voice message]" के बाद शब्दों के साथ सेव होता है, जिससे कीवर्ड मेल खा सकता है; ऐसी कुंजी के बिना वह "[voice message]" ही रहता है। रिएक्शन, स्टेटस और सिस्टम सूचनाएँ कभी रन शुरू नहीं करते, और Coexistence नंबर पर ग्रुप चैट एपीआई तक नहीं पहुँचतीं। दो और ट्रिगर किसी मैसेज से शुरू नहीं होते। “A contact gets a tag” (tag_added) हर बार तब चलता है जब नंबर पर पहुँचा जा सकने वाले किसी संपर्क को आपका बताया गया टैग मिलता है, चाहे फ़्लो से, किसी AI एजेंट से, आपके Conversations में किए बदलाव से या update_contact से। “Your system calls a URL” (webhook_received) तब चलता है जब आपका अपना सिस्टम फ़ोन नंबर के साथ JSON ऑटोमेशन के यूआरएल पर POST करता है, ऑटोमेशन के सीक्रेट को Bearer टोकन के रूप में देकर, किसी नए ऑर्डर या बुकिंग के लिए; 20 KB तक की बॉडी {{vars.webhook.*}} के रूप में उपलब्ध रहती है। दोनों में {{message}} खाली रहता है, और जिस व्यक्ति ने पिछले 24 घंटों में नहीं लिखा, उसे केवल send_template मिल सकता है। कोई शेड्यूल ट्रिगर नहीं है। मैसेज ट्रिगर पर, After hours में “Open on” के तहत चुने गए दिन, From और To के बीच खुले माने जाते हैं, IANA टाइमज़ोन में, जैसे America/Sao_Paulo; यदि To, From से पहले हो तो यह रात की शिफ़्ट है (22:00 से 06:00), और जो दिन चुना नहीं गया वह पूरे दिन बंद माना जाता है। एपीआई में hours के लिए timezone, days (1 = सोमवार से 7 = रविवार, वे दिन जब आप खुले हैं), और start व end हैं। First message तब चलता है जब easyCoexistence चैट के लिए रिकॉर्ड शुरू करता है: नंबर पर ऑटोमेशन चालू होने के बाद ग्राहक का पहला मैसेज, पुराने ग्राहक भी शामिल, या 30 निष्क्रिय दिनों के बाद का पहला मैसेज। जिस चैट को आपने फ़ोन से खोला, वह पहले ही देखी हुई मानी जाती है।
कीवर्ड मोड कैसे मैच करते हैं?
“Where the word has to be” के तहत, Contains (“Anywhere in the message”) डिफ़ॉल्ट है, Starts with, “At the start” है और Is exactly, “The whole message” है; एपीआई में keywordMode है contains, starts_with या exact। मिलान मैसेज के आगे-पीछे की खाली जगह हटा देता है और बड़े-छोटे अक्षरों को अनदेखा करता है, लेकिन एक्सेंट और विराम चिह्नों को अनदेखा नहीं करता, और Contains लंबे शब्दों के भीतर भी मैच करता है। Keywords के नीचे “Test it” बॉक्स, आप जो भी नमूना मैसेज टाइप करें, उसके लिए कीवर्ड के साथ “Runs: it matches” या “Does not run: no keyword matches” लिखकर जवाब देता है।
| Matches | Does not match | |
|---|---|---|
| Contains "price" | What is the price? · PRICES please | How much is it? |
| Contains "oi" | Oi! · Boa noite (inside noite) | Olá |
| Starts with "menu" | Menu please | Can I see the menu? |
| Is exactly "menu" | Menu · menu with spaces around it | menu? · the menu |
| Contains "preço" | Qual o preço? | Qual o preco? |
हर चरण क्या करता है, और उसे कौन-से फ़ील्ड चाहिए?
चरण ऊपर से नीचे क्रम में चलते हैं, एक लाइन में अधिकतम 30 और एक ऑटोमेशन में 60, ब्रांच समेत, और कम से कम एक चरण Wait, Stop, Split into paths, AI picks the path और Go back to a step के अलावा कुछ करना चाहिए। ब्रांच वाला चरण हर पाथ के लिए चरणों की एक पंक्ति और एक Otherwise पंक्ति रखता है, और ब्रांच 4 स्तर तक नेस्ट हो सकती हैं। “Choose a step” मेनू में हर चरण का नाम और एक छोटी पंक्ति दिखती है, दोनों छह बुनियादी चरणों के लिए नीचे उद्धृत हैं। Ask a question (ask) अपना Message अधिकतम 10 बटन के साथ भेजता है, जिनमें से 3 टैप करने वाले बटन के रूप में दिखते हैं और बाकी सूची में दिए जाते हैं और नंबर से जवाब दिए जाते हैं; यह जवाब के लिए 1,380 मिनट तक रुकता है और उसे संपर्क के फ़ील्ड में टेक्स्ट, ईमेल, नंबर, फ़ोन या किसी एक बटन के रूप में सेव करता है; गलत जवाब मिलने पर सवाल अधिकतम 3 बार दोबारा पूछा जाता है। Agent answers (agent) मैसेज को आपके किसी AI एजेंट को सौंपता है, Send a picture or file (send_file) आपकी फ़ाइलों से कोई फ़ोटो या PDF भेजता है, और Hand to a person (handoff) उस चैट पर बॉट को 1 से 168 घंटे के लिए रोकता है, डिफ़ॉल्ट 24, और आपको ईमेल करता है। Split into paths (condition) और AI picks the path (ai_decide) नियमों या अर्थ के आधार पर ब्रांच बनाते हैं। AI saves details (ai_extract), Save to contact (set_field) और Tag (tag) संपर्क के फ़ील्ड और टैग लिखते हैं, और Call an API (http_request) किसी भी HTTPS API को कॉल करता है और उसका JSON जवाब {{vars.<name>...}} के रूप में रखता है। Start automation (start_automation) उसी व्यक्ति के लिए दूसरा ऑटोमेशन चलाता है, अधिकतम 3 स्तर गहरा, Go back to a step (goto) लूप बनाने के लिए किसी चरण आईडी पर कूदता है, और Notify me (notify_owner) आपको ईमेल करता है, प्रति ऑटोमेशन प्रति घंटे अधिकतम 20। यदि कोई चरण विफल हो, तो उसके बाद के चरण छोड़ दिए जाते हैं और रन Failed के रूप में समाप्त होता है। Call my वेबहुक “automation.step” इवेंट के साथ, dry_run, run_id, नंबर, संपर्क (wa_id, name), मैसेज (id, type, text, at) और चैट के हाल के अधिकतम 10 मैसेज वाला JSON POST करता है। इस पर X-EC-Signature में t=<unix>,v1=<HMAC-SHA256 of “<t>.<body>”> के रूप में हस्ताक्षर होता है, चरण की “Signing secret” से। इसका यूआरएल सार्वजनिक HTTPS होना चाहिए, और रीडायरेक्ट का पालन नहीं होता।
कौन-से वेरिएबल चरण भर सकते हैं?
चार उस मैसेज से भरे जाते हैं जिसने रन शुरू किया, दोहरे ब्रेसेस में लिखे जाते हैं; {{contact.<field>}} संपर्क का कोई फ़ील्ड जोड़ता है (contact.name और contact.phone भी) और {{vars.<path>}} वह जोड़ता है जो पिछले चरणों ने सेव किया, जैसे Call an API चरण का जवाब। ये Reply with text के Message में, टेम्पलेट के बॉडी वेरिएबल में, Reply with AI के Instructions में और Ask a question जैसे दूसरे चरणों के टेक्स्ट में काम करते हैं; टेम्पलेट के वेरिएबल में “Insert:” चिप इन्हें जोड़ते हैं। जो मान अज्ञात है, जैसे बिना नाम की प्रोफ़ाइल, वह खाली हो जाता है। टेम्पलेट भेजने में केवल बॉडी वेरिएबल जाते हैं, वह भी क्रम के हिसाब से, इसलिए नाम वाले वेरिएबल का टेम्पलेट, हेडर फ़ोटो या हेडर वेरिएबल वाला टेम्पलेट, या वेरिएबल वाला बटन अभी नहीं चुना जा सकता, और कोई वेरिएबल खाली रह जाए तो Meta भेजना अस्वीकार कर देता है।
- {{
first_name}}: ग्राहक के WhatsApp प्रोफ़ाइल नाम का पहला शब्द (“First name”)। - {{name}}: पूरा प्रोफ़ाइल नाम (“Full name”)।
- {{message}}: मैसेज का टेक्स्ट, या उसका प्लेसहोल्डर जैसे “[image]” और कैप्शन (“Their message”)।
- {{phone}}: ग्राहक का नंबर अंतरराष्ट्रीय अंकों में, प्लस के बिना, जैसे 5511999998888 (“Their phone”)।
- टेस्ट में ग्राहक का नाम “Test customer” है और फ़ोन 15550000000 है।
सेटिंग और उनके डिफ़ॉल्ट क्या हैं?
दो सेटिंग एडिटर में On स्विच के बगल वाले बटन “Advanced” के नीचे हैं, और AI चरण के अपने दो और हैं। जो फ़ील्ड छोड़ दिया जाए, उसे उसका डिफ़ॉल्ट मिलता है, एडिटर में और create_automation के माध्यम से भी समान रूप से। टाइमआउट तय हैं, सेट नहीं किए जा सकते: AI जवाब को 45 सेकंड और वेबहुक को 20 सेकंड मिलते हैं। ऑटोमेशन का नाम अधिकतम 120 अक्षरों का हो सकता है। AI एजेंट की अपनी सेटिंग हैं: वह कितने पिछले मैसेज पढ़ता है, 0 से 40 (डिफ़ॉल्ट 20), सबसे लंबा जवाब 100 से 4,000 टोकन (डिफ़ॉल्ट 800), प्रति जवाब अधिकतम 10 टूल कॉल (डिफ़ॉल्ट 5) और हैंड-ऑफ़ के घंटे, 1 से 168 (डिफ़ॉल्ट 24)।
कई मैच होने पर कौन-सा ऑटोमेशन जवाब देता है?
अधिकतम एक, एक तय क्रम में चुना जाता है: पहले Has keyword, फिर First message, फिर After hours, फिर Every message, और एक ही प्रकार के भीतर सबसे पुराना ऑटोमेशन पहले। केवल वे ऑटोमेशन प्रतिस्पर्धा करते हैं जो On हैं और पॉज़ नहीं हैं, इसलिए जब कीवर्ड नियम Off हो, या अस्वीकृत AI कुंजी के कारण पॉज़ हो, तो कैच-ऑल (Every message) जवाब देता है। दो बातें लोगों को चौंकाती हैं। रात में लिखने वाला नया ग्राहक After hours के बजाय First message वाला ऑटोमेशन पाता है, क्योंकि First message ऊँचे क्रम पर है। और जिस मैसेज का जवाब कीवर्ड ऑटोमेशन दे देता है, वह किसी AI एजेंट या Every message पर लगे Reply with AI चरण तक नहीं पहुँचता, इसलिए दोनों चाहिए तो एजेंट या AI चरण को कीवर्ड ऑटोमेशन के भीतर रखें। जो मैसेज किसी खुले Ask a question चरण का जवाब देता है, वह उसी सवाल का होता है, और उस पर कोई दूसरा ऑटोमेशन शुरू नहीं होता। टैग और वेबहुक ऑटोमेशन अपने ही इवेंट से शुरू होते हैं और इस क्रम में हिस्सा नहीं लेते।
कौन-से गार्ड अंतर्निहित हैं?
रनर इन्हें बिना किसी सेटिंग के लागू करता है, और Runs टैब के स्किप कारण जब कोई रन रोकते हैं तो इनके नाम बताते हैं:
- Meta द्वारा दो बार डिलीवर किया गया मैसेज एक ही रन शुरू करता है: मैसेज id से डुप्लिकेट हटाए जाते हैं।
- रिएक्शन, स्टेटस, ऑटोमेशन के अपने भेजे मैसेज, और ऐप से आपके इको मैसेज कभी रन शुरू नहीं करते।
- Reply with text, Ask a question, Send a picture or file, Reply with AI, एजेंट के जवाब और वेबहुक के जवाब के लिए ग्राहक का आख़िरी मैसेज 24 घंटे से कम पुराना होना चाहिए; Send a टेम्पलेट के लिए यह ज़रूरी नहीं।
- WhatsApp Business ऐप में आप जो जवाब टाइप करते हैं, वह उस चैट पर ऑटोमेशन को पॉज़ कर देता है, और वहाँ प्रतीक्षारत रन अपने शेष चरण छोड़ देता है।
- कोई नया मैसेज जो उसी चैट पर उसी ऑटोमेशन को शुरू करता है, उस चैट पर Wait चरण में प्रतीक्षारत रन की जगह ले लेता है; जो मैसेज किसी खुले सवाल का जवाब देता है, वह इसके बजाय उसी सवाल के पास जाता है।
- किसी नंबर से भेजे गए मैसेज कम से कम 100 ms के अंतर पर जाते हैं, जो Coexistence नंबरों के लिए Meta की 20 प्रति सेकंड की सीमा से नीचे है।
- विफल चरण आपको ईमेल करता है, प्रति ऑटोमेशन हर 6 घंटे में अधिकतम एक बार; अस्वीकृत AI कुंजी उस प्रदाता वाले ऑटोमेशन को पॉज़ करती है और एक ईमेल भेजती है।
create_automation टूल क्या लेता है?
MCP कनेक्टर में ऑटोमेशन और उनके काम आने वाली चीज़ों के लिए उन्नीस टूल हैं। आठ ऑटोमेशन के लिए हैं: set_inbound_mode, list_automations, create_automation, update_automation, delete_automation, test_automation, list_automation_runs और get_automation_run। आठ एजेंट और फ़ाइलों के लिए हैं: list_agents, list_files, create_agent, update_agent, delete_agent, add_agent_knowledge, delete_agent_knowledge और test_agent। तीन लोगों के लिए हैं: list_conversations, get_conversation और update_contact। create_automation connection_id (list_numbers से), name, enabled, trigger, steps और settings लेता है, snake_case में, जैसे keyword_mode और max_tokens; camelCase भी स्वीकार है। चरण ऑब्जेक्ट ये हैं: reply_text {text}, send_template {name, language, params}, ai_reply {provider, model, prompt, history, max_tokens}, call_webhook {url} और wait {minutes}, फिर ask {text, buttons, save_to, expect, retry_text, wait_minutes}, agent {agent_id, wait_seconds}, send_file {file_id, caption}, condition {paths, otherwise}, ai_decide {provider, model, instructions, paths, otherwise}, ai_extract {provider, model, fields}, set_field {key, value}, tag {action, tag}, http_request {method, url, headers, body, save_as}, start_automation {automation_id}, handoff {hours, note}, notify_owner {text}, goto {to} और stop। update_automation वे फ़ील्ड जस के तस रखता है जो आप छोड़ देते हैं, और steps, यदि दिए जाएँ, पूरी सूची बदल देते हैं। गड़बड़ियाँ उस फ़ील्ड का नाम बताती हैं, जैसे “trigger.keywords: Add at least one keyword”, “steps.2: Stop must be the last step of its line” या “steps.0: save your openai API key on the Automations page first”। AI कुंजियाँ MCP से कभी नहीं जातीं। उदाहरण में 1 मिनट का Wait इसलिए है कि एक साथ कई पंक्तियाँ भेजने वाले ग्राहक को एक ही जवाब मिले।
{
"connection_id": "<connection_id from list_numbers>",
"name": "After-hours assistant",
"enabled": false,
"trigger": {
"type": "message_received",
"match": "outside_hours",
"hours": {
"timezone": "America/Sao_Paulo",
"days": [1, 2, 3, 4, 5, 6],
"start": "08:00",
"end": "18:00"
}
},
"steps": [
{ "type": "wait", "minutes": 1 },
{
"type": "ai_reply",
"provider": "openrouter",
"model": "google/gemini-omni-1.2-flash",
"prompt": "You are the assistant of Ana's Bakery. We are closed and open at 8:00. Answer questions about products; a person confirms orders in the morning.",
"history": 10,
"max_tokens": 600
}
],
"settings": { "takeover_hours": 4, "ai_max_per_hour": 10 }
}आम गड़बड़ियाँ
- दो अक्षर का कीवर्ड Contains के साथ इस्तेमाल करना। “oi” “noite” और “boi” से भी मैच करता है, इसलिए ऑटोमेशन ऐसे मैसेज पर जवाब देता है जिनके लिए वह बना ही नहीं था; Is exactly का उपयोग करें, या लंबा कीवर्ड चुनें।
- केवल एक्सेंट वाली वर्तनी लिखना। मिलान बड़े-छोटे अक्षर नज़रअंदाज़ करता है, एक्सेंट नहीं, इसलिए “preço” उन ग्राहकों से चूक जाता है जो “preco” लिखते हैं; दोनों जोड़ें।
- उम्मीद करना कि First message नियमित ग्राहकों को छोड़ देगा। यह हर उस ग्राहक पर चलता है जिसकी चैट easyCoexistence ने 30 दिनों से नहीं देखी, इसलिए पुराने ग्राहक आपके चालू करने के बाद अपने पहले मैसेज पर स्वागत मैसेज पाते हैं।
- ऐसा टेम्पलेट चुनना जिसे हेडर फ़ोटो या copy-code बटन चाहिए। ऑटोमेशन केवल बॉडी वेरिएबल भरते हैं, इसलिए एडिटर उसे सूची में दिखाता है पर चुनने नहीं देता, और MCP से सेट करने पर Meta भेजना अस्वीकार कर देता है और रन विफल हो जाता है।
easyCoexistence ये ऑटोमेशन उस WhatsApp Business नंबर पर चलाता है जिसे आप ऐप में इस्तेमाल करते रहते हैं, Meta के Cloud API और Coexistence के ज़रिए। इन्हें एडिटर में Automations के अंतर्गत New automation से बनाएँ, या ChatGPT या Claude को MCP कनेक्टर के माध्यम से create_automation और test_automation कॉल करने दें, जिसके 30 से अधिक टूल हैं। प्रति नंबर प्रति माह US$ 9 से US$ 0.75 तक, नंबर बढ़ाने के साथ घटता हुआ, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या एक ऑटोमेशन ग्राहक की बात के आधार पर ब्रांच कर सकता है?
हाँ। Split into paths (condition) मैसेज टेक्स्ट, संपर्क फ़ील्ड, टैग, पहले के API जवाब या आपके खुलने के घंटों के आधार पर ब्रांच बनाता है, और AI picks the path (ai_decide) अर्थ के आधार पर चुनता है, किसी भी भाषा में, आपके अपने मॉडल पर। हर पाथ के चरणों की अपनी पंक्ति होती है, और एक Otherwise पंक्ति बाकी को संभालती है। आप निर्णय Call my वेबहुक के ज़रिए n8n या अपने बैकएंड को भी सौंप सकते हैं, जो हर मामले के लिए अलग {"reply": "..."} लौटा सकता है।
क्या ऑटोमेशन या रन की कोई सीमा है?
रन पर कोई सीमा नहीं और उनका कोई अतिरिक्त शुल्क नहीं, और एक नंबर पर कितने भी ऑटोमेशन हो सकते हैं। लागू सीमाएँ प्रति चैट हैं: प्रति घंटे AI जवाब, टेक्स्ट के लिए Meta का 24 घंटे का नियम, और फ़ोन से जवाब देने के बाद का पॉज़।
क्या मैं ऑटोमेशन को दूसरे नंबर पर ले जा या कॉपी कर सकता हूँ?
एडिटर में उसका Connection बदलकर, या update_automation और नया connection_id देकर इसे ले जाएँ; पुराने नंबर पर प्रतीक्षारत रन “superseded” के रूप में समाप्त हो जाते हैं। कॉपी करने के लिए अपने AI से list_automations के साथ उसे पढ़वाएँ और दूसरे नंबर पर वही ट्रिगर और चरण बनवाएँ।
ऑटोमेशन बदलने पर प्रतीक्षारत रन का क्या होता है?
वे चलते रहते हैं। Wait पर रुका रन, जब वह जागता है, तब सहेजे गए ऑटोमेशन के अगले चरण क्रमांक पर फिर शुरू होता है, इसलिए बदलाव से वह जो भेजता है वह बदल सकता है। उन्हें रोकने के लिए ऑटोमेशन को Off करें: तब वे “Automation is off” के साथ Skipped पर समाप्त होते हैं।
पढ़ना जारी रखें
शुरू करने के लिए तैयार हैं?
WhatsApp Coexistence को महीनों में नहीं, मिनटों में कॉन्फ़िगर करें। ऐप्लिकेशन मोबाइल पर काम करता रहता है।
मुफ़्त ट्रायल शुरू करेंइस तारीख को सत्यापित