Розробники

Довідник можливостей Zinn® Chat

Zinn® Chat реєструє свої дії в WordPress Abilities API. Ці самі здібності є MCP-інструментами на власному сервері сайту та маршрутами REST у /wp-json/wp-abilities/v1. Цю сторінку згенеровано з власного реєстру плагіна.

Посібник користувача: підключення ШІ-додатка

Кінцеві точки

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 із вхідними даними в рядку запиту; інші — за допомогою 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 плагіна, який у свою чергу згенеровано з працюючого сайту; тест не проходить, якщо вони не збігаються.

Можливість	Що це робить	Видання	ВІДПОЧИНОК	Дозвіл	Параметри
`zinn-chat/answer-ticket` `zinn-chat-answer-ticket`	Відповісти на тікет Відповідає клієнту електронною поштою (text) або додає внутрішню замітку (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`	Запитати асистента Задає запитання штучному інтелекту сайту та повертає його відповідь разом із кожним знайденим джерелом.	Безплатна версія	`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) Створює проєкти статей бази знань, що відповідають на вибрані запитання (ідентифікатори); вони залишаються чорнетками.	Професійна версія	`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: лише повідомлення, новіші за цей ідентифікатор).	Безплатна версія	`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 днів (days).	Професійна версія	`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`	Повернути чат асистенту Повертає чат до штучного інтелекту-асистента, який відповідає відвідувачу на основі вмісту сайту.	Безплатна версія	`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`	Відповісти в чаті Надсилає відвідувачу повідомлення (text) або додає внутрішню замітку, яку бачать лише агенти (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) Встановлює відділ та теги чату або тикету (вид: chat або ticket; 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`	Створити чернетку відповіді за допомогою ШІ (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 (обов'язково)