একটি সেটআপ ফাইলে একটি ইন্টিগ্রেশনের পুরো সেটআপ একটি টেক্সট ফাইলে থাকে। ব্যাকআপ হিসেবে ডাউনলোড করুন, একসঙ্গে অনেক কিছু বদলান, একটি সেটআপ অন্য নম্বরে কপি করুন, বা একটি AI এজেন্টকে API বা MCP দিয়ে পুরো সেটআপ করতে দিন। প্রতিটি আপলোড আগে যাচাই হয় এবং ফিরিয়ে নেওয়া যায়।
একটি সেটআপ ফাইলে একটি ইন্টিগ্রেশনে আপনার সেট করা সবকিছু থাকে: Book-and-Pay-এর সেটিংস, সার্ভিস ও স্টাফ; Order-and-Pay-এর ক্যাটাগরি, অপশন ও প্রোডাক্ট; Tickets-and-Pay-এর ইভেন্ট, তারিখ ও টিকিটের ধরন; এবং Submit-Info-এর ফর্ম ও অটোমেশন। এটি একটি টেক্সট ফাইল, তাই একে ব্যাকআপ হিসেবে রাখা যায়, যেকোনো এডিটরে বদলানো যায়, আবার আপলোড করা যায়, অথবা আপনার অন্য কোনো নম্বরে কপি করা যায়।
একই ফাইল তিন জায়গায় কাজ করে: ড্যাশবোর্ডে, API-তে, এবং AI এজেন্টের জন্য MCP সার্ভারে।
প্রতিটি ইন্টিগ্রেশনে একটি Setup file বিভাগ আছে:
| ইন্টিগ্রেশন | কোথায় |
|---|---|
| Book-and-Pay | Overview ট্যাবের একেবারে নিচে |
| Order-and-Pay | Import & export ট্যাবের একেবারে নিচে |
| Tickets-and-Pay | Settings ট্যাবের একেবারে নিচে |
| Submit-Info | Settings ট্যাবের একেবারে নিচে |
শুধু কোনো নম্বরের মালিক ও অ্যাডমিনরা এটি দেখতে পান।
Download দিলে সেটআপটি একটি .a2e.jsonl ফাইলে পাওয়া যায়। Download with pictures দিলে পাওয়া যায় একটি .zip, যার ভেতরে একই ফাইল ও প্রতিটি ছবি থাকে: এটি একটি সম্পূর্ণ অফলাইন ব্যাকআপ, যা আবার এভাবেই আপলোড করা যায়।
ফাইলটি একটি টেক্সট এডিটরে খুলে লাইন বদলান, যোগ করুন বা মুছুন। প্রতিটি লাইন একটি জিনিস: একটি সার্ভিস, একটি প্রোডাক্ট, একটি ইভেন্ট। স্প্রেডশিটের দরকার নেই।
Upload a file দিলে ফাইলটি আগে যাচাই হয়। তখনও কিছু বদলায় না। প্রতিটি সমস্যা তার লাইন নম্বর ও কীভাবে ঠিক করবেন সেটিসহ দেখা যায়, অথবা প্রয়োগ করলে কী হবে তা দেখা যায়: কতগুলো জিনিস নতুন, বদলানো বা মুছে ফেলা হবে, এবং কোনগুলো।
Apply ঠিক সেই পরিবর্তনগুলোই করে, যা যাচাইয়ে দেখানো হয়েছিল। একটি যাচাই 1 ঘণ্টা পর্যন্ত বৈধ থাকে।
প্রতিটি প্রয়োগ Recent changes by setup file-এর অধীনে তালিকাভুক্ত হয়। Undo দিলে সেই প্রয়োগের বদলানো সবকিছু আগের অবস্থায় ফিরে যায়, 30 দিনের মধ্যে, যতক্ষণ না পরের কোনো প্রয়োগ একই ইন্টিগ্রেশন বদলেছে। পরেরটি আগে ফিরিয়ে নিন।
আপলোডের আগে ঠিক করুন ফাইলে যা নেই তার কী হবে:
যদি আপনি একাধিক নম্বরের মালিক বা অ্যাডমিন হন, Copy to another number দিয়ে আপনি যে নম্বরে আছেন সেখান থেকে একটি ইন্টিগ্রেশনের সেটআপ অন্য একটি নম্বরে কপি করতে পারেন: দ্বিতীয় শাখা, একটি টেস্ট নম্বর, অথবা প্রতিটি নতুন দোকানের জন্য একটি টেমপ্লেট।
কপিটি আগে অন্য নম্বরে যাচাই হয় এবং দেখায় সেখানে কী বদলাবে। Copy now দিলে তা প্রয়োগ হয়। ছবিগুলোও সঙ্গে যায়। কপি ফিরিয়ে নিতে হলে অন্য নম্বরে একই ইন্টিগ্রেশন খুলুন: কপিটি সেখানে Recent changes-এর অধীনে দেখা যাবে।
Book-and-Pay, Order-and-Pay ও Tickets-and-Pay-এর ওয়েব ঠিকানা শুধু একটি নম্বরের হয় এবং কখনোই কপি হয় না। অন্য নম্বরের ঠিকানা তার নিজের ড্যাশবোর্ডে সেট করুন।
| ইন্টিগ্রেশন | লাইন |
|---|---|
| Book-and-Pay | booking.settings (প্রতিটি বিভাগের জন্য একটি লাইন: সময়, ওয়েব, ব্র্যান্ড, মেসেজ ...), booking.service, booking.provider (স্টাফ) |
| Order-and-Pay | shop.settings (প্রতিটি বিভাগের জন্য একটি লাইন, অর্ডার পেজের চেহারাসহ), shop.category, shop.option_group, shop.item (ভেরিয়েন্ট ও ছবিসহ) |
| Tickets-and-Pay | tickets.settings (প্রতিটি বিভাগের জন্য একটি লাইন; wa_templates হলো WhatsApp মেসেজের আপনার নিজের লেখা), tickets.chart (সংরক্ষিত সিট প্ল্যান), tickets.event (তারিখ, টিকিটের ধরন, যৌথ সীমা, ছবি ও সিট প্ল্যানসহ), tickets.promo |
| Submit-Info | submit.settings, submit.list, submit.connection, submit.form, submit.automation |
| সব | asset: একটি ছবি, যার নাম দেওয়া হয় সেটি ব্যবহার করা লাইনগুলো দিয়ে |
ফাইলে কখনো থাকে না
একটি সেটআপ ফাইল হলো JSON Lines: প্রতি লাইনে একটি JSON অবজেক্ট। প্রথম লাইনে বলা থাকে ফাইলটি কী ধরনের; বাকি প্রতিটি লাইন একটি রেকর্ড, যার একটি type ও একটি key আছে। ওই key দিয়ে পরের বার একই রেকর্ডটি খুঁজে পাওয়া যায়: একটি সার্ভিসের id, একটি প্রোডাক্টের SKU, একটি ইভেন্টের ঠিকানা।
{"type":"a2e.setup","version":1,"products":["booking"]}
{"type":"booking.service","key":"haircut","name":"Haircut","duration_min":30,"price":"$25","price_amount":25}
{"type":"booking.service","key":"beard","name":"Beard trim","duration_min":15,"price":"$12","price_amount":12}
{"type":"booking.provider","key":"sam","name":"Sam","services":["haircut","beard"]}লাইনের ক্রম গুরুত্বপূর্ণ নয়। Book-and-Pay-এর দাম হলো পরিমাণ (25 মানে 25.00, price হলো পাশে দেখানো লেবেল); Order-and-Pay ও Tickets-and-Pay-এর দাম মুদ্রার সবচেয়ে ছোট একক দিয়ে লেখা হয় (1250 মানে 12.50)। প্রতিটি লাইনের সঠিক ফিল্ডগুলো API-এর গাইডে আছে (GET /v1/{number}/setup/guide)।
একটি রেকর্ড কোনো ছবিকে তার asset লাইনের key দিয়ে উল্লেখ করে। ছবিটি নিম্নের যেকোনো একটি থেকে আসে:
url: একটি https:// ঠিকানা, যা আমরা আনি।data: ছবিটি নিজেই, base64 আকারে।file: আপলোড করা .zip-এর ভেতরের একটি পথ।sha256: এই নম্বরে আগে থেকেই থাকা একটি ছবি।এক্সপোর্টে প্রতিটি ছবির পাবলিক ঠিকানা লেখা হয়। যে ছবির পাবলিক ঠিকানা নেই, যেমন সিট প্ল্যানের পেছনের ফ্লোর ছবি, তার জন্য একটি সাইন করা লিংক দেওয়া হয় যা 7 দিন কাজ করে, যাতে অন্য নম্বরে কপি করা ফাইলও ছবিটি সঙ্গে রাখে।
{"type":"asset","key":"classic-photo","url":"https://example.com/classic.jpg"}
{"type":"shop.item","key":"BURGER-CLASSIC","name":"Classic burger","category":"burgers","price":1250,"images":["classic-photo"]}ছবি হতে হবে PNG, JPEG বা WEBP, প্রতিটি সর্বোচ্চ 5 MB। যেখানে দরকার, ছবিটি ছোট করা হয় বা JPEG-এ বদলানো হয়: Book-and-Pay-এর লোগো 300 KB-তে, Tickets-and-Pay-এর ছবি 1 MB-তে ফিট করানো হয়।
একটি এজেন্ট কয়েক ডজন কলের বদলে এক ধাপে, যাচাই করা অবস্থায়, পুরো একটি ইন্টিগ্রেশন সেট আপ করতে পারে। MCP সার্ভার https://api.app2email.com/mcp/setup-এর টুলগুলো হলো: get_setup_guide, export_setup, check_setup, apply_setup, upload_setup_asset, list_setup_jobs, get_setup_job ও undo_setup। একই কলগুলো আছে API-তে:
| কল | এটি কী করে |
|---|---|
GET /v1/{number}/setup/guide | প্রতিটি রেকর্ডের ধরন, তার ফিল্ড ও সীমা, উদাহরণসহ। এজেন্ট আগে এটি পড়ে |
GET /v1/{number}/setup/export | বর্তমান ফাইল: format=jsonl, zip বা json |
POST /v1/{number}/setup/check | একটি ফাইল যাচাই করে, কিছু বদলায় না: লাইন অনুযায়ী সমস্যা, পরিকল্পনা, একটি check_id |
POST /v1/{number}/setup/apply | একটি যাচাই প্রয়োগ করে: {"check_id": 123} |
POST /v1/{number}/setup/assets | একটি ছবি 7 দিনের জন্য রাখে এবং তার sha256 ফেরত দেয় |
GET /v1/{number}/setup/jobs | সর্বশেষ যাচাই, প্রয়োগ ও ফিরিয়ে নেওয়াগুলো |
POST /v1/{number}/setup/jobs/{id}/undo | একটি প্রয়োগ যা বদলেছিল তা আগের অবস্থায় ফেরায় |
কীটির ইন্টিগ্রেশনের নিজস্ব অনুমতি লাগে: bookings:manage, orders:manage, tickets:manage বা submissions:manage। একটি স্যান্ডবক্স কী এক্সপোর্ট ও যাচাই করতে পারে, কিন্তু প্রয়োগ করতে পারে না।
এজেন্টের সাধারণ ধাপ: গাইড পড়ুন, বর্তমান ফাইল এক্সপোর্ট করুন, কয়েকটি লাইন বদলান, যাচাই করুন, যাচাইয়ে যা ধরা পড়ে তা ঠিক করুন, তারপর check_id প্রয়োগ করার আগে ব্যবহারকারীর কাছে জিজ্ঞেস করুন।
| কী | সীমা |
|---|---|
| একটি ফাইল | 20 MB টেক্সট, 50,000 লাইন (ড্যাশবোর্ডে আপলোড সর্বোচ্চ 19 MB) |
| ছবিসহ একটি অনুরোধ | API-তে 60 MB |
| একটি ছবি | 5 MB |
| ঠিকানা থেকে আনা ছবি | প্রতি আপলোডে 100টি; Order-and-Pay প্রোডাক্টের ছবি পটভূমিতে কয়েক মিনিটের মধ্যে আনে |
| বড় ফাইল | 1,000-এর বেশি রেকর্ড পটভূমিতে যাচাই ও প্রয়োগ হয়; ড্যাশবোর্ড নিজে থেকেই অপেক্ষা করে |
| একটি যাচাই | 1 ঘণ্টার মধ্যে একবার প্রয়োগ করা যায় |
| ফিরিয়ে নেওয়া | 30 দিন |