Skip to Content

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 তৈরি করুন

  1. Discord Developer Portal-এ যান
  2. New Application-এ click করুন
  3. একটি নাম দিন (যেমন, “My Support Bot”)
  4. Create-এ click করুন

২. আপনার Credential সংগ্রহ করুন

Discord Developer Portal থেকে এই মানগুলো সংগ্রহ করুন:

ক্ষেত্রবিবরণকোথায় পাবেন
Application IDআপনার Discord app-এর IDGeneral Information page
Public KeySignature verification-এর জন্য 64-character hex stringGeneral Information page
Bot Tokenআপনার bot-এর secret tokenBot section → Reset Token
Guild ID (ঐচ্ছিক)তাৎক্ষণিক command registration-এর জন্য Server IDServer-এ right-click → Copy Server ID

আপনার Bot Token সুরক্ষিত রাখুন — কখনও প্রকাশ্যে শেয়ার করবেন না। আপনার token যার কাছে আছে সে আপনার bot নিয়ন্ত্রণ করতে পারবে।

৩. Cuneiform Chat-এ সংযুক্ত করুন

  1. Agents → আপনার agent নির্বাচন করুন
  2. Integrations tab-এ navigate করুন
  3. Discord-এ click করুন
  4. আপনার Application ID, Public Key, এবং Bot Token দিন
  5. ঐচ্ছিকভাবে তাৎক্ষণিক slash command registration-এর জন্য Guild ID দিন
  6. Connect-এ click করুন

৪. Webhook URL configure করুন (আবশ্যক)

সংযুক্ত হওয়ার পর আপনি Webhook URL সহ একটি success dialog দেখবেন:

  1. Success dialog থেকে Webhook URL copy করুন
  2. Discord Developer Portal-এ General Information-এ যান
  3. Interactions Endpoint URL খুঁজুন
  4. 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 করুন:

  1. আপনার server-এর member list-এ bot খুঁজুন
  2. Right-click করুন এবং Message নির্বাচন করুন
  3. /ask command ব্যবহার করুন অথবা Text DM enable করুন (নিচে দেখুন)

Text DM Toggle

Integration card-এ Text DMs switch direct message আচরণ নিয়ন্ত্রণ করে:

  • Off (default): User-দের DM-এ /ask command ব্যবহার করতে হবে
  • 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 ServerServer-এ bot যোগ করতে invite link খোলে
Portalএই app-এর জন্য Discord Developer Portal খোলে
Copy URLWebhook URL copy করে
Test ConnectionBot-এর সংযোগ যাচাই করে
Disconnectএই integration সরায়

সমস্যা সমাধান

Bot respond করছে না

  1. Discord Developer Portal-এ Interactions Endpoint URL configured কিনা যাচাই করুন
  2. Channel-এ bot-এর permission আছে কিনা নিশ্চিত করুন
  3. Cuneiform Chat-এ token সঠিক কিনা পরীক্ষা করুন
  4. 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 কাজ করছে না

  1. Integration card-এ Text DMs toggle enabled কিনা যাচাই করুন
  2. Discord Developer Portal → Bot section-এ Message Content Intent enable করুন
  3. প্রয়োজনে bot connection restart করুন

নিরাপত্তা

  • Bot token এনক্রিপ্ট করে সুরক্ষিতভাবে সংরক্ষণ করা হয়
  • Command Discord-এর built-in signature verification ব্যবহার করে
  • Direct interaction-এর বাইরে কোনো server data access করা হয় না

সংযোগ বিচ্ছিন্ন করা

Discord integration সরাতে:

  1. Agents → agent নির্বাচন করুন → Integrations
  2. আপনার Discord bot-এ three-dot menu-তে click করুন
  3. Disconnect নির্বাচন করুন

Discord থেকে bot সম্পূর্ণ সরাতে:

  1. আপনার Discord server setting-এ যান
  2. Integrations → bot সরান
Last updated on