Програмери
Zinn® Chat референца могућности
Zinn® Chat региструје своје радње помоћу WordPress Abilities API-ја. Исте могућности су MCP алати на сопственом серверу сајта и REST руте под /wp-json/wp-abilities/v1. Ова страница је генерисана из сопственог регистра додатка.
Крајње тачке
MCP преко HTTP-а (уз стримовање)
https://example.com/wp-json/zinn-chat/v1/mcpMCP преко WP-CLI (стандардни улаз и излаз)
wp mcp-adapter serve --server=zinn-chat --user=<login>REST: излистајте могућности
/wp-json/wp-abilities/v1/abilities?category=zinn-chatREST: покрените способност
/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-ticketzinn-chat-answer-ticket | Одговорите на тикет Одговара клијенту путем е-поште (text) или додаје интерну белешку (note: true); status опционо мења статус тикета. | Бесплатно издање | POST …/abilities/zinn-chat/answer-ticket/run | the REST route's own per-item permission check | id: string (Обавезно) |
zinn-chat/ask-assistantzinn-chat-ask-assistant | Питајте асистента Поставља питање AI асистенту сајта и враћа његов одговор са свим изворима које је пронашао. | Бесплатно издање | POST …/abilities/zinn-chat/ask-assistant/run | the REST route's own per-item permission check | ниједно |
zinn-chat/bulk-update-ticketszinn-chat-bulk-update-tickets | Промените више тикета одједном (Pro) Мења статус, приоритет или додељено лице за највише 100 тикета (ids). Сваки тикет пролази кроз исте провере као и при појединачној измени; резултат наводи сваки од њих. | Про издање | 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-ticketzinn-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-chatzinn-chat-close-chat | Затворите ћаскање Завршава ћаскање; посетилац и даље може да затражи транскрипт. | Бесплатно издање | POST …/abilities/zinn-chat/close-chat/run | the REST route's own per-item permission check | id: string (Обавезно) |
zinn-chat/create-ticketzinn-chat-create-ticket | Отворите тикет Отвара тикет у име клијента (његов имејл, тема и прва порука). | Бесплатно издање | POST …/abilities/zinn-chat/create-ticket/run | the REST route's own per-item permission check | ниједно |
zinn-chat/delete-canned-replyzinn-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-ticketzinn-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-articlezinn-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-gapszinn-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-replyzinn-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-chatzinn-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-overviewzinn-chat-get-overview | Прочитајте преглед подршке Враћа број тикета у сваком статусу и колико ћаскања чека на агента (и њихове непрочитане поруке), као и да ли су ћаскање, асистент и тикети укључени. | Бесплатно издање | GET …/abilities/zinn-chat/get-overview/run | zinn_chat_answer | ниједно |
zinn-chat/get-settingszinn-chat-get-settings | Прочитајте подешавања ћаскања Враћа свако подешавање ћаскања: виџет, асистента, људе и радно време, тикете и имејл, индекс сајта, приватност и непожељну пошту. | Бесплатно издање | GET …/abilities/zinn-chat/get-settings/run | zinn_chat_manage | ниједно |
zinn-chat/get-statszinn-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-ticketzinn-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-assistantzinn-chat-hand-chat-to-assistant | Пренесите ћаскање назад асистенту Враћа ћаскање AI асистенту, који посетиоцу одговара на основу садржаја сајта. | Бесплатно издање | POST …/abilities/zinn-chat/hand-chat-to-assistant/run | the REST route's own per-item permission check | id: string (Обавезно) |
zinn-chat/list-canned-replieszinn-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-chatszinn-chat-list-chats | Прикажи ћаскања уживо Приказује ћаскања која чекају, која су у току и недавно затворена, са податком о томе ко води свако од њих. | Бесплатно издање | GET …/abilities/zinn-chat/list-chats/run | the REST route's own per-item permission check | ниједно |
zinn-chat/list-indexed-contentzinn-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-gapszinn-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-ticketszinn-chat-list-tickets | Прикажи тикете Приказује тикете за подршку, филтриране према статусу или претрази, страницу по страницу. | Бесплатно издање | GET …/abilities/zinn-chat/list-tickets/run | the REST route's own per-item permission check | ниједно |
zinn-chat/reembed-contentzinn-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-contentzinn-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-chatzinn-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-replyzinn-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-articlezinn-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-kbzinn-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-detailszinn-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-statuszinn-chat-set-kb-gap-status | Означите неодговорена питања (Pro) Означава неодговорена питања као отворена, планирана или одбачена (ids, status). | Про издање | POST …/abilities/zinn-chat/set-kb-gap-status/run | the REST route's own per-item permission check | ниједно |
zinn-chat/set-presencezinn-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-replyzinn-chat-suggest-reply | Саставите одговор помоћу вештачке интелигенције (Pro) Саставља нацрт одговора на ћаскање или тикет на основу садржаја сајта; ништа се не шаље. | Про издање | POST …/abilities/zinn-chat/suggest-reply/run | the REST route's own per-item permission check | ниједно |
zinn-chat/summarise-conversationzinn-chat-summarise-conversation | Резимирајте разговор уз помоћ вештачке интелигенције (Pro) Укратко приказује ћаскање или тикет у неколико редова. | Про издање | POST …/abilities/zinn-chat/summarise-conversation/run | the REST route's own per-item permission check | ниједно |
zinn-chat/take-chatzinn-chat-take-chat | Преузмите ћаскање Додељује ћаскање на чекању пријављеном агенту, тако да посетилац разговара са особом. | Бесплатно издање | POST …/abilities/zinn-chat/take-chat/run | the REST route's own per-item permission check | id: string (Обавезно) |
zinn-chat/update-settingszinn-chat-update-settings | Промените подешавања ћаскања Мења подешавања која пошаљете (подешавања: кључ у вредност) и задржава остала. Свака вредност се проверава тачно онако како је на екрану са подешавањима; get-settings наводи кључеве. | Бесплатно издање | POST …/abilities/zinn-chat/update-settings/run | zinn_chat_manage | settings: object (Обавезно) |
zinn-chat/update-ticketzinn-chat-update-ticket | Измените тикет Мења статус, приоритет или додељено лице тикета. | Бесплатно издање | POST …/abilities/zinn-chat/update-ticket/run | the REST route's own per-item permission check | id: string (Обавезно) |
Радње и филтери
Свака кукица коју додатак нуди, са описом из његовог изворног кода. Филтери мењају вредност; акције вам омогућавају да покренете код у одређеном тренутку; тачке улаза су акције које покрећете како бисте затражили од додатка да нешто уради.
| Кука | Врста | Шта ради | Параметри | Издање |
|---|---|---|---|---|
zinn_chat_admin_pages | Филтрирај | Filtrira administratorske ekrane za Zinn® Chat (Pro dodaje svoje). | ниједно | Бесплатно издање |
zinn_chat_agent_chat | Филтрирај | Filtrira korisnički teret za konzolu agenta (Pro dodaje detalje o posetiocu, beleške, predloge baze znanja). | ниједно | Бесплатно издање |
zinn_chat_agent_pages | Филтрирај | Filtrira Zinn® Chat ekrane koje nalog agenta podrške može da otvori. | ниједно | Про издање |
zinn_chat_agent_script_src | Филтрирај | Filtrira URL sa kojeg se učitava samostalni AI čet agent. | string $src | Бесплатно издање |
zinn_chat_agent_ticket | Филтрирај | Filtrira payload tiketa za wp-admin (Pro dodaje unapred pripremljene odgovore, SLA, predloge baze znanja). | ниједно | Бесплатно издање |
zinn_chat_answer | Филтрирај | Filtrira odgovor asistenta pre nego što bude prikazan (Pro dodaje svoje dodatke ovde). | string $question | Бесплатно издање |
zinn_chat_assistant_answered | Радња | Asistent je odgovorio posetiocu. | int $id, string $text | Бесплатно издање |
zinn_chat_challenge | Филтрирај | Filtrira ljudsku proveru koja se prikazuje posetiocima (URL skripte, ključ sajta i globalni objekat koji skripta definiše sa `render( element, { sitekey, callback } )` metodom). | ниједно | Бесплатно издање |
zinn_chat_challenge_ok | Филтрирај | Filtrira da li je posetilac prošao ljudsku proveru. Provera koja ne može da se potvrdi mora da vrati netačno (neuspelo zatvoreno): forma koja propušta sve kad god je servis nedostupan je forma koju bot može učiniti uspešnom vremenskim usklađivanjem. | bool $ok, string $ip, string $where | Бесплатно издање |
zinn_chat_client_ip | Филтрирај | Filtrira IP adresu posetioca koja se koristi za ograničenja brzine (rate limits) i evidencije. | string $ip | Бесплатно издање |
zinn_chat_console_config | Филтрирај | Filtrira dodatnu konfiguraciju prosleđenu skripti konzole operatera; Zinn® Chat Pro ovde dodaje svoje funkcije. | ниједно | Бесплатно издање |
zinn_chat_conversation_started | Радња | Posetilac je započeo ćaskanje. | int $id | Бесплатно издање |
zinn_chat_conversation_status | Радња | Status razgovora je promenjen. | int $id, string $status, string $old | Бесплатно издање |
zinn_chat_customer_ticket_url | Филтрирај | Filtrira link koji se šalje kupcu za njegovu kartu. | string $url | Бесплатно издање |
zinn_chat_elements | Филтрирај | Filtrira elemente korisničkog interfejsa koji su ponuđeni kao blokovi i moduli graditelja. | ниједно | Бесплатно издање |
zinn_chat_email | Филтрирај | Filtrira e-poruku pre nego što bude poslata. Vratite prazno `to` da biste je zaustavili. | ниједно | Бесплатно издање |
zinn_chat_fs_loaded | Радња | Pokreće se kada se SDK za licenciranje učita (u glavnoj datoteci, pre bilo kog Zinn® Chat koda). Povežite se ovde da biste razgovarali sa `zinn_chat_fs()`. | ниједно | Бесплатно издање |
zinn_chat_index_extract | Филтрирај | Filtrira ekstrahovani objekat (ili obezbeđuje jedan za prilagođeni tip objekta). | string $type, int $id | Бесплатно издање |
zinn_chat_index_language | Филтрирај | Filtrira jezik (lokalni format) indeksiranog posta. | string $language, \WP_Post $post | Бесплатно издање |
zinn_chat_index_object | Улазна тачка (ви је покрећете) | Kuke. | ниједно | Бесплатно издање |
zinn_chat_index_post_types | Филтрирај | Filtrira tipove objava koje asistent čita. | ниједно | Бесплатно издање |
zinn_chat_indexable | Филтрирај | Filtrira da li je post indeksiran. | bool $indexable, \WP_Post $post | Бесплатно издање |
zinn_chat_indexed | Радња | Objekat je (ponovo) indeksiran. | string $type, int $id | Бесплатно издање |
zinn_chat_is_pro | Филтрирај | Filtrira da li se Pro funkcije izvršavaju (kupljena licenca ili probni period, preko Freemius). Pro kod se isporučuje samo u premium paketu, tako da ovo ne može dodati ono što besplatna verzija nema. | bool $pro | Бесплатно издање |
zinn_chat_loaded | Радња | Zinn® Chat je učitan (tačka proširenja za dodatke). | ниједно | Бесплатно издање |
zinn_chat_message_added | Радња | Poruka je dodata u razgovor. | int $id, int $conversation_id, string $role | Бесплатно издање |
zinn_chat_order_tracking | Филтрирај | Filtrira informacije o praćenju date asistentu za porudžbinu. | \WC_Order $order | Бесплатно издање |
zinn_chat_pro_alert | Радња | Dogodio se važan događaj (puš-obaveštenja slušaju ovde). | string $alert, int $id, string $text, string $link | Про издање |
zinn_chat_pro_assigned | Радња | Tiket je automatski dodeljen agentu. | int $id, int $agent | Про издање |
zinn_chat_pro_loaded | Радња | Pro sloj je učitan. | ниједно | Про издање |
zinn_chat_pro_priority_changed | Радња | Prioritet tiketa je promenjen (SLA ciljevi se menjaju u skladu sa tim). | int $id | Про издање |
zinn_chat_pro_sla_breach | Радња | SLA cilj nije ispunjen. | int $ticket_id, string $which | Про издање |
zinn_chat_pro_ticket_rated | Радња | Korisnik je ocenio rešeni tiket (1-5). | int $id, int $score | Про издање |
zinn_chat_rated | Радња | Aktivira se nakon što posetilac oceni razgovor, sa ID-jem razgovora i ocenom (1 za korisno, -1 za nekorisno). | int $conversation_id, int $rating | Бесплатно издање |
zinn_chat_role_capabilities | Филтрирај | Filtrirajte koje uloge dobijaju koje Zinn® Chat mogućnosti. | ниједно | Бесплатно издање |
zinn_chat_save_settings | Филтрирај | Filtrira podešavanja pre njihovog čuvanja (Pro dodaje sopstvene ključeve ovde). | ниједно | Бесплатно издање |
zinn_chat_script_src | Филтрирај | Filtrira URL sa kojeg se učitava vidžet hostovanog ćaska (povezani režim). | string $src | Бесплатно издање |
zinn_chat_settings_before | Радња | Iznad obrasca kartice sa podešavanjima. | string $tab | Бесплатно издање |
zinn_chat_settings_fields | Филтрирај | Filtrira polja kartice sa podešavanjima (Pro dodaje sopstvena). | string $tab | Бесплатно издање |
zinn_chat_settings_tabs | Филтрирај | Filtrira kartice podešavanja. | ниједно | Бесплатно издање |
zinn_chat_setup_after | Радња | Izlaz ispod kontrolne liste za podešavanje (besplatno izdanje ovde prikazuje Pro karticu). | ниједно | Бесплатно издање |
zinn_chat_should_render | Филтрирај | Filtrira da li se ćaskanje prikazuje u ovom zahtevu (kuke za ciljanje stranice za Pro se nalaze ovde). | bool $render | Бесплатно издање |
zinn_chat_system_prompt | Филтрирај | Filtrira sistemski upit asistenta (Pro: persona i pravila preuzimanja). | string $rules | Бесплатно издање |
zinn_chat_team_online | Филтрирај | Filtrira da li osoba može da odgovori sada (Pro ovde dodaje radno vreme). | bool $online | Бесплатно издање |
zinn_chat_ticket_created | Радња | Tiket je otvoren. Odavde pošiljka šalje potvrdu i upozorenje timu. | int $id, string $token | Бесплатно издање |
zinn_chat_ticket_form_extra | Филтрирај | Филтрира додатне ознаке на крају формулара за гостујуће карте (Pro провера људског фактора иде овде). | string $html | Бесплатно издање |
zinn_chat_ticket_form_fields | Филтрирај | Filteri dodatnih polja prikazanih iznad poruke na svakom obrascu tiketa (Pro: izbor odeljenja). Imenujte ih `zinn_chat_extra[<key>]`; oni stižu do `zinn_chat_ticket_created` kao `$fields['extra']`, neočišćeni, na onome ko ih je dodao da ih validira. | string $html | Бесплатно издање |
zinn_chat_ticket_reply | Радња | Odgovor je dodat na tiket. Mailer odavde šalje e-poštu drugoj strani. | int $id, int $ticket_id, string $author | Бесплатно издање |
zinn_chat_ticket_status | Радња | Status tiketa je promenjen. | int $id, string $status, string $old | Бесплатно издање |
zinn_chat_uninstall | Радња | Zinn® Chat se deinstalira (Pro ovde uklanja sopstvene podatke). | ниједно | Бесплатно издање |
zinn_chat_widget_config | Филтрирај | Filtrira konfiguraciju pokretača koja se prikazuje na stranici. | ниједно | Бесплатно издање |
zinn_chat_widget_status | Филтрирај | Filtrira ono što primljeni razgovor prima (Pro dodaje sopstvene prekidače i reči). | ниједно | Бесплатно издање |