Programeri

Referenca mogućnosti za Zinn® Chat

Zinn® Chat svoje radnje registrira pri WordPress Abilities API-ju. Iste su sposobnosti MCP alati na poslužitelju samog web-mjesta i REST rute pod /wp-json/wp-abilities/v1. Ova se stranica generira iz vlastitog registra dodataka.

Korisnički vodič: povezivanje AI aplikacije

Krajnje točke

MCP preko HTTP-a (prenosivo)

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

MCP preko WP-CLI (standardni ulaz i izlaz)

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

REST: popis mogućnosti

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

REST: pokreni sposobnost

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

Autentifikacija i dozvole

HTTP zahtjevi se autentificiraju pomoću WordPress aplikacijske lozinke (HTTP Basic). Povezivanje s MCP poslužiteljem zahtijeva mogućnost prikazanu u nastavku; svaka sposobnost zatim provjerava vlastitu dozvolu, po objektu. Sposobnosti samo za čitanje izvode se s GET-om i njihovim unosom u query stringu; ostale s POST-om i JSON tijelom {"input": {…}}.

Primjeri

# REST: pokreni sposobnost
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":{}}}

Sve mogućnosti

Generirano iz datoteke abilities.json dodatka, koja se i sama generira iz aktivne web-lokacije; test ne uspijeva kada se ta dva elementa ne podudaraju.

MogućnostŠto radiIzdanjeMIROVANJEDozvolaParametri
zinn-chat/answer-ticket
zinn-chat-answer-ticket
Odgovorite na tiket
Odgovara klijentu putem e-pošte (tekst) ili dodaje internu bilješku (note: true); status opcionalno mijenja status zahtjeva.
Besplatno izdanjePOST …/abilities/zinn-chat/answer-ticket/runthe REST route's own per-item permission checkid: string (obavezno)
zinn-chat/ask-assistant
zinn-chat-ask-assistant
Pitajte asistenta
Postavlja pitanje Zinovom AI asistentu i vraća njegov odgovor zajedno sa svakim pronađenim izvorom.
Besplatno izdanjePOST …/abilities/zinn-chat/ask-assistant/runthe REST route's own per-item permission checknijedan
zinn-chat/bulk-update-tickets
zinn-chat-bulk-update-tickets
Promijenite više tiketa odjednom (Pro)
Mijenja status, prioritet ili osobu zaduženu za najviše 100 zahtjeva (ID-jeva). Svaki zahtjev prolazi iste provjere kao i kod pojedinačne izmjene; rezultat navodi svaki pojedinačno.
Pro izdanjePOST …/abilities/zinn-chat/bulk-update-tickets/runzinn_chat_answerids: array (obavezno), status: open|pending|solved|closed, priority: low|normal|high|urgent, assignee_id: integer
zinn-chat/chat-to-ticket
zinn-chat-chat-to-ticket
Pretvorite razgovor u zahtjev
Otvara tiket iz chata kako bi se mogao odgovoriti putem e-pošte (potrebna je adresa e-pošte posjetitelja).
Besplatno izdanjePOST …/abilities/zinn-chat/chat-to-ticket/runthe REST route's own per-item permission checkid: string (obavezno)
zinn-chat/close-chat
zinn-chat-close-chat
Zatvori chat
Završava razgovor; posjetitelj i dalje može zatražiti prijepis.
Besplatno izdanjePOST …/abilities/zinn-chat/close-chat/runthe REST route's own per-item permission checkid: string (obavezno)
zinn-chat/create-ticket
zinn-chat-create-ticket
Otvorite zahtjev
Otvara zahtjev u ime korisnika (njihovu e-poštu, predmet i prvu poruku).
Besplatno izdanjePOST …/abilities/zinn-chat/create-ticket/runthe REST route's own per-item permission checknijedan
zinn-chat/delete-canned-reply
zinn-chat-delete-canned-reply
Izbriši spremljeni odgovor (Pro)
Briše spremljeni odgovor.
Pro izdanjePOST …/abilities/zinn-chat/delete-canned-reply/runthe REST route's own per-item permission checkid: string (obavezno)
zinn-chat/delete-ticket
zinn-chat-delete-ticket
Izbriši tiket
Trajno briše zahtjev i njegov razgovor (samo za upravitelje).
Besplatno izdanjePOST …/abilities/zinn-chat/delete-ticket/runthe REST route's own per-item permission checkid: string (obavezno)
zinn-chat/draft-kb-article
zinn-chat-draft-kb-article
Nacrtaj pomoćni članak iz tiketa (Pro)
Piše nacrt članka baze znanja iz riješenog tiketa; ostaje u nacrtu dok ga osoba ne objavi.
Pro izdanjePOST …/abilities/zinn-chat/draft-kb-article/runedit_posts (the REST route's own check)nijedan
zinn-chat/draft-kb-from-gaps
zinn-chat-draft-kb-from-gaps
Izradite nacrte članaka pomoći za neodgovorena pitanja (Pro)
Piše nacrte članaka baze znanja koji odgovaraju na odabrana pitanja (id-ovi); ostaju u statusu nacrta.
Pro izdanjePOST …/abilities/zinn-chat/draft-kb-from-gaps/runedit_posts (the REST route's own check)nijedan
zinn-chat/fill-canned-reply
zinn-chat-fill-canned-reply
Ispuni spremljeni odgovor (Pro)
Vraća tekst spremljenog odgovora s popunjenim rezerviranim mjestima za jedan razgovor ili tiket.
Pro izdanjePOST …/abilities/zinn-chat/fill-canned-reply/runthe REST route's own per-item permission checkid: string (obavezno)
zinn-chat/get-chat
zinn-chat-get-chat
Pročitaj chat
Vraća poruke jednog chata i podatke o posjetitelju (after: samo poruke novije od ovog ID-ja).
Besplatno izdanjeGET …/abilities/zinn-chat/get-chat/runthe REST route's own per-item permission checkid: string (obavezno)
zinn-chat/get-overview
zinn-chat-get-overview
Pročitajte pregled podrške
Vraća koliko je ulaznica u svakom statusu i koliko razgovora čeka osobu (i njihove nepročitane poruke), te jesu li razgovor, pomoćnik i ulaznice uključeni.
Besplatno izdanjeGET …/abilities/zinn-chat/get-overview/runzinn_chat_answernijedan
zinn-chat/get-settings
zinn-chat-get-settings
Pročitajte postavke chata
Vraća sve postavke chata: widget, asistenta, osobe i radno vrijeme, tikete i e-poštu, indeks web-mjesta, privatnost i neželjenu poštu.
Besplatno izdanjeGET …/abilities/zinn-chat/get-settings/runzinn_chat_managenijedan
zinn-chat/get-stats
zinn-chat-get-stats
Pročitajte statistiku podrške (Pro)
Vraća broj razgovora i tiketa, vremena odziva i ocjene za posljednjih N dana (dana).
Pro izdanjeGET …/abilities/zinn-chat/get-stats/runthe REST route's own per-item permission checknijedan
zinn-chat/get-ticket
zinn-chat-get-ticket
Pročitajte zahtjev
Vraća jednu ulaznicu s cijelim razgovorom, statusom, prioritetom i osobom kojoj je dodijeljena.
Besplatno izdanjeGET …/abilities/zinn-chat/get-ticket/runthe REST route's own per-item permission checkid: string (obavezno)
zinn-chat/hand-chat-to-assistant
zinn-chat-hand-chat-to-assistant
Vratite razgovor pomoćniku
Vraća razgovor AI asistentu, koji odgovara posjetitelju na temelju sadržaja web-mjesta.
Besplatno izdanjePOST …/abilities/zinn-chat/hand-chat-to-assistant/runthe REST route's own per-item permission checkid: string (obavezno)
zinn-chat/list-canned-replies
zinn-chat-list-canned-replies
Popis spremljenih odgovora (Pro)
Prikazuje spremljene odgovore koje agenti mogu umetnuti, zajedno s njihovim prečacima.
Pro izdanjeGET …/abilities/zinn-chat/list-canned-replies/runthe REST route's own per-item permission checknijedan
zinn-chat/list-chats
zinn-chat-list-chats
Prikaži aktivne razgovore uživo
Prikazuje popise razgovora koji čekaju, u tijeku su i nedavno su zatvoreni, zajedno s informacijama o tome tko svaki od njih vodi.
Besplatno izdanjeGET …/abilities/zinn-chat/list-chats/runthe REST route's own per-item permission checknijedan
zinn-chat/list-indexed-content
zinn-chat-list-indexed-content
Navedite što pomoćnik zna
Navodi sadržaj na koji pomoćnik odgovara, zajedno s njegovim statusom indeksiranja, stranicu po stranicu.
Besplatno izdanjeGET …/abilities/zinn-chat/list-indexed-content/runthe REST route's own per-item permission checknijedan
zinn-chat/list-kb-gaps
zinn-chat-list-kb-gaps
Popis neodgovorenih pitanja (Pro)
Navodi pitanja koja su posjetitelji postavili, a na koja baza znanja nije mogla odgovoriti.
Pro izdanjeGET …/abilities/zinn-chat/list-kb-gaps/runthe REST route's own per-item permission checknijedan
zinn-chat/list-tickets
zinn-chat-list-tickets
Popis zahtjeva
Navodi zapisnike podrške, filtrirane prema statusu ili pretrazi, stranicu po stranicu.
Besplatno izdanjeGET …/abilities/zinn-chat/list-tickets/runthe REST route's own per-item permission checknijedan
zinn-chat/reembed-content
zinn-chat-reembed-content
Ponovno izgradi indeks pretraživanja pomoćnika
Ponovno gradi vektore pretraživanja za jednu stavku (item_id) ili sve (all: true) (samo za upravitelje).
Besplatno izdanjePOST …/abilities/zinn-chat/reembed-content/runthe REST route's own per-item permission checknijedan
zinn-chat/reindex-content
zinn-chat-reindex-content
Ponovno pročitajte sadržaj u pomoćnika
Ponovno učitava jednu stavku (item_id) ili sve (all: true) u indeks asistenta (samo za upravitelje).
Besplatno izdanjePOST …/abilities/zinn-chat/reindex-content/runthe REST route's own per-item permission checknijedan
zinn-chat/reply-chat
zinn-chat-reply-chat
Odgovori u chatu
Šalje poruku posjetitelju (text) ili dodaje internu bilješku koju vide samo agenti (note: true).
Besplatno izdanjePOST …/abilities/zinn-chat/reply-chat/runthe REST route's own per-item permission checkid: string (obavezno)
zinn-chat/save-canned-reply
zinn-chat-save-canned-reply
Spremi spremljeni odgovor (Pro)
Stvara ili mijenja spremljeni odgovor (naslov, prečac, tekst, odjel; ID za promjenu postojećeg).
Pro izdanjePOST …/abilities/zinn-chat/save-canned-reply/runthe REST route's own per-item permission checknijedan
zinn-chat/save-kb-article
zinn-chat-save-kb-article
Napiši pomoćni članak (Pro)
Stvara članak u bazi znanja ili mijenja postojeći (id): naslov, sadržaj, izvadak, kategorije i status (nacrt ili objavi kada možete objaviti).
Pro izdanjePOST …/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
Pretražite bazu znanja (Pro)
Pronalazi članke pomoći za povezivanje u odgovoru (q: pretraga).
Pro izdanjeGET …/abilities/zinn-chat/search-kb/runthe REST route's own per-item permission checknijedan
zinn-chat/set-conversation-details
zinn-chat-set-conversation-details
Postavite odjel i oznake razgovora (Pro)
Postavlja odjel i oznake chata ili tiketa (vrsta: chat ili tiket; id).
Pro izdanjePOST …/abilities/zinn-chat/set-conversation-details/runthe REST route's own per-item permission checknijedan
zinn-chat/set-kb-gap-status
zinn-chat-set-kb-gap-status
Označite neodgovorena pitanja (Pro)
Označava neodgovorena pitanja kao otvorena, planirana ili odbačena (ID-jevi, status).
Pro izdanjePOST …/abilities/zinn-chat/set-kb-gap-status/runthe REST route's own per-item permission checknijedan
zinn-chat/set-presence
zinn-chat-set-presence
Postavite svoju dostupnost
Označava prijavljenog agenta dostupnim ili odsutnim za nove razgovore (away: true ili false).
Besplatno izdanjePOST …/abilities/zinn-chat/set-presence/runthe REST route's own per-item permission checknijedan
zinn-chat/suggest-reply
zinn-chat-suggest-reply
Izradi nacrt odgovora pomoću umjetne inteligencije (Pro)
Sastavlja nacrt odgovora na chat ili tiket na temelju sadržaja stranice; ništa se ne šalje.
Pro izdanjePOST …/abilities/zinn-chat/suggest-reply/runthe REST route's own per-item permission checknijedan
zinn-chat/summarise-conversation
zinn-chat-summarise-conversation
Sažmi razgovor s AI (Pro)
Sažima razgovor ili zahtjev u nekoliko redaka.
Pro izdanjePOST …/abilities/zinn-chat/summarise-conversation/runthe REST route's own per-item permission checknijedan
zinn-chat/take-chat
zinn-chat-take-chat
Pokreni razgovor
Dodjeljuje chat na čekanju prijavljenom agentu, tako da posjetitelj razgovara s osobom.
Besplatno izdanjePOST …/abilities/zinn-chat/take-chat/runthe REST route's own per-item permission checkid: string (obavezno)
zinn-chat/update-settings
zinn-chat-update-settings
Promijenite postavke chata
Mijenja postavke koje pošaljete (postavke: ključ u vrijednost) i zadržava ostale. Svaka se vrijednost provjerava potpuno isto kao na zaslonu postavki; get-settings navodi ključeve.
Besplatno izdanjePOST …/abilities/zinn-chat/update-settings/runzinn_chat_managesettings: object (obavezno)
zinn-chat/update-ticket
zinn-chat-update-ticket
Promijeni tiket
Mijenja status, prioritet ili dodijeljenog korisnika zahtjeva.
Besplatno izdanjePOST …/abilities/zinn-chat/update-ticket/runthe REST route's own per-item permission checkid: string (obavezno)