الدليل ديال Submit-Info: ابني استمارة من لائحة أسئلة، نشرها على WhatsApp وصفحة ويب، خدم الإرساليات عبر مراحل فصندوق وارد مشترك بأدوار، وأتمتة الردود والاتصال بأنظمتك، وسطّب كلشي عبر API أو وكيل AI.
كتكتب الاستمارة كلائحة بسيطة ديال الأسئلة. app2email كيحولها لاستمارة فـ WhatsApp وصفحة ويب بنفس الخطوات. الزبون، ولا عضو من الفريق ديالك اللي خدام ميدان، كيعمرها وكياخد مرجع. الأجوبة والملفات كيولّيو إرسالية فصندوق وارد مشترك، فين كتمشي فالمراحل ديالك وكتشغل الأتمتة ديالك.
فكرة وحدة
الاستمارة، من بعد الإرسالية، من بعد المراحل، من بعد الأتمتة، من بعد الروابط. طلب عرض ثمن، طلب تسجيل، قراءة العداد، تبليغ عن مشكل، خدمة مكملة، إثبات التسليم، ووصل مصاريف، كلهم هما نفس الشي بأسئلة مختلفة وأسامي مراحل مختلفة. كل واحد كيجي كقالب تقدر تسطّبو وتبدّلو.
ماكاين والو تبدّل لرقم ما حلّ Submit-Info عمرو. استمارة ما منشورة على WhatsApp بعد كتخدم: الكلمة ديالها كتجاوب برابط صفحة الويب.
الاستمارة فيها من 1 حتى 12 خطوة، والخطوة فيها عنوان ومن 1 حتى 12 سؤال. ماكاين canvas ولا رسم: نفس اللائحة كتدير الاستمارة فـ 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، صور، ولا ملفات office |
location | فين كاين الشخص | فـ WhatsApp طلب الموقع؛ فالويب زر وسطر للعنوان |
info | نص كتبيّنو | ماكيتطلبش ولا كيتخزن والو |
hidden | قيمة كتجي مع الرابط | بحال رقم خدمة؛ ماكيتبيّنش والو |
{contact.name}.صفحة الويب. نفس الخطوات فـ /form/your-code/form-key. كتطلب الاسم ورقم WhatsApp فآخر خطوة. من بعد الإرسال، الشخص كيشوف المرجع وكيقدر يدير "Get updates on WhatsApp"، اللي كيأكد رقمو بميساج وحدة؛ والاستمارة تقدر تتحدد باش تطلب هاد التأكيد. رابط شخصي (كتصيفطو إنت) كيعرف من الشخص من قبل. باش تحط الاستمارة فالموقع ديالك، استعمل السنيبيت تحت Share؛ إلا الاستمارة طلبات موقع، زيد allow="geolocation" فالـ iframe. الصور كتتصغر فالمتصفح قبل ما تتحمل؛ والملف يقدر يوصل لـ 10 MB.
من يقدر يصيفط. أي واحد (الاختيار العادي)، ولا غير الأرقام اللي تحط فاللائحة، ولا الكونتاكتات بعلامة ديالك. هادشي كيخلي الاستمارة مع خدام الميدان ديالك. كلمة status كتجاوب الشخص بمرحلة آخر إرساليات ديالو.
المراحل ديال الاستمارة. الاستمارة الجديدة كتبدا بـ New وIn progress وDone؛ سمّيهم بغيرها، زيد مراحلك (من 2 حتى 12)، واختار لون. كل مرحلة من ثلاث أنواع: مفتوحة، منتهية، ولا ملغاة.
الرد اللي يكتب برا وقت الرد ديال WhatsApp كيتحفظ وكيتصيفط ملي الشخص يكتب من جديد. Inbox كيقول ليك هادشي على الرد.
الـ Inbox كيبيّن Open وMine وUnassigned وDone وAll، مع العروض اللي تحفظها. قلّب وفلتر بالاستمارة، المرحلة، المعيّن، العلامة، القناة والتاريخ. ثلاث طرق للعرض: لائحة، جدول (استمارة وحدة: كل سؤال عمود)، ولوحة (استمارة وحدة: عمود لكل مرحلة). علّم بزاف ديال السطور باش تبدّل المرحلة، تعيّن، تعلّم، تصدّر ولا تمسح معا.
الإرسالية كتبيّن أجوبتها وملفاتها، فين صيفطات منها، وتاريخ وحدة فيه كاع اللي وقع ليها: تبديلات المراحل مع شكون ولماذا، الملاحظات، الردود فالجوج اتجاهات، الملفات، وكل خطوة أتمتة مع نتيجتها. فالآخر كتكتب ملاحظة داخلية ولا رد WhatsApp. صدّر أي عرض بـ CSV أو Excel أو JSON، ولإرسالية وحدة بـ PDF.
الفريق ديالك. دعي الناس بالإيميل للـ inbox بوحدو. كيخدمو بتطبيق خفيف ديالهم فـ /desk وما كيشوفو والو من الحساب ديالك. الدور هو مجموعة ابتدائية ديال القدرات، وكل قدرة تقدر تتحل ولا تتسد لشخص وحدو.
| الدور | كيبدا بـ |
|---|---|
| Owner، Admin | كلشي، بما فيه الاستمارات والأتمتة والروابط والفريق |
| Manager | الملاحظات، الردود، تعديل الأجوبة، تبديل المرحلة، التعيين، الملفات، التصدير، المسح، وتشغيل الإجراءات اليدوية |
| Agent | الملاحظات، الردود، تعديل الأجوبة، تبديل المرحلة، الملفات، وتشغيل الإجراءات اليدوية. يقدر ياخد إرسالية لنفسو |
| Viewer | كيقرا غير، ماكاين غيرو |
تقدر كذلك تضيّق اللي كيشوفو الشخص: غير بعض الاستمارات، غير اللي معيّن ليه (مع ولا بلا الإرساليات الخاوية باش ياخدها)، وإخفاء بيانات الاتصال. كل فعل ديال عضو فالفريق كيتكتب فتاريخ الإرسالية.
الصفحة ديال الشخص. كل إرسالية عندها صفحة خاصة فـ /s/a-long-code، بلا تسجيل دخول: المرحلة، الميساجات وتبديلات المراحل حتى الآن، سؤالك المفتوح مع أزرارو، و"Add information" ملي الاستمارة تسمح بذلك. الملاحظات الداخلية والحقول الداخلية ماكيكونوش فيها أبدا.
الخصوصية. ملي تمسح كونتاكت، كيتمسحو إرساليتو وملفاته. الاستمارة تقدر تعندها مدة حفظ، ومن بعدها كيتمسحو الإرساليات المسدودة.
الأتمتة كتتقرا بحال جملة: ملي شي حاجة تقع، إلا شي حاجات صحاح، دير هادي بالترتيب. "ملي تتصيفط Quote request، إلا كانت الكمية 20 ولا أكثر، عيّنها للـ Managers وصيفط إيميل للمالك."
| ملي | كيخدم ملي |
|---|---|
submitted | الإرسالية تكملات والملفات ديالها وصلو |
status_changed | المرحلة تبدلات (ممكن: لمراحل معينة ولا منها) |
assigned | الشخص اللي معيّنة ليه تبدل |
updated | الأجوبة ولا الحقول الداخلية تعدلو |
note_added | عضو فالفريق كتب ملاحظة |
file_added | ملف تزاد من بعد |
customer_replied | الشخص اللي صيفطها زاد نص ولا ملفات |
button | الشخص ضغط على زر من الردود ديالك |
overdue | بقات فنفس المرحلة شي عدد من الدقايق |
due | وقتها الداز وهي مفتوحة |
manual | عضو فالفريق ضغط زر الإجراء على الإرسالية |
إلا: قواعد على الأجوبة، والقيم المحسوبة، والمرحلة، والقناة، والعلامات، والمعيّن. القاعدة فيها حقل، عامل، وقيمة: 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 | صيفط استمارة متابعة؛ اللي كيرجع كيتزاد لهاد الإرسالية |
email | للمالك، للمعيّن، للشخص، ولا لأي عنوان، مع الملفات مرفقة |
notify | إيميل للمعيّن، لدور، ولا لكل الفريق |
http, openapi, mcp | عيّط على ربط وحفظ شي أجزاء من الجواب فحقول |
wait | تكمل من بعد، غير إلا بقاو الشروط صحاح |
stop | وقف هنا |
كل تشغيل كيتسجّل خطوة بخطوة: شنو تصيفط، شنو رجع، وشحال دار. "Try with a submission" كيشغّل أتمتة على إرسالية حقيقية بلا ما يبدل أو يصيفط والو. ملي نظام خارجي يفشل، كتتعاود المحاولة بعد دقيقة، و10 دقايق، وساعة؛ من بعد هاداك الأتمتة كتتعلم كفاشلة، وكيوصلو الـ 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 حقل داخلي كيعمّرو فريقك قبل ما ينقل الإرسالية لـ 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."
}
]
}الرابط هو نظام خارجي تقدر الأتمتة تعيّط عليه. الـ webhooks ديال الحساب ديالك ماكيحتاجوش والو: كيستقبلو كل حدث ديال الإرساليات كيوقع (شوف الأحداث). لباقي الحالات كاين ثلاث أنواع. "Test" على الرابط، و"Try with a submission" على الإجراء، كيبيّنو الطلب الحقيقي والجواب الحقيقي قبل ما يتشغل شي حاجة.
عنوان أساسي وطريقة للدخول (والو، token ديال bearer، header، اسم المستخدم وكلمة السر، ولا key فالعنوان). الإجراء كيسمّي الطريقة، المسار، وجسم 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 3 بصيغة JSON، ولا لصقها. 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) والـ token ديالو. 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 وعامة: العناوين الخاصة والمحلية والداخلية مرفوضة، وما كيتبعوش الـ redirects. الطلب ممكن ياخد 15 ثانية، والجواب ممكن يكون 256 KB. فـ save، المسار هو $ (الجواب كامل) ولا مسار بسيط بحال $.data.items[0].id.
كل نص وكل متغير ديال إجراء يقدر يستعمل متغيرات بين قوسين معوججين. الاسم اللي ماكيتعرفش كيبقى كيفما كتبتيه.
| المتغير | كيولي |
|---|---|
{<field key>} | الجواب على هداك السؤال (وكذلك الحقول الداخلية، والقيم المحسوبة، والقيم اللي الأتمتة حفظات) |
{reference} | المرجع، مثلا MR-7Q3M2A |
{form} {form_key} | سمية الاستمارة ومفتاحها |
{status} {status_name} | مفتاح المرحلة وسميتها |
{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: الإرسالية كاملة كـ object |
{= formula } | صيغة كتتحسب فالمكان، مثلا {= round(qty * 1.1, 2) } |
كتستعمل فالقيم المحسوبة، وفالإجراء calculate، وداخل {= ... } فأي نص. الصيغة كتخدم بالأرقام، والنصوص بين علامات الاقتباس الفردية، ومفاتيح أسئلتك. تقدر تكون طولها 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 key ديالك كـ Authorization: Bearer YOUR_API_KEY (header X-API-KEY مقبول كذلك). الـ key خاصو scope submissions:manage؛ الـ keys بـ Full access عندهم، والـ Default key ما عندوش. الـ sandbox keys ما يقدروش يكتبو.
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. الاستمارات، اللوائح، والروابط الموجودة بنفس المفتاح كتتبدل؛ والأتمتة كتتعرف بالسمية داخل الاستمارة. "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 للمزامنة؛ CSV بـ ?format=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 | أتمتة وقفات بعد المحاولات ديالها |
كل طريق هو كذلك أداة فـ سيرفر MCP المستضاف ديال app2email، باش مساعد يقدر يدير الإعداد كامل فمحادثة: 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"زيد على ربط المساعدين وأدوات الأتمتة: Automation tools and agents.
| الحد | القيمة |
|---|---|
| استمارات فكل رقم | 100 |
| خطوات فالاستمارة، أسئلة فالخطوة | 12 و12 (60 سؤال فالاستمارة، وسؤال موقع وحدة) |
| اللوائح | 50، كل وحدة حتى 1,000 سطر |
| الأتمتة، الروابط، أعضاء الفريق | 200، 30، 200 |
| الملفات فإرسالية وحدة | 60 |
| حجم الملف | 25 MB من WhatsApp، 10 MB من صفحة الويب ولا API |
| ملاحظة ولا رد | 4,000 حرف |
| العلامات فإرسالية | 20 |
| الطلبات لأنظمة خارجية | 60 فالدقيقة و2,000 فالنهار لكل رقم؛ 15 ثانية و256 KB لكل طلب |
| سجل التشغيل | كيتحفظ 30 يوم |
كاع اللي فوق كيتحدد فصفحة Submit-Info فلوحة التحكم (/dashboard/app/submit). الأسئلة: support@app2email.com.