app2email API মূল্য

ডকুমেন্টেশন

সেটআপ ফাইল

একটি সেটআপ ফাইলে একটি ইন্টিগ্রেশনের পুরো সেটআপ একটি টেক্সট ফাইলে থাকে। ব্যাকআপ হিসেবে ডাউনলোড করুন, একসঙ্গে অনেক কিছু বদলান, একটি সেটআপ অন্য নম্বরে কপি করুন, বা একটি AI এজেন্টকে API বা MCP দিয়ে পুরো সেটআপ করতে দিন। প্রতিটি আপলোড আগে যাচাই হয় এবং ফিরিয়ে নেওয়া যায়।

একটি সেটআপ ফাইলে একটি ইন্টিগ্রেশনে আপনার সেট করা সবকিছু থাকে: Book-and-Pay-এর সেটিংস, সার্ভিস ও স্টাফ; Order-and-Pay-এর ক্যাটাগরি, অপশন ও প্রোডাক্ট; Tickets-and-Pay-এর ইভেন্ট, তারিখ ও টিকিটের ধরন; এবং Submit-Info-এর ফর্ম ও অটোমেশন। এটি একটি টেক্সট ফাইল, তাই একে ব্যাকআপ হিসেবে রাখা যায়, যেকোনো এডিটরে বদলানো যায়, আবার আপলোড করা যায়, অথবা আপনার অন্য কোনো নম্বরে কপি করা যায়।

একই ফাইল তিন জায়গায় কাজ করে: ড্যাশবোর্ডে, API-তে, এবং AI এজেন্টের জন্য MCP সার্ভারে।

ড্যাশবোর্ডে

প্রতিটি ইন্টিগ্রেশনে একটি Setup file বিভাগ আছে:

ইন্টিগ্রেশনকোথায়
Book-and-PayOverview ট্যাবের একেবারে নিচে
Order-and-PayImport & export ট্যাবের একেবারে নিচে
Tickets-and-PaySettings ট্যাবের একেবারে নিচে
Submit-InfoSettings ট্যাবের একেবারে নিচে

শুধু কোনো নম্বরের মালিক ও অ্যাডমিনরা এটি দেখতে পান।

  1. 1. ডাউনলোড

    Download দিলে সেটআপটি একটি .a2e.jsonl ফাইলে পাওয়া যায়। Download with pictures দিলে পাওয়া যায় একটি .zip, যার ভেতরে একই ফাইল ও প্রতিটি ছবি থাকে: এটি একটি সম্পূর্ণ অফলাইন ব্যাকআপ, যা আবার এভাবেই আপলোড করা যায়।

  2. 2. বদলান

    ফাইলটি একটি টেক্সট এডিটরে খুলে লাইন বদলান, যোগ করুন বা মুছুন। প্রতিটি লাইন একটি জিনিস: একটি সার্ভিস, একটি প্রোডাক্ট, একটি ইভেন্ট। স্প্রেডশিটের দরকার নেই।

  3. 3. আপলোড

    Upload a file দিলে ফাইলটি আগে যাচাই হয়। তখনও কিছু বদলায় না। প্রতিটি সমস্যা তার লাইন নম্বর ও কীভাবে ঠিক করবেন সেটিসহ দেখা যায়, অথবা প্রয়োগ করলে কী হবে তা দেখা যায়: কতগুলো জিনিস নতুন, বদলানো বা মুছে ফেলা হবে, এবং কোনগুলো।

  4. 4. প্রয়োগ

    Apply ঠিক সেই পরিবর্তনগুলোই করে, যা যাচাইয়ে দেখানো হয়েছিল। একটি যাচাই 1 ঘণ্টা পর্যন্ত বৈধ থাকে।

  5. 5. ফিরিয়ে নিন

    প্রতিটি প্রয়োগ Recent changes by setup file-এর অধীনে তালিকাভুক্ত হয়। Undo দিলে সেই প্রয়োগের বদলানো সবকিছু আগের অবস্থায় ফিরে যায়, 30 দিনের মধ্যে, যতক্ষণ না পরের কোনো প্রয়োগ একই ইন্টিগ্রেশন বদলেছে। পরেরটি আগে ফিরিয়ে নিন।

যোগ ও বদল, অথবা ফাইলের হুবহু মতো করা

আপলোডের আগে ঠিক করুন ফাইলে যা নেই তার কী হবে:

  • যোগ ও বদল (ডিফল্ট): ফাইলের লাইনগুলো তৈরি বা বদলানো হয়, বাকি সবকিছু যেমন আছে তেমনই থাকে। মাত্র পাঁচটি লাইনের একটি ফাইল শুধু সেই পাঁচটি জিনিসই বদলায়।
  • ফাইলের হুবহু মতো করুন: একই ধরনের যা কিছু ফাইলে নেই, সেগুলো মুছে ফেলা হয়। একটি প্রোডাক্ট মোছা হয় না, শুধু archive করা হয়। প্রয়োগ করার আগে যাচাইয়ে প্রতিটি মুছে ফেলার তালিকা দেখানো হয়।

অন্য নম্বরে কপি করুন

যদি আপনি একাধিক নম্বরের মালিক বা অ্যাডমিন হন, Copy to another number দিয়ে আপনি যে নম্বরে আছেন সেখান থেকে একটি ইন্টিগ্রেশনের সেটআপ অন্য একটি নম্বরে কপি করতে পারেন: দ্বিতীয় শাখা, একটি টেস্ট নম্বর, অথবা প্রতিটি নতুন দোকানের জন্য একটি টেমপ্লেট।

কপিটি আগে অন্য নম্বরে যাচাই হয় এবং দেখায় সেখানে কী বদলাবে। Copy now দিলে তা প্রয়োগ হয়। ছবিগুলোও সঙ্গে যায়। কপি ফিরিয়ে নিতে হলে অন্য নম্বরে একই ইন্টিগ্রেশন খুলুন: কপিটি সেখানে Recent changes-এর অধীনে দেখা যাবে।

Note

Book-and-Pay, Order-and-Pay ও Tickets-and-Pay-এর ওয়েব ঠিকানা শুধু একটি নম্বরের হয় এবং কখনোই কপি হয় না। অন্য নম্বরের ঠিকানা তার নিজের ড্যাশবোর্ডে সেট করুন।

সেটআপ ফাইলে কী থাকে

ইন্টিগ্রেশনলাইন
Book-and-Paybooking.settings (প্রতিটি বিভাগের জন্য একটি লাইন: সময়, ওয়েব, ব্র্যান্ড, মেসেজ ...), booking.service, booking.provider (স্টাফ)
Order-and-Payshop.settings (প্রতিটি বিভাগের জন্য একটি লাইন, অর্ডার পেজের চেহারাসহ), shop.category, shop.option_group, shop.item (ভেরিয়েন্ট ও ছবিসহ)
Tickets-and-Paytickets.settings (প্রতিটি বিভাগের জন্য একটি লাইন; wa_templates হলো WhatsApp মেসেজের আপনার নিজের লেখা), tickets.chart (সংরক্ষিত সিট প্ল্যান), tickets.event (তারিখ, টিকিটের ধরন, যৌথ সীমা, ছবি ও সিট প্ল্যানসহ), tickets.promo
Submit-Infosubmit.settings, submit.list, submit.connection, submit.form, submit.automation
সবasset: একটি ছবি, যার নাম দেওয়া হয় সেটি ব্যবহার করা লাইনগুলো দিয়ে

ফাইলে কখনো থাকে না

  • গোপন তথ্য: পেমেন্টের কী, সংযোগের পাসওয়ার্ড ও টোকেন। সংরক্ষিত গোপন তথ্য যেমন আছে তেমনই থাকে।
  • কোনো ইন্টিগ্রেশন চালু করা। ফাইল এটি কখনো করে না, এবং ফাইল কখনো টিকিটওয়ালা ইভেন্ট প্রকাশ, বাতিল বা মুছে ফেলে না।
  • গ্রাহকরা যা করেছেন: বুকিং, অর্ডার, বিক্রি হওয়া টিকিট, জমা দেওয়া তথ্য, গ্রাহক, পেমেন্ট।
  • টিম সদস্য ও স্টাফের লগইন।
  • Order-and-Pay-এর স্টকের সংখ্যা, যদি না আপনি Also set the stock figures from the file টিক দেন। এটি ছাড়া সকালে এক্সপোর্ট করা ফাইল দিয়ে দিনের বিক্রি ফিরিয়ে নেওয়া যায় না।

ফরম্যাট

একটি সেটআপ ফাইল হলো 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-তে ফিট করানো হয়।

AI এজেন্ট ও API-এর জন্য

একটি এজেন্ট কয়েক ডজন কলের বদলে এক ধাপে, যাচাই করা অবস্থায়, পুরো একটি ইন্টিগ্রেশন সেট আপ করতে পারে। 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। একটি স্যান্ডবক্স কী এক্সপোর্ট ও যাচাই করতে পারে, কিন্তু প্রয়োগ করতে পারে না।

Tip

এজেন্টের সাধারণ ধাপ: গাইড পড়ুন, বর্তমান ফাইল এক্সপোর্ট করুন, কয়েকটি লাইন বদলান, যাচাই করুন, যাচাইয়ে যা ধরা পড়ে তা ঠিক করুন, তারপর check_id প্রয়োগ করার আগে ব্যবহারকারীর কাছে জিজ্ঞেস করুন।

সীমা

কীসীমা
একটি ফাইল20 MB টেক্সট, 50,000 লাইন (ড্যাশবোর্ডে আপলোড সর্বোচ্চ 19 MB)
ছবিসহ একটি অনুরোধAPI-তে 60 MB
একটি ছবি5 MB
ঠিকানা থেকে আনা ছবিপ্রতি আপলোডে 100টি; Order-and-Pay প্রোডাক্টের ছবি পটভূমিতে কয়েক মিনিটের মধ্যে আনে
বড় ফাইল1,000-এর বেশি রেকর্ড পটভূমিতে যাচাই ও প্রয়োগ হয়; ড্যাশবোর্ড নিজে থেকেই অপেক্ষা করে
একটি যাচাই1 ঘণ্টার মধ্যে একবার প্রয়োগ করা যায়
ফিরিয়ে নেওয়া30 দিন