Discord ইন্টিগ্রেশন
Slash command এবং direct message ব্যবহার করে আপনার agent-কে Discord server-এ যোগ করুন।
সংক্ষিপ্ত বিবরণ
Discord integration প্রদান করে:
- Slash command support (
/ask) - Direct message conversation
- Server-ব্যাপী উপলব্ধতা
- Channel-ভিত্তিক response
- Rich embed formatting
- ঐচ্ছিক text-based DM (command prefix প্রয়োজন নেই)
পূর্বশর্ত
- একটি Discord account
- Target server-এ Manage Server permission
- Discord Developer Portal access
সেটআপ ধাপসমূহ
১. Discord Application তৈরি করুন
- Discord Developer Portal-এ যান
- New Application-এ click করুন
- একটি নাম দিন (যেমন, “My Support Bot”)
- Create-এ click করুন
২. আপনার Credential সংগ্রহ করুন
Discord Developer Portal থেকে এই মানগুলো সংগ্রহ করুন:
| ক্ষেত্র | বিবরণ | কোথায় পাবেন |
|---|---|---|
| Application ID | আপনার Discord app-এর ID | General Information page |
| Public Key | Signature verification-এর জন্য 64-character hex string | General Information page |
| Bot Token | আপনার bot-এর secret token | Bot section → Reset Token |
| Guild ID (ঐচ্ছিক) | তাৎক্ষণিক command registration-এর জন্য Server ID | Server-এ right-click → Copy Server ID |
আপনার Bot Token সুরক্ষিত রাখুন — কখনও প্রকাশ্যে শেয়ার করবেন না। আপনার token যার কাছে আছে সে আপনার bot নিয়ন্ত্রণ করতে পারবে।
৩. Cuneiform Chat-এ সংযুক্ত করুন
- Agents → আপনার agent নির্বাচন করুন
- Integrations tab-এ navigate করুন
- Discord-এ click করুন
- আপনার Application ID, Public Key, এবং Bot Token দিন
- ঐচ্ছিকভাবে তাৎক্ষণিক slash command registration-এর জন্য Guild ID দিন
- Connect-এ click করুন
৪. Webhook URL configure করুন (আবশ্যক)
সংযুক্ত হওয়ার পর আপনি Webhook URL সহ একটি success dialog দেখবেন:
- Success dialog থেকে Webhook URL copy করুন
- Discord Developer Portal-এ General Information-এ যান
- Interactions Endpoint URL খুঁজুন
- Webhook URL paste করুন এবং Save Changes-এ click করুন
এই ধাপটি আবশ্যক। Discord এই URL ব্যবহার করে আপনার bot-এ slash command interaction পাঠায়।
৫. আপনার Server-এ Bot যোগ করুন
Integration card-এ Add to Server button ব্যবহার করুন, অথবা সংযুক্ত হওয়ার পর প্রদত্ত invite URL ব্যবহার করুন। এটি প্রয়োজনীয় permission সহ bot যোগ করে।
Bot ব্যবহার করা
Slash Command
User-রা /ask slash command ব্যবহার করে আপনার bot-এর সাথে interact করে:
/ask What are your business hours?Bot প্রশ্ন প্রক্রিয়া করে এবং channel-এ respond করে।
Direct Message
ব্যক্তিগত conversation-এর জন্য bot-কে সরাসরি message করুন:
- আপনার server-এর member list-এ bot খুঁজুন
- Right-click করুন এবং Message নির্বাচন করুন
/askcommand ব্যবহার করুন অথবা Text DM enable করুন (নিচে দেখুন)
Text DM Toggle
Integration card-এ Text DMs switch direct message আচরণ নিয়ন্ত্রণ করে:
- Off (default): User-দের DM-এ
/askcommand ব্যবহার করতে হবে - On: User-রা DM-এ plain text message পাঠাতে পারে (command prefix প্রয়োজন নেই)
Text DM enable করার সময় Discord Developer Portal → Bot section → Privileged Gateway Intents-এ Message Content Intent enable করতে হবে।
Response Format
Response plain text message হিসেবে পোস্ট করা হয়। দীর্ঘ উত্তর স্বয়ংক্রিয়ভাবে একাধিক message-এ ভাগ করা হয় যাতে সেগুলো Discord-এর প্রতি-message ২,০০০-অক্ষর সীমার মধ্যে থাকে।
বৈশিষ্ট্যসমূহ
Server-ব্যাপী Access
একবার যোগ করলে, bot সব text channel-এ উপলব্ধ থাকে যেখানে এর permission আছে।
Thread Support
Bot thread-এ respond করতে পারে, conversation সংগঠিত রাখতে।
Instant vs Global Command
- Guild ID সহ: Slash command সেই server-এ তাৎক্ষণিকভাবে register হয়
- Guild ID ছাড়া: Global command propagate হতে ১ ঘণ্টা পর্যন্ত সময় লাগতে পারে
তাৎক্ষণিক slash command উপলব্ধতার জন্য setup-এর সময় Guild ID দিন। পরে আরও server যোগ করতে পারবেন।
আপনার Bot পরিচালনা
প্রতিটি connected bot দেখায়:
- Bot username এবং status (Active/Error)
- Application ID
- সংশ্লিষ্ট agent
- শেষ কার্যকলাপ timestamp
- Webhook URL (reference-এর জন্য)
উপলব্ধ Action
| Action | বিবরণ |
|---|---|
| Add to Server | Server-এ bot যোগ করতে invite link খোলে |
| Portal | এই app-এর জন্য Discord Developer Portal খোলে |
| Copy URL | Webhook URL copy করে |
| Test Connection | Bot-এর সংযোগ যাচাই করে |
| Disconnect | এই integration সরায় |
সমস্যা সমাধান
Bot respond করছে না
- Discord Developer Portal-এ Interactions Endpoint URL configured কিনা যাচাই করুন
- Channel-এ bot-এর permission আছে কিনা নিশ্চিত করুন
- Cuneiform Chat-এ token সঠিক কিনা পরীক্ষা করুন
- Slash command registered কিনা test করুন (
/আপনার command দেখায়)
Command দেখা যাচ্ছে না
Slash command globally register হতে এক ঘণ্টা পর্যন্ত সময় লাগতে পারে। তাৎক্ষণিক testing-এর জন্য:
- তাৎক্ষণিক registration-এর জন্য setup-এর সময় Guild ID দিন
- Guild ID না দিলে global propagation-এর জন্য অপেক্ষা করুন
Permission Error
Bot-এর এই permission আছে কিনা নিশ্চিত করুন:
- Send Messages
- Use Slash Commands
- Embed Links
- Read Message History (thread support-এর জন্য)
Text DM কাজ করছে না
- Integration card-এ Text DMs toggle enabled কিনা যাচাই করুন
- Discord Developer Portal → Bot section-এ Message Content Intent enable করুন
- প্রয়োজনে bot connection restart করুন
নিরাপত্তা
- Bot token এনক্রিপ্ট করে সুরক্ষিতভাবে সংরক্ষণ করা হয়
- Command Discord-এর built-in signature verification ব্যবহার করে
- Direct interaction-এর বাইরে কোনো server data access করা হয় না
সংযোগ বিচ্ছিন্ন করা
Discord integration সরাতে:
- Agents → agent নির্বাচন করুন → Integrations
- আপনার Discord bot-এ three-dot menu-তে click করুন
- Disconnect নির্বাচন করুন
Discord থেকে bot সম্পূর্ণ সরাতে:
- আপনার Discord server setting-এ যান
- Integrations → bot সরান