Horumariyeyaasha

Tixraaca awoodaha Zinn® Chat

Zinn® Chat waxay falalkeeda ka diiwaan gelisaa WordPress Abilities API. Awoodahaas oo kalena waa qalabka MCP ee server-ka bogga iyo waddooyinka REST ee hoos yimaada /wp-json/wp-abilities/v1. Boggan waxaa laga soo saaray diiwaanka plugin-ka laftiisa.

Hage isticmaale: ku xidh abka AI

Meelaha laga baxo

MCP over HTTP (loo baahan yahay in la daawado)

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

MCP over WP-CLI (halabuurka iyo wax-soo-saarka caadiga ah)

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

REST: liiska awoodaha

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

REST: socodsii awood

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

Xaqiijinta iyo fasaxyada

Codsiga HTTP wuxuu ku xaqiijiyaa erayga sirta ah ee codsiga WordPress (HTTP Basic). Ku xidhirka server-ka MCP wuxuu u baahan yahay awoodda hoos ku xusan; awood kastaa waxay markaas hubisaa ogolaanshaha u gaarka ah, shay kasta. Awoodaha akhriska-kaliya waxay ku shaqeeyaan GET iyo gelidooda xadhigga su'aasha; kuwa kalena waxay ku shaqeeyaan POST iyo jirka JSON {"input": {…}}.

Tusaalooyin

# REST: socodsii awood
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":{}}}

Dhammaan awoodaha

Waxaa laga soo saaray abilities.json ee plugin-ka, taas oo iyaduna laga soo saaray shabakad shaqaynaysa; imtixaanku wuu dhacaa marka labadaas ay is khilaafaan.

AwooddaWaxa ay qabatoDaabacaadNasashoOgolaanshoHalbeegyada
zinn-chat/answer-ticket
zinn-chat-answer-ticket
Ka jawaab tigidhka
Wuxuu iimayl ugu jawaabaa macmiilka (qoraal), ama wuxuu ku darayaa qoraal gudaha ah (note: true); xaaladdu si ikhtiyaari ah ayay u beddeshaa xaaladda tigidhka.
Daabacaadda bilaashka ahPOST …/abilities/zinn-chat/answer-ticket/runthe REST route's own per-item permission checkid: string (Loo baahan yahay)
zinn-chat/ask-assistant
zinn-chat-ask-assistant
Weydii kaaliyaha
Waxay weydiisaa kaaliyaha AI ee barta su'aal waxayna soo celisaa jawaabtiisa iyada oo wadata dhammaan ilaha ay heshay.
Daabacaadda bilaashka ahPOST …/abilities/zinn-chat/ask-assistant/runthe REST route's own per-item permission checkmid ahayn
zinn-chat/bulk-update-tickets
zinn-chat-bulk-update-tickets
Badal tikidhada badan hal mar (Pro)
Wax ka beddelaya heerka, muhiimadda ama qofka loo xil saaray ilaa 100 tikidh (aqoonsiyada). Tikidh kasta wuxuu maraa isla hubinta sidii iyagoo gaar u ah; natiijadu waxay taxaysaa mid kasta.
Daabacaadda ProPOST …/abilities/zinn-chat/bulk-update-tickets/runzinn_chat_answerids: array (Loo baahan yahay), status: open|pending|solved|closed, priority: low|normal|high|urgent, assignee_id: integer
zinn-chat/chat-to-ticket
zinn-chat-chat-to-ticket
Sheeko chat ah u beddel tigidh
Wuxuu ka furayaa tigidh wadahadal ah si loogu jawaabo iimayl ahaan (wuxuu u baahan yahay cinwaanka iimaylka ee booqdaha).
Daabacaadda bilaashka ahPOST …/abilities/zinn-chat/chat-to-ticket/runthe REST route's own per-item permission checkid: string (Loo baahan yahay)
zinn-chat/close-chat
zinn-chat-close-chat
Xir wadasheekeysi
Wuxuu soo gabagabeeyaa sheekaysiga; booqdaygu wuxuu weli codsan karaa qoraalka wada-hadalka.
Daabacaadda bilaashka ahPOST …/abilities/zinn-chat/close-chat/runthe REST route's own per-item permission checkid: string (Loo baahan yahay)
zinn-chat/create-ticket
zinn-chat-create-ticket
Ka fur tigidh
Wuxuu u furayaa tigidh magaca macaamiisha (iimaylkooda, mawduuca iyo fariinta koowaad).
Daabacaadda bilaashka ahPOST …/abilities/zinn-chat/create-ticket/runthe REST route's own per-item permission checkmid ahayn
zinn-chat/delete-canned-reply
zinn-chat-delete-canned-reply
Tirtir jawaab la keydiyay (Pro)
Wuxuu tirtirayaa jawaab la keydiyay.
Daabacaadda ProPOST …/abilities/zinn-chat/delete-canned-reply/runthe REST route's own per-item permission checkid: string (Loo baahan yahay)
zinn-chat/delete-ticket
zinn-chat-delete-ticket
Tirtir tigidh
Waxay tirtirtaa tikidhka iyo wada-sheekaysigiisa si rasmi ah (maamulayaasha oo keliya).
Daabacaadda bilaashka ahPOST …/abilities/zinn-chat/delete-ticket/runthe REST route's own per-item permission checkid: string (Loo baahan yahay)
zinn-chat/draft-kb-article
zinn-chat-draft-kb-article
Qoraal caawimaad ah ka qor tigidh (Pro)
Waxay qortaa qabyo-qoraal maqaalka saldhigga aqoonta ah oo laga soo qaatay tigidh la xalliyey; wuxuu ahaanayaa qabyo-qoraal illaa qof uu daabaco.
Daabacaadda ProPOST …/abilities/zinn-chat/draft-kb-article/runedit_posts (the REST route's own check)mid ahayn
zinn-chat/draft-kb-from-gaps
zinn-chat-draft-kb-from-gaps
Qabyo qoraal caawimaad ah oo loogu talagalay su'aalaha aan la jawaabin (Pro)
Waxay qortaa qabyo-qoraallada maqaallada saldhigga aqoonta ee ka jawaabaya su'aalaha la doortay (ids); waxay ahaanayaan qabyo-qoraal.
Daabacaadda ProPOST …/abilities/zinn-chat/draft-kb-from-gaps/runedit_posts (the REST route's own check)mid ahayn
zinn-chat/fill-canned-reply
zinn-chat-fill-canned-reply
Buuxi jawaab la keydiyay (Pro)
Wuxuu soo celinayaa qoraalka jawaabta la keydiyay iyada oo meelaha ay bannaan yihiin laga buuxiyay hal sheeko ama tikidh.
Daabacaadda ProPOST …/abilities/zinn-chat/fill-canned-reply/runthe REST route's own per-item permission checkid: string (Loo baahan yahay)
zinn-chat/get-chat
zinn-chat-get-chat
Akhri sheeko-wadaagaha
Waxay soo celisaa fariimaha hal wada-sheekaysi iyo faahfaahinta booqdaha (after: kaliya fariimaha ka cusub aqoonsigan).
Daabacaadda bilaashka ahGET …/abilities/zinn-chat/get-chat/runthe REST route's own per-item permission checkid: string (Loo baahan yahay)
zinn-chat/get-overview
zinn-chat-get-overview
Akhri dulmar taageerada
Waxay soo celineysaa inta tikidh ee ku jirta xaalad kasta iyo inta wada-sheekaysi ee sugaysa qof (iyo fariimahooda aan la akhrinin), iyo in wada-sheekaysiga, caawiyaha iyo tikidhada ay shidmaan.
Daabacaadda bilaashka ahGET …/abilities/zinn-chat/get-overview/runzinn_chat_answermid ahayn
zinn-chat/get-settings
zinn-chat-get-settings
Akhri dejinta sheekaysiga
Waxay soo celisaa dhammaan habaynta sheekaysiga: widget-ka, kaaliyaha, dadka iyo saacadaha shaqada, tigidhada iyo iimaylka, tusmada goobta, asturnaanta iyo spam-ka.
Daabacaadda bilaashka ahGET …/abilities/zinn-chat/get-settings/runzinn_chat_managemid ahayn
zinn-chat/get-stats
zinn-chat-get-stats
Akhriso tirakoobka taageero (Pro)
Waxay soo celisaa tirooyinka wada-sheekaysiga iyo tikidhada, waqtiyada jawaabta iyo qiimaynta N-ta maalmood ee la soo dhaafay (maalmo).
Daabacaadda ProGET …/abilities/zinn-chat/get-stats/runthe REST route's own per-item permission checkmid ahayn
zinn-chat/get-ticket
zinn-chat-get-ticket
Akhri tigidhka
Wuxuu soo celinayaa hal tigidh oo ay ku jirto wada-hadalkiisa oo dhan, heerka uu marayo, mudnaanta iyo qofka loo xil saaray.
Daabacaadda bilaashka ahGET …/abilities/zinn-chat/get-ticket/runthe REST route's own per-item permission checkid: string (Loo baahan yahay)
zinn-chat/hand-chat-to-assistant
zinn-chat-hand-chat-to-assistant
Wadahadal dib ugu celi caawiyaha
Wuxuu jawaab u celinayaa kaaliyaha AI, kaas oo uga jawaabaya booqdaha waxyaabaha ku jira mareegta.
Daabacaadda bilaashka ahPOST …/abilities/zinn-chat/hand-chat-to-assistant/runthe REST route's own per-item permission checkid: string (Loo baahan yahay)
zinn-chat/list-canned-replies
zinn-chat-list-canned-replies
Liiska jawaabaha la keydiyay (Pro)
Waxay taxaysaa jawaabaha la keydiyay ee wakiiladu geli karaan, iyada oo ay la socdaan gaabisyadooda.
Daabacaadda ProGET …/abilities/zinn-chat/list-canned-replies/runthe REST route's own per-item permission checkmid ahayn
zinn-chat/list-chats
zinn-chat-list-chats
Liiska sheekooyinka tooska ah
Waxay liis garaysaa sheekooyinka sugaya, kuwa socda iyo kuwa dhawaan la xiray, iyada oo wadata qofka gacanta ku haya mid walba.
Daabacaadda bilaashka ahGET …/abilities/zinn-chat/list-chats/runthe REST route's own per-item permission checkmid ahayn
zinn-chat/list-indexed-content
zinn-chat-list-indexed-content
Qor waxa caawiyaha uu garanayo
Waxay ku qortaa liiska waxyaabaha uu ka jawaabo kaaliyuhu, oo ay ku jirto heerka tusmeynteeda, bogkiiba mar.
Daabacaadda bilaashka ahGET …/abilities/zinn-chat/list-indexed-content/runthe REST route's own per-item permission checkmid ahayn
zinn-chat/list-kb-gaps
zinn-chat-list-kb-gaps
Liiska su'alaha aan la jawaabin (Pro)
Waxay ku qortaa su'aalaha ay booqdayaashu weydiiyeen ee aysan xog-ururintu ka jawaabi karin.
Daabacaadda ProGET …/abilities/zinn-chat/list-kb-gaps/runthe REST route's own per-item permission checkmid ahayn
zinn-chat/list-tickets
zinn-chat-list-tickets
Liiska tigidhada
Waxay soo bandhigaysaa tigidhada taageerada, oo lagu sifeeyay heer ama baaritaan, hal bog markiiba.
Daabacaadda bilaashka ahGET …/abilities/zinn-chat/list-tickets/runthe REST route's own per-item permission checkmid ahayn
zinn-chat/reembed-content
zinn-chat-reembed-content
Dib u dhis tusmada raadinta caawiyaha
Waxay dib u dhisaysaa faylasha baaritaanka ee hal shay (item_id) ama wax walba (all: true) (maamulayaasha kaliya).
Daabacaadda bilaashka ahPOST …/abilities/zinn-chat/reembed-content/runthe REST route's own per-item permission checkmid ahayn
zinn-chat/reindex-content
zinn-chat-reindex-content
Dib ugu akhri waxa ku jira caawiyaha
Waxay dib u akhrisaa hal shay (item_id) ama wax walba (all: true) oo ku jira tusmada caawiyaha (maareeyayaasha kaliya).
Daabacaadda bilaashka ahPOST …/abilities/zinn-chat/reindex-content/runthe REST route's own per-item permission checkmid ahayn
zinn-chat/reply-chat
zinn-chat-reply-chat
Kaga jawaab sheeko-wadaagaha
Wuxuu fariin u diraa booqashada (text), ama wuxuu ku darayaa qoraal gudaha ah oo ay wakiilada kaliya arkaan (note: true).
Daabacaadda bilaashka ahPOST …/abilities/zinn-chat/reply-chat/runthe REST route's own per-item permission checkid: string (Loo baahan yahay)
zinn-chat/save-canned-reply
zinn-chat-save-canned-reply
Kaydi jawaabta la keydiyay (Pro)
Wuxuu abuuraa ama beddelaa jawaab la keydiyay (cinwaan, gaabin, jidh, waax; id si loo beddelo mid).
Daabacaadda ProPOST …/abilities/zinn-chat/save-canned-reply/runthe REST route's own per-item permission checkmid ahayn
zinn-chat/save-kb-article
zinn-chat-save-kb-article
Qor maqaal caawimaad ah (Pro)
Waxay abuurtaa maqaal aqoon-saldhig ah, ama ay wax ka beddeshaa mid (id): cinwaanka, waxa ku jira, soo-gaabinta, qaybaha iyo heerka (qabyo, ama daabac marka aad daabici karto).
Daabacaadda ProPOST …/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
Raadi saldhigga aqoonta (Pro)
Wuxuu helaa maqaallada caawimada ee lagu xiriirinayo jawaabta (q: raadinta).
Daabacaadda ProGET …/abilities/zinn-chat/search-kb/runthe REST route's own per-item permission checkmid ahayn
zinn-chat/set-conversation-details
zinn-chat-set-conversation-details
Geli waaxda iyo sumadaha wada-sheekaysiga (Pro)
Waxay dejisaa waaxda iyo calaamadaha wada-sheekaysiga ama tikidhada (nooca: wada-sheekaysiga ama tikidhada; id).
Daabacaadda ProPOST …/abilities/zinn-chat/set-conversation-details/runthe REST route's own per-item permission checkmid ahayn
zinn-chat/set-kb-gap-status
zinn-chat-set-kb-gap-status
Calaamadi su'aalaha aan la jawaabin (Pro)
Waxay calaamadeysaa su'aalaha aan la jawaabin inay yihiin kuwo furan, qorshaysan ama la diiday (aqoonsiyada, heerka).
Daabacaadda ProPOST …/abilities/zinn-chat/set-kb-gap-status/runthe REST route's own per-item permission checkmid ahayn
zinn-chat/set-presence
zinn-chat-set-presence
Deji helitaankaada
Waxay calaamadinaysaa wakiilka soo galay inuu diyaar yahay ama uu maqan yahay sheekooyinka cusub (maqan: run ama been).
Daabacaadda bilaashka ahPOST …/abilities/zinn-chat/set-presence/runthe REST route's own per-item permission checkmid ahayn
zinn-chat/suggest-reply
zinn-chat-suggest-reply
Qor jawaab adoo adeegsanaya AI (Pro)
Wuxuu qoraa jawaab ku socota wada-sheekaysi ёr tigidh ka yimid waxa ku jira bogga; waxba lama diro.
Daabacaadda ProPOST …/abilities/zinn-chat/suggest-reply/runthe REST route's own per-item permission checkmid ahayn
zinn-chat/summarise-conversation
zinn-chat-summarise-conversation
So koobi wada hadalka AI (Pro)
Wuxuu soo koobayaa wada-sheekaysiga ama tigidhka dhowr sadar.
Daabacaadda ProPOST …/abilities/zinn-chat/summarise-conversation/runthe REST route's own per-item permission checkmid ahayn
zinn-chat/take-chat
zinn-chat-take-chat
Wada sheekeysi samee
Wuxuu sheekeysi sugaya u qoondeeyaa wakiilka soo galay, si booqdaha ula hadlo qof.
Daabacaadda bilaashka ahPOST …/abilities/zinn-chat/take-chat/runthe REST route's own per-item permission checkid: string (Loo baahan yahay)
zinn-chat/update-settings
zinn-chat-update-settings
Beddel goobaha sheeko-wadaagta
Waxay bedeshaa dejinta aad dirto (dejin: furaha ilaa qiimaha) waxayna haysaa inta kale. Qiime kasta waxaa loo hubiyaa si sax ah sida shaashadda dejinta; get-settings ayaa liis gareeya furayaasha.
Daabacaadda bilaashka ahPOST …/abilities/zinn-chat/update-settings/runzinn_chat_managesettings: object (Loo baahan yahay)
zinn-chat/update-ticket
zinn-chat-update-ticket
Beddel tigidh
Wax ka beddela xaaladda tikidhada, mudnaanta ama qofka loo xilsaaray.
Daabacaadda bilaashka ahPOST …/abilities/zinn-chat/update-ticket/runthe REST route's own per-item permission checkid: string (Loo baahan yahay)