ডেভেলপারগণ
Zinn® Chat ক্ষমতার রেফারেন্স
Zinn® Chat তার অ্যাকশনগুলোকে WordPress Abilities API-এর সাথে রেজিস্টার করে। একই অ্যাবিলিটিগুলো সাইটের নিজস্ব সার্ভারে MCP টুল এবং /wp-json/wp-abilities/v1-এর অধীনে REST রুট হিসেবে কাজ করে। এই পেজটি প্লাগইনের নিজস্ব রেজিস্ট্রি থেকে জেনারেট করা হয়েছে।
এন্ডপয়েন্টসমূহ
HTTP এর উপর MCP (স্ট্রিমযোগ্য)
https://example.com/wp-json/zinn-chat/v1/mcpWP-CLI-এর মাধ্যমে MCP (standard input and output)
wp mcp-adapter serve --server=zinn-chat --user=<login>REST: ক্ষমতাগুলির তালিকা তৈরি করুন
/wp-json/wp-abilities/v1/abilities?category=zinn-chatREST: ক্ষমতা চালান
/wp-json/wp-abilities/v1/abilities/<name>/runপ্রমাণীকরণ এবং অনুমতিসমূহ
HTTP অনুরোধগুলি একটি WordPress অ্যাপ্লিকেশন পাসওয়ার্ড (HTTP বেসিক) দিয়ে প্রমাণীকরণ করে। MCP সার্ভারের সাথে সংযোগ স্থাপনের জন্য নিচে দেখানো ক্ষমতা প্রয়োজন; তারপরে প্রতিটি ক্ষমতা প্রতি অবজেক্টের ভিত্তিতে তার নিজস্ব অনুমতি পরীক্ষা করে। শুধুমাত্র পাঠযোগ্য (Read-only) ক্ষমতাগুলি GET এবং ক্যোয়ারী স্ট্রিংয়ে তাদের ইনপুট নিয়ে চলে; অন্যগুলি POST এবং একটি JSON বডি {"input": {…}} সহ চলে।
উদাহরণ
# REST: ক্ষমতা চালান
curl -u your-username:your-application-password \
"https://example.com/wp-json/wp-abilities/v1/abilities/zinn-chat/get-overview/run"# MCP (JSON-RPC over HTTP, after "initialize")
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"zinn-chat-get-overview","arguments":{}}}সকল ক্ষমতা
প্লাগইনের abilities.json থেকে জেনারেট করা হয়েছে, যা নিজেই একটি চলমান সাইট থেকে জেনারেট করা হয়; দুটির মধ্যে মিল না থাকলে একটি টেস্ট ব্যর্থ হয়।
| ক্ষমতা | এটি যা করে | সংস্করণ | REST | অনুমতি | পরামিতি |
|---|---|---|---|---|---|
zinn-chat/answer-ticketzinn-chat-answer-ticket | একটি টিকিট উত্তর দিন গ্রাহককে ইমেল (টেক্সট) দ্বারা উত্তর দেয়, অথবা একটি অভ্যন্তরীণ নোট (note: true) যোগ করে; স্থিতি ঐচ্ছিকভাবে টিকিটের স্থিতি পরিবর্তন করে। | বিনামূল্যে সংস্করণ | POST …/abilities/zinn-chat/answer-ticket/run | the REST route's own per-item permission check | id: string (প্রয়োজনীয়) |
zinn-chat/ask-assistantzinn-chat-ask-assistant | সহকারীকে জিজ্ঞাসা করুন সাইটের এআই সহকারীতে একটি প্রশ্ন করে এবং এর প্রাপ্ত প্রতিটি উৎসের সাথে উত্তরটি প্রদান করে। | বিনামূল্যে সংস্করণ | POST …/abilities/zinn-chat/ask-assistant/run | the REST route's own per-item permission check | কোনোটিই নয় |
zinn-chat/bulk-update-ticketszinn-chat-bulk-update-tickets | একসঙ্গে অনেকগুলো টিকিট পরিবর্তন করুন (Pro) একসাথে ১০০টি পর্যন্ত টিকিটের (আইডি) স্ট্যাটাস, অগ্রাধিকার বা নির্ধারিত ব্যক্তি পরিবর্তন করে। প্রতিটি টিকিট আলাদাভাবে পরিবর্তনের মতো একই পরীক্ষার মধ্য দিয়ে যায়; ফলাফল প্রতিটি টিকিটের তালিকা দেখায়। | প্রো সংস্করণ | POST …/abilities/zinn-chat/bulk-update-tickets/run | zinn_chat_answer | ids: array (প্রয়োজনীয়), status: open|pending|solved|closed, priority: low|normal|high|urgent, assignee_id: integer |
zinn-chat/chat-to-ticketzinn-chat-chat-to-ticket | একটি চ্যাটকে টিকিটে রূপান্তর করুন একটি চ্যাট থেকে একটি টিকিট খোলে যাতে ইমেলের মাধ্যমে এর উত্তর দেওয়া যায় (ভিজিটারের ইমেল ঠিকানা প্রয়োজন)। | বিনামূল্যে সংস্করণ | POST …/abilities/zinn-chat/chat-to-ticket/run | the REST route's own per-item permission check | id: string (প্রয়োজনীয়) |
zinn-chat/close-chatzinn-chat-close-chat | একটি চ্যাট বন্ধ করুন একটি চ্যাট সমাপ্ত করে; ভিজিটর এখনও ট্রান্সক্রিপ্টের জন্য অনুরোধ করতে পারে। | বিনামূল্যে সংস্করণ | POST …/abilities/zinn-chat/close-chat/run | the REST route's own per-item permission check | id: string (প্রয়োজনীয়) |
zinn-chat/create-ticketzinn-chat-create-ticket | একটি টিকিট খুলুন গ্রাহকের পক্ষে একটি টিকিট খোলে (তাদের ইমেল, একটি বিষয় এবং প্রথম বার্তা)। | বিনামূল্যে সংস্করণ | POST …/abilities/zinn-chat/create-ticket/run | the REST route's own per-item permission check | কোনোটিই নয় |
zinn-chat/delete-canned-replyzinn-chat-delete-canned-reply | সংরক্ষিত উত্তর মুছে ফেলুন (প্রো) একটি সংরক্ষিত উত্তর মুছে ফেলে। | প্রো সংস্করণ | POST …/abilities/zinn-chat/delete-canned-reply/run | the REST route's own per-item permission check | id: string (প্রয়োজনীয়) |
zinn-chat/delete-ticketzinn-chat-delete-ticket | একটি টিকিট মুছুন একটি টিকিট এবং এর কথোপকথন চিরতরে মুছে ফেলে (শুধুমাত্র ম্যানেজারদের জন্য)। | বিনামূল্যে সংস্করণ | POST …/abilities/zinn-chat/delete-ticket/run | the REST route's own per-item permission check | id: string (প্রয়োজনীয়) |
zinn-chat/draft-kb-articlezinn-chat-draft-kb-article | একটি টিকিট থেকে একটি সহায়তা নিবন্ধ তৈরি করুন (Pro) একটি সমাধান করা টিকিট থেকে নলেজ-বেসের একটি ড্রাফট নিবন্ধ লেখে; কোনো ব্যক্তি এটি প্রকাশ না করা পর্যন্ত এটি ড্রাফট হিসেবেই থাকে। | প্রো সংস্করণ | POST …/abilities/zinn-chat/draft-kb-article/run | edit_posts (the REST route's own check) | কোনোটিই নয় |
zinn-chat/draft-kb-from-gapszinn-chat-draft-kb-from-gaps | উত্তরহীন প্রশ্নগুলির জন্য খসড়া সহায়তা নিবন্ধ (প্রো) নির্বাচিত প্রশ্নগুলোর (আইডি) উত্তর দিয়ে ড্রাফট নলেজ-বেস নিবন্ধ লেখে; সেগুলো ড্রাফট হিসেবেই থেকে যায়। | প্রো সংস্করণ | POST …/abilities/zinn-chat/draft-kb-from-gaps/run | edit_posts (the REST route's own check) | কোনোটিই নয় |
zinn-chat/fill-canned-replyzinn-chat-fill-canned-reply | সংরক্ষিত উত্তর পূরণ করুন (প্রো) একটি চ্যাট বা টিকিটের জন্য স্থানধারকগুলি পূরণ করে একটি সংরক্ষিত উত্তরের পাঠ্য প্রদান করে। | প্রো সংস্করণ | POST …/abilities/zinn-chat/fill-canned-reply/run | the REST route's own per-item permission check | id: string (প্রয়োজনীয়) |
zinn-chat/get-chatzinn-chat-get-chat | একটি চ্যাট পড়ুন একটি চ্যাটের বার্তা এবং ভিজিটর বিবরণ ফিরিয়ে দেয় (after: এই আইডির চেয়ে নতুন বার্তাগুলি)। | বিনামূল্যে সংস্করণ | GET …/abilities/zinn-chat/get-chat/run | the REST route's own per-item permission check | id: string (প্রয়োজনীয়) |
zinn-chat/get-overviewzinn-chat-get-overview | সমর্থন ওভারভিউ পড়ুন প্রতিটি স্ট্যাটাসে কতটি টিকিট রয়েছে এবং কতটি চ্যাট একজন ব্যক্তির জন্য অপেক্ষমাণ (এবং তাদের অপঠিত বার্তাগুলি) এবং চ্যাট, সহকারী এবং টিকিট চালু আছে কিনা তা ফেরত দেয়। | বিনামূল্যে সংস্করণ | GET …/abilities/zinn-chat/get-overview/run | zinn_chat_answer | কোনোটিই নয় |
zinn-chat/get-settingszinn-chat-get-settings | চ্যাট সেটিংস পড়ুন সব চ্যাট সেটিংস প্রদান করে: উইজেট, সহকারী, লোকজন এবং খোলার সময়, টিকিট এবং ইমেল, সাইট সূচক, গোপনীয়তা এবং স্প্যাম। | বিনামূল্যে সংস্করণ | GET …/abilities/zinn-chat/get-settings/run | zinn_chat_manage | কোনোটিই নয় |
zinn-chat/get-statszinn-chat-get-stats | সমর্থন পরিসংখ্যান পড়ুন (প্রো) গত N দিনের (দিনগুলি) চ্যাট এবং টিকিট নম্বর, রেসপন্স টাইম এবং রেটিং প্রদান করে। | প্রো সংস্করণ | GET …/abilities/zinn-chat/get-stats/run | the REST route's own per-item permission check | কোনোটিই নয় |
zinn-chat/get-ticketzinn-chat-get-ticket | একটি টিকিট পড়ুন এর পুরো কথোপকথন, স্ট্যাটাস, অগ্রাধিকার এবং দায়িত্বপ্রাপ্ত ব্যক্তিসহ একটি টিকিট ফেরত দেয়। | বিনামূল্যে সংস্করণ | GET …/abilities/zinn-chat/get-ticket/run | the REST route's own per-item permission check | id: string (প্রয়োজনীয়) |
zinn-chat/hand-chat-to-assistantzinn-chat-hand-chat-to-assistant | একটি চ্যাট আবার সহকারীতে ফিরিয়ে দিন AI অ্যাসিস্ট্যান্টে একটি চ্যাট ফিরিয়ে দেয়, যা সাইটের কন্টেন্ট থেকে ভিজিটরদের উত্তর দেয়। | বিনামূল্যে সংস্করণ | POST …/abilities/zinn-chat/hand-chat-to-assistant/run | the REST route's own per-item permission check | id: string (প্রয়োজনীয়) |
zinn-chat/list-canned-replieszinn-chat-list-canned-replies | সংরক্ষিত উত্তরগুলির তালিকা (প্রো) সংরক্ষিত উত্তরগুলির তালিকা দেখায় যা এজেন্টরা তাদের শর্টকাট সহ যুক্ত করতে পারে। | প্রো সংস্করণ | GET …/abilities/zinn-chat/list-canned-replies/run | the REST route's own per-item permission check | কোনোটিই নয় |
zinn-chat/list-chatszinn-chat-list-chats | লাইভ চ্যাটগুলো তালিকাভুক্ত করুন অপেক্ষারত, চলমান এবং সম্প্রতি বন্ধ হওয়া চ্যাটগুলোর তালিকা দেখায় এবং প্রতিটির দায়িত্বে কে আছেন তা উল্লেখ করে। | বিনামূল্যে সংস্করণ | GET …/abilities/zinn-chat/list-chats/run | the REST route's own per-item permission check | কোনোটিই নয় |
zinn-chat/list-indexed-contentzinn-chat-list-indexed-content | সহকারী যা জানে তা তালিকাভুক্ত করুন সহায়কের উত্তর দেওয়ার বিষয়বস্তু এর ইনডেক্স অবস্থা সহ প্রতিবার এক পাতা করে তালিকাভুক্ত করে। | বিনামূল্যে সংস্করণ | GET …/abilities/zinn-chat/list-indexed-content/run | the REST route's own per-item permission check | কোনোটিই নয় |
zinn-chat/list-kb-gapszinn-chat-list-kb-gaps | অনুত্তর প্রশ্নগুলির তালিকা (প্রো) যে প্রশ্নগুলোর উত্তর নলেজ বেস দিতে পারেনি, দর্শনার্থীরা সেই প্রশ্নগুলোর একটি তালিকা দেখায়। | প্রো সংস্করণ | GET …/abilities/zinn-chat/list-kb-gaps/run | the REST route's own per-item permission check | কোনোটিই নয় |
zinn-chat/list-ticketszinn-chat-list-tickets | টিকেট তালিকা একবারে একটি পৃষ্ঠা হিসেবে, স্ট্যাটাস বা সার্চ দ্বারা ফিল্টার করা সমর্থন টিকিটগুলি তালিকাভুক্ত করে। | বিনামূল্যে সংস্করণ | GET …/abilities/zinn-chat/list-tickets/run | the REST route's own per-item permission check | কোনোটিই নয় |
zinn-chat/reembed-contentzinn-chat-reembed-content | সহায়তাকারীর অনুসন্ধান সূচক পুনর্নির্মাণ করুন একটি আইটেমের (item_id) বা সবকিছুর (all: true) সার্চ ভেক্টর পুনর্নির্মাণ করে (শুধুমাত্র ম্যানেজারদের জন্য)। | বিনামূল্যে সংস্করণ | POST …/abilities/zinn-chat/reembed-content/run | the REST route's own per-item permission check | কোনোটিই নয় |
zinn-chat/reindex-contentzinn-chat-reindex-content | সহায়কে বিষয়বস্তু আবার পড়ুন সহায়কের ইনডেক্সে একটি আইটেম (item_id) অথবা সবকিছু (all: true) পুনরায় রিড করে (শুধুমাত্র ম্যানেজারদের জন্য)। | বিনামূল্যে সংস্করণ | POST …/abilities/zinn-chat/reindex-content/run | the REST route's own per-item permission check | কোনোটিই নয় |
zinn-chat/reply-chatzinn-chat-reply-chat | চ্যাটে উত্তর দিন দর্শনার্থীকে একটি বার্তা (টেক্সট) পাঠায় অথবা শুধুমাত্র এজেন্টরা দেখতে পায় এমন একটি অভ্যন্তরীণ নোট যোগ করে (note: true)। | বিনামূল্যে সংস্করণ | POST …/abilities/zinn-chat/reply-chat/run | the REST route's own per-item permission check | id: string (প্রয়োজনীয়) |
zinn-chat/save-canned-replyzinn-chat-save-canned-reply | একটি সংরক্ষিত উত্তর সংরক্ষণ করুন (প্রো) সংরক্ষিত উত্তর তৈরি বা পরিবর্তন করে (শিরোনাম, শর্টকাট, মূল অংশ, বিভাগ; পরিবর্তনের জন্য আইডি)। | প্রো সংস্করণ | POST …/abilities/zinn-chat/save-canned-reply/run | the REST route's own per-item permission check | কোনোটিই নয় |
zinn-chat/save-kb-articlezinn-chat-save-kb-article | একটি সহায়তা নিবন্ধ লিখুন (Pro) একটি নলেজ-বেস নিবন্ধ তৈরি করে, অথবা একটি পরিবর্তন করে (id): শিরোনাম, বিষয়বস্তু, সারাংশ, ক্যাটাগরি এবং স্ট্যাটাস (ড্রাফট, অথবা আপনি প্রকাশ করতে পারলে প্রকাশ করুন)। | প্রো সংস্করণ | POST …/abilities/zinn-chat/save-kb-article/run | edit_posts | id: integer, title: string, content: string, excerpt: string, categories: array, status: draft|publish |
zinn-chat/search-kbzinn-chat-search-kb | জ্ঞানভাণ্ডার অনুসন্ধান করুন (প্রো) একটি উত্তরে লিঙ্ক করার জন্য সাহায্যকারী আর্টিকেল খুঁজুন (q: অনুসন্ধান)। | প্রো সংস্করণ | GET …/abilities/zinn-chat/search-kb/run | the REST route's own per-item permission check | কোনোটিই নয় |
zinn-chat/set-conversation-detailszinn-chat-set-conversation-details | একটি কথোপকথনের ডিপার্টমেন্ট এবং ট্যাগ সেট করুন (Pro) একটি চ্যাট বা টিকিটের বিভাগ এবং ট্যাগ নির্ধারণ করে (ধরণ: চ্যাট বা টিকিট; আইডি)। | প্রো সংস্করণ | POST …/abilities/zinn-chat/set-conversation-details/run | the REST route's own per-item permission check | কোনোটিই নয় |
zinn-chat/set-kb-gap-statuszinn-chat-set-kb-gap-status | অনুউত্তর দেওয়া প্রশ্নগুলো চিহ্নিত করুন (প্রো) উত্তরহীন প্রশ্নগুলোকে উন্মুক্ত, পরিকল্পিত বা বাতিল হিসেবে চিহ্নিত করে (আইডি, স্ট্যাটাস)। | প্রো সংস্করণ | POST …/abilities/zinn-chat/set-kb-gap-status/run | the REST route's own per-item permission check | কোনোটিই নয় |
zinn-chat/set-presencezinn-chat-set-presence | আপনার প্রাপ্যতা নির্ধারণ করুন নতুন চ্যাটের জন্য সাইন-ইন করা এজেন্টকে উপলব্ধ বা দূরে হিসেবে চিহ্নিত করে (away: true বা false)। | বিনামূল্যে সংস্করণ | POST …/abilities/zinn-chat/set-presence/run | the REST route's own per-item permission check | কোনোটিই নয় |
zinn-chat/suggest-replyzinn-chat-suggest-reply | এআই (প্রো) দিয়ে একটি উত্তর ড্রাফট করুন সাইটের কন্টেন্ট থেকে চ্যাট বা টিকিটের একটি উত্তর ড্রাফট করে; কিছু পাঠানো হয় না। | প্রো সংস্করণ | POST …/abilities/zinn-chat/suggest-reply/run | the REST route's own per-item permission check | কোনোটিই নয় |
zinn-chat/summarise-conversationzinn-chat-summarise-conversation | এআই (প্রো) এর সাথে কথোপকথন সারসংক্ষেপ করুন কয়েক লাইনে একটি চ্যাট বা টিকিট সারসংক্ষেপ করে। | প্রো সংস্করণ | POST …/abilities/zinn-chat/summarise-conversation/run | the REST route's own per-item permission check | কোনোটিই নয় |
zinn-chat/take-chatzinn-chat-take-chat | একটি চ্যাট শুরু করুন লগ-ইন করা এজেন্টের কাছে অপেক্ষমাণ চ্যাট বরাদ্দ করে, যাতে ভিজিটর একজন ব্যক্তির সাথে কথা বলতে পারেন। | বিনামূল্যে সংস্করণ | POST …/abilities/zinn-chat/take-chat/run | the REST route's own per-item permission check | id: string (প্রয়োজনীয়) |
zinn-chat/update-settingszinn-chat-update-settings | চ্যাট সেটিংস পরিবর্তন করুন আপনার পাঠানো সেটিংস পরিবর্তন করে (সেটিংস: মানের জন্য কি) এবং বাকিগুলো ঠিক রাখে। প্রতিটি মান সেটিংস স্ক্রিনের মতোই নিখুঁতভাবে চেক করা হয়; get-settings কিগুলো তালিকাভুক্ত করে। | বিনামূল্যে সংস্করণ | POST …/abilities/zinn-chat/update-settings/run | zinn_chat_manage | settings: object (প্রয়োজনীয়) |
zinn-chat/update-ticketzinn-chat-update-ticket | একটি টিকিট পরিবর্তন করুন একটি টিকিটের স্ট্যাটাস, অগ্রাধিকার বা নির্ধারিত ব্যক্তি পরিবর্তন করে। | বিনামূল্যে সংস্করণ | POST …/abilities/zinn-chat/update-ticket/run | the REST route's own per-item permission check | id: string (প্রয়োজনীয়) |