app2email API قیمتیں

دستاویزات

Submit-Info

Submit-Info کی گائیڈ: سوالات کی فہرست سے فارم بنائیں، اسے WhatsApp اور ویب صفحے پر پبلش کریں، رولز کے ساتھ مشترکہ ان باکس میں submissions کو مرحلوں سے گزاریں، جوابات اور اپنے سسٹمز کو کالز خودکار بنائیں، اور سب کچھ API یا AI ایجنٹ سے سیٹ کریں۔

آپ فارم کو سوالات کی سادہ فہرست کے طور پر لکھتے ہیں۔ app2email اسے WhatsApp کے اندر ایک فارم اور انہی مرحلوں والے ویب صفحے میں بدل دیتا ہے۔ کسٹمر، یا آپ کے اپنے فیلڈ اسٹاف کا کوئی رکن، اسے بھرتا ہے اور اسے ایک ریفرنس ملتا ہے۔ جوابات اور فائلیں مشترکہ ان باکس میں ایک submission بن جاتی ہیں، جہاں وہ آپ کے اسٹیجز سے گزرتی ہے اور آپ کی آٹومیشنز کو چلاتی ہے۔

ایک خیال

فارم، پھر submission، پھر اسٹیجز، پھر آٹومیشنز، پھر کنکشنز۔ کوٹیشن کی درخواست، درخواست فارم، میٹر ریڈنگ، مسئلے کی رپورٹ، مکمل کیا گیا کام، ڈیلیوری کا ثبوت اور خرچ کی رسید سب ایک ہی چیز ہیں، صرف سوالات اور اسٹیج کے نام مختلف ہیں۔ ہر ایک ٹیمپلیٹ کے طور پر آتا ہے جسے آپ انسٹال کر کے بدل سکتے ہیں۔

پانچ منٹ میں شروع کریں

  1. اسے کھولیں: اپنے ڈیش بورڈ میں Submit-Info صفحہ کھولیں (/dashboard/app/submit، Integrations سے بھی کھلتا ہے)۔ اسے آن کریں۔
  2. فارم بنائیں: "New form" چنیں اور ٹیمپلیٹ چنیں، یا خالی سے شروع کریں۔ اسے نام دیں اور اپنے سوالات لکھیں۔ ہر سوال ایک قطار ہے: اس کا متن، اس کی قسم، اور یہ کہ اس کا جواب دینا لازمی ہے یا نہیں۔
  3. پبلش کریں: "Publish to WhatsApp" فارم کو WhatsApp پر اپ لوڈ کرتا ہے اور live کر دیتا ہے۔ انہی مرحلوں والا ویب صفحہ فوراً live ہو جاتا ہے۔
  4. شیئر کریں: Share کے تحت آپ کو وہ لفظ ملتا ہے جو آپ کی چیٹ میں فارم کھولتا ہے، ایک لنک جو وہ لفظ ٹائپ کیے ہوئے آپ کی چیٹ کھولتا ہے، ویب صفحے کا ایڈریس، ایک QR کوڈ، اور فارم کو اپنی ویب سائٹ پر لگانے کے لیے ایک snippet۔
  5. Inbox سنبھالیں: نئی submissions Inbox میں آتی ہیں۔ ایک کھولیں، اس کا اسٹیج بدلیں، جواب دیں۔ جب تیار ہوں تو اپنی ٹیم کو مدعو کریں۔

جو نمبر 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)، کم سے کم اور زیادہ سے زیادہ جتنے نشان لگائے جائیں
yesnoYes یا No
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 سے بدلیں اور فارم اس کے ساتھ چلتا ہے، دوبارہ پبلش کرنے کی ضرورت نہیں۔
  • حساب شدہ قدریں: جوابات پر فارمولا، فوری اندازے یا جانچ کے لیے۔ دیکھیں فارمولے۔
  • بھیجنے کے بعد: بھیجنے سے پہلے ایک review اسکرین، ریفرنس کے ساتھ جواب، ایک "Add more" بٹن جو اگلے میسجز (ٹیکسٹ، تصاویر، فائلیں) کو دس منٹ تک submission سے جوڑتا ہے، اور شخص کے اپنے اسٹیٹس صفحے کا لنک۔
  • پبلش کرنا: app2email آپ کے لیے WhatsApp فارم لکھتا ہے، جب WhatsApp کی حدود تقاضا کریں تو لمبے مرحلے کو کئی اسکرینز میں بانٹتا ہے، اور آخری پانچ پبلش کیے گئے ورژن رکھتا ہے تاکہ پرانا میسج اسی فارم کو کھولے جس کے ساتھ بھیجا گیا تھا۔

ویب صفحہ۔ وہی مرحلے /form/your-code/form-key پر۔ یہ نام اور WhatsApp نمبر آخر میں پوچھتا ہے۔ بھیجنے کے بعد شخص کو ریفرنس نظر آتا ہے اور وہ "Get updates on WhatsApp" ٹیپ کر سکتا ہے، جو ایک میسج سے ان کے نمبر کی تصدیق کرتا ہے؛ فارم کو اسے لازمی بنانے پر سیٹ کیا جا سکتا ہے۔ ذاتی لنک (جو آپ بھیجتے ہیں) پہلے سے جانتا ہے کہ شخص کون ہے۔ فارم کو اپنی سائٹ پر لگانے کے لیے Share کے تحت snippet استعمال کریں؛ اگر فارم لوکیشن مانگتا ہے تو iframe میں allow="geolocation" شامل کریں۔ تصاویر اپ لوڈ ہونے سے پہلے براؤزر میں چھوٹی کی جاتی ہیں؛ فائل 10 MB تک ہو سکتی ہے۔

لوگ فارم تک کیسے پہنچتے ہیں

  • ایک لفظ: ہر فارم کے اپنے الفاظ ہیں۔ الفاظ form، forms، report اور submit (آپ انہیں بدل سکتے ہیں) کئی فارمز ہونے پر آپ کے فارمز کو مینو کی صورت میں دکھاتے ہیں۔ لفظ صرف چھوٹے میسج میں شمار ہوتا ہے: جس میں 10 سے کم دوسرے الفاظ ہوں (Settings، "Ignore the words in long messages")، اس لیے جس لمبے میسج میں اتفاقاً وہ آ جائے وہ کچھ شروع نہیں کرتا۔
  • ایک لنک یا QR کوڈ: ایسا لنک جو فارم کے لفظ کے ساتھ آپ کی WhatsApp چیٹ کھولتا ہے، یا ویب صفحے کا ایڈریس۔
  • آپ کی طرف سے بھیجا گیا: Inbox میں "Send form"، یا API، فارم کو ایک نمبر پر پہلے سے بھری ہوئی قدروں کے ساتھ بھیجتا ہے (جاب نمبر، اکاؤنٹ، وہ دستاویزات جو آپ چاہتے ہیں)۔
  • فالو اپ: کوئی آٹومیشن یا ٹیم رکن دوسرے فارم سے مزید مانگتا ہے۔ جو واپس آتا ہے وہ پہلی submission سے جڑ جاتا ہے۔
  • ویب صفحہ، اور API ان سسٹمز کے لیے جن کے پاس ڈیٹا پہلے سے ہے۔

کون بھیج سکتا ہے۔ کوئی بھی (عام انتخاب)، یا صرف وہ نمبرز جو آپ درج کریں یا آپ کے ٹیگ والے کانٹیکٹس۔ اسی طرح فارم آپ کے فیلڈ اسٹاف تک رہتا ہے۔ لفظ status شخص کو اس کی حالیہ submissions کا اسٹیج بتاتا ہے۔

اسٹیجز

اسٹیجز فارم کے ہوتے ہیں۔ نیا فارم New، In progress اور Done سے شروع ہوتا ہے؛ انہیں نیا نام دیں، اپنے شامل کریں (2 سے 12)، اور رنگ چنیں۔ ہر اسٹیج تین میں سے ایک قسم کا ہے: open، done یا cancelled۔

  • اسے کون چن سکتا ہے: کوئی اسٹیج مخصوص رولز کے لیے رکھیں۔ Agent تیاری کرتا ہے، صرف Manager منظور کرتا ہے۔
  • نوٹ لازمی: جب submission وہاں منتقل ہو تو وجہ مانگیں (declined، rejected، queried)۔
  • میسج: ایک متن جو شخص کو بھیجا جاتا ہے جب اس کی submission اس اسٹیج پر پہنچے، placeholders کے ساتھ۔
  • شخص کے لیے بٹن: جواب میں تین بٹن تک ہو سکتے ہیں (Accept، Decline، "Not fixed yet")، اور ہر ایک اسٹیج بدلتا ہے۔ یہی ایک چیز آپ کو کوٹیشن کی قبولیت، وزٹ کی تصدیق اور "is it fixed?" دیتی ہے۔

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."

جبیہ کب چلتی ہے
submittedsubmission مکمل ہو اور اس کی فائلیں پہنچ گئی ہوں
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 سے جڑ جاتا ہے
emailowner، assignee، شخص، یا کسی بھی ایڈریس کو، فائلوں کے ساتھ
notifyassignee، کسی رول، یا ٹیم میں سب کو ای میل
http, openapi, mcpکنکشن کو کال کریں اور جواب کے حصے فیلڈز میں رکھیں
waitبعد میں جاری رکھیں، صرف تب جب شرائط اب بھی قائم ہوں
stopیہیں ختم کریں

ہر رن مرحلہ وار لاگ ہوتا ہے: کیا بھیجا گیا، کیا واپس آیا، کتنا وقت لگا۔ "Try with a submission" آٹومیشن کو کسی اصل submission کے خلاف چلاتا ہے بغیر کچھ بدلے یا بھیجے۔ باہر کے سسٹم کو ناکام کال 1 منٹ، 10 منٹ اور 1 گھنٹے بعد دوبارہ کی جاتی ہے؛ اس کے بعد آٹومیشن ناکام نشان زد ہوتی ہے اور آپ کے webhooks کو 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 ایک اندرونی فیلڈ ہے جسے آپ کی ٹیم 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."
    }
  ]
}

نسخہ 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."
    }
  ]
}

کنکشنز

کنکشن ایک بیرونی سسٹم ہے جسے آٹومیشن کال کر سکتی ہے۔ آپ کے اکاؤنٹ کے webhooks کو کسی کی ضرورت نہیں: وہ ہر submission ایونٹ ہوتے ہی وصول کرتے ہیں (دیکھیں ایونٹس)۔ باقی ہر چیز کے لیے تین قسمیں ہیں۔ کنکشن پر "Test" اور ایکشن پر "Try with a submission" کچھ بھی آن کرنے سے پہلے اصل درخواست اور اصل جواب دکھاتے ہیں۔

HTTP درخواست

ایک 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"
}

OpenAPI دستاویز

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 سرور

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 ہوتا ہے۔

Placeholders

ایکشن کا ہر متن اور ہر پیرامیٹر 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')۔

ڈیولپرز اور AI ایجنٹس کے لیے

اوپر کی ہر چیز REST API میں /v1/{number}/submit کے تحت ہے، جہاں {number} ملک کے کوڈ کے ساتھ آپ کا WhatsApp نمبر ہے، صرف ہندسے۔ اپنی API کلید Authorization: Bearer YOUR_API_KEY کے طور پر بھیجیں (X-API-KEY ہیڈر بھی قبول ہے)۔ کلید کو scope submissions:manage چاہیے؛ مکمل رسائی والی کلیدوں کے پاس یہ ہے، Default کلید کے پاس نہیں۔ Sandbox کلیدیں لکھ نہیں سکتیں۔

  1. GET /submit/guide: ایک JSON دستاویز جس میں پوری لغت ہے: سوالات کی اقسام ان کے آپشنز اور حدود کے ساتھ، اسٹیج کے اصول، triggers، operators، ایکشنز ان کے پیرامیٹرز کے ساتھ، placeholders، فارمولا فنکشنز، ٹیمپلیٹس، اور کام کی مثالیں۔
  2. POST /submit/setup جس میں "dry_run": true ہو: کچھ نہیں لکھا جاتا؛ ہر مسئلہ اپنے path اور حل بتانے والے جملے کے ساتھ واپس آتا ہے۔
  3. dry_run کے بغیر POST /submit/setup: فہرستیں، کنکشنز، فارمز اور آٹومیشنز ایک ساتھ لاگو ہوتے ہیں۔ کوئی بھی مسئلہ ہو تو کچھ نہیں لکھا جاتا۔
  4. POST /submit/forms/{key}/publish، یا setup دستاویز کے "publish" میں فارمز کے نام دیں۔
  5. فارم کے لنکس شیئر کریں (GET /submit/forms/{key} انہیں واپس کرتا ہے)، پھر GET /submit/submissions پڑھیں یا webhook ایونٹس سنیں۔

مکمل setup کال

نیچے کی دستاویز 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": []
}

دوسرے routes

  • Settings: GET / PUT /submit/settings۔
  • Forms: فہرست، بنانا (تعریف یا ٹیمپلیٹ سے)، پڑھنا، اپ ڈیٹ، حذف، پبلش، اور POST /submit/forms/{key}/send فارم کو بھری ہوئی قدروں کے ساتھ کسی نمبر کو بھیجنے کے لیے۔
  • Lists: PUT /submit/lists/{key} فہرست کی قطاریں بدل دیتا ہے۔
  • Submissions: فہرست (فارم، اسٹیج، assignee، ٹیگ، چینل، کانٹیکٹ، ٹیکسٹ اور تاریخوں سے فلٹر؛ سنک کے لیے updated_after؛ ?format=csv کے ساتھ CSV)، بنانا، id یا ریفرنس سے پڑھنا، اپ ڈیٹ (اسٹیج، نوٹ، ترجیح، assignee، مقررہ وقت، ٹیگز، جوابات، اندرونی فیلڈز)، نوٹ شامل کرنا، بٹنوں کے ساتھ جواب دینا، فائل شامل کرنا، حذف۔
  • آٹومیشنز اور رنز: فہرست، بنانا، پڑھنا، اپ ڈیٹ، حذف، POST /submit/automations/try، اور رن لاگ۔
  • Connections: فہرست، سیٹ، حذف، ٹیسٹ، ریفریش، اور وہ فنکشنز جنہیں ایکشن کال کر سکتا ہے۔
  • ٹیم اور رپورٹ: ارکان کو مدعو کرنا، اپ ڈیٹ اور ہٹانا؛ فارم، اسٹیج، دن اور assignee کے حساب سے شمار۔

Webhook ایونٹس

آپ کے اکاؤنٹ کے ہر webhook کو ہر ایونٹ ملتا ہے۔ ہر ایک میں submission اس لمحے کی حالت میں ہوتی ہے؛ اس میں فائلوں کے لنکس 7 دن تک کام کرتے ہیں۔

ایونٹکب
submission.createdsubmission موجود ہے (اس کی فائلیں ابھی پہنچ رہی ہو سکتی ہیں)
submission.files_readyاس کی فائلیں محفوظ ہو گئیں
submission.updatedجوابات، اندرونی قدریں، ترجیح، ٹیگز یا مقررہ وقت بدلے
submission.status_changedاسٹیج بدل گیا
submission.assignedassignee بدل گیا
submission.note_addedنوٹ لکھا گیا
submission.customer_repliedشخص نے ٹیکسٹ، فائلیں یا فالو اپ شامل کیا، یا بٹن دبایا
submission.deletedحذف یا مٹا دی گئی
submit.automation_failedآٹومیشن نے اپنی دوبارہ کوششوں کے بعد ہار مان لی

MCP ٹولز

ہر 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 دن رکھا جاتا ہے

ابھی دستیاب نہیں

  • submission پر ادائیگی لینا (کوٹیشن قبول کی جاتی ہے، ادا نہیں)۔
  • ایسے شخص کو WhatsApp فارم کے طور پر فارم بھیجنا جس نے پچھلے 24 گھنٹوں میں آپ کو نہیں لکھا: اس کے بجائے آپ کو ان کا ذاتی ویب لنک ملتا ہے، جسے کسی بھی منظور شدہ ٹیمپلیٹ سے بھیجا جا سکتا ہے۔
  • دستخط۔
  • دہرائے جانے والے گروپس ("add another item")۔
  • آدھے راستے میں کسی دوسرے فارم پر جانا۔
  • کنکشن کے بغیر فارم بھرنا۔
  • ویب صفحے کے مقررہ متن میں دوسری زبانیں (آپ کے فارم کا ہر متن آپ کے لکھنے کے لیے ہے)۔
  • YAML یا Swagger 2 میں OpenAPI دستاویزات، اور وہ MCP سرورز جو صرف پرانا SSE transport بولتے ہیں۔
  • تصاویر سے قدریں پڑھنا۔

اوپر کی ہر چیز ڈیش بورڈ کے Submit-Info صفحے (/dashboard/app/submit) پر سیٹ ہوتی ہے۔ سوالات: support@app2email.com۔