Dezvoltatori

Referință privind capacitățile Zinn® Chat

Zinn® Chat își înregistrează acțiunile în WordPress Abilities API. Aceleași capacități sunt instrumente MCP pe propriul server al site-ului și rute REST sub /wp-json/wp-abilities/v1. Această pagină este generată din propriul registru al pluginului.

Ghidul utilizatorului: conectarea unei aplicații AI

Puncte finale

MCP prin HTTP (streamabil)

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

MCP prin WP-CLI (intrare și ieșire standard)

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

REST: listați capabilitățile

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

REST: rulează o abilitate

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

Autentificare și permisiuni

Cererile HTTP se autentifică cu o parolă de aplicație WordPress (HTTP Basic). Conectarea la serverul MCP necesită capabilitatea afișată mai jos; fiecare abilitate își verifică apoi propria permisiune, per obiect. Abilitățile doar pentru citire rulează cu GET și datele de intrare în șirul de interogare; celelalte cu POST și un corp JSON {"input": {…}}.

Exemple

# REST: rulează o abilitate
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":{}}}

Toate abilitățile

Generat din fișierul abilities.json al pluginului, care la rândul său este generat dintr-un site în execuție; un test eșuează atunci când cele două nu concordă.

Capacitate	Ce face	Ediție	REST	Permisiune	Parametri
`zinn-chat/answer-ticket` `zinn-chat-answer-ticket`	Răspundeți la un tichet Răspunde clientului prin e-mail (text) sau adaugă o notă internă (note: true); starea modifică opțional starea tichetului.	Ediție gratuită	`POST …/abilities/zinn-chat/answer-ticket/run`	the REST route's own per-item permission check	id: string (obligatoriu)
`zinn-chat/ask-assistant` `zinn-chat-ask-assistant`	Întreabă asistentul Pune o întrebare asistentului AI al site-ului și returnează răspunsul său împreună cu fiecare sursă găsită.	Ediție gratuită	`POST …/abilities/zinn-chat/ask-assistant/run`	the REST route's own per-item permission check	niciunul
`zinn-chat/bulk-update-tickets` `zinn-chat-bulk-update-tickets`	Modificați mai multe tichete simultan (Pro) Modifică starea, prioritatea sau persoana căreia îi este atribuit un număr de până la 100 de tichete (ids). Fiecare tichet trece prin aceleași verificări ca și cum ar fi modificat individual; rezultatul le listează pe fiecare în parte.	Ediția Pro	`POST …/abilities/zinn-chat/bulk-update-tickets/run`	zinn_chat_answer	ids: array (obligatoriu), status: open\|pending\|solved\|closed, priority: low\|normal\|high\|urgent, assignee_id: integer
`zinn-chat/chat-to-ticket` `zinn-chat-chat-to-ticket`	Transformați un chat într-un tichet Deschide un tichet d dintr-un chat pentru a putea fi răspuns prin e-mail (necesită adresa de e-mail a vizitatorului).	Ediție gratuită	`POST …/abilities/zinn-chat/chat-to-ticket/run`	the REST route's own per-item permission check	id: string (obligatoriu)
`zinn-chat/close-chat` `zinn-chat-close-chat`	Închide un chat Încheie un chat; vizitatorul poate solicita în continuare transcrierea.	Ediție gratuită	`POST …/abilities/zinn-chat/close-chat/run`	the REST route's own per-item permission check	id: string (obligatoriu)
`zinn-chat/create-ticket` `zinn-chat-create-ticket`	Deschide un tichet Deschide un tichet în numele unui client (adresa sa de e-mail, un subiect și primul mesaj).	Ediție gratuită	`POST …/abilities/zinn-chat/create-ticket/run`	the REST route's own per-item permission check	niciunul
`zinn-chat/delete-canned-reply` `zinn-chat-delete-canned-reply`	Ștergeți un răspuns salvat (Pro) Șterge un răspuns salvat.	Ediția Pro	`POST …/abilities/zinn-chat/delete-canned-reply/run`	the REST route's own per-item permission check	id: string (obligatoriu)
`zinn-chat/delete-ticket` `zinn-chat-delete-ticket`	Ștergeți un tichet Șterge definitiv un tichet și conversația aferentă (doar pentru manageri).	Ediție gratuită	`POST …/abilities/zinn-chat/delete-ticket/run`	the REST route's own per-item permission check	id: string (obligatoriu)
`zinn-chat/draft-kb-article` `zinn-chat-draft-kb-article`	Redactați un articol de ajutor d dintr-un tichet (Pro) Scrie o ciornă de articol pentru baza de cunoștințe pe baza unui tichet rezolvat; aceasta rămâne ciornă până când o persoană o publică.	Ediția Pro	`POST …/abilities/zinn-chat/draft-kb-article/run`	edit_posts (the REST route's own check)	niciunul
`zinn-chat/draft-kb-from-gaps` `zinn-chat-draft-kb-from-gaps`	Schițează articole de ajutor pentru întrebările fără răspuns (Pro) Scrie ciorne de articole pentru baza de cunoștințe care răspund la întrebările alese (ids); acestea rămân în stadiul de ciornă.	Ediția Pro	`POST …/abilities/zinn-chat/draft-kb-from-gaps/run`	edit_posts (the REST route's own check)	niciunul
`zinn-chat/fill-canned-reply` `zinn-chat-fill-canned-reply`	Completați un răspuns salvat (Pro) Returnează textul unui răspuns salvat, având substituentul completat pentru un chat sau un tichet.	Ediția Pro	`POST …/abilities/zinn-chat/fill-canned-reply/run`	the REST route's own per-item permission check	id: string (obligatoriu)
`zinn-chat/get-chat` `zinn-chat-get-chat`	Citește un chat Returnează mesajele unui singur chat și detaliile vizitatorului (după: doar mesajele mai noi decât acest id).	Ediție gratuită	`GET …/abilities/zinn-chat/get-chat/run`	the REST route's own per-item permission check	id: string (obligatoriu)
`zinn-chat/get-overview` `zinn-chat-get-overview`	Citiți prezentarea generală a Asistenței Returnează câte tichete există în fiecare stare și câte chaturi așteaptă o persoană (și mesajele lor necitite), precum și dacă chatul, asistentul și tichetele sunt activate.	Ediție gratuită	`GET …/abilities/zinn-chat/get-overview/run`	zinn_chat_answer	niciunul
`zinn-chat/get-settings` `zinn-chat-get-settings`	Citește setările de chat Returnează toate setările de chat: widgetul, asistentul, persoanele și programul de lucru, tichetele și e-mailul, indexul site-ului, confidențialitatea și spamul.	Ediție gratuită	`GET …/abilities/zinn-chat/get-settings/run`	zinn_chat_manage	niciunul
`zinn-chat/get-stats` `zinn-chat-get-stats`	Citește statisticile de asistență (Pro) Returnează numărul de chat-uri și tichete, timpii de răspuns și calificativele pentru ultimele N zile (zile).	Ediția Pro	`GET …/abilities/zinn-chat/get-stats/run`	the REST route's own per-item permission check	niciunul
`zinn-chat/get-ticket` `zinn-chat-get-ticket`	Citiți un tichet Returnază un tichet cu întreaga sa conversație, statut, prioritate și persoană atribuită.	Ediție gratuită	`GET …/abilities/zinn-chat/get-ticket/run`	the REST route's own per-item permission check	id: string (obligatoriu)
`zinn-chat/hand-chat-to-assistant` `zinn-chat-hand-chat-to-assistant`	Predați un chat înapoi asistentului Returnează un chat către asistentul AI, care răspunde vizitatorului pe baza conținutului site-ului.	Ediție gratuită	`POST …/abilities/zinn-chat/hand-chat-to-assistant/run`	the REST route's own per-item permission check	id: string (obligatoriu)
`zinn-chat/list-canned-replies` `zinn-chat-list-canned-replies`	Listați răspunsurile salvate (Pro) Afișează lista de răspunsuri salvate pe care agenții le pot introduce, împreună cu scurtăturile lor.	Ediția Pro	`GET …/abilities/zinn-chat/list-canned-replies/run`	the REST route's own per-item permission check	niciunul
`zinn-chat/list-chats` `zinn-chat-list-chats`	Listă chaturi live Afișează listele cu chaturile în așteptare, în curs și recent închise, precizând cine se ocupă de fiecare în parte.	Ediție gratuită	`GET …/abilities/zinn-chat/list-chats/run`	the REST route's own per-item permission check	niciunul
`zinn-chat/list-indexed-content` `zinn-chat-list-indexed-content`	Enumerați ce știe asistentul Afișează conținutul din care răspunde asistentul, împreună cu starea de indexare, câte o pagină.	Ediție gratuită	`GET …/abilities/zinn-chat/list-indexed-content/run`	the REST route's own per-item permission check	niciunul
`zinn-chat/list-kb-gaps` `zinn-chat-list-kb-gaps`	Listați întrebările fără răspuns (Pro) Afișează o listă cu întrebările adresate de vizitatori la care baza de cunoștințe nu a putut răspunde.	Ediția Pro	`GET …/abilities/zinn-chat/list-kb-gaps/run`	the REST route's own per-item permission check	niciunul
`zinn-chat/list-tickets` `zinn-chat-list-tickets`	Listați tichetele Listează tichetele de asistență, filtrate după stare sau o căutare, câte o pagină pe rând.	Ediție gratuită	`GET …/abilities/zinn-chat/list-tickets/run`	the REST route's own per-item permission check	niciunul
`zinn-chat/reembed-content` `zinn-chat-reembed-content`	Reconstruiește indexul de căutare al asistentului Reconstruiește vectorii de căutare pentru un element (item_id) sau pentru tot (all: true) (doar pentru manageri).	Ediție gratuită	`POST …/abilities/zinn-chat/reembed-content/run`	the REST route's own per-item permission check	niciunul
`zinn-chat/reindex-content` `zinn-chat-reindex-content`	Re-citește conținutul în asistent Re-citește un element (item_id) sau totul (all: true) în indexul asistentului (doar pentru manageri).	Ediție gratuită	`POST …/abilities/zinn-chat/reindex-content/run`	the REST route's own per-item permission check	niciunul
`zinn-chat/reply-chat` `zinn-chat-reply-chat`	Răspunde într-un chat Trimite un mesaj vizitatorului (text) sau adaugă o notă internă pe care doar agenții o pot vedea (note: true).	Ediție gratuită	`POST …/abilities/zinn-chat/reply-chat/run`	the REST route's own per-item permission check	id: string (obligatoriu)
`zinn-chat/save-canned-reply` `zinn-chat-save-canned-reply`	Salvează un răspuns salvat (Pro) Creează sau modifică un răspuns salvat (titlu, comandă rapidă, conținut, departament; id pentru a modifica unul).	Ediția Pro	`POST …/abilities/zinn-chat/save-canned-reply/run`	the REST route's own per-item permission check	niciunul
`zinn-chat/save-kb-article` `zinn-chat-save-kb-article`	Scrie un articol de ajutor (Pro) Creează un articol pentru baza de cunoștințe sau îl modifică (id): titlu, conținut, un fragment, categorii și stare (draft sau publică atunci când poți publica).	Ediția 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`	Căutați în baza de cunoștințe (Pro) Găsește articole de ajutor pentru a le include într-un răspuns (q: căutarea).	Ediția Pro	`GET …/abilities/zinn-chat/search-kb/run`	the REST route's own per-item permission check	niciunul
`zinn-chat/set-conversation-details` `zinn-chat-set-conversation-details`	Setați departamentul și etichetele unei conversații (Pro) Setează departamentul și etichetele unui chat sau tichet (tip: chat sau tichet; id).	Ediția Pro	`POST …/abilities/zinn-chat/set-conversation-details/run`	the REST route's own per-item permission check	niciunul
`zinn-chat/set-kb-gap-status` `zinn-chat-set-kb-gap-status`	Marchează întrebările fără răspuns (Pro) Marchează întrebările fără răspuns ca fiind deschise, planificate sau respinse (id-uri, status).	Ediția Pro	`POST …/abilities/zinn-chat/set-kb-gap-status/run`	the REST route's own per-item permission check	niciunul
`zinn-chat/set-presence` `zinn-chat-set-presence`	Setați-vă disponibilitatea Marchează agentul conectat ca fiind disponibil sau absent pentru chaturi noi (absent: true sau false).	Ediție gratuită	`POST …/abilities/zinn-chat/set-presence/run`	the REST route's own per-item permission check	niciunul
`zinn-chat/suggest-reply` `zinn-chat-suggest-reply`	Redactează un răspuns cu AI (Pro) Elaborează o ciornă de răspuns la un chat sau la un tichet pe baza conținutului site-ului; nu se trimite nimic.	Ediția Pro	`POST …/abilities/zinn-chat/suggest-reply/run`	the REST route's own per-item permission check	niciunul
`zinn-chat/summarise-conversation` `zinn-chat-summarise-conversation`	Rezumatul unei conversații cu AI (Pro) Rezumă un chat sau un tichet în câteva rânduri.	Ediția Pro	`POST …/abilities/zinn-chat/summarise-conversation/run`	the REST route's own per-item permission check	niciunul
`zinn-chat/take-chat` `zinn-chat-take-chat`	Începeți o conversație Atribuie un chat în așteptare agentului conectat, astfel încât vizitatorul să vorbească cu o persoană.	Ediție gratuită	`POST …/abilities/zinn-chat/take-chat/run`	the REST route's own per-item permission check	id: string (obligatoriu)
`zinn-chat/update-settings` `zinn-chat-update-settings`	Modificați setările pentru chat Modifică setările pe care le trimiți (setări: cheie-valoare) și le păstrează pe celelalte. Fiecare valoare este verificată exact ca pe ecranul de setări; get-settings listează cheile.	Ediție gratuită	`POST …/abilities/zinn-chat/update-settings/run`	zinn_chat_manage	settings: object (obligatoriu)
`zinn-chat/update-ticket` `zinn-chat-update-ticket`	Modifică un tichet Modifică starea, prioritatea sau persoana căreia i s-a atribuit un tichet.	Ediție gratuită	`POST …/abilities/zinn-chat/update-ticket/run`	the REST route's own per-item permission check	id: string (obligatoriu)