app2email API प्राइसिंग

दस्तावेज़ीकरण

Submit-Info

Submit-Info की गाइड: प्रश्नों की सूची से फ़ॉर्म बनाएँ, उसे WhatsApp और वेब पेज पर प्रकाशित करें, साझा इनबॉक्स में भूमिकाओं के साथ सबमिशन को चरणों से गुज़ारें, जवाब और अपने सिस्टम को कॉल ऑटोमेट करें, और सब कुछ API या AI एजेंट से सेट करें।

आप फ़ॉर्म को प्रश्नों की एक सादी सूची के रूप में लिखते हैं। app2email उसे WhatsApp के अंदर एक फ़ॉर्म और उन्हीं चरणों वाले वेब पेज में बदल देता है। कोई ग्राहक, या आपके अपने फ़ील्ड स्टाफ़ का सदस्य, उसे भरता है और उसे एक रेफ़रेंस मिलता है। जवाब और फ़ाइलें साझा इनबॉक्स में एक सबमिशन बन जाते हैं, जहाँ वह आपके चरणों से गुज़रता है और आपके ऑटोमेशन चालू करता है।

एक विचार

फ़ॉर्म, फिर सबमिशन, फिर चरण, फिर ऑटोमेशन, फिर कनेक्शन। कोटेशन का अनुरोध, आवेदन, मीटर रीडिंग, समस्या की रिपोर्ट, पूरा हुआ काम, डिलीवरी का प्रमाण और खर्च की रसीद, सब एक ही चीज़ हैं, बस प्रश्न और चरणों के नाम अलग हैं। हर एक एक टेम्पलेट के रूप में आता है जिसे आप इंस्टॉल करके बदल सकते हैं।

पाँच मिनट में शुरू करें

  1. इसे खोलें: अपने डैशबोर्ड में Submit-Info पेज खोलें (/dashboard/app/submit, Integrations से भी खुलता है)। इसे चालू करें।
  2. फ़ॉर्म बनाएँ: "New form" चुनें और कोई टेम्पलेट चुनें, या खाली से शुरू करें। उसे एक नाम दें और अपने प्रश्न लिखें। हर प्रश्न एक पंक्ति है: उसका टेक्स्ट, उसका प्रकार, और क्या उसका जवाब देना ज़रूरी है।
  3. प्रकाशित करें: "Publish to WhatsApp" फ़ॉर्म को WhatsApp पर अपलोड करके चालू कर देता है। उन्हीं चरणों वाला वेब पेज तुरंत चालू हो जाता है।
  4. साझा करें: Share के नीचे आपको वह शब्द मिलता है जो आपकी चैट में फ़ॉर्म खोलता है, एक लिंक जो वह शब्द लिखकर आपकी चैट खोलता है, वेब पेज का पता, एक QR कोड, और फ़ॉर्म को अपनी वेबसाइट पर लगाने के लिए एक स्निपेट।
  5. इनबॉक्स संभालें: नए सबमिशन Inbox में आते हैं। एक खोलें, उसका चरण बदलें, जवाब दें। तैयार होने पर अपनी टीम को आमंत्रित करें।

जो नंबर कभी Submit-Info नहीं खोलता, उसके लिए कुछ नहीं बदलता। जो फ़ॉर्म अभी WhatsApp पर प्रकाशित नहीं हुआ, वह भी काम करता है: उसका शब्द वेब पेज के लिंक के साथ जवाब देता है।

फ़ॉर्म बिल्डर

एक फ़ॉर्म में 1 से 12 चरण होते हैं, और एक चरण में एक शीर्षक और 1 से 12 प्रश्न होते हैं। कोई कैनवास नहीं और कुछ बनाना नहीं: वही सूची WhatsApp पर फ़ॉर्म, वेब पेज, जवाबों की जाँच, टेबल व्यू के कॉलम, एक्सपोर्ट और API को चलाती है। एडिटर के बगल का प्रीव्यू फ़ॉर्म को वैसे दिखाता है जैसे कोई व्यक्ति उसे देखता है।

प्रकारव्यक्ति क्या देता हैआप क्या सेट कर सकते हैं
textएक छोटा जवाबसबसे कम और सबसे ज़्यादा लंबाई, एक पैटर्न
textareaएक लंबा जवाबसबसे कम और सबसे ज़्यादा लंबाई
numberएक संख्यासबसे कम और सबसे ज़्यादा मान, दशमलव, kWh जैसी इकाई
emailएक ईमेल पता
phoneएक फ़ोन नंबर
dateएक तारीखकितने दिन पीछे या आगे तक हो सकती है
selectएक विकल्पविकल्प (2 से 200), या आपकी अपनी सूची
multiselectकई विकल्पविकल्प (2 से 20), कम से कम और ज़्यादा से ज़्यादा कितने टिक करें
yesnoहाँ या नहीं
rating1 से लेकर 3-10 तक का अंकसबसे ऊँचा अंक
consentसहमति देने के लिए एक वाक्यक्या उस पर टिक करना ज़रूरी है
photoएक या अधिक फ़ोटोकितनी (1 से 10); कैमरा, गैलरी या दोनों
documentएक या अधिक फ़ाइलेंकितनी (1 से 10); कोई भी फ़ाइल, PDF, इमेज या ऑफ़िस फ़ाइलें
locationव्यक्ति कहाँ हैWhatsApp पर लोकेशन अनुरोध; वेब पर एक बटन और एक पते की पंक्ति
infoटेक्स्ट जो आप दिखाते हैंकुछ पूछा या सहेजा नहीं जाता
hiddenवह मान जो लिंक के साथ आता हैजैसे जॉब नंबर; कुछ दिखाया नहीं जाता
  • सहायता टेक्स्ट और डिफ़ॉल्ट: हर प्रश्न के साथ एक छोटा संकेत और एक डिफ़ॉल्ट मान हो सकता है। डिफ़ॉल्ट उस जानकारी का इस्तेमाल कर सकता है जो आपके पास पहले से है, जैसे {contact.name}।
  • सिर्फ़ तब दिखाएँ जब: कोई चरण या प्रश्न किसी पहले के जवाब पर निर्भर हो सकता है ("show this step only when Problem is Yes")। WhatsApp और वेब पेज एक ही नियम का पालन करते हैं।
  • आंतरिक फ़ील्ड: ऐसे फ़ील्ड जो कभी पूछे नहीं जाते। आपकी टीम या कोई ऑटोमेशन उन्हें भरता है: कोटेशन की रकम, निर्णय का कारण, किसी दूसरे सिस्टम से लौटी id। वे सिर्फ़ इनबॉक्स और एक्सपोर्ट में दिखते हैं।
  • सूचियाँ: विकल्प वाला प्रश्न अपने विकल्प आपकी किसी सूची से ले सकता है (साइटें, जॉब, कीमत वाले उत्पाद)। सूची को डैशबोर्ड में या API से बदलें और फ़ॉर्म उसके साथ बदल जाता है, दोबारा प्रकाशित करने की ज़रूरत नहीं।
  • परिकलित मान: जवाबों पर एक फ़ॉर्मूला, तुरंत अनुमान या जाँच के लिए। फ़ॉर्मूले देखें।
  • भेजने के बाद: भेजने से पहले एक रिव्यू स्क्रीन, रेफ़रेंस के साथ जवाब, एक "Add more" बटन जो अगले संदेशों (टेक्स्ट, फ़ोटो, फ़ाइलें) को दस मिनट तक सबमिशन से जोड़ता है, और व्यक्ति के अपने स्टेटस पेज का लिंक।
  • प्रकाशन: app2email आपके लिए WhatsApp फ़ॉर्म लिखता है, WhatsApp की सीमाएँ माँगें तो लंबे चरण को कई स्क्रीन में बाँट देता है, और पिछले पाँच प्रकाशित संस्करण रखता है ताकि पुराना संदेश वही फ़ॉर्म खोले जिसके साथ वह भेजा गया था।

वेब पेज। वही चरण /form/your-code/form-key पर। यह नाम और WhatsApp नंबर सबसे आखिर में पूछता है। भेजने के बाद व्यक्ति रेफ़रेंस देखता है और "Get updates on WhatsApp" पर टैप कर सकता है, जो एक संदेश से उसके नंबर की पुष्टि करता है; फ़ॉर्म को इसे ज़रूरी बनाने के लिए सेट किया जा सकता है। आपका भेजा हुआ निजी लिंक पहले से जानता है कि व्यक्ति कौन है। फ़ॉर्म को अपनी साइट पर लगाने के लिए Share के नीचे का स्निपेट इस्तेमाल करें; अगर फ़ॉर्म लोकेशन पूछता है, तो iframe में allow="geolocation" जोड़ें। ब्राउज़र में फ़ोटो अपलोड से पहले छोटी कर दी जाती हैं; फ़ाइल 10 MB तक हो सकती है।

लोग फ़ॉर्म तक कैसे पहुँचते हैं

  • एक शब्द: हर फ़ॉर्म के अपने शब्द होते हैं। शब्द form, forms, report और submit (आप इन्हें बदल सकते हैं) कई फ़ॉर्म होने पर आपके फ़ॉर्म को मेनू के रूप में दिखाते हैं। शब्द सिर्फ़ छोटे संदेश में गिना जाता है: जिसमें 10 से कम अन्य शब्द हों (Settings, "Ignore the words in long messages"), इसलिए जिस लंबे संदेश में संयोग से वह आ जाए, वह कुछ शुरू नहीं करता।
  • एक लिंक या QR कोड: एक लिंक जो फ़ॉर्म के शब्द के साथ आपकी WhatsApp चैट खोलता है, या वेब पेज का पता।
  • आपकी ओर से भेजा गया: इनबॉक्स में "Send form", या API, एक नंबर पर फ़ॉर्म भेजता है, मान पहले से भरे हुए (जॉब नंबर, खाता, वे दस्तावेज़ जो आप चाहते हैं)।
  • एक फ़ॉलो-अप: कोई ऑटोमेशन या टीम का सदस्य दूसरे फ़ॉर्म से और जानकारी माँगता है। जो वापस आता है वह पहले सबमिशन से जुड़ जाता है।
  • वेब पेज, और API उन सिस्टम के लिए जिनके पास डेटा पहले से है।

कौन भेज सकता है। कोई भी (आम चुनाव), या सिर्फ़ वे नंबर जो आप सूचीबद्ध करें या आपके किसी टैग वाले संपर्क। इसी तरह फ़ॉर्म आपके फ़ील्ड स्टाफ़ तक सीमित रहता है। शब्द status किसी व्यक्ति को उसके हाल के सबमिशन का चरण बताता है।

चरण

चरण फ़ॉर्म के होते हैं। नया फ़ॉर्म New, In progress और Done से शुरू होता है; उनका नाम बदलें, अपने चरण जोड़ें (2 से 12), और एक रंग चुनें। हर चरण तीन प्रकारों में से एक है: open, done या cancelled।

  • कौन चुन सकता है: किसी चरण को कुछ भूमिकाओं के लिए रखें। Agent तैयारी करता है, सिर्फ़ Manager मंज़ूर करता है।
  • नोट ज़रूरी: जब सबमिशन को वहाँ ले जाया जाए तो कारण माँगें (अस्वीकृत, ठुकराया गया, पूछताछ)।
  • संदेश: सबमिशन के चरण पर पहुँचने पर व्यक्ति को भेजा जाने वाला टेक्स्ट, प्लेसहोल्डर के साथ।
  • व्यक्ति के लिए बटन: जवाब के साथ तीन तक बटन हो सकते हैं (Accept, Decline, "Not fixed yet"), और हर एक चरण बदलता है। इसी एक चीज़ से आपको कोटेशन की स्वीकृति, विज़िट की पुष्टि और "क्या यह ठीक हो गया?" मिलते हैं।

WhatsApp की जवाब देने की अवधि के बाहर लिखा गया जवाब रख लिया जाता है और तब डिलीवर होता है जब व्यक्ति अगली बार लिखता है। इनबॉक्स जवाब पर यह बताता है।

इनबॉक्स और भूमिकाएँ

Inbox में Open, Mine, Unassigned, Done और All दिखते हैं, साथ में वे व्यू जो आप सहेजते हैं। फ़ॉर्म, चरण, असाइनी, टैग, चैनल और तारीख से खोजें और फ़िल्टर करें। तीन लेआउट: एक सूची, एक टेबल (एक फ़ॉर्म: हर प्रश्न एक कॉलम) और एक बोर्ड (एक फ़ॉर्म: हर चरण के लिए एक कॉलम)। चरण बदलने, असाइन करने, टैग करने, एक्सपोर्ट करने या हटाने के लिए कई पंक्तियों पर टिक करें और एक साथ करें।

सबमिशन अपने जवाब, अपनी फ़ाइलें, वह जगह जहाँ से भेजा गया, और उसके साथ जो कुछ हुआ उसका एक इतिहास दिखाता है: चरण बदलाव किसने और क्यों किए, नोट्स, दोनों दिशाओं के जवाब, फ़ाइलें, और हर ऑटोमेशन चरण अपने नतीजे के साथ। सबसे नीचे आप या तो आंतरिक नोट लिखते हैं या WhatsApp जवाब। किसी भी व्यू को CSV, Excel या JSON में, और एक सबमिशन को PDF में एक्सपोर्ट करें।

आपकी टीम। लोगों को ईमेल से सिर्फ़ इनबॉक्स के लिए आमंत्रित करें। उन्हें /desk पर अपना एक हल्का ऐप मिलता है और वे आपके खाते का बाकी हिस्सा कभी नहीं देखते। भूमिका क्षमताओं का एक शुरुआती सेट है, और हर क्षमता एक व्यक्ति के लिए चालू या बंद की जा सकती है।

भूमिकाइससे शुरू होती है
Owner, Adminसब कुछ, फ़ॉर्म, ऑटोमेशन, कनेक्शन और टीम समेत
Managerनोट्स, जवाब, जवाबों में बदलाव, चरण बदलना, असाइन करना, फ़ाइलें, एक्सपोर्ट, डिलीट, मैन्युअल कार्रवाइयाँ चलाना
Agentनोट्स, जवाब, जवाबों में बदलाव, चरण बदलना, फ़ाइलें, मैन्युअल कार्रवाइयाँ चलाना। सबमिशन को अपने लिए ले सकता है
Viewerपढ़ सकता है, और कुछ नहीं

आप यह भी सीमित कर सकते हैं कि व्यक्ति क्या देखे: सिर्फ़ कुछ फ़ॉर्म, सिर्फ़ जो उसे असाइन हो (बिना असाइन वालों के साथ या बिना, जिन्हें वह उठा सके), और संपर्क विवरण छिपे हुए। टीम के सदस्य की हर कार्रवाई सबमिशन के इतिहास में लिखी जाती है।

व्यक्ति का अपना पेज। हर सबमिशन का /s/a-long-code पर एक निजी पेज होता है, बिना लॉगिन के: चरण, अब तक के संदेश और चरण बदलाव, बटनों के साथ आपका खुला प्रश्न, और फ़ॉर्म अनुमति दे तो "Add information"। आंतरिक नोट्स और आंतरिक फ़ील्ड उस पर कभी नहीं होते।

गोपनीयता। किसी संपर्क को मिटाने पर उसके सबमिशन और फ़ाइलें भी मिट जाती हैं। फ़ॉर्म पर रखने की अवधि हो सकती है, जिसके बाद बंद सबमिशन मिटा दिए जाते हैं।

ऑटोमेशन

ऑटोमेशन एक वाक्य की तरह पढ़ा जाता है: when कुछ होता है, if कुछ बातें सच हैं, do ये काम क्रम से। "When a Quote request is submitted, if quantity is 20 or more, assign it to Managers and e-mail the owner."

Whenयह कब चलता है
submittedसबमिशन पूरा है और उसकी फ़ाइलें पहुँच गई हैं
status_changedचरण बदला (वैकल्पिक: कुछ चरणों में या उनसे)
assignedजिसे असाइन किया गया है वह व्यक्ति बदला
updatedजवाब या आंतरिक फ़ील्ड संपादित हुए
note_addedटीम के सदस्य ने नोट लिखा
file_addedबाद में कोई फ़ाइल जोड़ी गई
customer_repliedजिसने भेजा था उसने टेक्स्ट या फ़ाइलें जोड़ीं
buttonव्यक्ति ने आपके किसी जवाब का बटन दबाया
overdueकुछ मिनट बाद भी वह उसी चरण में है
dueखुले रहते हुए उसका नियत समय बीत गया
manualटीम का सदस्य सबमिशन पर कार्रवाई का बटन दबाता है

If: जवाबों, परिकलित मानों, चरण, चैनल, टैग और असाइनी पर नियम। नियम एक फ़ील्ड, एक ऑपरेटर और एक मान है: equals, not_equals, in, not_in, contains, empty, not_empty, gt, gte, lt, lte। नियमों को all (और) या any (या) से जोड़ें।

Doयह क्या करता है
set_statusउसे किसी चरण में ले जाना, नोट के साथ
assignकिसी सदस्य को, किसी भूमिका में बारी-बारी से, किसी भूमिका के सबसे कम व्यस्त को, या किसी को नहीं
set_field, calculateआंतरिक फ़ील्ड लिखना, या फ़ॉर्मूले से निकालना
tag, set_priority, set_dueटैग, प्राथमिकता, नियत समय
replyव्यक्ति को WhatsApp संदेश, 3 तक बटनों के साथ जो हर एक चरण बदलता है, एक फ़ाइल, या उनके स्टेटस पेज का लिंक
ask_locationव्यक्ति से अपनी जगह साझा करने को कहना
send_formफ़ॉलो-अप फ़ॉर्म भेजना; जो वापस आता है वह इस सबमिशन से जुड़ जाता है
emailowner, असाइनी, व्यक्ति, या किसी भी पते पर, फ़ाइलों के साथ
notifyअसाइनी, किसी भूमिका, या टीम में सभी को ईमेल
http, openapi, mcpकिसी कनेक्शन को कॉल करना और जवाब के हिस्से फ़ील्ड में रखना
waitबाद में जारी रखना, सिर्फ़ तभी जब शर्तें अब भी सही हों
stopयहीं खत्म

हर रन का लॉग चरण-दर-चरण रखा जाता है: क्या भेजा गया, क्या लौटा, कितना समय लगा। "Try with a submission" किसी असली सबमिशन पर ऑटोमेशन चलाकर देखता है, बिना कुछ बदले या भेजे। बाहरी सिस्टम को किया गया जो कॉल विफल होता है उसे 1 मिनट, 10 मिनट और 1 घंटे बाद दोबारा आज़माया जाता है; उसके बाद ऑटोमेशन विफल चिह्नित हो जाता है और आपके webhook को submit.automation_failed मिलता है। जो ऑटोमेशन एक-दूसरे को चालू करते हैं वे तीन स्तर के बाद रोक दिए जाते हैं।

रेसिपी 1: बड़े कोटेशन मैनेजर के पास जाते हैं

{
  "name": "Large quotes go to a manager",
  "form": "quote_request",
  "enabled": true,
  "trigger": "submitted",
  "options": {},
  "conditions": {
    "all": [
      {
        "field": "quantity",
        "gte": 20
      }
    ]
  },
  "actions": [
    {
      "type": "assign",
      "to": "role:manager"
    },
    {
      "type": "set_priority",
      "priority": "high"
    },
    {
      "type": "email",
      "to": [
        "owner"
      ],
      "subject": "Large quote {reference}",
      "body": "{contact.name} asked for a quote.\n\n{answers}\n\n{desk_link}",
      "attach_files": true
    }
  ]
}

रेसिपी 2: कोटेशन भेजें, जवाब माँगें, तीन दिन बाद याद दिलाएँ

quote_amount एक आंतरिक फ़ील्ड है जिसे आपकी टीम सबमिशन को Quoted में ले जाने से पहले भरती है। रिमाइंडर तभी जाता है जब सबमिशन अब भी Quoted में हो।

{
  "name": "Send the quote and ask for an answer",
  "form": "quote_request",
  "enabled": true,
  "trigger": "status_changed",
  "options": {
    "to": [
      "quoted"
    ],
    "from": []
  },
  "conditions": {
    "field": "status",
    "equals": "quoted"
  },
  "actions": [
    {
      "type": "reply",
      "text": "Your quote {reference}: {quote_amount}. Would you like to go ahead?",
      "link": true,
      "buttons": [
        {
          "id": "accept",
          "title": "Accept",
          "set_status": "accepted"
        },
        {
          "id": "decline",
          "title": "Decline",
          "set_status": "declined"
        }
      ]
    },
    {
      "type": "wait",
      "minutes": 4320
    },
    {
      "type": "reply",
      "text": "A reminder about your quote {reference}. Tap Accept or Decline, or write to us with any question."
    }
  ]
}

रेसिपी 3: गलत दिखने वाली मीटर रीडिंग को अलग रखें

usage एक परिकलित मान है: reading - previous('reading')।

{
  "name": "Query a reading that looks wrong",
  "form": "meter_reading",
  "enabled": true,
  "trigger": "submitted",
  "options": {},
  "conditions": {
    "any": [
      {
        "field": "usage",
        "lt": 0
      },
      {
        "field": "usage",
        "gt": 2000
      }
    ]
  },
  "actions": [
    {
      "type": "set_status",
      "status": "queried",
      "note": "Usage {usage} kWh is outside the usual range."
    },
    {
      "type": "notify",
      "to": "role:manager",
      "text": "Reading {reference} for meter {meter_no} needs a check: usage {usage} kWh."
    }
  ]
}

कनेक्शन

कनेक्शन एक बाहरी सिस्टम है जिसे ऑटोमेशन कॉल कर सकता है। आपके खाते के webhook को किसी की ज़रूरत नहीं: वे हर सबमिशन इवेंट को होते ही पा लेते हैं (इवेंट देखें)। बाकी सब कुछ के लिए तीन प्रकार हैं। कनेक्शन पर "Test" और कार्रवाई पर "Try with a submission" कुछ भी चालू करने से पहले असली अनुरोध और असली जवाब दिखाते हैं।

HTTP अनुरोध

एक बेस पता और साइन इन करने का तरीका (कोई नहीं, bearer token, एक हेडर, यूज़र नेम और पासवर्ड, या पते में एक कुंजी)। कार्रवाई मेथड, पाथ और एक JSON बॉडी का नाम देती है। save जवाब के हिस्सों को सबमिशन के फ़ील्ड में रखता है।

{
  "key": "billing",
  "name": "Billing",
  "kind": "http",
  "base_url": "https://billing.example.com/api",
  "auth": {
    "type": "bearer",
    "secret": "YOUR_BILLING_TOKEN"
  },
  "enabled": true
}
{
  "type": "http",
  "connection": "billing",
  "method": "POST",
  "path": "/readings",
  "body": {
    "meter": "{meter_no}",
    "reading": "{reading}",
    "usage": "{usage}",
    "reference": "{reference}",
    "photo": "{files.photo}"
  },
  "save": {
    "billing_id": "$.id"
  },
  "on_fail": "retry"
}

OpenAPI दस्तावेज़

JSON में किसी OpenAPI 3 दस्तावेज़ का पता दें, या उसे चिपकाएँ। app2email उसके ऑपरेशन पढ़ता है; कार्रवाई उनमें से एक को उसकी id से चुनती है और उसके पैरामीटर भरती है। YAML और Swagger 2 दस्तावेज़ नहीं पढ़े जाते।

{
  "key": "helpdesk",
  "name": "Helpdesk",
  "kind": "openapi",
  "base_url": "https://helpdesk.example.com/api",
  "spec_url": "https://helpdesk.example.com/openapi.json",
  "auth": {
    "type": "header",
    "name": "X-Api-Token",
    "secret": "YOUR_HELPDESK_TOKEN"
  },
  "enabled": true
}
{
  "type": "openapi",
  "connection": "helpdesk",
  "operation": "createTicket",
  "params": {
    "title": "Problem {reference}: {category}",
    "description": "{description}",
    "reporter": "{contact.phone}"
  },
  "save": {
    "ticket_id": "$.id"
  },
  "on_fail": "retry"
}

MCP सर्वर

किसी MCP सर्वर (streamable HTTP) का पता और उसका टोकन दें। app2email सर्वर के टूल की सूची बनाता है; कार्रवाई एक चुनती है और उसके आर्ग्युमेंट भरती है। $text टूल का पूरा जवाब टेक्स्ट के रूप में रखता है।

{
  "key": "dispatch",
  "name": "Dispatch",
  "kind": "mcp",
  "base_url": "https://dispatch.example.com/mcp",
  "auth": {
    "type": "bearer",
    "secret": "YOUR_DISPATCH_TOKEN"
  },
  "enabled": true
}
{
  "type": "mcp",
  "connection": "dispatch",
  "tool": "close_job",
  "arguments": {
    "job_id": "{job}",
    "summary": "{work_done}",
    "minutes": "{time_spent}",
    "photos": "{files.photos}"
  },
  "save": {
    "dispatch_answer": "$text"
  },
  "on_fail": "continue"
}

जानने लायक। जो मान ठीक एक प्लेसहोल्डर हो वह अपना प्रकार बनाए रखता है (संख्या संख्या रहती है, सूची सूची रहती है)। गोपनीय जानकारी एन्क्रिप्ट करके सहेजी जाती है, दोबारा कभी दिखाई नहीं जाती और API से कभी लौटाई नहीं जाती। पते https और सार्वजनिक होने चाहिए: निजी, लोकल और आंतरिक पते अस्वीकार किए जाते हैं, और रीडायरेक्ट का पालन नहीं किया जाता। एक कॉल में 15 सेकंड लग सकते हैं और उसका जवाब 256 KB हो सकता है। save में पाथ $ (पूरा जवाब) या $.data.items[0].id जैसा सादा पाथ होता है।

प्लेसहोल्डर

हर टेक्स्ट और कार्रवाई का हर पैरामीटर घुमावदार कोष्ठक में प्लेसहोल्डर इस्तेमाल कर सकता है। जो नाम पहचाना नहीं जाता वह वैसा ही रहता है जैसा आपने लिखा।

प्लेसहोल्डरक्या बन जाता है
{<field key>}उस प्रश्न का जवाब (आंतरिक फ़ील्ड, परिकलित मान और ऑटोमेशन के सहेजे मान भी)
{reference}रेफ़रेंस, जैसे MR-7Q3M2A
{form} {form_key}फ़ॉर्म का नाम और उसकी key
{status} {status_name}चरण की key और उसका नाम
{channel}whatsapp, web, api या staff
{priority} {tags}प्राथमिकता और टैग
{created} {updated} {due}समय
{contact.name} {contact.phone} {contact.email}जिस व्यक्ति ने भेजा
{assignee.name} {assignee.email}जिस टीम सदस्य को असाइन किया गया
{link}व्यक्ति का अपना स्टेटस पेज
{desk_link}आपकी टीम के इनबॉक्स में सबमिशन
{answers}सभी जवाब "Label: value" पंक्तियों के रूप में
{files} {files.<field key>}सभी फ़ाइलों के, या एक प्रश्न की फ़ाइलों के लिंक; दूसरा सिस्टम उन्हें 7 दिन तक ला सकता है
{note}चरण बदलाव का नोट, या वह नोट जिसने ऑटोमेशन चालू किया
{button}व्यक्ति ने जो बटन दबाया
{business}आपके बिज़नेस का नाम
{submission}JSON बॉडी में: पूरा सबमिशन एक ऑब्जेक्ट के रूप में
{= formula }जगह पर ही निकाला गया फ़ॉर्मूला, जैसे {= round(qty * 1.1, 2) }

फ़ॉर्मूले

परिकलित मानों, calculate कार्रवाई, और किसी भी टेक्स्ट में {= ... } के भीतर इस्तेमाल होते हैं। फ़ॉर्मूला संख्याओं, एकल उद्धरण में टेक्स्ट और आपके प्रश्नों की key के साथ काम करता है। वह 500 अक्षर लंबा हो सकता है। शून्य से भाग, या कोई संख्या न होने पर त्रुटि की जगह खाली मान मिलता है।

आप लिखते हैंमतलब
+ - * / %संख्याओं और जवाबों पर अंकगणित
== != > >= < <=तुलनाएँ
and or not ( )तर्क और कोष्ठक
if(condition, a, b)शर्त सही हो तो a, वरना b
min(a, b, ...) max(a, b, ...)सबसे छोटा, सबसे बड़ा
round(x, n) abs(x)n दशमलव तक पूर्णांकन, संख्या का चिह्न हटाकर आकार
num(x) len(x)टेक्स्ट को संख्या के रूप में; टेक्स्ट या सूची की लंबाई
coalesce(a, b)a, या a खाली हो तो b
lower(x) upper(x) concat(a, b, ...)टेक्स्ट
lookup('list', id, 'column')आपकी किसी सूची की एक पंक्ति का कॉलम, उदाहरण के लिए कीमत
previous('field')उसी व्यक्ति का उस प्रश्न का पिछला जवाब
count_files('field')किसी प्रश्न में कितनी फ़ाइलें हैं
days_since(date)किसी तारीख से आज तक के दिन

उदाहरण: तुरंत अनुमान के लिए qty * lookup('prices', product, 'price'); उपयोग के लिए reading - previous('reading'); कौन मंज़ूर करे यह तय करने के लिए if(amount > 500, 'manager', 'agent')।

डेवलपर और AI एजेंट के लिए

ऊपर की हर बात /v1/{number}/submit के अंतर्गत REST API में है, जहाँ {number} देश कोड के साथ आपका WhatsApp नंबर है, सिर्फ़ अंक। अपनी API कुंजी Authorization: Bearer YOUR_API_KEY के रूप में भेजें (X-API-KEY हेडर भी स्वीकार है)। कुंजी को submissions:manage स्कोप चाहिए; पूर्ण एक्सेस वाली कुंजियों के पास यह है, Default कुंजी के पास नहीं। सैंडबॉक्स कुंजियाँ लिख नहीं सकतीं।

  1. GET /submit/guide: पूरी शब्दावली वाला एक JSON दस्तावेज़: विकल्पों और सीमाओं के साथ प्रश्न प्रकार, चरण नियम, ट्रिगर, ऑपरेटर, पैरामीटर के साथ कार्रवाइयाँ, प्लेसहोल्डर, फ़ॉर्मूला फ़ंक्शन, टेम्पलेट, और काम के उदाहरण।
  2. POST /submit/setup के साथ "dry_run": true: कुछ लिखा नहीं जाता; हर समस्या अपने पाथ और ठीक करने का तरीका बताने वाले एक वाक्य के साथ लौटती है।
  3. POST /submit/setup, dry_run के बिना: सूचियाँ, कनेक्शन, फ़ॉर्म और ऑटोमेशन एक साथ लागू होते हैं। कोई भी समस्या हो तो कुछ नहीं लिखा जाता।
  4. POST /submit/forms/{key}/publish, या सेटअप दस्तावेज़ के "publish" में फ़ॉर्म के नाम दें।
  5. फ़ॉर्म के लिंक साझा करें (GET /submit/forms/{key} उन्हें लौटाता है), फिर GET /submit/submissions पढ़ें या webhook इवेंट सुनें।

एक पूरा सेटअप कॉल

नीचे का दस्तावेज़ setup.json के रूप में सहेजें और उसे पोस्ट करें। 61400000000 की जगह अपना नंबर डालें। यह एक मीटर रीडिंग समाधान जाँचता है: साइटों की एक सूची, एक बिलिंग सिस्टम से कनेक्शन, तीन चरणों और एक परिकलित उपयोग वाला एक फ़ॉर्म, और दो ऑटोमेशन। इसे लागू करने के लिए "dry_run": true हटा दें। उसी key वाले मौजूदा फ़ॉर्म, सूचियाँ और कनेक्शन बदल दिए जाते हैं; ऑटोमेशन फ़ॉर्म के भीतर नाम से मिलाए जाते हैं। हिस्सों की जगह "preset": "..." टेम्पलेट में से एक इंस्टॉल करता है (GET /submit/presets उनकी सूची देता है)।

curl -X POST "https://api.app2email.com/v1/61400000000/submit/setup" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @setup.json
{
  "dry_run": true,
  "settings": {
    "enabled": true,
    "config": {
      "business_name": "Northside Energy",
      "default_prefix": "NE"
    }
  },
  "lists": [
    {
      "key": "sites",
      "name": "Sites",
      "items": [
        {
          "id": "north",
          "title": "North depot"
        },
        {
          "id": "south",
          "title": "South depot"
        }
      ]
    }
  ],
  "connections": [
    {
      "key": "billing",
      "name": "Billing",
      "kind": "http",
      "base_url": "https://billing.example.com/api",
      "auth": {
        "type": "bearer",
        "secret": "YOUR_BILLING_TOKEN"
      },
      "enabled": true
    }
  ],
  "forms": [
    {
      "key": "meter_reading",
      "name": "Meter reading",
      "definition": {
        "title": "Meter reading",
        "description": "Send us your reading. It takes about a minute.",
        "prefix": "MR",
        "steps": [
          {
            "key": "reading",
            "title": "Your reading",
            "text": "",
            "show_if": null,
            "fields": [
              {
                "key": "site",
                "type": "select",
                "label": "Site",
                "required": true,
                "list": "sites"
              },
              {
                "key": "meter_no",
                "type": "text",
                "label": "Meter number",
                "help": "Printed on the front of the meter",
                "required": true,
                "max_length": 30
              },
              {
                "key": "reading",
                "type": "number",
                "label": "Reading",
                "required": true,
                "min": 0,
                "decimals": 0,
                "unit": "kWh"
              },
              {
                "key": "photo",
                "type": "photo",
                "label": "Photo of the meter",
                "required": false,
                "max_files": 1,
                "source": "any"
              },
              {
                "key": "billing_id",
                "type": "text",
                "label": "Billing record",
                "internal": true
              }
            ]
          }
        ],
        "stages": [
          {
            "key": "received",
            "name": "Received",
            "kind": "open",
            "color": "blue",
            "set_by": [],
            "require_note": false,
            "message": ""
          },
          {
            "key": "queried",
            "name": "Queried",
            "kind": "open",
            "color": "amber",
            "set_by": [],
            "require_note": true,
            "message": "We have a question about your reading {reference}. We will be in touch."
          },
          {
            "key": "checked",
            "name": "Checked",
            "kind": "done",
            "color": "green",
            "set_by": [],
            "require_note": false,
            "message": ""
          }
        ],
        "who": {
          "mode": "anyone",
          "numbers": [],
          "tag": ""
        },
        "trigger": {
          "words": [
            "meter",
            "reading"
          ],
          "header": "",
          "body": "Tap the button to send your reading.",
          "button": "Open form",
          "footer": ""
        },
        "after": {
          "review_step": true,
          "reply": "Thanks {contact.name}. We have your reading - reference {reference}.",
          "allow_additions": false,
          "status_page": true
        },
        "web": {
          "enabled": true,
          "verify": "optional",
          "ask_email": false,
          "success_text": "Thank you. We have your reading."
        },
        "notify": {
          "email": true,
          "to": [],
          "attach_files": true
        },
        "calculated": [
          {
            "key": "usage",
            "label": "Usage",
            "formula": "reading - previous('reading')",
            "unit": "kWh",
            "decimals": 0
          }
        ],
        "retention_days": 0
      }
    }
  ],
  "automations": [
    {
      "name": "Query a reading that looks wrong",
      "form": "meter_reading",
      "enabled": true,
      "trigger": "submitted",
      "options": {},
      "conditions": {
        "any": [
          {
            "field": "usage",
            "lt": 0
          },
          {
            "field": "usage",
            "gt": 2000
          }
        ]
      },
      "actions": [
        {
          "type": "set_status",
          "status": "queried",
          "note": "Usage {usage} kWh is outside the usual range."
        },
        {
          "type": "notify",
          "to": "role:manager",
          "text": "Reading {reference} for meter {meter_no} needs a check: usage {usage} kWh."
        }
      ]
    },
    {
      "name": "Send good readings to billing",
      "form": "meter_reading",
      "enabled": true,
      "trigger": "submitted",
      "options": {},
      "conditions": {
        "all": [
          {
            "field": "usage",
            "gte": 0
          },
          {
            "field": "usage",
            "lte": 2000
          }
        ]
      },
      "actions": [
        {
          "type": "http",
          "connection": "billing",
          "method": "POST",
          "path": "/readings",
          "body": {
            "meter": "{meter_no}",
            "reading": "{reading}",
            "usage": "{usage}",
            "reference": "{reference}",
            "photo": "{files.photo}"
          },
          "save": {
            "billing_id": "$.id"
          },
          "on_fail": "retry"
        },
        {
          "type": "set_status",
          "status": "checked",
          "note": "Sent to billing as {billing_id}."
        }
      ]
    }
  ],
  "publish": [
    "meter_reading"
  ]
}

असली कॉल (dry_run के बिना) का जवाब:

{
  "success": true,
  "request_id": "req_...",
  "applied": {
    "lists": [
      "sites"
    ],
    "connections": [
      "billing"
    ],
    "forms": [
      "meter_reading"
    ],
    "automations": [
      "Query a reading that looks wrong",
      "Send good readings to billing"
    ],
    "published": [
      "meter_reading"
    ]
  },
  "problems": []
}

अन्य रूट

  • सेटिंग्स: GET / PUT /submit/settings।
  • फ़ॉर्म: सूची, बनाना (परिभाषा या टेम्पलेट से), पढ़ना, अपडेट, डिलीट, प्रकाशित करना, और POST /submit/forms/{key}/send किसी नंबर पर मान भरकर फ़ॉर्म भेजने के लिए।
  • सूचियाँ: PUT /submit/lists/{key} किसी सूची की पंक्तियाँ बदल देता है।
  • सबमिशन: सूची (फ़ॉर्म, चरण, असाइनी, टैग, चैनल, संपर्क, टेक्स्ट और तारीखों से फ़िल्टर; सिंक के लिए updated_after; ?format=csv से CSV), बनाना, id या रेफ़रेंस से पढ़ना, अपडेट (चरण, नोट, प्राथमिकता, असाइनी, नियत समय, टैग, जवाब, आंतरिक फ़ील्ड), नोट जोड़ना, बटनों के साथ जवाब, फ़ाइल जोड़ना, डिलीट।
  • ऑटोमेशन और रन: सूची, बनाना, पढ़ना, अपडेट, डिलीट, POST /submit/automations/try, और रन लॉग।
  • कनेक्शन: सूची, सेट, डिलीट, टेस्ट, रिफ़्रेश, और वे फ़ंक्शन जिन्हें कार्रवाई कॉल कर सकती है।
  • टीम और रिपोर्ट: सदस्यों को आमंत्रित, अपडेट और हटाना; फ़ॉर्म, चरण, दिन और असाइनी के अनुसार गिनती।

Webhook इवेंट

आपके खाते के हर webhook को हर इवेंट मिलता है। हर इवेंट उस क्षण का सबमिशन ले जाता है; उसमें फ़ाइल लिंक 7 दिन तक काम करते हैं।

इवेंटकब
submission.createdएक सबमिशन मौजूद है (उसकी फ़ाइलें अभी आ रही हो सकती हैं)
submission.files_readyउसकी फ़ाइलें सहेज ली गईं
submission.updatedजवाब, आंतरिक मान, प्राथमिकता, टैग या नियत समय बदले
submission.status_changedचरण बदला
submission.assignedअसाइनी बदला
submission.note_addedएक नोट लिखा गया
submission.customer_repliedव्यक्ति ने टेक्स्ट, फ़ाइलें या फ़ॉलो-अप जोड़ा, या बटन दबाया
submission.deletedडिलीट या मिटाया गया
submit.automation_failedएक ऑटोमेशन ने दोबारा कोशिशों के बाद हार मान ली

MCP टूल

हर रूट app2email के होस्ट किए MCP सर्वर पर एक टूल भी है, ताकि असिस्टेंट बातचीत में पूरा सेटअप कर सके: get_submit_guide, apply_submit_setup, list_submit_presets, create_form, publish_form, send_form, list_submissions, get_submission, update_submission, reply_to_submission, create_automation, try_automation, set_connection, test_connection और भी। असिस्टेंट को एक अच्छा पहला संदेश: "Submit-Info की गाइड पढ़ो, फिर फ़ोटो और लोकेशन वाला समस्या रिपोर्ट फ़ॉर्म सेट करो, और अर्जेंट वाले मेरे मैनेजरों को बताओ।"

claude mcp add --transport http app2email https://api.app2email.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

असिस्टेंट और ऑटोमेशन टूल जोड़ने के बारे में और: ऑटोमेशन टूल और एजेंट।

सीमाएँ

सीमामान
प्रति नंबर फ़ॉर्म100
फ़ॉर्म में चरण, चरण में प्रश्न12 और 12 (फ़ॉर्म में 60 प्रश्न, एक लोकेशन प्रश्न)
सूचियाँ50, हर एक में 1,000 पंक्तियों तक
ऑटोमेशन, कनेक्शन, टीम सदस्य200, 30, 200
एक सबमिशन में फ़ाइलें60
फ़ाइल का आकारWhatsApp से 25 MB, वेब पेज या API से 10 MB
एक नोट या एक जवाब4,000 अक्षर
एक सबमिशन पर टैग20
बाहरी सिस्टम को कॉलप्रति नंबर 60 प्रति मिनट और 2,000 प्रति दिन; प्रति कॉल 15 सेकंड और 256 KB
रन लॉग30 दिन रखा जाता है

अभी उपलब्ध नहीं

  • सबमिशन पर भुगतान लेना (कोटेशन स्वीकार होता है, चुकाया नहीं जाता)।
  • ऐसे व्यक्ति को WhatsApp फ़ॉर्म के रूप में फ़ॉर्म भेजना जिसने पिछले 24 घंटों में आपको नहीं लिखा: इसकी जगह आपको उसका निजी वेब लिंक मिलता है, जिसे किसी भी मंज़ूर टेम्पलेट से भेजा जा सकता है।
  • हस्ताक्षर।
  • दोहराए जाने वाले समूह ("add another item")।
  • बीच में किसी दूसरे फ़ॉर्म पर कूदना।
  • बिना कनेक्शन के फ़ॉर्म भर देना।
  • वेब पेज के तय टेक्स्ट में अन्य भाषाएँ (आपके फ़ॉर्म का हर टेक्स्ट आपके लिखने के लिए है)।
  • YAML या Swagger 2 में OpenAPI दस्तावेज़, और ऐसे MCP सर्वर जो सिर्फ़ पुराना SSE ट्रांसपोर्ट बोलते हैं।
  • फ़ोटो से मान पढ़ना।

ऊपर की हर बात डैशबोर्ड के Submit-Info पेज (/dashboard/app/submit) पर सेट होती है। प्रश्न: support@app2email.com।