Submit-Info की गाइड: प्रश्नों की सूची से फ़ॉर्म बनाएँ, उसे WhatsApp और वेब पेज पर प्रकाशित करें, साझा इनबॉक्स में भूमिकाओं के साथ सबमिशन को चरणों से गुज़ारें, जवाब और अपने सिस्टम को कॉल ऑटोमेट करें, और सब कुछ API या AI एजेंट से सेट करें।
आप फ़ॉर्म को प्रश्नों की एक सादी सूची के रूप में लिखते हैं। app2email उसे WhatsApp के अंदर एक फ़ॉर्म और उन्हीं चरणों वाले वेब पेज में बदल देता है। कोई ग्राहक, या आपके अपने फ़ील्ड स्टाफ़ का सदस्य, उसे भरता है और उसे एक रेफ़रेंस मिलता है। जवाब और फ़ाइलें साझा इनबॉक्स में एक सबमिशन बन जाते हैं, जहाँ वह आपके चरणों से गुज़रता है और आपके ऑटोमेशन चालू करता है।
एक विचार
फ़ॉर्म, फिर सबमिशन, फिर चरण, फिर ऑटोमेशन, फिर कनेक्शन। कोटेशन का अनुरोध, आवेदन, मीटर रीडिंग, समस्या की रिपोर्ट, पूरा हुआ काम, डिलीवरी का प्रमाण और खर्च की रसीद, सब एक ही चीज़ हैं, बस प्रश्न और चरणों के नाम अलग हैं। हर एक एक टेम्पलेट के रूप में आता है जिसे आप इंस्टॉल करके बदल सकते हैं।
जो नंबर कभी Submit-Info नहीं खोलता, उसके लिए कुछ नहीं बदलता। जो फ़ॉर्म अभी WhatsApp पर प्रकाशित नहीं हुआ, वह भी काम करता है: उसका शब्द वेब पेज के लिंक के साथ जवाब देता है।
एक फ़ॉर्म में 1 से 12 चरण होते हैं, और एक चरण में एक शीर्षक और 1 से 12 प्रश्न होते हैं। कोई कैनवास नहीं और कुछ बनाना नहीं: वही सूची WhatsApp पर फ़ॉर्म, वेब पेज, जवाबों की जाँच, टेबल व्यू के कॉलम, एक्सपोर्ट और API को चलाती है। एडिटर के बगल का प्रीव्यू फ़ॉर्म को वैसे दिखाता है जैसे कोई व्यक्ति उसे देखता है।
| प्रकार | व्यक्ति क्या देता है | आप क्या सेट कर सकते हैं |
|---|---|---|
text | एक छोटा जवाब | सबसे कम और सबसे ज़्यादा लंबाई, एक पैटर्न |
textarea | एक लंबा जवाब | सबसे कम और सबसे ज़्यादा लंबाई |
number | एक संख्या | सबसे कम और सबसे ज़्यादा मान, दशमलव, kWh जैसी इकाई |
email | एक ईमेल पता | |
phone | एक फ़ोन नंबर | |
date | एक तारीख | कितने दिन पीछे या आगे तक हो सकती है |
select | एक विकल्प | विकल्प (2 से 200), या आपकी अपनी सूची |
multiselect | कई विकल्प | विकल्प (2 से 20), कम से कम और ज़्यादा से ज़्यादा कितने टिक करें |
yesno | हाँ या नहीं | |
rating | 1 से लेकर 3-10 तक का अंक | सबसे ऊँचा अंक |
consent | सहमति देने के लिए एक वाक्य | क्या उस पर टिक करना ज़रूरी है |
photo | एक या अधिक फ़ोटो | कितनी (1 से 10); कैमरा, गैलरी या दोनों |
document | एक या अधिक फ़ाइलें | कितनी (1 से 10); कोई भी फ़ाइल, PDF, इमेज या ऑफ़िस फ़ाइलें |
location | व्यक्ति कहाँ है | WhatsApp पर लोकेशन अनुरोध; वेब पर एक बटन और एक पते की पंक्ति |
info | टेक्स्ट जो आप दिखाते हैं | कुछ पूछा या सहेजा नहीं जाता |
hidden | वह मान जो लिंक के साथ आता है | जैसे जॉब नंबर; कुछ दिखाया नहीं जाता |
{contact.name}।वेब पेज। वही चरण /form/your-code/form-key पर। यह नाम और WhatsApp नंबर सबसे आखिर में पूछता है। भेजने के बाद व्यक्ति रेफ़रेंस देखता है और "Get updates on WhatsApp" पर टैप कर सकता है, जो एक संदेश से उसके नंबर की पुष्टि करता है; फ़ॉर्म को इसे ज़रूरी बनाने के लिए सेट किया जा सकता है। आपका भेजा हुआ निजी लिंक पहले से जानता है कि व्यक्ति कौन है। फ़ॉर्म को अपनी साइट पर लगाने के लिए Share के नीचे का स्निपेट इस्तेमाल करें; अगर फ़ॉर्म लोकेशन पूछता है, तो iframe में allow="geolocation" जोड़ें। ब्राउज़र में फ़ोटो अपलोड से पहले छोटी कर दी जाती हैं; फ़ाइल 10 MB तक हो सकती है।
कौन भेज सकता है। कोई भी (आम चुनाव), या सिर्फ़ वे नंबर जो आप सूचीबद्ध करें या आपके किसी टैग वाले संपर्क। इसी तरह फ़ॉर्म आपके फ़ील्ड स्टाफ़ तक सीमित रहता है। शब्द status किसी व्यक्ति को उसके हाल के सबमिशन का चरण बताता है।
चरण फ़ॉर्म के होते हैं। नया फ़ॉर्म New, In progress और Done से शुरू होता है; उनका नाम बदलें, अपने चरण जोड़ें (2 से 12), और एक रंग चुनें। हर चरण तीन प्रकारों में से एक है: open, done या cancelled।
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 | फ़ॉलो-अप फ़ॉर्म भेजना; जो वापस आता है वह इस सबमिशन से जुड़ जाता है |
email | owner, असाइनी, व्यक्ति, या किसी भी पते पर, फ़ाइलों के साथ |
notify | असाइनी, किसी भूमिका, या टीम में सभी को ईमेल |
http, openapi, mcp | किसी कनेक्शन को कॉल करना और जवाब के हिस्से फ़ील्ड में रखना |
wait | बाद में जारी रखना, सिर्फ़ तभी जब शर्तें अब भी सही हों |
stop | यहीं खत्म |
हर रन का लॉग चरण-दर-चरण रखा जाता है: क्या भेजा गया, क्या लौटा, कितना समय लगा। "Try with a submission" किसी असली सबमिशन पर ऑटोमेशन चलाकर देखता है, बिना कुछ बदले या भेजे। बाहरी सिस्टम को किया गया जो कॉल विफल होता है उसे 1 मिनट, 10 मिनट और 1 घंटे बाद दोबारा आज़माया जाता है; उसके बाद ऑटोमेशन विफल चिह्नित हो जाता है और आपके webhook को submit.automation_failed मिलता है। जो ऑटोमेशन एक-दूसरे को चालू करते हैं वे तीन स्तर के बाद रोक दिए जाते हैं।
{
"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
}
]
}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."
}
]
}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" कुछ भी चालू करने से पहले असली अनुरोध और असली जवाब दिखाते हैं।
एक बेस पता और साइन इन करने का तरीका (कोई नहीं, 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"
}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 सर्वर (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')।
ऊपर की हर बात /v1/{number}/submit के अंतर्गत REST API में है, जहाँ {number} देश कोड के साथ आपका WhatsApp नंबर है, सिर्फ़ अंक। अपनी API कुंजी Authorization: Bearer YOUR_API_KEY के रूप में भेजें (X-API-KEY हेडर भी स्वीकार है)। कुंजी को submissions:manage स्कोप चाहिए; पूर्ण एक्सेस वाली कुंजियों के पास यह है, Default कुंजी के पास नहीं। सैंडबॉक्स कुंजियाँ लिख नहीं सकतीं।
GET /submit/guide: पूरी शब्दावली वाला एक JSON दस्तावेज़: विकल्पों और सीमाओं के साथ प्रश्न प्रकार, चरण नियम, ट्रिगर, ऑपरेटर, पैरामीटर के साथ कार्रवाइयाँ, प्लेसहोल्डर, फ़ॉर्मूला फ़ंक्शन, टेम्पलेट, और काम के उदाहरण।POST /submit/setup के साथ "dry_run": true: कुछ लिखा नहीं जाता; हर समस्या अपने पाथ और ठीक करने का तरीका बताने वाले एक वाक्य के साथ लौटती है।POST /submit/setup, dry_run के बिना: सूचियाँ, कनेक्शन, फ़ॉर्म और ऑटोमेशन एक साथ लागू होते हैं। कोई भी समस्या हो तो कुछ नहीं लिखा जाता।POST /submit/forms/{key}/publish, या सेटअप दस्तावेज़ के "publish" में फ़ॉर्म के नाम दें।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 को हर इवेंट मिलता है। हर इवेंट उस क्षण का सबमिशन ले जाता है; उसमें फ़ाइल लिंक 7 दिन तक काम करते हैं।
| इवेंट | कब |
|---|---|
submission.created | एक सबमिशन मौजूद है (उसकी फ़ाइलें अभी आ रही हो सकती हैं) |
submission.files_ready | उसकी फ़ाइलें सहेज ली गईं |
submission.updated | जवाब, आंतरिक मान, प्राथमिकता, टैग या नियत समय बदले |
submission.status_changed | चरण बदला |
submission.assigned | असाइनी बदला |
submission.note_added | एक नोट लिखा गया |
submission.customer_replied | व्यक्ति ने टेक्स्ट, फ़ाइलें या फ़ॉलो-अप जोड़ा, या बटन दबाया |
submission.deleted | डिलीट या मिटाया गया |
submit.automation_failed | एक ऑटोमेशन ने दोबारा कोशिशों के बाद हार मान ली |
हर रूट 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 दिन रखा जाता है |
ऊपर की हर बात डैशबोर्ड के Submit-Info पेज (/dashboard/app/submit) पर सेट होती है। प्रश्न: support@app2email.com।