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

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

Возможность	Назначение	Редакция	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`	Спросить ассистента Задает сайтовому ИИ-ассистенту вопрос и возвращает его ответ со всеми найденными источниками.	Бесплатный тариф	`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 тикетов (по их id). Каждый тикет проходит те же проверки, что и при изменении по отдельности; результат выводится для каждого из них.	Версия Pro	`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) Удаляет сохраненный ответ.	Версия 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) Создает черновик статьи базы знаний из решенного тикета; он остается черновиком, пока его не опубликует человек.	Версия 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); они остаются черновиками.	Версия 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) Возвращает текст сохраненного ответа с заполненными заполнителями для одного чата или тикета.	Версия 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 дней (days).	Версия Pro	`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) Отображает список сохраненных ответов, которые агенты могут вставлять, с указанием их ярлыков.	Версия 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) Отображает список вопросов посетителей, на которые база знаний не смогла ответить.	Версия 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 для изменения существующего).	Версия Pro	`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): заголовок, содержание, отрывок, категории и статус (черновик или опубликовано, когда публикация разрешена).	Версия 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`	Поиск по базе знаний (Pro) Находит справочные статьи для добавления ссылки в ответ (q: поиск).	Версия Pro	`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).	Версия Pro	`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) Помечает неотвеченные вопросы как открытые, запланированные или отклоненные (идентификаторы, статус).	Версия 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) Создает проект ответа на чат или тикет на основе контента сайта; ничего не отправляется.	Версия 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) Суммирует чат или тикет в нескольких строках.	Версия 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 (обязательно)