پراخه کونکي

د Zinn® Chat وړتیاوې حواله

Zinn® Chat خپل کړنې د WordPress Abilities API سره ثبتوي. ورته وړتیاوې د سایټ په خپل سرور کې د MCP وسیلې او د /wp-json/wp-abilities/v1 لاندې د REST لارې دي. دا پاڼه د پلگ ان د خپل راجستر څخه جوړه شوې ده.

د کارونکي لارښود: د مصنوعي ځيرکتیا (AI) اپلیکیشن ونښلوئ

پای ټکي

د HTTP له لارې MCP (د سیند وړ)

https://example.com/wp-json/zinn-chat/v1/mcp

د WP-CLI له لارې MCP (معیاري ان پټ او آوټ پټ)

wp mcp-adapter serve --server=zinn-chat --user=<login>

REST: د وړتیاو لیست کول

/wp-json/wp-abilities/v1/abilities?category=zinn-chat

REST: د یو وړتیا اجرا کول

/wp-json/wp-abilities/v1/abilities/<name>/run

تصدیق او اجازې

HTTP غوښتنې د WordPress کاریال پټنوم (HTTP Basic) سره تایید کیږي. د MCP سرور سره نښلول لاندې ښودل شوي وړتیا ته اړتیا لري؛ بیا هره وړتیا د هر شی په اساس خپل اجازه چک کوي. یوازې د لوستلو وړ وړتیاوې د GET او د هغو ورودی په پوښتنې پټه (query string) کې چلیږي؛ نورې د 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-ticket
zinn-chat-answer-ticket
ټکټ ته ځواب ورکول
پېرودونکي ته د برېښنالیک له لارې ځواب ورکوي (text)، یا یو داخلي یادښت اضافه کوي (note: true)؛ حالت په اختیاري توګه د ټکټ حالت بدلوي.
وړیا نسخهPOST …/abilities/zinn-chat/answer-ticket/runthe REST route's own per-item permission checkid: string (ضروري)
zinn-chat/ask-assistant
zinn-chat-ask-assistant
له مرستیال څخه پوښتنه وکړئ
د سایټ د مصنوعي استخباراتو مرستیال څخه پوښتنه کوي او د هغې ځواب د ټولو هغو سرچینو سره راستنوي چې هغه موندلي دي.
وړیا نسخهPOST …/abilities/zinn-chat/ask-assistant/runthe REST route's own per-item permission checkهیڅ یو
zinn-chat/bulk-update-tickets
zinn-chat-bulk-update-tickets
په یو ځل ډېر ټکټونه بدل کړئ (Pro)
د تر ۱۰۰ پورې ټکټونو (ids) حالت، لومړیتوب یا مؤظف کس بدلوي. هر ټکټ د هغو چکونو له لارې تیریږي چې د خپلواک بدلون په وخت کې پرې کیږي؛ پایله یې هر یو په ګوته کوي.
پرو نسخهPOST …/abilities/zinn-chat/bulk-update-tickets/runzinn_chat_answerids: array (ضروري), status: open|pending|solved|closed, priority: low|normal|high|urgent, assignee_id: integer
zinn-chat/chat-to-ticket
zinn-chat-chat-to-ticket
يوه خبره په ټکټ بدلول
یو ټکټ له یوه چټ څخه پرانیزي ترڅو د بریښنالیک له لارې ځواب شي (د لیدونکي بریښنالیک پته ته اړتیا لري).
وړیا نسخهPOST …/abilities/zinn-chat/chat-to-ticket/runthe REST route's own per-item permission checkid: string (ضروري)
zinn-chat/close-chat
zinn-chat-close-chat
چاټ وتړئ
یو چټ پای ته رسوي؛ لیدونکی بیا هم د متن (ټرانسکریپټ) غوښتنه کولی شي.
وړیا نسخهPOST …/abilities/zinn-chat/close-chat/runthe REST route's own per-item permission checkid: string (ضروري)
zinn-chat/create-ticket
zinn-chat-create-ticket
ټکټ پرانیستل
د پیرودونکي په استازیتوب یو ټکټ پرانیزي (د هغوی بریښنالیک، موضوع او لومړی پیغام).
وړیا نسخهPOST …/abilities/zinn-chat/create-ticket/runthe REST route's own per-item permission checkهیڅ یو
zinn-chat/delete-canned-reply
zinn-chat-delete-canned-reply
د خوندي شوي ځواب حذف کول (Pro)
saved reply حذفوي.
پرو نسخهPOST …/abilities/zinn-chat/delete-canned-reply/runthe REST route's own per-item permission checkid: string (ضروري)
zinn-chat/delete-ticket
zinn-chat-delete-ticket
یو ټکټ ړنګول
یو ټکټ او د هغه خبرې اترې په بشپړه توګه له منځه وړي (یوازې مدیرانو لپاره).
وړیا نسخهPOST …/abilities/zinn-chat/delete-ticket/runthe REST route's own per-item permission checkid: string (ضروري)
zinn-chat/draft-kb-article
zinn-chat-draft-kb-article
د ټیکټ څخه د مرستې مقاله مسوده کړئ (Pro)
د حل شوي ټکټ څخه د پوهې د اډې (knowledge-base) د مسودې مقاله لیکي؛ دا تر هغه وخته مسوده پاتې کیږي ترڅو چې یو څوک یې خپره کړي.
پرو نسخهPOST …/abilities/zinn-chat/draft-kb-article/runedit_posts (the REST route's own check)هیڅ یو
zinn-chat/draft-kb-from-gaps
zinn-chat-draft-kb-from-gaps
د نه ځواب شويو پوښتنو لپاره د مرستې مقالې مسودې چمتو کړئ (Pro)
د پوهې د اډې (knowledge-base) مسوده مقالې چې ټاکل شوې پوښتنې (شناسې) ځوابوي، لیکي؛ دوی مسودې پاتې کیږي.
پرو نسخهPOST …/abilities/zinn-chat/draft-kb-from-gaps/runedit_posts (the REST route's own check)هیڅ یو
zinn-chat/fill-canned-reply
zinn-chat-fill-canned-reply
خوندي شوی ځواب ډک کړئ (Pro)
د یو چیټ یا ټکټ لپاره د ځای پر ځای شویو نښو (placeholder) په ډکولو سره د یوه خوندي شوي ځواب متن بیرته راګرځوي.
پرو نسخهPOST …/abilities/zinn-chat/fill-canned-reply/runthe REST route's own per-item permission checkid: string (ضروري)
zinn-chat/get-chat
zinn-chat-get-chat
چټ ولولئ
د یوو چټ پیغامونه او د لیدونکي تفصیالت بیرته راګرځوي (وروسته: یوازې د دې آی ډي څخه نوي پیغامونه).
وړیا نسخهGET …/abilities/zinn-chat/get-chat/runthe REST route's own per-item permission checkid: string (ضروري)
zinn-chat/get-overview
zinn-chat-get-overview
د ملاتړ لنډیز ولولئ
دا معلوموي چې په هر حالت کې څومره ټکټونه دي او څومره چټونه د یو کس په تمه دي (او د هغوی نه لوستل شوي پیغامونه)، او ایا چټ، مرستندوی او ټکټونه فعال دي که نه.
وړیا نسخهGET …/abilities/zinn-chat/get-overview/runzinn_chat_answerهیڅ یو
zinn-chat/get-settings
zinn-chat-get-settings
د چپې تنظیمات ولولئ
د خبرو اترو ټول تنظیمات بیرته راګرځوي: ویجټ، مرستیال، خلک او د پرانیستلو ساعتونه، ټکټونه او برېښنالیک، د سایټ شاخص، محرمیت او سپیم.
وړیا نسخهGET …/abilities/zinn-chat/get-settings/runzinn_chat_manageهیڅ یو
zinn-chat/get-stats
zinn-chat-get-stats
د ملاتړ احصایې ولولئ (Pro)
د تیرو N ورځو لپاره د چیټ او ټکټ شمیرې، د ځواب ویلو وختونه او درجه بندي بیرته راګرځوي (ورځې).
پرو نسخهGET …/abilities/zinn-chat/get-stats/runthe REST route's own per-item permission checkهیڅ یو
zinn-chat/get-ticket
zinn-chat-get-ticket
ټکټ ولولئ
یو ټکټ د هغه د ټولې خبرو اترو، حالت، لومړیتوب او ګمارل شوي کس سره بیرته راستنوي.
وړیا نسخهGET …/abilities/zinn-chat/get-ticket/runthe REST route's own per-item permission checkid: string (ضروري)
zinn-chat/hand-chat-to-assistant
zinn-chat-hand-chat-to-assistant
خبرې اترې بیرته مرستیال ته وسپارئ
د AI مرستیال ته یو چیټ بیرته راستانه کوي، کوم چې لیدونکي ته د سایټ له مینځه ځواب ورکوي.
وړیا نسخهPOST …/abilities/zinn-chat/hand-chat-to-assistant/runthe REST route's own per-item permission checkid: string (ضروري)
zinn-chat/list-canned-replies
zinn-chat-list-canned-replies
خپاره شوي ځوابونه لیست کړئ (Pro)
هغه خوندي شوي ځوابونه لیست کوي چې استازي یې د لنډلارو سره داخلولی شي.
پرو نسخهGET …/abilities/zinn-chat/list-canned-replies/runthe REST route's own per-item permission checkهیڅ یو
zinn-chat/list-chats
zinn-chat-list-chats
د ژوندۍ خبرې اترې لیست کول
انتظار، روان او وروستي تړل شوي چیټونه لیست کوي، او دا ښيي چې هر یو څوک پرمخ وړي.
وړیا نسخهGET …/abilities/zinn-chat/list-chats/runthe REST route's own per-item permission checkهیڅ یو
zinn-chat/list-indexed-content
zinn-chat-list-indexed-content
د مرستیال پوهه لیسټ کړئ
د مرستیال لخوا د ځواب ویلو لپاره مینځپانګه د دې د شاخص حالت سره یو ځل کې یو مخ لیست کوي.
وړیا نسخهGET …/abilities/zinn-chat/list-indexed-content/runthe REST route's own per-item permission checkهیڅ یو
zinn-chat/list-kb-gaps
zinn-chat-list-kb-gaps
د بې ځوابه پوښتنو لیست (Pro)
د هغه پوښتنو لست کوي چې لیدونکو کړې وې او پوهنغونډ یې ځواب نه شو ورکولای.
پرو نسخهGET …/abilities/zinn-chat/list-kb-gaps/runthe REST route's own per-item permission checkهیڅ یو
zinn-chat/list-tickets
zinn-chat-list-tickets
ټیکټونه لیست کړئ
د ملاتړ ټکټونه د وضعیت یا لټون له مخې فلتر شوي، په یو ځل کې د یوې پاڼې په اندازه ښيي.
وړیا نسخهGET …/abilities/zinn-chat/list-tickets/runthe REST route's own per-item permission checkهیڅ یو
zinn-chat/reembed-content
zinn-chat-reembed-content
د مرستیال د لټون شاخص بیا رغول
د یو توکي (item_id) یا هر څه (all: true) لپاره د لټون وکتورونه بیا جوړوي (یوازې مدیران).
وړیا نسخهPOST …/abilities/zinn-chat/reembed-content/runthe REST route's own per-item permission checkهیڅ یو
zinn-chat/reindex-content
zinn-chat-reindex-content
منځپانګه په مرستیال کې بیا ولولئ
د مرستيال په شاخص کې یو توکی (item_id) یا ټول شیان (all: true) بیا لولي (یوازې مدیران).
وړیا نسخهPOST …/abilities/zinn-chat/reindex-content/runthe REST route's own per-item permission checkهیڅ یو
zinn-chat/reply-chat
zinn-chat-reply-chat
په خبرو اترو کې ځواب ورکول
لیدونکي ته پیغام واستوئ (text)، یا یوه داخلي یادونه اضافه کړئ چې یوازې اجنټان یې ویني (note: true).
وړیا نسخهPOST …/abilities/zinn-chat/reply-chat/runthe REST route's own per-item permission checkid: string (ضروري)
zinn-chat/save-canned-reply
zinn-chat-save-canned-reply
خوندي ځواب خوندي کړئ (Pro)
یوه خوندي شوې ځوابیه جوړوي یا بدلوي (سرلیک، شارټ کټ، متن، څانګه؛ د یو د بدلولو لپاره آی ډي).
پرو نسخهPOST …/abilities/zinn-chat/save-canned-reply/runthe REST route's own per-item permission checkهیڅ یو
zinn-chat/save-kb-article
zinn-chat-save-kb-article
د مرستې یوه مقاله ولیکئ (Pro)
د پوهې د اډې یوه مقاله جوړوي، یا یو بلوي (id): سرلیک، منځپانګه، لنډیز، کټګورۍ او حالت (مسوده، یا خپرول کله چې تاسو خپرولی شئ).
پرو نسخهPOST …/abilities/zinn-chat/save-kb-article/runedit_postsid: integer, title: string, content: string, excerpt: string, categories: array, status: draft|publish
zinn-chat/search-kb
zinn-chat-search-kb
د پوهې بنسټ وپلټئ (Pro)
په ځواب کې د لینک کولو لپاره د مرستې مقالې ومومئ (q: لټون).
پرو نسخهGET …/abilities/zinn-chat/search-kb/runthe REST route's own per-item permission checkهیڅ یو
zinn-chat/set-conversation-details
zinn-chat-set-conversation-details
د یوې خبرو اترې څانګه او ټاګونه وټاکئ (Pro)
د چیټ یا ټکټ څانګه او ټاګونه تنظیموي (ډول: چیټ یا ټکټ؛ id).
پرو نسخهPOST …/abilities/zinn-chat/set-conversation-details/runthe REST route's own per-item permission checkهیڅ یو
zinn-chat/set-kb-gap-status
zinn-chat-set-kb-gap-status
نامځوابه پوښتنې په نښه کړئ (Pro)
نامعلوم پوښتنې د پرانیستې، پلان شوې یا رد شوې په توګه په نښه کوي (ids، status).
پرو نسخهPOST …/abilities/zinn-chat/set-kb-gap-status/runthe REST route's own per-item permission checkهیڅ یو
zinn-chat/set-presence
zinn-chat-set-presence
خپله شتون وټاکئ
د نویو خبرو اترو لپاره لاسلیک شوی استازی شتون لرونکی یا لیرې په نښه کوي (لیرې: true یا false).
وړیا نسخهPOST …/abilities/zinn-chat/set-presence/runthe REST route's own per-item permission checkهیڅ یو
zinn-chat/suggest-reply
zinn-chat-suggest-reply
د AI په مرسته ځواب مسوده کړئ (Pro)
د سایټ د مینځپانګې څخه چټ یا ټکټ ته ځواب مسوده کوي؛ هیڅ شی نه لیږل کیږي.
پرو نسخهPOST …/abilities/zinn-chat/suggest-reply/runthe REST route's own per-item permission checkهیڅ یو
zinn-chat/summarise-conversation
zinn-chat-summarise-conversation
له AI سره د خبرو اترو لنډیز (Pro)
یوې خبرې اترې یا ټکټ په څو کرښو کې لنډوي.
پرو نسخهPOST …/abilities/zinn-chat/summarise-conversation/runthe REST route's own per-item permission checkهیڅ یو
zinn-chat/take-chat
zinn-chat-take-chat
chat پیلول
یو منتظر چیټ لاسلیک شوي اېجنټ ته ورکوي، ترڅو لیدونکی له یو شخص سره خبرې وکړي.
وړیا نسخهPOST …/abilities/zinn-chat/take-chat/runthe REST route's own per-item permission checkid: string (ضروري)
zinn-chat/update-settings
zinn-chat-update-settings
د خبرو اترو امستنې بدلول
ستاسو لخوا استول شوي ترتیبات بدلوي (ترتیبات: کیلي د ارزښت لپاره) او پاتې نور ساتي. هر ارزښت په سمه توګه د تنظیماتو سکرین په څیر چک کیږي؛ get-settings کیلي لیست کوي.
وړیا نسخهPOST …/abilities/zinn-chat/update-settings/runzinn_chat_managesettings: object (ضروري)
zinn-chat/update-ticket
zinn-chat-update-ticket
ټکټ بدلول
د ټکټ حالت، لومړیتوب یا ټاکل شوی کس بدلوي.
وړیا نسخهPOST …/abilities/zinn-chat/update-ticket/runthe REST route's own per-item permission checkid: string (ضروري)