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"। অভ্যন্তরীণ নোট ও অভ্যন্তরীণ ফিল্ড সেখানে কখনো থাকে না।
গোপনীয়তা। একটি কন্টাক্ট মুছলে তার সাবমিশন ও ফাইলও মুছে যায়। একটি ফর্মের একটি রাখার সময়সীমা থাকতে পারে, যার পরে বন্ধ হওয়া সাবমিশনগুলো মুছে যায়।
একটি অটোমেশন একটি বাক্যের মতো পড়া যায়: যখন কিছু ঘটে, যদি কিছু সত্য হয়, তখন এগুলো ক্রমানুসারে করা হয়। "যখন একটি Quote request জমা হয়, যদি quantity 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" একটি বাস্তব সাবমিশনে অটোমেশন চালায়, কিন্তু কিছু বদলায় বা পাঠায় না। বাইরের কোনো সিস্টেমের কল ব্যর্থ হলে 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 টোকেন, একটি হেডার, ব্যবহারকারীর নাম ও পাসওয়ার্ড, বা ঠিকানায় একটি 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"
}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')।
উপরের সবকিছুই REST API-তে আছে /v1/{number}/submit-এর অধীনে, যেখানে {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-এর জায়গায় আপনার নম্বর বসান। এটি একটি মিটার রিডিং সমাধান যাচাই করে: সাইটের একটি তালিকা, একটি বিলিং সিস্টেমের সংযোগ, তিনটি স্টেজসহ একটি ফর্ম এবং একটি হিসাব করা 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 বা রেফারেন্স দিয়ে পড়া, হালনাগাদ (স্টেজ, নোট, অগ্রাধিকার, দায়িত্বপ্রাপ্ত ব্যক্তি, নির্ধারিত সময়, ট্যাগ, উত্তর, অভ্যন্তরীণ ফিল্ড), একটি নোট যোগ, বাটনসহ উত্তর, একটি ফাইল যোগ, মোছা।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।