Mga Nag-develop

Sanggunian ng mga kakayahan ng Zinn® Chat

Ang Zinn® Chat ay nagrerehistro ng mga aksyon nito sa WordPress Abilities API. Ang parehong mga kakayahan ay mga MCP tool sa sariling server ng site at mga REST route sa ilalim ng /wp-json/wp-abilities/v1. Ang pahinang ito ay nabuo mula sa sariling registry ng plugin.

Gabay sa gumagamit: kumonekta ng AI app

Mga Endpoint

MCP sa ibabaw ng HTTP (naa-stream)

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

MCP sa pamamagitan ng WP-CLI (karaniwang input at output)

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

REST: ilista ang mga kakayahan

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

REST: magpatakbo ng kakayahan

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

Pagpapatotoo at mga pahintulot

Ang mga kahilingan sa HTTP ay nag-a-authenticate gamit ang isang WordPress application password (HTTP Basic). Ang pagkonekta sa MCP server ay nangangailangan ng kakayahang ipinapakita sa ibaba; ang bawat kakayahan ay nagsusuri ng sarili nitong pahintulot, sa bawat bagay. Ang mga kakayahang read-only ay tumatakbo gamit ang GET at ang kanilang input sa query string; ang iba naman ay gamit ang POST at isang JSON body na {"input": {…}}.

Mga Halimbawa

# REST: magpatakbo ng kakayahan
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":{}}}

Lahat ng kakayahan

Binuo mula sa abilities.json ng plugin, na binubuo naman mula sa tumatakbong site; nabibigo ang pagsubok kapag hindi magkatugma ang dalawa.

KakayahanAno ang ginagawa nitoEdisyonIba paPahintulotMga Parameter
zinn-chat/answer-ticket
zinn-chat-answer-ticket
Sumagot ng ticket
Tumutugon sa customer sa pamamagitan ng email (text), o nagdaragdag ng panloob na tala (note: true); opsyonal na binabago ng status ang status ng ticket.
Libreng edisyonPOST …/abilities/zinn-chat/answer-ticket/runthe REST route's own per-item permission checkid: string (kinakailangan)
zinn-chat/ask-assistant
zinn-chat-ask-assistant
Tanungin ang assistant
Nagtanong sa AI assistant ng site at ibinalik ang sagot nito kasama ang bawat pinagmulang natagpuan nito.
Libreng edisyonPOST …/abilities/zinn-chat/ask-assistant/runthe REST route's own per-item permission checkwala
zinn-chat/bulk-update-tickets
zinn-chat-bulk-update-tickets
Baguhin ang maraming ticket nang sabay-sabay (Pro)
Binabago ang status, priyoridad o ang nagtatalaga ng hanggang 100 na tiket (mga id). Ang bawat tiket ay dumadaan sa parehong mga pagsusuri tulad ng pagbabago nito nang mag-isa; nakalista sa resulta ang bawat isa.
Pro edisyonPOST …/abilities/zinn-chat/bulk-update-tickets/runzinn_chat_answerids: array (kinakailangan), status: open|pending|solved|closed, priority: low|normal|high|urgent, assignee_id: integer
zinn-chat/chat-to-ticket
zinn-chat-chat-to-ticket
Gawing tiket ang isang chat
Nagbubukas ng tiket mula sa chat para masagot ito sa pamamagitan ng email (kailangan ang email address ng bisita).
Libreng edisyonPOST …/abilities/zinn-chat/chat-to-ticket/runthe REST route's own per-item permission checkid: string (kinakailangan)
zinn-chat/close-chat
zinn-chat-close-chat
Isara ang chat
Tinatapos ang isang chat; maaari pa ring humingi ang bisita ng transcript.
Libreng edisyonPOST …/abilities/zinn-chat/close-chat/runthe REST route's own per-item permission checkid: string (kinakailangan)
zinn-chat/create-ticket
zinn-chat-create-ticket
Magbukas ng tiket
Nagbubukas ng tiket sa ngalan ng isang customer (ang kanilang email, isang paksa at ang unang mensahe).
Libreng edisyonPOST …/abilities/zinn-chat/create-ticket/runthe REST route's own per-item permission checkwala
zinn-chat/delete-canned-reply
zinn-chat-delete-canned-reply
Tanggalin ang nakaimbak na tugon (Pro)
Nagtatanggal ng nakas-save na tugon.
Pro edisyonPOST …/abilities/zinn-chat/delete-canned-reply/runthe REST route's own per-item permission checkid: string (kinakailangan)
zinn-chat/delete-ticket
zinn-chat-delete-ticket
Mag-delete ng ticket
Permanenteng tinatanggal ang isang tiket at ang pag-uusap nito (para sa mga manager lamang).
Libreng edisyonPOST …/abilities/zinn-chat/delete-ticket/runthe REST route's own per-item permission checkid: string (kinakailangan)
zinn-chat/draft-kb-article
zinn-chat-draft-kb-article
Bumuo ng artikulo sa tulong mula sa isang tiket (Pro)
Sumusulat ng isang draft na artikulo sa knowledge-base mula sa isang nalutas na ticket; nananatili itong draft hanggang sa i-publish ito ng isang tao.
Pro edisyonPOST …/abilities/zinn-chat/draft-kb-article/runedit_posts (the REST route's own check)wala
zinn-chat/draft-kb-from-gaps
zinn-chat-draft-kb-from-gaps
Gumawa ng mga draft ng artikulo sa tulong para sa mga hindi nasagot na tanong (Pro)
Sumusulat ito ng mga draft na artikulo sa knowledge base na sumasagot sa mga napiling tanong (mga id); nananatili silang mga draft.
Pro edisyonPOST …/abilities/zinn-chat/draft-kb-from-gaps/runedit_posts (the REST route's own check)wala
zinn-chat/fill-canned-reply
zinn-chat-fill-canned-reply
Punan ang isang naka-save na tugon (Pro)
Ibinabalik ang teksto ng naka-save na tugon na may mga nakapuno nitong placeholder para sa isang chat o tiket.
Pro edisyonPOST …/abilities/zinn-chat/fill-canned-reply/runthe REST route's own per-item permission checkid: string (kinakailangan)
zinn-chat/get-chat
zinn-chat-get-chat
Basahin ang chat
Nagbabalik ng mga mensahe at detalye ng bisita ng isang chat (after: mga mensaheng mas bago lang kaysa sa id na ito).
Libreng edisyonGET …/abilities/zinn-chat/get-chat/runthe REST route's own per-item permission checkid: string (kinakailangan)
zinn-chat/get-overview
zinn-chat-get-overview
Basahin ang pangkalahatang-ideya ng suporta
Ibinabalik nito kung ilang tiket ang nasa bawat status at kung ilang chat ang naghihintay para sa isang tao (at ang kanilang mga hindi pa nababasang mensahe), pati na rin kung naka-on ba ang chat, ang assistant, at ang mga tiket.
Libreng edisyonGET …/abilities/zinn-chat/get-overview/runzinn_chat_answerwala
zinn-chat/get-settings
zinn-chat-get-settings
Basahin ang mga setting ng chat
Ibinabalik ang bawat setting ng chat: ang widget, ang assistant, ang mga tao at oras ng pagbubukas, mga tiket at email, ang index ng site, privacy at spam.
Libreng edisyonGET …/abilities/zinn-chat/get-settings/runzinn_chat_managewala
zinn-chat/get-stats
zinn-chat-get-stats
Basahin ang mga istatistika ng suporta (Pro)
Ibinabalik ang mga numero ng chat at tiket, mga oras ng pagtugon at mga rating para sa huling N araw (days).
Pro edisyonGET …/abilities/zinn-chat/get-stats/runthe REST route's own per-item permission checkwala
zinn-chat/get-ticket
zinn-chat-get-ticket
Magbasa ng tiket
Nagbabalik ng isang tiket kasama ang buong pag-uusap, status, prayoridad, at ang nag-aatas nito.
Libreng edisyonGET …/abilities/zinn-chat/get-ticket/runthe REST route's own per-item permission checkid: string (kinakailangan)
zinn-chat/hand-chat-to-assistant
zinn-chat-hand-chat-to-assistant
Ibalik ang chat sa assistant
Nagbabalik ng chat sa AI assistant, na sumasagot sa bisita mula sa nilalaman ng site.
Libreng edisyonPOST …/abilities/zinn-chat/hand-chat-to-assistant/runthe REST route's own per-item permission checkid: string (kinakailangan)
zinn-chat/list-canned-replies
zinn-chat-list-canned-replies
I-list ang mga naka-save na tugon (Pro)
Naglilista ng mga naka-save na tugon na maaaring ipasok ng mga ahente, kasama ang kanilang mga shortcut.
Pro edisyonGET …/abilities/zinn-chat/list-canned-replies/runthe REST route's own per-item permission checkwala
zinn-chat/list-chats
zinn-chat-list-chats
Ilista ang mga live chat
Ipinapakista ang mga chat na naghihintay, kasalukuyang ginagawa, at kamakailang sinara, kasama kung sino ang humahawak sa bawat isa.
Libreng edisyonGET …/abilities/zinn-chat/list-chats/runthe REST route's own per-item permission checkwala
zinn-chat/list-indexed-content
zinn-chat-list-indexed-content
Ilista kung ano ang alam ng assistant
Inililista nito ang nilalaman na sinasagutan ng assistant, kasama ang status ng index nito, bawat pahina.
Libreng edisyonGET …/abilities/zinn-chat/list-indexed-content/runthe REST route's own per-item permission checkwala
zinn-chat/list-kb-gaps
zinn-chat-list-kb-gaps
Ilista ang mga hindi pa nasasagot na tanong (Pro)
Ipinapakita ang mga tanong na itinanong ng mga bisita na hindi masagot ng knowledge base.
Pro edisyonGET …/abilities/zinn-chat/list-kb-gaps/runthe REST route's own per-item permission checkwala
zinn-chat/list-tickets
zinn-chat-list-tickets
Maglista ng mga tiket
Naglilista ito ng mga ticket ng suporta, na naka-filter ayon sa status o paghahanap, bawat pahina.
Libreng edisyonGET …/abilities/zinn-chat/list-tickets/runthe REST route's own per-item permission checkwala
zinn-chat/reembed-content
zinn-chat-reembed-content
Buuin muli ang index ng paghahanap ng assistant
Muling binubuo ang mga vector ng paghahanap para sa isang item (item_id) o sa lahat (all: true) (mga manager lamang).
Libreng edisyonPOST …/abilities/zinn-chat/reembed-content/runthe REST route's own per-item permission checkwala
zinn-chat/reindex-content
zinn-chat-reindex-content
Basahin muli ang nilalaman sa katulong
Binabasa muli ang isang aytem (item_id) o ang lahat (all: true) papasok sa index ng assistant (mga manager lamang).
Libreng edisyonPOST …/abilities/zinn-chat/reindex-content/runthe REST route's own per-item permission checkwala
zinn-chat/reply-chat
zinn-chat-reply-chat
Sumagot sa chat
Nagpapadala ng mensahe sa bisita (text), o nagdaragdag ng panloob na tala na mga ahente lang ang nakakakita (note: true).
Libreng edisyonPOST …/abilities/zinn-chat/reply-chat/runthe REST route's own per-item permission checkid: string (kinakailangan)
zinn-chat/save-canned-reply
zinn-chat-save-canned-reply
I-save ang naka-save na tugon (Pro)
Lumilikha o nagbabago ng naka-save na tugon (pamagat, shortcut, katawan, departamento; id para baguhin ang isa).
Pro edisyonPOST …/abilities/zinn-chat/save-canned-reply/runthe REST route's own per-item permission checkwala
zinn-chat/save-kb-article
zinn-chat-save-kb-article
Sumulat ng artikulo sa tulong (Pro)
Lumilikha ng artikulo sa knowledge-base, o nagbabago ng isa (id): pamagat, nilalaman, buod, mga kategorya at estado (draft, o i-publish kapag maaari kang mag-publish).
Pro edisyonPOST …/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
Maghanap sa knowledge base (Pro)
Humanap ng mga artikulo sa tulong na ili-link sa isang tugon (q: ang paghahanap).
Pro edisyonGET …/abilities/zinn-chat/search-kb/runthe REST route's own per-item permission checkwala
zinn-chat/set-conversation-details
zinn-chat-set-conversation-details
Magtakda ng departamento at mga tag ng isang pag-uusap (Pro)
Itinatakda ang departamento at mga tag ng isang chat o tiket (uri: chat o tiket; id).
Pro edisyonPOST …/abilities/zinn-chat/set-conversation-details/runthe REST route's own per-item permission checkwala
zinn-chat/set-kb-gap-status
zinn-chat-set-kb-gap-status
Markan ang mga tanong na walang sagot (Pro)
Minamark ang mga hindi nasagot na tanong bilang bukas, planado o tinanggihan (mga id, status).
Pro edisyonPOST …/abilities/zinn-chat/set-kb-gap-status/runthe REST route's own per-item permission checkwala
zinn-chat/set-presence
zinn-chat-set-presence
Itakda ang iyong availability
Minamark ang naka-sign in na ahente bilang available o away para sa mga bagong chat (away: true o false).
Libreng edisyonPOST …/abilities/zinn-chat/set-presence/runthe REST route's own per-item permission checkwala
zinn-chat/suggest-reply
zinn-chat-suggest-reply
Gumawa ng draft ng tugon gamit ang AI (Pro)
Bumubuo ng blangkong draft ng tugon sa isang chat o tiket mula sa nilalaman ng site; walang ipinapadala.
Pro edisyonPOST …/abilities/zinn-chat/suggest-reply/runthe REST route's own per-item permission checkwala
zinn-chat/summarise-conversation
zinn-chat-summarise-conversation
Ibuod ang isang pag-uusap kasama ang AI (Pro)
Binubuod ang isang chat o tiket sa ilang linya.
Pro edisyonPOST …/abilities/zinn-chat/summarise-conversation/runthe REST route's own per-item permission checkwala
zinn-chat/take-chat
zinn-chat-take-chat
Magsimula ng chat
Nagtatalaga ng naghihintay na chat sa naka-sign in na ahente, upang ang bisita ay makipag-usap sa isang tao.
Libreng edisyonPOST …/abilities/zinn-chat/take-chat/runthe REST route's own per-item permission checkid: string (kinakailangan)
zinn-chat/update-settings
zinn-chat-update-settings
Palitan ang mga setting ng chat
Binabago nito ang mga setting na ipinapadala mo (mga setting: key hanggang value) at pinapanatili ang iba. Ang bawat value ay eksaktong sinusuri tulad ng sa screen ng mga setting; nakalista sa get-settings ang mga key.
Libreng edisyonPOST …/abilities/zinn-chat/update-settings/runzinn_chat_managesettings: object (kinakailangan)
zinn-chat/update-ticket
zinn-chat-update-ticket
Baguhin ang isang tiket
Binabago ang katayuan, priyoridad o tagatalaga ng isang tiket.
Libreng edisyonPOST …/abilities/zinn-chat/update-ticket/runthe REST route's own per-item permission checkid: string (kinakailangan)