Meta (Facebook) ইন্টিগ্রেশন
আপনার Facebook Page-এর মাধ্যমে agent-কে Facebook Messenger-এ সংযুক্ত করুন।
প্রতিটি সংযুক্ত Facebook Page একটি বিল্ট-ইন in-app Storefrontও পায় যা Page-এর Persistent Menu থেকে চালু হয় — multipage product catalog, per-product AI chat, এবং Messenger-এর ভেতরেই এক-ট্যাপে order intake। দেখুন Messenger Storefront।
সংক্ষিপ্ত বিবরণ
Meta integration প্রদান করে:
- আপনার Page-এর মাধ্যমে Facebook Messenger conversation
- Page-এর Persistent Menu থেকে চালু করা যায় এমন একটি বিল্ট-ইন Messenger Storefront
- Typing indicator সহ background processing
- দীর্ঘ response-এর জন্য স্বয়ংক্রিয় message splitting
- ২৪ ঘণ্টার messaging window compliance
- Session-এর মধ্যে conversation memory
পূর্বশর্ত
- আপনি পরিচালনা করেন এমন একটি Facebook Page
- Page-এ Admin বা Editor role
- একটি active agent সহ Cuneiform Chat account
সেটআপ ধাপসমূহ
১. Integration সেটআপ শুরু করুন
- Agents → আপনার agent নির্বাচন করুন
- Integrations tab-এ navigate করুন
- Meta (Facebook)-এ click করুন
- Connect Page-এ click করুন
২. Facebook-এ Authorize করুন
- কোন Agent respond করবে তা নির্বাচন করুন
- Connect with Facebook-এ click করুন
- Facebook-এ log in করুন (প্রয়োজন হলে)
- আপনি যে Page সংযুক্ত করতে চান তা নির্বাচন করুন
- Messenger permission দিন
- আপনাকে success message সহ ফিরিয়ে আনা হবে
৩. সংযোগ যাচাই করুন
সংযুক্ত হলে আপনার Page integration list-এ দেখা যাবে:
- Page name এবং status
- Page ID
- শেষ কার্যকলাপ timestamp
এটি কীভাবে কাজ করে
User-রা Messenger-এর মাধ্যমে আপনার Facebook Page-এ message করলে:
- Message Facebook Messenger-এর মাধ্যমে আসে
- Bot প্রক্রিয়ার সময় typing indicator দেখায়
- আপনার agent প্রশ্ন প্রক্রিয়া করে
- Response Messenger-এর মাধ্যমে ফেরত যায়
Message background-এ প্রক্রিয়া হয়। আপনার agent response তৈরি করার সময় bot typing indicator দেখায়।
বৈশিষ্ট্যসমূহ
স্বয়ংক্রিয় Response
আপনার agent স্বয়ংক্রিয়ভাবে আপনার content-এর ভিত্তিতে আগত Messenger conversation-এ respond করে। সব text message response trigger করে — কোনো command বা prefix প্রয়োজন নেই।
Typing Indicator
আপনার agent message প্রক্রিয়া করার সময় user-রা Messenger-এ typing indicator (”…”) দেখে, স্বাভাবিক conversation-এর অনুভূতি দেয়।
Message Splitting
২,০০০ অক্ষরের বেশি দীর্ঘ response স্বয়ংক্রিয়ভাবে একাধিক message-এ বিভক্ত হয়, পাঠযোগ্যতার জন্য paragraph break এবং sentence boundary সংরক্ষণ করে।
Conversation Memory
Bot একটি session-এর মধ্যে context মনে রাখে, তাই user-রা নিজেদের পুনরাবৃত্তি না করে follow-up প্রশ্ন করতে পারে।
Message Queuing
Bot এখনও প্রক্রিয়া করার সময় user অতিরিক্ত message পাঠালে, সেগুলো queue হয় এবং পরবর্তী response-এ অন্তর্ভুক্ত হয়।
২৪ ঘণ্টার Messaging Window
Facebook-এর নীতি শেষ user message-এর ২৪ ঘণ্টার মধ্যে respond করার অনুমতি দেয়। আপনার agent real-time-এ respond করে, এই window-এর মধ্যেই। ২৪ ঘণ্টা নিষ্ক্রিয়তার পর conversation পুনরায় শুরু করতে user-কে নতুন message পাঠাতে হবে।
User-দের প্রথমে আপনার Page-এ message করতে হবে — আপনি অযাচিত message পাঠাতে পারবেন না। তাদের শেষ message-এর পর ২৪ ঘণ্টা পার হলে user আবার message না করা পর্যন্ত bot reply করতে পারবে না।
Page পরিচালনা
সংযুক্ত Page দেখুন
প্রতিটি সংযুক্ত Page দেখায়:
- Page name এবং সংযোগ status
- সংশ্লিষ্ট agent
- কার্যকলাপ তথ্য
উপলব্ধ Action
| Action | বিবরণ |
|---|---|
| Test Connection | Integration কাজ করছে কিনা যাচাই করুন |
| Disconnect | Page সংযোগ সরান |
প্রতিটি সংযুক্ত Page-এ three-dot menu-র মাধ্যমে এগুলো access করুন।
সমস্যা সমাধান
Page দেখা যাচ্ছে না
- Page-এ আপনার Admin বা Editor role আছে কিনা যাচাই করুন
- সব অনুরোধকৃত permission দিয়েছেন কিনা পরীক্ষা করুন
- Disconnect করে পুনরায় connect করে দেখুন
Message-এ Response আসছে না
- Integration যাচাই করতে “Test Connection” ব্যবহার করুন
- আপনার agent configured এবং কাজ করছে কিনা পরীক্ষা করুন (Playground-এ test করুন)
- Messenger permission দেওয়া হয়েছে কিনা নিশ্চিত করুন
- User গত ২৪ ঘণ্টায় message করেছে কিনা যাচাই করুন (messaging window নীতি)
Authorization Error
- Facebook login session clear করে আবার চেষ্টা করুন
- আপনার Facebook account-এ Page access আছে কিনা যাচাই করুন
- Page Facebook দ্বারা restricted কিনা পরীক্ষা করুন
নিরাপত্তা
- OAuth token এনক্রিপ্ট করে সুরক্ষিতভাবে সংরক্ষণ করা হয়
- Webhook signature প্রতিটি incoming request-এ HMAC-SHA256 ব্যবহার করে verify করা হয়
- Messenger conversation-এর বাইরে Page content-এ কোনো access নেই
- Facebook Platform নীতিমালার সাথে সামঞ্জস্যপূর্ণ
সংযোগ বিচ্ছিন্ন করা
Meta integration সরাতে:
- Agents → agent নির্বাচন করুন → Integrations
- আপনার Page-এ three-dot menu-তে click করুন
- Disconnect নির্বাচন করুন
সম্পূর্ণভাবে access revoke করতে:
- Facebook Settings → Business Integrations-এ যান
- Cuneiform Chat app সরান
গুরুত্বপূর্ণ তথ্য
- প্রতি Page একটি agent: প্রতিটি Facebook Page একবারে শুধুমাত্র একটি AI agent-এর সাথে সংযুক্ত করা যায়
- শুধুমাত্র Messenger: এই integration Facebook Messenger-এর মাধ্যমে কাজ করে, Page comment বা post-এ নয়
- Message সীমা: Individual message ২,০০০ অক্ষরে সীমাবদ্ধ; দীর্ঘ response স্বয়ংক্রিয়ভাবে বিভক্ত হয়
- Agent পরিবর্তন করতে: প্রথমে বিদ্যমান integration disconnect করুন, তারপর ভিন্ন agent দিয়ে পুনরায় connect করুন