Submit-Info کی گائیڈ: سوالات کی فہرست سے فارم بنائیں، اسے WhatsApp اور ویب صفحے پر پبلش کریں، رولز کے ساتھ مشترکہ ان باکس میں submissions کو مرحلوں سے گزاریں، جوابات اور اپنے سسٹمز کو کالز خودکار بنائیں، اور سب کچھ API یا AI ایجنٹ سے سیٹ کریں۔
آپ فارم کو سوالات کی سادہ فہرست کے طور پر لکھتے ہیں۔ app2email اسے WhatsApp کے اندر ایک فارم اور انہی مرحلوں والے ویب صفحے میں بدل دیتا ہے۔ کسٹمر، یا آپ کے اپنے فیلڈ اسٹاف کا کوئی رکن، اسے بھرتا ہے اور اسے ایک ریفرنس ملتا ہے۔ جوابات اور فائلیں مشترکہ ان باکس میں ایک submission بن جاتی ہیں، جہاں وہ آپ کے اسٹیجز سے گزرتی ہے اور آپ کی آٹومیشنز کو چلاتی ہے۔
ایک خیال
فارم، پھر submission، پھر اسٹیجز، پھر آٹومیشنز، پھر کنکشنز۔ کوٹیشن کی درخواست، درخواست فارم، میٹر ریڈنگ، مسئلے کی رپورٹ، مکمل کیا گیا کام، ڈیلیوری کا ثبوت اور خرچ کی رسید سب ایک ہی چیز ہیں، صرف سوالات اور اسٹیج کے نام مختلف ہیں۔ ہر ایک ٹیمپلیٹ کے طور پر آتا ہے جسے آپ انسٹال کر کے بدل سکتے ہیں۔
جو نمبر Submit-Info کبھی نہیں کھولتا اس کے لیے کچھ نہیں بدلتا۔ جو فارم ابھی WhatsApp پر پبلش نہیں ہوا وہ پھر بھی کام کرتا ہے: اس کا لفظ ویب صفحے کے لنک کے ساتھ جواب دیتا ہے۔
فارم میں 1 سے 12 مرحلے ہوتے ہیں، اور ہر مرحلے کا ایک عنوان اور 1 سے 12 سوالات ہوتے ہیں۔ کوئی canvas نہیں اور کچھ بنانا نہیں پڑتا: وہی فہرست WhatsApp پر فارم، ویب صفحہ، جوابات کی جانچ، ٹیبل ویو کے کالم، ایکسپورٹس اور API کو چلاتی ہے۔ ایڈیٹر کے ساتھ والا preview فارم کو ویسا دکھاتا ہے جیسا کوئی شخص اسے دیکھتا ہے۔
| قسم | شخص کیا دیتا ہے | آپ کیا سیٹ کر سکتے ہیں |
|---|---|---|
text | مختصر جواب | کم سے کم اور زیادہ سے زیادہ لمبائی، ایک pattern |
textarea | لمبا جواب | کم سے کم اور زیادہ سے زیادہ لمبائی |
number | ایک نمبر | کم سے کم اور زیادہ سے زیادہ قدر، اعشاریہ، kWh جیسی اکائی |
email | ای میل ایڈریس | |
phone | فون نمبر | |
date | ایک تاریخ | کتنے دن پیچھے یا آگے ہو سکتی ہے |
select | ایک انتخاب | انتخابات (2 سے 200)، یا آپ کی اپنی فہرست |
multiselect | کئی انتخابات | انتخابات (2 سے 20)، کم سے کم اور زیادہ سے زیادہ جتنے نشان لگائے جائیں |
yesno | Yes یا No | |
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 کے تحت snippet استعمال کریں؛ اگر فارم لوکیشن مانگتا ہے تو iframe میں allow="geolocation" شامل کریں۔ تصاویر اپ لوڈ ہونے سے پہلے براؤزر میں چھوٹی کی جاتی ہیں؛ فائل 10 MB تک ہو سکتی ہے۔
کون بھیج سکتا ہے۔ کوئی بھی (عام انتخاب)، یا صرف وہ نمبرز جو آپ درج کریں یا آپ کے ٹیگ والے کانٹیکٹس۔ اسی طرح فارم آپ کے فیلڈ اسٹاف تک رہتا ہے۔ لفظ status شخص کو اس کی حالیہ submissions کا اسٹیج بتاتا ہے۔
اسٹیجز فارم کے ہوتے ہیں۔ نیا فارم New، In progress اور Done سے شروع ہوتا ہے؛ انہیں نیا نام دیں، اپنے شامل کریں (2 سے 12)، اور رنگ چنیں۔ ہر اسٹیج تین میں سے ایک قسم کا ہے: open، done یا cancelled۔
WhatsApp کے جواب کے وقت سے باہر لکھا گیا جواب رکھ لیا جاتا ہے اور جب شخص اگلی بار لکھے تو ڈیلیور ہوتا ہے۔ ان باکس جواب پر یہ بتاتا ہے۔
Inbox Open، Mine، Unassigned، Done اور All دکھاتا ہے، ساتھ وہ ویوز جو آپ محفوظ کریں۔ فارم، اسٹیج، assignee، ٹیگ، چینل اور تاریخ سے تلاش اور فلٹر کریں۔ تین layouts: ایک فہرست، ایک ٹیبل (ایک فارم: ہر سوال ایک کالم) اور ایک بورڈ (ایک فارم: ہر اسٹیج کا ایک کالم)۔ اسٹیج بدلنے، assign کرنے، ٹیگ لگانے، ایکسپورٹ یا حذف کرنے کے لیے کئی قطاروں پر نشان لگائیں۔
submission اپنے جوابات، اپنی فائلیں، یہ کہ کہاں سے بھیجی گئی، اور اس کے ساتھ جو کچھ ہوا اس کی ایک تاریخ دکھاتی ہے: اسٹیج کی تبدیلیاں کس نے اور کیوں کیں، نوٹس، دونوں طرف کے جوابات، فائلیں، اور ہر آٹومیشن مرحلہ اپنے نتیجے کے ساتھ۔ نیچے آپ اندرونی نوٹ یا WhatsApp جواب لکھتے ہیں۔ کسی بھی ویو کو CSV، Excel یا JSON کے طور پر، اور ایک submission کو PDF کے طور پر ایکسپورٹ کریں۔
آپ کی ٹیم۔ لوگوں کو ای میل سے صرف ان باکس کے لیے مدعو کریں۔ انہیں /desk پر اپنی ہلکی ایپ ملتی ہے اور وہ آپ کے اکاؤنٹ کا باقی حصہ کبھی نہیں دیکھتے۔ رول صلاحیتوں کا ابتدائی سیٹ ہے، اور ہر صلاحیت ایک شخص کے لیے آن یا آف کی جا سکتی ہے۔
| رول | کس کے ساتھ شروع ہوتا ہے |
|---|---|
| Owner، Admin | سب کچھ، بشمول فارمز، آٹومیشنز، کنکشنز اور ٹیم |
| Manager | نوٹس، جوابات، جوابات میں ترمیم، اسٹیج بدلنا، assign کرنا، فائلیں، ایکسپورٹ، حذف، دستی ایکشنز چلانا |
| Agent | نوٹس، جوابات، جوابات میں ترمیم، اسٹیج بدلنا، فائلیں، دستی ایکشنز چلانا۔ submission اپنے لیے لے سکتا ہے |
| Viewer | پڑھ سکتا ہے، اور کچھ نہیں |
آپ یہ بھی محدود کر سکتے ہیں کہ شخص کیا دیکھے: صرف کچھ فارمز، صرف جو اسے assign ہو (غیر assign شدہ کے ساتھ یا بغیر جنہیں وہ اٹھا سکے)، اور رابطے کی تفصیلات چھپی ہوئی۔ ٹیم رکن کا ہر عمل submission کی تاریخ میں لکھا جاتا ہے۔
شخص کا اپنا صفحہ۔ ہر submission کا /s/a-long-code پر ایک نجی صفحہ ہے، بغیر لاگ ان کے: اسٹیج، اب تک کے میسجز اور اسٹیج کی تبدیلیاں، آپ کا کھلا سوال اس کے بٹنوں کے ساتھ، اور "Add information" جب فارم اجازت دے۔ اندرونی نوٹس اور اندرونی فیلڈز اس پر کبھی نہیں ہوتے۔
پرائیویسی۔ کانٹیکٹ مٹانا اس کی submissions اور فائلیں مٹا دیتا ہے۔ فارم کا keep-for وقت ہو سکتا ہے، جس کے بعد بند submissions مٹا دی جاتی ہیں۔
آٹومیشن ایک جملے کی طرح پڑھی جاتی ہے: جب کچھ ہو، اگر کچھ باتیں درست ہوں، تو یہ کام ترتیب سے کریں۔ "When a Quote request is submitted, if quantity is 20 or more, assign it to Managers and e-mail the owner."
| جب | یہ کب چلتی ہے |
|---|---|
submitted | submission مکمل ہو اور اس کی فائلیں پہنچ گئی ہوں |
status_changed | اسٹیج بدل گیا (اختیاری: مخصوص اسٹیجز میں یا سے) |
assigned | جس شخص کو assign تھا وہ بدل گیا |
updated | جوابات یا اندرونی فیلڈز میں ترمیم ہوئی |
note_added | ٹیم رکن نے نوٹ لکھا |
file_added | بعد میں فائل شامل ہوئی |
customer_replied | بھیجنے والے شخص نے ٹیکسٹ یا فائلیں شامل کیں |
button | شخص نے آپ کے کسی جواب کا بٹن دبایا |
overdue | چند منٹ کے بعد بھی یہ اسی اسٹیج میں ہے |
due | اس کا مقررہ وقت گزر گیا جبکہ یہ کھلی تھی |
manual | ٹیم رکن submission پر ایکشن کا بٹن دباتا ہے |
اگر: جوابات، حساب شدہ قدروں، اسٹیج، چینل، ٹیگز اور assignee پر اصول۔ اصول ایک فیلڈ، ایک operator اور ایک قدر ہے: equals، not_equals، in، not_in، contains، empty، not_empty، gt، gte، lt، lte۔ اصولوں کو all (اور) یا any (یا) سے جوڑیں۔
| تو | یہ کیا کرتا ہے |
|---|---|
set_status | اسے نوٹ کے ساتھ کسی اسٹیج میں منتقل کریں |
assign | کسی رکن کو، کسی رول میں باری باری، رول کے سب سے کم مصروف کو، یا کسی کو نہیں |
set_field, calculate | اندرونی فیلڈ لکھیں، یا فارمولے سے نکالیں |
tag, set_priority, set_due | ٹیگز، ترجیح، مقررہ وقت |
reply | شخص کو WhatsApp میسج، 3 بٹنوں تک جو ہر ایک اسٹیج بدلتا ہے، ایک فائل، یا ان کے اسٹیٹس صفحے کا لنک |
ask_location | شخص سے کہیں کہ وہ اپنی جگہ شیئر کرے |
send_form | فالو اپ فارم بھیجیں؛ جو واپس آتا ہے وہ اس submission سے جڑ جاتا ہے |
email | owner، assignee، شخص، یا کسی بھی ایڈریس کو، فائلوں کے ساتھ |
notify | assignee، کسی رول، یا ٹیم میں سب کو ای میل |
http, openapi, mcp | کنکشن کو کال کریں اور جواب کے حصے فیلڈز میں رکھیں |
wait | بعد میں جاری رکھیں، صرف تب جب شرائط اب بھی قائم ہوں |
stop | یہیں ختم کریں |
ہر رن مرحلہ وار لاگ ہوتا ہے: کیا بھیجا گیا، کیا واپس آیا، کتنا وقت لگا۔ "Try with a submission" آٹومیشن کو کسی اصل submission کے خلاف چلاتا ہے بغیر کچھ بدلے یا بھیجے۔ باہر کے سسٹم کو ناکام کال 1 منٹ، 10 منٹ اور 1 گھنٹے بعد دوبارہ کی جاتی ہے؛ اس کے بعد آٹومیشن ناکام نشان زد ہوتی ہے اور آپ کے webhooks کو 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 ایک اندرونی فیلڈ ہے جسے آپ کی ٹیم submission کو Quoted میں منتقل کرنے سے پہلے بھرتی ہے۔ یاددہانی صرف تب جاتی ہے جب submission اب بھی 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."
}
]
}کنکشن ایک بیرونی سسٹم ہے جسے آٹومیشن کال کر سکتی ہے۔ آپ کے اکاؤنٹ کے webhooks کو کسی کی ضرورت نہیں: وہ ہر submission ایونٹ ہوتے ہی وصول کرتے ہیں (دیکھیں ایونٹس)۔ باقی ہر چیز کے لیے تین قسمیں ہیں۔ کنکشن پر "Test" اور ایکشن پر "Try with a submission" کچھ بھی آن کرنے سے پہلے اصل درخواست اور اصل جواب دکھاتے ہیں۔
ایک base ایڈریس اور سائن ان کا طریقہ (کوئی نہیں، bearer ٹوکن، ہیڈر، صارف نام اور پاس ورڈ، یا ایڈریس میں کلید)۔ ایکشن میں method، path اور JSON body کا نام ہوتا ہے۔ save جواب کے حصے submission کے فیلڈز میں رکھتا ہے۔
{
"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 اس کے operations پڑھتا ہے؛ ایکشن ان میں سے ایک کو اس کی 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 سرور کے ٹولز کی فہرست بناتا ہے؛ ایکشن ایک چنتا ہے اور اس کے arguments بھرتا ہے۔ $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"
}جاننے کی بات۔ جو قدر بالکل ایک placeholder ہو وہ اپنی قسم برقرار رکھتی ہے (نمبر نمبر رہتا ہے، فہرست فہرست رہتی ہے)۔ Secrets encrypted محفوظ ہوتے ہیں، دوبارہ کبھی نہیں دکھائے جاتے اور API انہیں کبھی واپس نہیں کرتی۔ ایڈریس https اور عوامی ہونے چاہییں: نجی، مقامی اور اندرونی ایڈریس رد کر دیے جاتے ہیں، اور redirects کی پیروی نہیں کی جاتی۔ کال 15 سیکنڈ لے سکتی ہے اور اس کا جواب 256 KB تک ہو سکتا ہے۔ save میں path $ (پورا جواب) یا $.data.items[0].id جیسا سادہ path ہوتا ہے۔
ایکشن کا ہر متن اور ہر پیرامیٹر curly بریکٹس میں placeholders استعمال کر سکتا ہے۔ جو نام معلوم نہ ہو وہ ویسا ہی رہتا ہے جیسا آپ نے ٹائپ کیا۔
| Placeholder | کیا بنتا ہے |
|---|---|
{<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} | وہ ٹیم رکن جسے یہ assign ہے |
{link} | شخص کا اپنا اسٹیٹس صفحہ |
{desk_link} | آپ کی ٹیم کے ان باکس میں submission |
{answers} | تمام جوابات "Label: value" لائنوں کی صورت میں |
{files} {files.<field key>} | تمام فائلوں کے، یا ایک سوال کی فائلوں کے لنکس؛ کوئی دوسرا سسٹم انہیں 7 دن تک حاصل کر سکتا ہے |
{note} | اسٹیج کی تبدیلی کا نوٹ، یا وہ نوٹ جس نے آٹومیشن چلائی |
{button} | وہ بٹن جو شخص نے دبایا |
{business} | آپ کے کاروبار کا نام |
{submission} | JSON body میں: پوری submission ایک آبجیکٹ کے طور پر |
{= formula } | اسی جگہ نکالا گیا فارمولا، مثلاً {= round(qty * 1.1, 2) } |
حساب شدہ قدروں، calculate ایکشن، اور کسی بھی متن میں {= ... } کے اندر استعمال ہوتے ہیں۔ فارمولا نمبرز، single quotes میں ٹیکسٹ اور آپ کے سوالات کی keys کے ساتھ کام کرتا ہے۔ یہ 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، یا b جب a خالی ہو |
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')۔
اوپر کی ہر چیز REST API میں /v1/{number}/submit کے تحت ہے، جہاں {number} ملک کے کوڈ کے ساتھ آپ کا WhatsApp نمبر ہے، صرف ہندسے۔ اپنی API کلید Authorization: Bearer YOUR_API_KEY کے طور پر بھیجیں (X-API-KEY ہیڈر بھی قبول ہے)۔ کلید کو scope submissions:manage چاہیے؛ مکمل رسائی والی کلیدوں کے پاس یہ ہے، Default کلید کے پاس نہیں۔ Sandbox کلیدیں لکھ نہیں سکتیں۔
GET /submit/guide: ایک JSON دستاویز جس میں پوری لغت ہے: سوالات کی اقسام ان کے آپشنز اور حدود کے ساتھ، اسٹیج کے اصول، triggers، operators، ایکشنز ان کے پیرامیٹرز کے ساتھ، placeholders، فارمولا فنکشنز، ٹیمپلیٹس، اور کام کی مثالیں۔POST /submit/setup جس میں "dry_run": true ہو: کچھ نہیں لکھا جاتا؛ ہر مسئلہ اپنے path اور حل بتانے والے جملے کے ساتھ واپس آتا ہے۔dry_run کے بغیر POST /submit/setup: فہرستیں، کنکشنز، فارمز اور آٹومیشنز ایک ساتھ لاگو ہوتے ہیں۔ کوئی بھی مسئلہ ہو تو کچھ نہیں لکھا جاتا۔POST /submit/forms/{key}/publish، یا setup دستاویز کے "publish" میں فارمز کے نام دیں۔GET /submit/forms/{key} انہیں واپس کرتا ہے)، پھر GET /submit/submissions پڑھیں یا webhook ایونٹس سنیں۔نیچے کی دستاویز setup.json کے طور پر محفوظ کریں اور اسے پوسٹ کریں۔ 61400000000 کی جگہ اپنا نمبر لگائیں۔ یہ میٹر ریڈنگ کا حل جانچتا ہے: سائٹس کی فہرست، بلنگ سسٹم سے کنکشن، تین اسٹیجز اور حساب شدہ usage والا ایک فارم، اور دو آٹومیشنز۔ لاگو کرنے کے لیے "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 یا ریفرنس سے پڑھنا، اپ ڈیٹ (اسٹیج، نوٹ، ترجیح، assignee، مقررہ وقت، ٹیگز، جوابات، اندرونی فیلڈز)، نوٹ شامل کرنا، بٹنوں کے ساتھ جواب دینا، فائل شامل کرنا، حذف۔POST /submit/automations/try، اور رن لاگ۔آپ کے اکاؤنٹ کے ہر webhook کو ہر ایونٹ ملتا ہے۔ ہر ایک میں submission اس لمحے کی حالت میں ہوتی ہے؛ اس میں فائلوں کے لنکس 7 دن تک کام کرتے ہیں۔
| ایونٹ | کب |
|---|---|
submission.created | submission موجود ہے (اس کی فائلیں ابھی پہنچ رہی ہو سکتی ہیں) |
submission.files_ready | اس کی فائلیں محفوظ ہو گئیں |
submission.updated | جوابات، اندرونی قدریں، ترجیح، ٹیگز یا مقررہ وقت بدلے |
submission.status_changed | اسٹیج بدل گیا |
submission.assigned | assignee بدل گیا |
submission.note_added | نوٹ لکھا گیا |
submission.customer_replied | شخص نے ٹیکسٹ، فائلیں یا فالو اپ شامل کیا، یا بٹن دبایا |
submission.deleted | حذف یا مٹا دی گئی |
submit.automation_failed | آٹومیشن نے اپنی دوبارہ کوششوں کے بعد ہار مان لی |
ہر route app2email کے hosted 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 اور مزید۔ اسسٹنٹ کو پہلا اچھا میسج: "Read the Submit-Info guide, then set up a problem report form with photos and a location, and tell my managers about urgent ones."
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 |
| ایک submission میں فائلیں | 60 |
| فائل کا سائز | WhatsApp سے 25 MB، ویب صفحے یا API سے 10 MB |
| نوٹ یا جواب | 4,000 حروف |
| submission پر ٹیگز | 20 |
| بیرونی سسٹمز کو کالز | فی نمبر 60 فی منٹ اور 2,000 فی دن؛ فی کال 15 سیکنڈ اور 256 KB |
| رن لاگ | 30 دن رکھا جاتا ہے |
اوپر کی ہر چیز ڈیش بورڈ کے Submit-Info صفحے (/dashboard/app/submit) پر سیٹ ہوتی ہے۔ سوالات: support@app2email.com۔