অ্যাকাউন্ট ও ইন্টিগ্রেশন
বাহ্যিক সিস্টেম বা সহকারী সংযুক্ত করুন
Pro বা Agency-তে সীমিত অনুমতির কী তৈরি করুন, নতুন কনটেন্ট প্রকাশ করুন বা সহকারী সংযুক্ত করুন।
শুরু করার আগে
Webhook WhatsApp সেবা থেকে আগত মেসেজের বিজ্ঞপ্তি পায়। সার্ভারের সেটআপ ইন্টিগ্রেশনের পরিচালনাকারীর দায়িত্ব। প্যানেলের ব্যবহারকারীকে সার্ভার সেটিংস বদলাতে হয় না। MCP সহকারীকে অ্যাকাউন্টের টুল চাওয়ার সুযোগ দেয়।
কী করবেন
- আগত মেসেজের জন্য সেটিংস খুলে Webhook URL খুঁজুন।
- অ্যাকাউন্টের স্থাপনার সঠিক ঠিকানা পেতে কপি করুন বেছে নিন।
- ওই ঠিকানায় কাঙ্ক্ষিত ডিভাইসের আগত ঘটনা কনফিগার করতে পরিচালনাকারীকে বলুন।
- পরিচালনাকারী প্রস্তুতি নিশ্চিত করলে নিজের নম্বর থেকে একটি আগত পরীক্ষামূলক মেসেজের ব্যবস্থা করুন।
- প্রত্যাশিত ফলাফল দেখুন, যেমন মিলে যাওয়া স্বয়ংক্রিয় উত্তর বা লগ চালু থাকলে নতুন রেকর্ড হওয়া গ্রুপ মেসেজ।
- সহকারী সংযোগের জন্য MCP ক্লায়েন্টের খোলা অনুমোদন পর্দা দিয়ে সাইন ইন করুন।
- প্রবেশের অনুমতি দেওয়ার আগে নাম দেওয়া অ্যাপ ও অ্যাকাউন্ট দেখুন।
- বাহ্যিক সিস্টেম থেকে পাঠানোর জন্য সেটিংস → বাহ্যিক সংযোগ খুলুন। একটি সংযুক্ত অ্যাকাউন্ট ও নির্দিষ্টভাবে নির্বাচিত গ্রুপের জন্য নামসহ কী তৈরি করুন। কী সঙ্গে সঙ্গে সংরক্ষণ করুন; এটি শুধু একবার দেখানো হয়। API-এর মূল URL কপি করুন।
- উদাহরণ: America/Sao_Paulo-তে প্রতিদিন প্রকাশের আটটি সময়ের প্রত্যেকটিতে নতুন কনটেন্ট তৈরির জন্য Abacus.AI সেট করুন। প্রতিটি প্রকাশনা নতুন Idempotency-Key দিয়ে তিনটি অনুমোদিত গ্রুপে পাঠান। কেবল হুবহু একই অনুরোধ আবার করার সময় কী পুনরায় ব্যবহার করুন।
- সঙ্গে সঙ্গে সারিতে যোগ করতে scheduled_at বাদ দিন, অথবা পরবর্তী 30 দিন পর্যন্ত -03:00 বা Z (UTC) সহ নির্দিষ্ট তারিখ ও সময় দিন। প্রসেসর প্রতি মিনিটে পরীক্ষা করে; scheduled_at হলো প্রথম উপযুক্ত সময়, ঠিক সেই সেকেন্ডে পৌঁছানোর নিশ্চয়তা নেই।
- আবার চেষ্টা করার আগে কাজের অবস্থা ও প্রতিটি গ্রুপের ফলাফল দেখুন। কেবল এখনও পাঠানো শুরু হয়নি এমন পাঠানো বাতিল করুন। ফাঁস হওয়া কী সেটিংসে বাতিল করুন, তারপর নতুন কী তৈরি করে সংরক্ষণ করুন; পুরোনো কাজ নতুন কী দিয়ে আবার শুরু হয় না।
সম্পূর্ণ উদাহরণ
স্থানধারকসহ অনুরোধ; পাঠানোর আগে আইডি বদলান ও ভবিষ্যতের তারিখ বেছে নিন। এই অনুরোধগুলো আসল বার্তা প্রকাশ করে। curl '<API_BASE_URL>/v1/groups' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-0900' -H 'Content-Type: application/json' --data '{"type":"text","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"text":"Updated publication","scheduled_at":"2026-10-16T09:00:00-03:00"}' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-1200' -F 'payload={"type":"image","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"caption":"Updated caption"}' -F 'image=@publication.png;type=image/png' curl '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X DELETE '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>'
কাজ হয়েছে কি না যাচাই করুন
কাজের গ্রহণ ও গ্রুপের গৃহীত ফলাফল গেটওয়ের গ্রহণ নিশ্চিত করে। এগুলো পৌঁছানো বা পড়ার নিশ্চয়তা দেয় না। প্রবেশাধিকার, কী, অ্যাকাউন্ট বা গ্রুপের অনুমতি বদলালে নির্ধারিত কাজ অবরুদ্ধ হতে পারে।
যা জানা দরকার
- সহকারী উপলব্ধ রেকর্ড পড়তে পারে এবং অনুরোধ পেলে টেক্সট পাঠাতে পারে। পাঠানোর অনুরোধের আগে সহকারীর টুলের নির্দেশিকা দেখুন।
- MCP-তে নেই এমন সম্পাদনার জন্য প্যানেল ব্যবহার করুন।
- Pro ও Agency-এর মাসিক বা বার্ষিক প্ল্যানে API ব্যবহারের সুযোগ আছে। Starter-এর জন্য আপগ্রেড প্রয়োজন। কী শুধু নির্বাচিত অ্যাকাউন্ট ও গ্রুপের অনুমতি দেয়; WhatsApp অ্যাকাউন্ট বদলালে পাঠানো বন্ধ হয়। সার্ভারের প্রবেশতথ্য কখনও শেয়ার করবেন না।
- লেখায় 4,096 অক্ষর ও ক্যাপশনে 1,024 অক্ষর রাখা যায়। 5 MiB পর্যন্ত JPEG, PNG বা WebP ফাইল multipart-এর payload ও image ফিল্ডে আপলোড করুন। দূরবর্তী ছবির URL গ্রহণ করা হয় না।
- নতুন কাজ HTTP 202 ফেরত দেয়। একই Idempotency-Key দিয়ে হুবহু অনুরোধ আবার করলে মূল কাজটি HTTP 200 সহ ফেরত আসে; একই কী দিয়ে ভিন্ন কনটেন্ট পাঠালে 409 আসে। পাঠানোর পর সময়সীমা পেরিয়ে গেলে ফলাফল অনিশ্চিত হতে পারে; অন্য কী দিয়ে স্বয়ংক্রিয়ভাবে আবার পাঠাবেন না।
সাধারণ সমস্যা
- যা দেখছেন
- পরীক্ষার পর উত্তর বা নতুন রেকর্ড নেই।
- কী করবেন
- ডিভাইসের সংযোগ এবং সংশ্লিষ্ট নিয়ম বা লগ সেটিংস দেখে আগত ঘটনার কনফিগারেশন যাচাই করতে পরিচালনাকারীকে বলুন।
- কী আশা করবেন
- সঠিক কনফিগারেশনের সুবিধা নতুন মিলে যাওয়া ঘটনা প্রক্রিয়া করতে পারবে।
- যা দেখছেন
- সহকারী অনুমোদন করতে পারে না বা অন্য অ্যাকাউন্ট দেখায়।
- কী করবেন
- সাইন ইনে ফিরে কাঙ্ক্ষিত অ্যাকাউন্ট বেছে নিন; বারবার অনুমোদনের ত্রুটি হলে পরিচালনাকারীকে জানান।
- কী আশা করবেন
- অনুমোদন পর্দা ও ফেরত রেকর্ড কাঙ্ক্ষিত অ্যাকাউন্টের হবে।
আরও সহায়তা নিন
সুবিধা ও দৃশ্যমান ত্রুটি পরিচালনাকারীকে জানান। সহকারীর কথোপকথনে সার্ভারের গোপন প্রবেশতথ্য দেবেন না।