Разработчици

Справка за възможностите на Zinn® Chat

Zinn® Chat регистрира своите действия в WordPress Abilities API. Същите способности са MCP инструменти на собствения сървър на сайта и REST маршрути под /wp-json/wp-abilities/v1. Тази страница се генерира от собствения регистър на плъгина.

Ръководство за потребителя: свързване на AI приложение

Крайна точка

MCP през HTTP (потоков)

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

MCP през WP-CLI (стандартен вход и изход)

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

REST: извеждане на възможностите

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

REST: стартиране на способност

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

Удостоверяване и права за достъп

HTTP заявките се удостоверяват с WordPress приложение-парола (HTTP Basic). Свързването към MCP сървъра се нуждае от показаното по-долу разрешение; след това всяка възможност проверява собственото си право на достъп за всеки обект. Възможностите само за четене се изпълняват с GET и входните им данни в заявката (query string); останалите с POST и JSON тяло {"input": {…}}.

Примери

# REST: стартиране на способност
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":{}}}

Всички права

Генерирано от abilities.json на плъгина, който от своя страна се генерира от работещ сайт; тестът се проваля, когато двете не съвпадат.

Възможност	Как работи	Издание	REST	Право на достъп	Параметри
`zinn-chat/answer-ticket` `zinn-chat-answer-ticket`	Отговорете на билет Отговаря на клиента по имейл (текст) или добавя вътрешна бележка (note: true); състоянието променя статуса на заявката по желание.	Безплатно издание	`POST …/abilities/zinn-chat/answer-ticket/run`	the REST route's own per-item permission check	id: string (задължително)
`zinn-chat/ask-assistant` `zinn-chat-ask-assistant`	Попитайте асистента Задава въпрос на AI асистента на сайта и връща неговия отговор с всеки намерен източник.	Безплатно издание	`POST …/abilities/zinn-chat/ask-assistant/run`	the REST route's own per-item permission check	няма
`zinn-chat/bulk-update-tickets` `zinn-chat-bulk-update-tickets`	Промяна на много заявки едновременно (Pro) Променя статуса, приоритета или отговорника на до 100 тикета (по идентификатори). Всеки тикет преминава през същите проверки като при самостоятелната му промяна; резултатът изброява всеки от тях.	Про версия	`POST …/abilities/zinn-chat/bulk-update-tickets/run`	zinn_chat_answer	ids: array (задължително), status: open\|pending\|solved\|closed, priority: low\|normal\|high\|urgent, assignee_id: integer
`zinn-chat/chat-to-ticket` `zinn-chat-chat-to-ticket`	Превърнете чата в билет Отваря билет от чат, за да може да бъде отговорено по имейл (изисква имейл адреса на посетителя).	Безплатно издание	`POST …/abilities/zinn-chat/chat-to-ticket/run`	the REST route's own per-item permission check	id: string (задължително)
`zinn-chat/close-chat` `zinn-chat-close-chat`	Затваряне на чат Приключва чат; посетителят все пак може да поиска хронологията.	Безплатно издание	`POST …/abilities/zinn-chat/close-chat/run`	the REST route's own per-item permission check	id: string (задължително)
`zinn-chat/create-ticket` `zinn-chat-create-ticket`	Създайте билет Отваря билет от името на клиент (неговия имейл, тема и първо съобщение).	Безплатно издание	`POST …/abilities/zinn-chat/create-ticket/run`	the REST route's own per-item permission check	няма
`zinn-chat/delete-canned-reply` `zinn-chat-delete-canned-reply`	Изтриване на запазен отговор (Pro) Изтрива запазен отговор.	Про версия	`POST …/abilities/zinn-chat/delete-canned-reply/run`	the REST route's own per-item permission check	id: string (задължително)
`zinn-chat/delete-ticket` `zinn-chat-delete-ticket`	Изтриване на билет Изтрива заявка и нейния разговор завинаги (само за мениджъри).	Безплатно издание	`POST …/abilities/zinn-chat/delete-ticket/run`	the REST route's own per-item permission check	id: string (задължително)
`zinn-chat/draft-kb-article` `zinn-chat-draft-kb-article`	Създаване на помощна статия от заявка (Pro) Създава чернова на статия от базата знания от разрешен билет; тя остава чернова, докато някой я публикува.	Про версия	`POST …/abilities/zinn-chat/draft-kb-article/run`	edit_posts (the REST route's own check)	няма
`zinn-chat/draft-kb-from-gaps` `zinn-chat-draft-kb-from-gaps`	Чернова на помощни статии за въпроси без отговор (Pro) Създава чернови на статии от базата знания, отговарящи на избраните въпроси (ids); те остават чернови.	Про версия	`POST …/abilities/zinn-chat/draft-kb-from-gaps/run`	edit_posts (the REST route's own check)	няма
`zinn-chat/fill-canned-reply` `zinn-chat-fill-canned-reply`	Попълнете запазен отговор (Pro) Връща текста на запазен отговор с попълнени полета за запълване за един чат или билет.	Про версия	`POST …/abilities/zinn-chat/fill-canned-reply/run`	the REST route's own per-item permission check	id: string (задължително)
`zinn-chat/get-chat` `zinn-chat-get-chat`	Четене на чат Връща съобщенията и данните за посетителя на един чат (after: само съобщения, по-нови от това ID).	Безплатно издание	`GET …/abilities/zinn-chat/get-chat/run`	the REST route's own per-item permission check	id: string (задължително)
`zinn-chat/get-overview` `zinn-chat-get-overview`	Прочетете прегледа на поддръжката Връща броя на тикетите във всеки статус и колко чата чакат оператор (както и техните непрочетени съобщения), както и дали чатът, асистентът и тикетите са включени.	Безплатно издание	`GET …/abilities/zinn-chat/get-overview/run`	zinn_chat_answer	няма
`zinn-chat/get-settings` `zinn-chat-get-settings`	Прочетете настройките на чата Връща всяка настройка на чата: уиджета, асистента, хората и работното време, тикетите и имейла, индекса на сайта, поверителността и спама.	Безплатно издание	`GET …/abilities/zinn-chat/get-settings/run`	zinn_chat_manage	няма
`zinn-chat/get-stats` `zinn-chat-get-stats`	Прочитане на статистика за поддръжката (Pro) Връща номерата на чатове и тикети, времето за отговор и оценките за последните N дни (дни).	Про версия	`GET …/abilities/zinn-chat/get-stats/run`	the REST route's own per-item permission check	няма
`zinn-chat/get-ticket` `zinn-chat-get-ticket`	Преглед на заявка Връща един билет с цялата му история на разговорите, статус, приоритет и отговорник.	Безплатно издание	`GET …/abilities/zinn-chat/get-ticket/run`	the REST route's own per-item permission check	id: string (задължително)
`zinn-chat/hand-chat-to-assistant` `zinn-chat-hand-chat-to-assistant`	Прехвърлете чата обратно на асистентa Връща чат към ИИ асистента, който отговаря на посетителя въз основа на съдържанието на сайта.	Безплатно издание	`POST …/abilities/zinn-chat/hand-chat-to-assistant/run`	the REST route's own per-item permission check	id: string (задължително)
`zinn-chat/list-canned-replies` `zinn-chat-list-canned-replies`	Списък със запазени отговори (Pro) Показва списък със запазените отговори, които агентите могат да вмъкват, заедно с техните бързи клавиши.	Про версия	`GET …/abilities/zinn-chat/list-canned-replies/run`	the REST route's own per-item permission check	няма
`zinn-chat/list-chats` `zinn-chat-list-chats`	Списък на активните чатове Показва чакащите, текущите и наскоро затворените чатове, заедно с това кой отговаря за всеки от тях.	Безплатно издание	`GET …/abilities/zinn-chat/list-chats/run`	the REST route's own per-item permission check	няма
`zinn-chat/list-indexed-content` `zinn-chat-list-indexed-content`	Избройте какво знае асистентът Извежда списъка с отговорите на асистента, включително състоянието на индексиране, по една страница на път.	Безплатно издание	`GET …/abilities/zinn-chat/list-indexed-content/run`	the REST route's own per-item permission check	няма
`zinn-chat/list-kb-gaps` `zinn-chat-list-kb-gaps`	Списък с невъпроси без отговор (Pro) Показва списък с въпросите, които посетителите са задали и на които базата от знания не е могла да отговори.	Про версия	`GET …/abilities/zinn-chat/list-kb-gaps/run`	the REST route's own per-item permission check	няма
`zinn-chat/list-tickets` `zinn-chat-list-tickets`	Списък с тикети Извежда списък с поддържани билети, филтрирани по статус или търсене, по една страница на път.	Безплатно издание	`GET …/abilities/zinn-chat/list-tickets/run`	the REST route's own per-item permission check	няма
`zinn-chat/reembed-content` `zinn-chat-reembed-content`	Пресъздаване на индекса за търсене на асистента Пресъздава вексерите за търсене за един елемент (item_id) или за всичко (all: true) (само за мениджъри).	Безплатно издание	`POST …/abilities/zinn-chat/reembed-content/run`	the REST route's own per-item permission check	няма
`zinn-chat/reindex-content` `zinn-chat-reindex-content`	Прочетете отново съдържанието в асистента Препрочита отново един елемент (item_id) или всичко (all: true) в индекса на асистента (само за мениджъри).	Безплатно издание	`POST …/abilities/zinn-chat/reindex-content/run`	the REST route's own per-item permission check	няма
`zinn-chat/reply-chat` `zinn-chat-reply-chat`	Отговор в чат Изпраща съобщение до посетителя (текст) или добавя вътрешна бележка, видима само за агентите (note: true).	Безплатно издание	`POST …/abilities/zinn-chat/reply-chat/run`	the REST route's own per-item permission check	id: string (задължително)
`zinn-chat/save-canned-reply` `zinn-chat-save-canned-reply`	Запазване на запазен отговор (Pro) Създава или променя запазен отговор (заглавие, прякор, съдържание, отдел; id за промяна на съществуващ).	Про версия	`POST …/abilities/zinn-chat/save-canned-reply/run`	the REST route's own per-item permission check	няма
`zinn-chat/save-kb-article` `zinn-chat-save-kb-article`	Напишете помощна статия (Pro) Създава статия от базата знания или променя такава (id): заглавие, съдържание, откъс, категории и статус (чернова или публикуване, когато имате право да публикувате).	Про версия	`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`	Търсене в базата знания (Pro) Намира помощни статии за добавяне на връзка в отговор (q: търсенето).	Про версия	`GET …/abilities/zinn-chat/search-kb/run`	the REST route's own per-item permission check	няма
`zinn-chat/set-conversation-details` `zinn-chat-set-conversation-details`	Задаване на отдел и етикети на разговор (Pro) Задава отдел и етикети на чат или билет (тип: чат или билет; ID).	Про версия	`POST …/abilities/zinn-chat/set-conversation-details/run`	the REST route's own per-item permission check	няма
`zinn-chat/set-kb-gap-status` `zinn-chat-set-kb-gap-status`	Отбележи неизразените въпроси (Pro) Маркира като отворени, планирани или отхвърлени въпроси без отговор (идентификатори, статус).	Про версия	`POST …/abilities/zinn-chat/set-kb-gap-status/run`	the REST route's own per-item permission check	няма
`zinn-chat/set-presence` `zinn-chat-set-presence`	Задайте наличността си Маркира влезлия в системата агент като наличен или отсъстващ за нови чатове (away: true или false).	Безплатно издание	`POST …/abilities/zinn-chat/set-presence/run`	the REST route's own per-item permission check	няма
`zinn-chat/suggest-reply` `zinn-chat-suggest-reply`	Създайте чернова на отговор с AI (Pro) Създава чернова на отговор на чат или билет въз основа на съдържанието на сайта; нищо не се изпраща.	Про версия	`POST …/abilities/zinn-chat/suggest-reply/run`	the REST route's own per-item permission check	няма
`zinn-chat/summarise-conversation` `zinn-chat-summarise-conversation`	Обобщаване на разговор с ИИ (Pro) Обобщава чат или билет в няколко реда.	Про версия	`POST …/abilities/zinn-chat/summarise-conversation/run`	the REST route's own per-item permission check	няма
`zinn-chat/take-chat` `zinn-chat-take-chat`	Започнете чат Наддава чакащ чат на влезлия в системата агент, така че посетителят да разговаря с човек.	Безплатно издание	`POST …/abilities/zinn-chat/take-chat/run`	the REST route's own per-item permission check	id: string (задължително)
`zinn-chat/update-settings` `zinn-chat-update-settings`	Промяна на настройките за чат Променя настройките, които изпращате (настройки: ключ към стойност), и запазва останалите. Всяка стойност се проверява точно както на екрана с настройки; get-settings извежда списък с ключовете.	Безплатно издание	`POST …/abilities/zinn-chat/update-settings/run`	zinn_chat_manage	settings: object (задължително)
`zinn-chat/update-ticket` `zinn-chat-update-ticket`	Промяна на заявка Променя статуса, приоритета или отговорника на заявка.	Безплатно издание	`POST …/abilities/zinn-chat/update-ticket/run`	the REST route's own per-item permission check	id: string (задължително)