Zhvilluesit

Referenca e aftësive për Zinn® Chat

Zinn® Chat regjistron veprimet e veta te WordPress Abilities API. Të njëjtat aftësi janë mjete MCP në serverin e vet të faqes dhe rrugë REST nën /wp-json/wp-abilities/v1. Kjo faqe gjenerohet nga regjistri i vetë shtojcës.

Udhëzuesi i përdoruesit: lidhni një aplikacion AI

Pikat përfundimtare

MCP mbi HTTP (që transmetohet)

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

MCP përmes WP-CLI (hyrja dhe dalja standarde)

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

REST: listoni aftësitë

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

REST: ekzekuto një aftësi

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

Autentifikimi dhe lejet

Kërkesat HTTP autentikohen me një fjalëkalim aplikacioni WordPress (HTTP Basic). Lidhja me serverin MCP kërkon aftësinë e treguar më poshtë; çdo aftësi më pas kontrollon lejen e saj, për çdo objekt. Aftësitë vetëm për lexim ekzekutohen me GET dhe hyrjen e lor në vargun e pyetjes (query string); të tjerat me POST dhe një trup JSON {"input": {…}}.

Shembuj

# REST: ekzekuto një aftësi
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":{}}}

Të gjitha aftësitë

Gjeneruar nga abilities.json i shtojcës, i cili nga ana e tij gjenerohet nga një sajt në ekzekutim; një test dështon kur të dyja nuk pajtohen.

Aftësia	Çfarë bën	Edicioni	REST	Leja	Parametrat
`zinn-chat/answer-ticket` `zinn-chat-answer-ticket`	Përgjigju një ticket-i Përgjigjet ndaj klientit me email (text), ose shton një shënim të brendshëm (note: true); statusi ndryshon opsionalisht statusin e kërkesës.	Edicioni falas	`POST …/abilities/zinn-chat/answer-ticket/run`	the REST route's own per-item permission check	id: string (kërkuar)
`zinn-chat/ask-assistant` `zinn-chat-ask-assistant`	Pyetni asistentin I bën një pyetje asistentei AI të faqes dhe kthen përgjigjen e tij me çdo burim që gjeti.	Edicioni falas	`POST …/abilities/zinn-chat/ask-assistant/run`	the REST route's own per-item permission check	asnjë
`zinn-chat/bulk-update-tickets` `zinn-chat-bulk-update-tickets`	Ndrysho shumë bileta menjëherë (Pro) Ndryshon statusin, prioritetin ose të caktuarin e deri në 100 tiketave (ID). Çdo tiketë kalon në të njëjtat kontrolle sikur të ndryshohej vetëm; rezultati liston secilën prej tyre.	Edicioni Pro	`POST …/abilities/zinn-chat/bulk-update-tickets/run`	zinn_chat_answer	ids: array (kërkuar), status: open\|pending\|solved\|closed, priority: low\|normal\|high\|urgent, assignee_id: integer
`zinn-chat/chat-to-ticket` `zinn-chat-chat-to-ticket`	Shndërro një bisedë në një kërkesë mbështetjeje Helpon një kërkesë nga një bisedë në mënyrë që ajo të mund të përgjigjet me email (kërkon adresën e emailit të vizitorit).	Edicioni falas	`POST …/abilities/zinn-chat/chat-to-ticket/run`	the REST route's own per-item permission check	id: string (kërkuar)
`zinn-chat/close-chat` `zinn-chat-close-chat`	Mbyll një bisedë Përfundon një bisedë; vizitori mund të kërkojë ende transkriptin.	Edicioni falas	`POST …/abilities/zinn-chat/close-chat/run`	the REST route's own per-item permission check	id: string (kërkuar)
`zinn-chat/create-ticket` `zinn-chat-create-ticket`	Hapni një biletë Helpin një biletë në emër të një klienti (email-in e tij, një subjekt dhe mesazhin e parë).	Edicioni falas	`POST …/abilities/zinn-chat/create-ticket/run`	the REST route's own per-item permission check	asnjë
`zinn-chat/delete-canned-reply` `zinn-chat-delete-canned-reply`	Fshi një përgjigje të ruajtur (Pro) Fshin një përgjigje të ruajtur.	Edicioni Pro	`POST …/abilities/zinn-chat/delete-canned-reply/run`	the REST route's own per-item permission check	id: string (kërkuar)
`zinn-chat/delete-ticket` `zinn-chat-delete-ticket`	Fshi një biletë Fshin përgjithmonë një kërkesë mbështetjeje dhe bisedën e saj (vetëm për menaxherët).	Edicioni falas	`POST …/abilities/zinn-chat/delete-ticket/run`	the REST route's own per-item permission check	id: string (kërkuar)
`zinn-chat/draft-kb-article` `zinn-chat-draft-kb-article`	Hartoni një artikull ndihme nga një biletë (Pro) Shkruan një draft artikulli për bazën e njohurive nga një biletë e zgjidhur; ai mbetet draft derisa dikush ta publikojë atë.	Edicioni Pro	`POST …/abilities/zinn-chat/draft-kb-article/run`	edit_posts (the REST route's own check)	asnjë
`zinn-chat/draft-kb-from-gaps` `zinn-chat-draft-kb-from-gaps`	Skiconi artikuj ndihme për pyetjet pa përgjigje (Pro) Shkruan artikuj draft të bazës së njohurive që u përgjigjen pyetjeve të zgjedhura (id); ato mbeten draftë.	Edicioni Pro	`POST …/abilities/zinn-chat/draft-kb-from-gaps/run`	edit_posts (the REST route's own check)	asnjë
`zinn-chat/fill-canned-reply` `zinn-chat-fill-canned-reply`	Plotni një përgjigje të ruajtur (Pro) Kthen tekstin e një përgjigjeje të ruajtur me vendmbajtësit e plotësuar për një bisedë ose një biletë.	Edicioni Pro	`POST …/abilities/zinn-chat/fill-canned-reply/run`	the REST route's own per-item permission check	id: string (kërkuar)
`zinn-chat/get-chat` `zinn-chat-get-chat`	Lexo një bisedë Kthen mesazhet dhe detajet e vizitorit të një bisede (after: vetëm mesazhet më të reja se ky ID).	Edicioni falas	`GET …/abilities/zinn-chat/get-chat/run`	the REST route's own per-item permission check	id: string (kërkuar)
`zinn-chat/get-overview` `zinn-chat-get-overview`	Lexoni përmbledhjen e mbështetjes Kthen se sa biletë janë në secilin status dhe sa biseda janë duke pritur për një person (dhe mesazhet e tyre të palexuara), si dhe nëse biseda, asistenti dhe biletat janë të ndezura.	Edicioni falas	`GET …/abilities/zinn-chat/get-overview/run`	zinn_chat_answer	asnjë
`zinn-chat/get-settings` `zinn-chat-get-settings`	Lexo cilësimet e bisedës Kthen çdo cilësim të bisedës: widget-in, asistentin, personat dhe orët e hapjes, biletat dhe email-in, indeksin e faqes, privatësinë dhe spam-in.	Edicioni falas	`GET …/abilities/zinn-chat/get-settings/run`	zinn_chat_manage	asnjë
`zinn-chat/get-stats` `zinn-chat-get-stats`	Lexoni statistikat e mbështetjes (Pro) Kthen numrat e bisedave dhe të biletave, kohët e përgjigjes dhe vlerësimet për N ditët e fundit (ditët).	Edicioni Pro	`GET …/abilities/zinn-chat/get-stats/run`	the REST route's own per-item permission check	asnjë
`zinn-chat/get-ticket` `zinn-chat-get-ticket`	Lexo një biletë Kthen një biletë me të gjithë bisedën, statusin, prioritetin dhe personin e caktuar të saj.	Edicioni falas	`GET …/abilities/zinn-chat/get-ticket/run`	the REST route's own per-item permission check	id: string (kërkuar)
`zinn-chat/hand-chat-to-assistant` `zinn-chat-hand-chat-to-assistant`	Kthejini një bisedë sërish asistenti Kthen një bisedë tek asistenti i AI, i cili i përgjigjet vizitorit nga përmbajtja e faqes.	Edicioni falas	`POST …/abilities/zinn-chat/hand-chat-to-assistant/run`	the REST route's own per-item permission check	id: string (kërkuar)
`zinn-chat/list-canned-replies` `zinn-chat-list-canned-replies`	Listo përgjigjet e ruajtura (Pro) Rendit përgjigjet e ruajtura që agjentët mund t'i fusin, së bashku me shkurtesat e tyre.	Edicioni Pro	`GET …/abilities/zinn-chat/list-canned-replies/run`	the REST route's own per-item permission check	asnjë
`zinn-chat/list-chats` `zinn-chat-list-chats`	Listo bisedat direkte Rendit bisedat në pritje, në progres dhe të mbyllura së fundmi, së bashku me personin që po trajton secilën prej tyre.	Edicioni falas	`GET …/abilities/zinn-chat/list-chats/run`	the REST route's own per-item permission check	asnjë
`zinn-chat/list-indexed-content` `zinn-chat-list-indexed-content`	Listo se çfarë di asistenti Rendit përmbajtjen nga e cila përgjigjet asistenti, së bashku me statusin e indeksimit të saj, një faqe në të njëjtën kohë.	Edicioni falas	`GET …/abilities/zinn-chat/list-indexed-content/run`	the REST route's own per-item permission check	asnjë
`zinn-chat/list-kb-gaps` `zinn-chat-list-kb-gaps`	Lista e pyetjeve pa përgjigje (Pro) Liston pyetjet që vizitorët bënë, të cilave baza e njohurive nuk mund t'u përgjigjej.	Edicioni Pro	`GET …/abilities/zinn-chat/list-kb-gaps/run`	the REST route's own per-item permission check	asnjë
`zinn-chat/list-tickets` `zinn-chat-list-tickets`	Listo biletat Rendit biletat e mbështetjes, të filtruara sipas statusit ose një kërkimi, një faqe në të njëjtën kohë.	Edicioni falas	`GET …/abilities/zinn-chat/list-tickets/run`	the REST route's own per-item permission check	asnjë
`zinn-chat/reembed-content` `zinn-chat-reembed-content`	Rindërtoni indeksin e kërkimit të asistentes Rindërton vektorët e kërkimit për një artikull (item_id) ose për të gjitha (all: true) (vetëm për menaxherët).	Edicioni falas	`POST …/abilities/zinn-chat/reembed-content/run`	the REST route's own per-item permission check	asnjë
`zinn-chat/reindex-content` `zinn-chat-reindex-content`	Rifutoni përmbajtjen në asistent Rifreskon një artikull (item_id) ose gjithçka (all: true) në indeksin e asistentit (vetëm për menaxherët).	Edicioni falas	`POST …/abilities/zinn-chat/reindex-content/run`	the REST route's own per-item permission check	asnjë
`zinn-chat/reply-chat` `zinn-chat-reply-chat`	Përgjigju në një bisedë Dërgon një mesazh te vizitori (text), ose shton një shënim të brendshëm që e shohin vetëm agjentët (note: true).	Edicioni falas	`POST …/abilities/zinn-chat/reply-chat/run`	the REST route's own per-item permission check	id: string (kërkuar)
`zinn-chat/save-canned-reply` `zinn-chat-save-canned-reply`	Ruaj një përgjigje të ruajtur (Pro) Krijon ose ndryshon një përgjigje të ruajtur (titulli, shkurtorja, trupi, departamenti; id për të ndryshuar një).	Edicioni Pro	`POST …/abilities/zinn-chat/save-canned-reply/run`	the REST route's own per-item permission check	asnjë
`zinn-chat/save-kb-article` `zinn-chat-save-kb-article`	Shkruani një artikull ndihme (Pro) Krijon një artikull të bazës së njohurive ose ndryshon një (id): titullin, përmbajtjen, fragmentin, kategoritë dhe statusin (skicë, ose publiko kur mund të publikosh).	Edicioni Pro	`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-kb` `zinn-chat-search-kb`	Kërko në bazën e njohurive (Pro) Gjen artikuj ndihme për t'i lidhur në një përgjigje (q: kërkimi).	Edicioni Pro	`GET …/abilities/zinn-chat/search-kb/run`	the REST route's own per-item permission check	asnjë
`zinn-chat/set-conversation-details` `zinn-chat-set-conversation-details`	Vendosni departamentin dhe etiketat e një bisede (Pro) Vendos departamentin dhe etiketat e një bisede ose tikete (lloji: bisedë ose tiketë; id).	Edicioni Pro	`POST …/abilities/zinn-chat/set-conversation-details/run`	the REST route's own per-item permission check	asnjë
`zinn-chat/set-kb-gap-status` `zinn-chat-set-kb-gap-status`	Shëno pyetjet pa përgjigje (Pro) Shënon pyetjet e pakthyera si të hapura, të planifikuara ose të refuzuara (ID, statusi).	Edicioni Pro	`POST …/abilities/zinn-chat/set-kb-gap-status/run`	the REST route's own per-item permission check	asnjë
`zinn-chat/set-presence` `zinn-chat-set-presence`	Vendosni disponueshmërinë tuaj Shënon agjentin e kyçur si të disponueshëm ose larg për biseda të jafta (larg: i vërtetë ose i rremë).	Edicioni falas	`POST …/abilities/zinn-chat/set-presence/run`	the REST route's own per-item permission check	asnjë
`zinn-chat/suggest-reply` `zinn-chat-suggest-reply`	Krijo një përgjigje me AI (Pro) Krijon një draft përgjigjeje për një bisedë ose biletë nga përmbajtja e faqes; nuk dërgohet asgjë.	Edicioni Pro	`POST …/abilities/zinn-chat/suggest-reply/run`	the REST route's own per-item permission check	asnjë
`zinn-chat/summarise-conversation` `zinn-chat-summarise-conversation`	Përmblidhni një bisedë me AI (Pro) Përmbledh një bisedë ose biletë në pak rreshta.	Edicioni Pro	`POST …/abilities/zinn-chat/summarise-conversation/run`	the REST route's own per-item permission check	asnjë
`zinn-chat/take-chat` `zinn-chat-take-chat`	Fisni në chat I confronon një bisedë në pritje agjentit të kyçur, në mënyrë që vizitori të flasë me një person.	Edicioni falas	`POST …/abilities/zinn-chat/take-chat/run`	the REST route's own per-item permission check	id: string (kërkuar)
`zinn-chat/update-settings` `zinn-chat-update-settings`	Ndrysho cilësimet e bisedës Ndryshon cilësimet që dërgoni (cilësimet: çelësi në vlerë) dhe ruan pjesën tjetër. Çdo vlerë kontrollohet saktësisht si në ekranin e cilësimeve; get-settings liston çelësat.	Edicioni falas	`POST …/abilities/zinn-chat/update-settings/run`	zinn_chat_manage	settings: object (kërkuar)
`zinn-chat/update-ticket` `zinn-chat-update-ticket`	Ndrysho një kërkesë mbështetjeje Ndryshon statusin, prioritetin ose të caktuarin e një tikete.	Edicioni falas	`POST …/abilities/zinn-chat/update-ticket/run`	the REST route's own per-item permission check	id: string (kërkuar)