app2email API মূল্য

ডকুমেন্টেশন

Submit-Info

Submit-Info-এর গাইড: প্রশ্নের তালিকা থেকে একটি ফর্ম বানান, সেটি WhatsApp ও একটি ওয়েব পেজে প্রকাশ করুন, ভূমিকাসহ একটি শেয়ার করা ইনবক্সে স্টেজ ধরে সাবমিশনগুলো নিষ্পত্তি করুন, উত্তর ও আপনার নিজের সিস্টেমের কলগুলো স্বয়ংক্রিয় করুন, এবং API বা একটি AI এজেন্টের মাধ্যমে সবকিছু সেট আপ করুন।

আপনি একটি ফর্ম লেখেন প্রশ্নের একটি সাধারণ তালিকা হিসেবে। app2email সেটিকে WhatsApp-এর ভেতরে একটি ফর্মে এবং একই ধাপের একটি ওয়েব পেজে রূপান্তর করে। একজন গ্রাহক, বা আপনার নিজের মাঠপর্যায়ের কর্মী, সেটি পূরণ করেন এবং একটি রেফারেন্স পান। উত্তর ও ফাইলগুলো একটি সাবমিশন হয়ে একটি শেয়ার করা ইনবক্সে যায়, যেখানে সেটি আপনার স্টেজগুলো ধরে এগোয় এবং আপনার অটোমেশন চালু করে।

একটি ধারণা

ফর্ম, তারপর সাবমিশন, তারপর স্টেজ, তারপর অটোমেশন, তারপর কানেকশন। একটি মূল্য-অনুরোধ, একটি আবেদন, একটি মিটার রিডিং, একটি সমস্যার প্রতিবেদন, একটি সম্পন্ন কাজ, একটি ডেলিভারির প্রমাণ এবং একটি খরচের রসিদ, সবই এক জিনিস, শুধু ভিন্ন প্রশ্ন ও ভিন্ন স্টেজের নাম নিয়ে। প্রতিটি একটি টেমপ্লেট হিসেবে আসে, যা আপনি ইনস্টল ও বদলাতে পারেন।

পাঁচ মিনিটে শুরু করুন

  1. খুলুন: আপনার ড্যাশবোর্ডে Submit-Info পেজটি খুলুন (/dashboard/app/submit, Integrations থেকেও খোলা যায়)। এটি চালু করুন।
  2. একটি ফর্ম বানান: "New form" বেছে নিন এবং একটি টেমপ্লেট বাছুন, অথবা খালি থেকে শুরু করুন। একটি নাম দিন এবং আপনার প্রশ্নগুলো লিখুন। প্রতিটি প্রশ্ন একটি সারি: তার লেখা, তার ধরন, এবং এর উত্তর দেওয়া বাধ্যতামূলক কি না।
  3. প্রকাশ করুন: "Publish to WhatsApp" ফর্মটি WhatsApp-এ আপলোড করে এবং সেটি চালু করে। একই ধাপের ওয়েব পেজটি সঙ্গে সঙ্গেই চালু হয়।
  4. শেয়ার করুন: Share-এর নিচে পাবেন সেই শব্দটি যা আপনার চ্যাটে ফর্মটি খোলে, একটি লিংক যা আপনার চ্যাটে ওই শব্দটি টাইপ করা অবস্থায় খোলে, ওয়েব পেজের ঠিকানা, একটি QR কোড, এবং আপনার নিজের ওয়েবসাইটে ফর্মটি বসানোর একটি স্নিপেট।
  5. ইনবক্স চালান: নতুন সাবমিশনগুলো Inbox-এ আসে। একটি খুলুন, তার স্টেজ বদলান, উত্তর দিন। প্রস্তুত হলে আপনার টিমকে আমন্ত্রণ জানান।

যে নম্বরে Submit-Info কখনো খোলা হয়নি, তার কিছু বদলায় না। যে ফর্ম এখনো WhatsApp-এ প্রকাশ হয়নি, সেটিও কাজ করে: তার শব্দটি ওয়েব পেজের লিংক দিয়ে উত্তর দেয়।

ফর্ম বিল্ডার

একটি ফর্মে থাকে 1 থেকে 12টি ধাপ, এবং একটি ধাপে থাকে একটি শিরোনাম ও 1 থেকে 12টি প্রশ্ন। এখানে কোনো ক্যানভাস নেই, আঁকার কিছু নেই: একই তালিকা WhatsApp-এর ফর্ম, ওয়েব পেজ, উত্তরের যাচাই, টেবিল ভিউয়ের কলাম, এক্সপোর্ট ও API চালায়। সম্পাদকের পাশের প্রিভিউ দেখায় ব্যক্তি ফর্মটি কীভাবে দেখেন।

ধরনব্যক্তি যা দেনআপনি যা সেট করতে পারেন
textএকটি ছোট উত্তরসবচেয়ে ছোট ও সবচেয়ে বড় দৈর্ঘ্য, একটি প্যাটার্ন
textareaএকটি দীর্ঘ উত্তরসবচেয়ে ছোট ও সবচেয়ে বড় দৈর্ঘ্য
numberএকটি সংখ্যাসবচেয়ে ছোট ও সবচেয়ে বড় মান, দশমিক, একটি একক যেমন kWh
emailএকটি ইমেইল ঠিকানা
phoneএকটি ফোন নম্বর
dateএকটি তারিখকত দিন আগে বা পরে হতে পারে
selectএকটি পছন্দপছন্দগুলো (2 থেকে 200), বা আপনার একটি তালিকা
multiselectএকাধিক পছন্দপছন্দগুলো (2 থেকে 20), সবচেয়ে কম ও সবচেয়ে বেশি কয়টি টিক দেওয়া যাবে
yesnoহ্যাঁ বা না
rating1 থেকে 3-10 পর্যন্ত একটি নম্বরসবচেয়ে বড় নম্বর
consentএকটি বাক্য যাতে সম্মতি দিতে হবেটিক দেওয়া বাধ্যতামূলক কি না
photoএক বা একাধিক ছবিকয়টি (1 থেকে 10); ক্যামেরা, গ্যালারি, বা যেকোনোটি
documentএক বা একাধিক ফাইলকয়টি (1 থেকে 10); যেকোনো ফাইল, PDF, ছবি বা অফিসের ফাইল
locationব্যক্তি কোথায় আছেনWhatsApp-এ লোকেশনের অনুরোধ; ওয়েবে একটি বাটন ও একটি ঠিকানার লাইন
infoআপনার দেখানো লেখাকিছু জিজ্ঞেস করা বা সংরক্ষণ করা হয় না
hiddenলিংকের সঙ্গে আসা একটি মানযেমন একটি কাজের নম্বর; কিছু দেখানো হয় না
  • সাহায্যের লেখা ও ডিফল্ট: প্রতিটি প্রশ্নের সঙ্গে একটি ছোট ইঙ্গিত ও একটি ডিফল্ট মান থাকতে পারে। ডিফল্ট মান এমন কিছু ব্যবহার করতে পারে যা আপনি ইতিমধ্যে জানেন, যেমন {contact.name}।
  • শুধু যখন দেখান: একটি ধাপ বা একটি প্রশ্ন আগের উত্তরের ওপর নির্ভর করতে পারে ("Problem হ্যাঁ হলেই এই ধাপ দেখান")। WhatsApp ও ওয়েব পেজ একই নিয়ম মানে।
  • অভ্যন্তরীণ ফিল্ড: যে ফিল্ড কখনো জিজ্ঞেস করা হয় না। আপনার টিম বা একটি অটোমেশন সেটি পূরণ করে: একটি মূল্যের অঙ্ক, একটি সিদ্ধান্তের কারণ, অন্য সিস্টেম থেকে ফেরত আসা একটি id। এগুলো শুধু ইনবক্স ও এক্সপোর্টে দেখা যায়।
  • তালিকা: একটি পছন্দের প্রশ্ন আপনার নিজের একটি তালিকা থেকে পছন্দ নিতে পারে (সাইট, কাজ, দামসহ প্রোডাক্ট)। ড্যাশবোর্ড বা API দিয়ে তালিকা বদলালে ফর্মও সঙ্গে সঙ্গে বদলায়, আবার প্রকাশ করার দরকার হয় না।
  • হিসাব করা মান: উত্তরের ওপর একটি সূত্র, তাৎক্ষণিক আনুমানিক হিসাব বা যাচাইয়ের জন্য। দেখুন সূত্র।
  • পাঠানোর পরে: পাঠানোর আগে একটি পর্যালোচনার পর্দা, রেফারেন্সসহ উত্তর, একটি "Add more" বাটন যা পরের মেসেজগুলো (লেখা, ছবি, ফাইল) দশ মিনিটের জন্য সাবমিশনে যুক্ত করে, এবং ব্যক্তির নিজের স্ট্যাটাস পেজের লিংক।
  • প্রকাশ: app2email আপনার জন্য WhatsApp-এর ফর্মটি লেখে, WhatsApp-এর সীমা দাবি করলে একটি দীর্ঘ ধাপ কয়েকটি পর্দায় ভাগ করে, এবং শেষ পাঁচটি প্রকাশিত সংস্করণ রাখে, যাতে পুরোনো মেসেজ যেটি দিয়ে পাঠানো হয়েছিল সেই ফর্মটিই খোলে।

ওয়েব পেজ। একই ধাপগুলো /form/your-code/form-key-এ। এটি শেষে নাম ও WhatsApp নম্বর চায়। পাঠানোর পরে ব্যক্তি রেফারেন্স দেখেন এবং "Get updates on WhatsApp"-এ ট্যাপ করতে পারেন, যা একটি মেসেজ দিয়ে তার নম্বর নিশ্চিত করে; একটি ফর্ম এটি বাধ্যতামূলক করতে পারে। একটি ব্যক্তিগত লিংক (আপনার পাঠানো) ইতিমধ্যে জানে ব্যক্তিটি কে। ফর্মটি আপনার নিজের সাইটে বসাতে Share-এর নিচের স্নিপেটটি ব্যবহার করুন; ফর্মটি লোকেশন চাইলে iframe-এ allow="geolocation" যোগ করুন। আপলোডের আগে ব্রাউজারেই ছবি ছোট করা হয়; একটি ফাইল 10 MB পর্যন্ত হতে পারে।

ব্যক্তিরা একটি ফর্মে কীভাবে পৌঁছান

  • একটি শব্দ: প্রতিটি ফর্মের নিজস্ব শব্দ আছে। form, forms, report ও submit শব্দগুলো (আপনি বদলাতে পারেন) একাধিক ফর্ম থাকলে আপনার ফর্মের একটি মেনু দেখায়। একটি শব্দ শুধু ছোট মেসেজে গণ্য হয়: যেখানে অন্য শব্দ 10টির কম (সেটিংস, "Ignore the words in long messages"), তাই দীর্ঘ মেসেজে শব্দটি থাকলেও কিছু শুরু হয় না।
  • একটি লিংক বা QR কোড: একটি লিংক যা আপনার WhatsApp চ্যাট ফর্মের শব্দসহ খোলে, অথবা ওয়েব পেজের ঠিকানা।
  • আপনার পাঠানো: Inbox-এর "Send form", অথবা API, একটি নম্বরে একটি ফর্ম পাঠায়, মানগুলো আগে থেকে পূরণ করা অবস্থায় (একটি কাজের নম্বর, একটি অ্যাকাউন্ট, আপনার দরকারি নথিগুলো)।
  • একটি ফলো-আপ: একটি অটোমেশন বা টিমের একজন সদস্য দ্বিতীয় একটি ফর্মের মাধ্যমে আরও কিছু চায়। যা ফেরত আসে তা প্রথম সাবমিশনের সঙ্গে যুক্ত হয়।
  • ওয়েব পেজ, এবং API, যেসব সিস্টেম আগে থেকেই তথ্য রাখে তাদের জন্য।

কারা পাঠাতে পারেন। যে কেউ (সাধারণত এটিই বেছে নেওয়া হয়), অথবা শুধু আপনার দেওয়া নম্বর বা আপনার একটি ট্যাগওয়ালা কন্টাক্ট। আপনার মাঠপর্যায়ের কর্মীদের সঙ্গে ফর্মটি এভাবেই থাকে। status শব্দটি ব্যক্তিকে তার সাম্প্রতিক সাবমিশনের স্টেজ জানায়।

স্টেজ

স্টেজ ফর্মের নিজের। নতুন ফর্ম শুরু হয় New, In progress ও Done দিয়ে; নাম বদলান, নিজের স্টেজ যোগ করুন (2 থেকে 12), এবং একটি রং বাছুন। প্রতিটি স্টেজ তিনটি ধরনের একটি: open, done বা cancelled।

  • কে বেছে নিতে পারবে: কোনো স্টেজ নির্দিষ্ট ভূমিকার জন্য রাখুন। একজন Agent প্রস্তুত করে, শুধু একজন Manager অনুমোদন দেয়।
  • নোট বাধ্যতামূলক: সাবমিশন সেখানে সরালে একটি কারণ চাওয়া হয় (বাতিল, প্রত্যাখ্যাত, প্রশ্নসাপেক্ষ)।
  • মেসেজ: সাবমিশন একটি স্টেজে পৌঁছালে ব্যক্তিকে পাঠানো একটি লেখা, প্লেসহোল্ডারসহ।
  • ব্যক্তির জন্য বাটন: একটি উত্তরে সর্বোচ্চ তিনটি বাটন থাকতে পারে (Accept, Decline, "Not fixed yet"), এবং প্রতিটি স্টেজ বদলায়। এই একটি জিনিসেই আপনি পান মূল্য-গ্রহণ, পরিদর্শন নিশ্চিত করা, এবং "ঠিক হয়েছে কি?"।

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", কিছু চালু করার আগে আসল অনুরোধ ও আসল উত্তর দেখায়।

HTTP অনুরোধ

একটি বেস ঠিকানা ও সাইন ইন করার একটি উপায় (কিছু না, একটি 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"
}

OpenAPI ডকুমেন্ট

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 সার্ভার

একটি 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')।

ডেভেলপার ও AI এজেন্টদের জন্য

উপরের সবকিছুই REST API-তে আছে /v1/{number}/submit-এর অধীনে, যেখানে {number} হলো দেশের কোডসহ আপনার WhatsApp নম্বর, শুধু সংখ্যা দিয়ে। আপনার API কী পাঠান Authorization: Bearer YOUR_API_KEY হিসেবে (X-API-KEY হেডারও গ্রহণযোগ্য)। কীটির স্কোপ লাগে submissions:manage; পূর্ণ অ্যাক্সেসের কীতে এটি থাকে, Default কীতে থাকে না। স্যান্ডবক্স কী লিখতে পারে না।

  1. GET /submit/guide: একটি JSON ডকুমেন্ট যাতে পুরো শব্দভাণ্ডার আছে: প্রশ্নের ধরন তাদের বিকল্প ও সীমাসহ, স্টেজের নিয়ম, ট্রিগার, অপারেটর, অ্যাকশন তাদের প্যারামিটারসহ, প্লেসহোল্ডার, সূত্রের ফাংশন, টেমপ্লেট, এবং কাজের উদাহরণ।
  2. POST /submit/setup "dry_run": true দিয়ে: কিছু লেখা হয় না; প্রতিটি সমস্যা তার পাথসহ ফেরত আসে, সঙ্গে কীভাবে ঠিক করবেন তার একটি বাক্য।
  3. POST /submit/setup dry_run ছাড়া: তালিকা, কানেকশন, ফর্ম ও অটোমেশন একসঙ্গে প্রয়োগ হয়। কোনো সমস্যা থাকলে কিছুই লেখা হয় না।
  4. POST /submit/forms/{key}/publish, অথবা সেটআপ ডকুমেন্টের "publish"-এ ফর্মের নাম দিন।
  5. ফর্মের লিংকগুলো শেয়ার করুন (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 ইভেন্ট

আপনার অ্যাকাউন্টের প্রতিটি 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-এর হোস্ট করা 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 দিন রাখা হয়

এখনো উপলব্ধ নয়

  • একটি সাবমিশনে পেমেন্ট নেওয়া (মূল্য গৃহীত হয়, পরিশোধিত হয় না)।
  • গত 24 ঘণ্টায় যিনি আপনাকে লেখেননি, এমন কাউকে WhatsApp ফর্ম হিসেবে ফর্ম পাঠানো: বদলে তার ব্যক্তিগত ওয়েব লিংক পাবেন, যেকোনো অনুমোদিত টেমপ্লেটে পাঠানোর জন্য।
  • স্বাক্ষর।
  • পুনরাবৃত্ত দল ("আরেকটি আইটেম যোগ করুন")।
  • ফর্মের মাঝখানে অন্য একটি ফর্মে যাওয়া।
  • কানেকশন ছাড়া একটি ফর্ম পূরণ করা।
  • ওয়েব পেজের স্থির লেখায় অন্য ভাষা (আপনার ফর্মের প্রতিটি লেখা আপনাকেই লিখতে হবে)।
  • YAML বা Swagger 2 OpenAPI ডকুমেন্ট, এবং শুধু পুরোনো SSE ট্রান্সপোর্ট বলে এমন MCP সার্ভার।
  • ছবি থেকে মান পড়া।

উপরের সবকিছু ড্যাশবোর্ডের Submit-Info পেজে (/dashboard/app/submit) সেট হয়। প্রশ্ন থাকলে: support@app2email.com।