Deweloperzy

Odnośnik możliwości Zinn® Chat

Wtyczka Zinn® Chat rejestruje swoje działania za pomocą WordPress Abilities API. Te same uprawnienia są narzędziami MCP na własnym serwerze witryny oraz ścieżkami REST pod adresem /wp-json/wp-abilities/v1. Ta strona jest generowana z własnego rejestru wtyczki.

Przewodnik użytkownika: podłącz aplikację sztucznej inteligencji

Endpointy

MCP przez HTTP (przesyłane strumieniowo)

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

MCP przez WP-CLI (standardowe wejście i wyjście)

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

REST: wyświetl listę umiejętności

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

REST: uruchom zdolność

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

Uwierzytelnianie i uprawnienia

Żądania HTTP uwierzytelniają się za pomocą hasła aplikacyjnego WordPress (HTTP Basic). Połączenie z serwerem MCP wymaga uprawnienia pokazanego poniżej; każda funkcja sprawdza następnie własne uprawnienia dla każdego obiektu. Funkcje tylko do odczytu działają z metodą GET i danymi wejściowymi w ciągu zapytania; pozostałe z metodą POST i treścią JSON {"input": {…}}.

Przykłady

# REST: uruchom zdolność
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":{}}}

Wszystkie uprawnienia

Wygenerowano z pliku abilities.json wtyczki, który z kolei jest generowany z działającej witryny; test kończy się niepowodzeniem, gdy oba źródła się nie zgadzają.

Uprawnienie	Jak to działa	Wydanie	REST	Uprawnienie	Parametry
`zinn-chat/answer-ticket` `zinn-chat-answer-ticket`	Odpowiedz na zgłoszenie Odpowiada klientowi przez e-mail (text) lub dodaje wewnętrzną notatkę (note: true); status opcjonalnie zmienia status zgłoszenia.	Wersja darmowa	`POST …/abilities/zinn-chat/answer-ticket/run`	the REST route's own per-item permission check	id: string (wymagane)
`zinn-chat/ask-assistant` `zinn-chat-ask-assistant`	Zapytaj asystenta Zadaje pytanie asystentowi AI witryny i zwraca jego odpowiedź wraz z każdym znalezionym źródłem.	Wersja darmowa	`POST …/abilities/zinn-chat/ask-assistant/run`	the REST route's own per-item permission check	brak
`zinn-chat/bulk-update-tickets` `zinn-chat-bulk-update-tickets`	Zmień wiele zgłoszeń jednocześnie (Pro) Zmienia status, priorytet lub osobę przypisaną do maksymalnie 100 zgłoszeń (id). Każde zgłoszenie przechodzi takie same sprawdzenia jak przy zmianie pojedynczego zgłoszenia; wynik zawiera listę każdego z nich.	Edycja Pro	`POST …/abilities/zinn-chat/bulk-update-tickets/run`	zinn_chat_answer	ids: array (wymagane), status: open\|pending\|solved\|closed, priority: low\|normal\|high\|urgent, assignee_id: integer
`zinn-chat/chat-to-ticket` `zinn-chat-chat-to-ticket`	Zamień czat w zgłoszenie Otwiera zgłoszenie z czatu, aby można było na nie odpowiedzieć przez e-mail (wymaga adresu e-mail odwiedzającego).	Wersja darmowa	`POST …/abilities/zinn-chat/chat-to-ticket/run`	the REST route's own per-item permission check	id: string (wymagane)
`zinn-chat/close-chat` `zinn-chat-close-chat`	Zamknij czat Kończy czat; odwiedzający nadal może poprosić o transkrypcję.	Wersja darmowa	`POST …/abilities/zinn-chat/close-chat/run`	the REST route's own per-item permission check	id: string (wymagane)
`zinn-chat/create-ticket` `zinn-chat-create-ticket`	Otwórz zgłoszenie Otwiera zgłoszenie w imieniu klienta (jego adres e-mail, temat oraz pierwsza wiadomość).	Wersja darmowa	`POST …/abilities/zinn-chat/create-ticket/run`	the REST route's own per-item permission check	brak
`zinn-chat/delete-canned-reply` `zinn-chat-delete-canned-reply`	Usuń zapisaną odpowiedź (Pro) Usuwa zapisaną odpowiedź.	Edycja Pro	`POST …/abilities/zinn-chat/delete-canned-reply/run`	the REST route's own per-item permission check	id: string (wymagane)
`zinn-chat/delete-ticket` `zinn-chat-delete-ticket`	Usuń zgłoszenie Trwale usuwa zgłoszenie wraz z całą konwersacją (tylko dla menedżerów).	Wersja darmowa	`POST …/abilities/zinn-chat/delete-ticket/run`	the REST route's own per-item permission check	id: string (wymagane)
`zinn-chat/draft-kb-article` `zinn-chat-draft-kb-article`	Utwórz artykuł pomocy ze zgłoszenia (Pro) Tworzy szkic artykułu bazy wiedzy z rozwiązanego zgłoszenia; pozostaje on szkicem, dopóki ktoś go nie opublikuje.	Edycja Pro	`POST …/abilities/zinn-chat/draft-kb-article/run`	edit_posts (the REST route's own check)	brak
`zinn-chat/draft-kb-from-gaps` `zinn-chat-draft-kb-from-gaps`	Szkicowanie artykułów pomocy dla pytań bez odpowiedzi (Pro) Tworzy wersje robocze artykułów bazy wiedzy odpowiadające na wybrane pytania (identyfikatory); pozostają one wersjami roboczymi.	Edycja Pro	`POST …/abilities/zinn-chat/draft-kb-from-gaps/run`	edit_posts (the REST route's own check)	brak
`zinn-chat/fill-canned-reply` `zinn-chat-fill-canned-reply`	Wypełnij zapisaną odpowiedź (Pro) Zwraca treść zapisanej odpowiedzi z wypełnionymi symbolami zastępczymi dla jednego czatu lub zgłoszenia.	Edycja Pro	`POST …/abilities/zinn-chat/fill-canned-reply/run`	the REST route's own per-item permission check	id: string (wymagane)
`zinn-chat/get-chat` `zinn-chat-get-chat`	Przeczytaj czat Zwraca wiadomości i szczegóły odwiedzającego dla jednego czatu (parametr after: tylko wiadomości nowsze niż to id).	Wersja darmowa	`GET …/abilities/zinn-chat/get-chat/run`	the REST route's own per-item permission check	id: string (wymagane)
`zinn-chat/get-overview` `zinn-chat-get-overview`	Przeczytaj przegląd pomocy Zwraca liczbę zgłoszeń w każdym statusie, liczbę czatów oczekujących na konsultanta (oraz ich nieprzeczytane wiadomości) oraz informacje o tym, czy czat, asystent i zgłoszenia są włączone.	Wersja darmowa	`GET …/abilities/zinn-chat/get-overview/run`	zinn_chat_answer	brak
`zinn-chat/get-settings` `zinn-chat-get-settings`	Odczytaj ustawienia czatu Zwraca wszystkie ustawienia czatu: widget, asystenta, osoby i godziny otwarcia, zgłoszenia i e-mail, indeks witryny, prywatność oraz spam.	Wersja darmowa	`GET …/abilities/zinn-chat/get-settings/run`	zinn_chat_manage	brak
`zinn-chat/get-stats` `zinn-chat-get-stats`	Przeczytaj statystyki pomocy (Pro) Zwraca numery czatów i zgłoszeń, czasy odpowiedzi oraz oceny za ostatnie N dni (dni).	Edycja Pro	`GET …/abilities/zinn-chat/get-stats/run`	the REST route's own per-item permission check	brak
`zinn-chat/get-ticket` `zinn-chat-get-ticket`	Przeczytaj zgłoszenie Zwraca jedno zgłoszenie wraz z całą jego konwersacją, statusem, priorytetem i osobą przypisaną.	Wersja darmowa	`GET …/abilities/zinn-chat/get-ticket/run`	the REST route's own per-item permission check	id: string (wymagane)
`zinn-chat/hand-chat-to-assistant` `zinn-chat-hand-chat-to-assistant`	Przekaż czat z powrotem do asystenta Zwraca czat asystentowi AI, który odpowiada odwiedzającemu na podstawie treści witryny.	Wersja darmowa	`POST …/abilities/zinn-chat/hand-chat-to-assistant/run`	the REST route's own per-item permission check	id: string (wymagane)
`zinn-chat/list-canned-replies` `zinn-chat-list-canned-replies`	Wyświetl zapisane odpowiedzi (Pro) Wyświetla listę zapisanych odpowiedzi, które agenci mogą wstawiać, wraz z ich skrótami.	Edycja Pro	`GET …/abilities/zinn-chat/list-canned-replies/run`	the REST route's own per-item permission check	brak
`zinn-chat/list-chats` `zinn-chat-list-chats`	Wyświetl aktywne czaty Wyświetla listę oczekujących, trwających i ostatnio zamkniętych czatów wraz z informacją, kto obsługuje każdy z nich.	Wersja darmowa	`GET …/abilities/zinn-chat/list-chats/run`	the REST route's own per-item permission check	brak
`zinn-chat/list-indexed-content` `zinn-chat-list-indexed-content`	Wypisz to, co wie asystent Wyświetla zawartość, na której asystent opiera swoje odpowiedzi, wraz z jej indeksem statusu, strona po stronie.	Wersja darmowa	`GET …/abilities/zinn-chat/list-indexed-content/run`	the REST route's own per-item permission check	brak
`zinn-chat/list-kb-gaps` `zinn-chat-list-kb-gaps`	Wyświetl listę bez odpowiedzi (Pro) Wyświetla listę pytań zadanych przez odwiedzających, na które baza wiedzy nie mogła odpowiedzieć.	Edycja Pro	`GET …/abilities/zinn-chat/list-kb-gaps/run`	the REST route's own per-item permission check	brak
`zinn-chat/list-tickets` `zinn-chat-list-tickets`	Lista zgłoszeń Wyświetla listę zgłoszeń do pomocy technicznej, filtrowanych według statusu lub wyszukiwania, po jednej stronie na raz.	Wersja darmowa	`GET …/abilities/zinn-chat/list-tickets/run`	the REST route's own per-item permission check	brak
`zinn-chat/reembed-content` `zinn-chat-reembed-content`	Przebuduj indeks wyszukiwania asystenta Przebudowuje wektory wyszukiwania dla jednego elementu (item_id) lub wszystkich (all: true) (tylko dla menedżerów).	Wersja darmowa	`POST …/abilities/zinn-chat/reembed-content/run`	the REST route's own per-item permission check	brak
`zinn-chat/reindex-content` `zinn-chat-reindex-content`	Ponownie wczytaj treść do asystenta Ponownie wczytuje jeden element (item_id) lub wszystko (all: true) do indeksu asystenta (tylko dla menedżerów).	Wersja darmowa	`POST …/abilities/zinn-chat/reindex-content/run`	the REST route's own per-item permission check	brak
`zinn-chat/reply-chat` `zinn-chat-reply-chat`	Odpowiedz na czacie Wysyła wiadomość do odwiedzającego (text) lub dodaje wewnętrzną notatkę widoczną tylko dla agentów (note: true).	Wersja darmowa	`POST …/abilities/zinn-chat/reply-chat/run`	the REST route's own per-item permission check	id: string (wymagane)
`zinn-chat/save-canned-reply` `zinn-chat-save-canned-reply`	Zapisz zapisaną odpowiedź (Pro) Tworzy lub modyfikuje zapisaną odpowiedź (tytuł, skrót, treść, dział; identyfikator w celu modyfikacji).	Edycja Pro	`POST …/abilities/zinn-chat/save-canned-reply/run`	the REST route's own per-item permission check	brak
`zinn-chat/save-kb-article` `zinn-chat-save-kb-article`	Napisz artykuł pomocy (Pro) Tworzy artykuł bazy wiedzy lub modyfikuje istniejący (id): tytuł, treść, zajawkę, kategorie oraz status (szkic lub publikuj, gdy masz uprawnienia do publikacji).	Edycja 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`	Przeszukaj bazę wiedzy (Pro) Znajduje artykuły pomocy do podlinkowania w odpowiedzi (q: wyszukiwanie).	Edycja Pro	`GET …/abilities/zinn-chat/search-kb/run`	the REST route's own per-item permission check	brak
`zinn-chat/set-conversation-details` `zinn-chat-set-conversation-details`	Ustaw dział i tagi konwersacji (Pro) Ustawia dział i etykiety czatu lub zgłoszenia (typ: chat lub ticket; id).	Edycja Pro	`POST …/abilities/zinn-chat/set-conversation-details/run`	the REST route's own per-item permission check	brak
`zinn-chat/set-kb-gap-status` `zinn-chat-set-kb-gap-status`	Oznacz bez odpowiedzi pytania (Pro) Oznacza nieodpowiedziane pytania jako otwarte, zaplanowane lub odrzucone (identyfikatory, status).	Edycja Pro	`POST …/abilities/zinn-chat/set-kb-gap-status/run`	the REST route's own per-item permission check	brak
`zinn-chat/set-presence` `zinn-chat-set-presence`	Ustaw swoją dostępność Oznacza zalogowanego agenta jako dostępnego lub niedostępnego do nowych czatów (niedostępny: true lub false).	Wersja darmowa	`POST …/abilities/zinn-chat/set-presence/run`	the REST route's own per-item permission check	brak
`zinn-chat/suggest-reply` `zinn-chat-suggest-reply`	Napisz odpowiedź za pomocą sztucznej inteligencji (Pro) Przygotowuje projekt odpowiedzi na czat lub zgłoszenie na podstawie treści strony; nic nie jest wysyłane.	Edycja Pro	`POST …/abilities/zinn-chat/suggest-reply/run`	the REST route's own per-item permission check	brak
`zinn-chat/summarise-conversation` `zinn-chat-summarise-conversation`	Podsumuj rozmowę z AI (Pro) Podsumowuje czat lub zgłoszenie w kilku wierszach.	Edycja Pro	`POST …/abilities/zinn-chat/summarise-conversation/run`	the REST route's own per-item permission check	brak
`zinn-chat/take-chat` `zinn-chat-take-chat`	Rozpocznij czat Przypisuje oczekujący czat zalogowanemu konsultantowi, dzięki czemu odwiedzający rozmawia z człowiekiem.	Wersja darmowa	`POST …/abilities/zinn-chat/take-chat/run`	the REST route's own per-item permission check	id: string (wymagane)
`zinn-chat/update-settings` `zinn-chat-update-settings`	Zmień ustawienia czatu Zmienia wysyłane ustawienia (ustawienia: klucz na wartość) i zachowuje pozostałe. Każda wartość jest weryfikowana dokładnie tak samo jak na ekranie ustawień; get-settings wyświetla listę kluczy.	Wersja darmowa	`POST …/abilities/zinn-chat/update-settings/run`	zinn_chat_manage	settings: object (wymagane)
`zinn-chat/update-ticket` `zinn-chat-update-ticket`	Zmień zgłoszenie Zmienia status, priorytet lub osobę przypisaną do zgłoszenia.	Wersja darmowa	`POST …/abilities/zinn-chat/update-ticket/run`	the REST route's own per-item permission check	id: string (wymagane)