Програмери

Zinn® Chat референца могућности

Zinn® Chat региструје своје радње помоћу WordPress Abilities API-ја. Исте могућности су MCP алати на сопственом серверу сајта и REST руте под /wp-json/wp-abilities/v1. Ова страница је генерисана из сопственог регистра додатка.

Кориснички водич: повежите AI апликацију

Zinn®, наш Викинг, навија док се помоћник са вештачком интелигенцијом повезује са алатима платформе.

Крајње тачке

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
Одговорите на тикет
Одговара кориснику путем е-поште (text), или додаје интерну белешку (note: true); status опционо мења статус тикета.
Бесплатно издањеPOST …/abilities/zinn-chat/answer-ticket/runthe REST route's own per-item permission checkid: string (Обавезно)
zinn-chat/ask-assistant
zinn-chat-ask-assistant
Питајте асистента
Поставља питање AI помоћнику сајта и враћа његов одговор са свим пронађеним изворима.
Бесплатно издањеPOST …/abilities/zinn-chat/ask-assistant/runthe REST route's own per-item permission checkquestion: string (Обавезно), language: string
zinn-chat/bulk-update-tickets
zinn-chat-bulk-update-tickets
Промените више тикета одједном (Pro)
Мења статус, приоритет или додељену особу за до 100 тикета (ids). Сваки тикет пролази кроз исте провере као и при појединачној измени; резултат наводи сваки од њих.
Про издањеPOST …/abilities/zinn-chat/bulk-update-tickets/runzinn_chat_answerids: 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/runthe REST route's own per-item permission checkid: string (Обавезно)
zinn-chat/close-chat
zinn-chat-close-chat
Затворите ћаскање
Завршава ћаскање; посетилац и даље може затражити транскрипт.
Бесплатно издањеPOST …/abilities/zinn-chat/close-chat/runthe REST route's own per-item permission checkid: string (Обавезно)
zinn-chat/create-ticket
zinn-chat-create-ticket
Отворите тикет
Отвара тикет у име корисника (његова е-пошта, наслов и прва порука).
Бесплатно издањеPOST …/abilities/zinn-chat/create-ticket/runthe REST route's own per-item permission checkemail: string (Обавезно), subject: string (Обавезно), body: string (Обавезно), name: string
zinn-chat/delete-canned-reply
zinn-chat-delete-canned-reply
Обришите сачувани одговор (Pro)
Брише сачувани одговор.
Про издањеPOST …/abilities/zinn-chat/delete-canned-reply/runthe REST route's own per-item permission checkid: string (Обавезно)
zinn-chat/delete-ticket
zinn-chat-delete-ticket
Обришите тикет
Брише тикет и његов разговор заувек (само за менаџере).
Бесплатно издањеPOST …/abilities/zinn-chat/delete-ticket/runthe REST route's own per-item permission checkid: string (Обавезно)
zinn-chat/draft-kb-article
zinn-chat-draft-kb-article
Направите нацрт чланка помоћи из тикета (Pro)
Пише нацрт чланка базе знања из решеног тикета; остаје нацрт све док га особа не објави.
Про издањеPOST …/abilities/zinn-chat/draft-kb-article/runedit_posts (the REST route's own check)ticket: integer (Обавезно)
zinn-chat/draft-kb-from-gaps
zinn-chat-draft-kb-from-gaps
Направите нацрте чланака помоћи за неодговорена питања (Pro)
Пише нацрте чланака базе знања који одговарају на изабрана питања (ids); они остају нацрти.
Про издањеPOST …/abilities/zinn-chat/draft-kb-from-gaps/runedit_posts (the REST route's own check)ids: array (Обавезно)
zinn-chat/fill-canned-reply
zinn-chat-fill-canned-reply
Попуните сачуваним одговором (Про)
Враћа текст сачуваног одговора са попуњеним чуварима места за једно ћаскање или тикет.
Про издањеPOST …/abilities/zinn-chat/fill-canned-reply/runthe REST route's own per-item permission checkid: string (Обавезно)
zinn-chat/get-chat
zinn-chat-get-chat
Прочитајте ћаскање
Враћа поруке једног ћаскања и податке о посетиоцу (after: само поруке новије од овог id-а).
Бесплатно издањеGET …/abilities/zinn-chat/get-chat/runthe REST route's own per-item permission checkid: string (Обавезно)
zinn-chat/get-overview
zinn-chat-get-overview
Прочитајте преглед подршке
Враћа број тикета у сваком од статуса и број ћаскања која чекају на оператера (као и њихове непрочитане поруке), као и информацију о томе да ли су ћаскање, асистент и тикети укључени.
Бесплатно издањеGET …/abilities/zinn-chat/get-overview/runzinn_chat_answerниједно
zinn-chat/get-settings
zinn-chat-get-settings
Прочитајте подешавања ћаскања
Враћа свако подешавање ћаскања: виџет, асистента, људе и радно време, тикете и е-пошту, индекс сајта, приватност и непожељне поруке.
Бесплатно издањеGET …/abilities/zinn-chat/get-settings/runzinn_chat_manageниједно
zinn-chat/get-stats
zinn-chat-get-stats
Преглед статистике подршке (Pro)
Враћа бројеве ћаскања и тикета, времена одговора и оцене за последњих N дана (days).
Про издањеGET …/abilities/zinn-chat/get-stats/runthe REST route's own per-item permission checkdays: integer
zinn-chat/get-ticket
zinn-chat-get-ticket
Прочитајте тикет
Враћа један тикет са његовим целим разговором, статусом, приоритетом и додељеном особом.
Бесплатно издањеGET …/abilities/zinn-chat/get-ticket/runthe REST route's own per-item permission checkid: string (Обавезно)
zinn-chat/hand-chat-to-assistant
zinn-chat-hand-chat-to-assistant
Препустите ћаскање назад асистенту
Враћа ћаскање вештачкој интелигенцији (AI), која одговара посетиоцу на основу садржаја веб-места.
Бесплатно издањеPOST …/abilities/zinn-chat/hand-chat-to-assistant/runthe REST route's own per-item permission checkid: string (Обавезно)
zinn-chat/list-canned-replies
zinn-chat-list-canned-replies
Прикажи сачуване одговоре (Pro)
Приказује сачуване одговоре које агенти могу да уметну, са њиховим пречицама.
Про издањеGET …/abilities/zinn-chat/list-canned-replies/runthe REST route's own per-item permission checkниједно
zinn-chat/list-chats
zinn-chat-list-chats
Испишите ћаскања уживо
Приказује ћаскања на чекању, у току и недавно затворена, са податком о томе ко води свако од њих.
Бесплатно издањеGET …/abilities/zinn-chat/list-chats/runthe REST route's own per-item permission checkview: active|bot|closed|all
zinn-chat/list-indexed-content
zinn-chat-list-indexed-content
Наведите шта асистент зна
Наводи садржај из ког асистент даје одговоре, са његовим статусом индексирања, страницу по страницу.
Бесплатно издањеGET …/abilities/zinn-chat/list-indexed-content/runthe REST route's own per-item permission checksearch: string, status: indexed|pending|error, page: integer
zinn-chat/list-kb-gaps
zinn-chat-list-kb-gaps
Прикажи неодговорена питања (Pro)
Наводи питања која су посетиоци поставили, а на која база знања није могла да одговори.
Про издањеGET …/abilities/zinn-chat/list-kb-gaps/runthe REST route's own per-item permission checkstatus: open|drafted|answered|ignored|all, page: integer
zinn-chat/list-tickets
zinn-chat-list-tickets
Прикажи тикете
Приказује тикете подршке, филтриране према статусу или претрази, страницу по страницу.
Бесплатно издањеGET …/abilities/zinn-chat/list-tickets/runthe REST route's own per-item permission checkstatus: active|open|pending|solved|closed|all, search: string, page: integer
zinn-chat/reembed-content
zinn-chat-reembed-content
Поново изградите индекс претраге помоћника
Поново гради векторе претраге за једну ставку (item_id) или све (all: true) (само управници).
Бесплатно издањеPOST …/abilities/zinn-chat/reembed-content/runthe REST route's own per-item permission checkall: boolean, item_id: integer
zinn-chat/reindex-content
zinn-chat-reindex-content
Поново учитајте садржај у асистента
Поново учитава једну ставку (item_id) или све (all: true) у индекс асистента (само за менаџере).
Бесплатно издањеPOST …/abilities/zinn-chat/reindex-content/runthe REST route's own per-item permission checkall: boolean, item_id: integer
zinn-chat/reply-chat
zinn-chat-reply-chat
Одговорите у ћаскању
Шаље поруку посетиоцу (text), или додаје интерну белешку коју виде само агенти (note: true).
Бесплатно издањеPOST …/abilities/zinn-chat/reply-chat/runthe REST route's own per-item permission checkid: string (Обавезно)
zinn-chat/save-canned-reply
zinn-chat-save-canned-reply
Сачувајте сачувани одговор (Pro)
Прави или мења сачувани одговор (наслов, пречица, текст поруке, одељење; id за измену једног).
Про издањеPOST …/abilities/zinn-chat/save-canned-reply/runthe REST route's own per-item permission checkid: integer, title: string (Обавезно), body: string (Обавезно), shortcut: string, department: string
zinn-chat/save-kb-article
zinn-chat-save-kb-article
Напишите чланак помоћи (Pro)
Прави чланак базе знања или мења постојећи (id): наслов, садржај, одломак, категорије и статус (нацрт или објавити ако имате дозволу за објављивање).
Про издањеPOST …/abilities/zinn-chat/save-kb-article/runedit_postsid: 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/runthe REST route's own per-item permission checkq: string (Обавезно)
zinn-chat/set-conversation-details
zinn-chat-set-conversation-details
Поставите одељење и ознаке разговора (Pro)
Поставља одељење и ознаке ћаскања или тикета (врста: ћаскање или тикет; id).
Про издањеPOST …/abilities/zinn-chat/set-conversation-details/runthe REST route's own per-item permission checkkind: ticket|chat, id: integer (Обавезно), department: string, tags: array
zinn-chat/set-kb-gap-status
zinn-chat-set-kb-gap-status
Означите неодговорена питања (Pro)
Означава неодговорена питања као отворена, планирана или одбачена (ids, status).
Про издањеPOST …/abilities/zinn-chat/set-kb-gap-status/runthe REST route's own per-item permission checkids: array (Обавезно), status: open|drafted|answered|ignored (Обавезно)
zinn-chat/set-presence
zinn-chat-set-presence
Подесите своју доступност
Означава пријављеног агента као доступног или одсутног за нова ћаскања (away: true или false).
Бесплатно издањеPOST …/abilities/zinn-chat/set-presence/runthe REST route's own per-item permission checkaway: boolean
zinn-chat/suggest-reply
zinn-chat-suggest-reply
Саставите одговор помоћу вештачке интелигенције (Pro)
Саставља нацрт одговора на ћаскање или тикет из садржаја веб-места; ништа се не шаље.
Про издањеPOST …/abilities/zinn-chat/suggest-reply/runthe REST route's own per-item permission checkkind: ticket|chat, id: integer (Обавезно)
zinn-chat/summarise-conversation
zinn-chat-summarise-conversation
Резимирајте разговор помоћу вештачке интелигенције (Pro)
Сажима ћаскање или тикет у неколико редова.
Про издањеPOST …/abilities/zinn-chat/summarise-conversation/runthe REST route's own per-item permission checkkind: ticket|chat, id: integer (Обавезно)
zinn-chat/take-chat
zinn-chat-take-chat
Преузмите ћаскање
Додељује ћаскање на чекању пријављеном агенту, тако да посетилац разговара са особом.
Бесплатно издањеPOST …/abilities/zinn-chat/take-chat/runthe REST route's own per-item permission checkid: string (Обавезно)
zinn-chat/update-settings
zinn-chat-update-settings
Промените подешавања ћаскања
Мења подешавања која пошаљете (подешавања: кључ у вредност) и задржава остала. Свака вредност се проверава тачно онако као на екрану са подешавањима; get-settings наводи кључеве.
Бесплатно издањеPOST …/abilities/zinn-chat/update-settings/runzinn_chat_managesettings: object (Обавезно)
zinn-chat/update-ticket
zinn-chat-update-ticket
Промените тикет
Мења статус, приоритет или додељено лице тикета.
Бесплатно издањеPOST …/abilities/zinn-chat/update-ticket/runthe REST route's own per-item permission checkid: 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_site_factsФилтрирајФилтрира чињенице о веб-сајту које се пружају асистенту уз свако питање. Свака садржи `title`, `url` (на овом сајту) и `text` (обичан текст, највише 3.000 знакова); користи се највише четири.string $languageБесплатно издање
zinn_chat_site_stringsФилтрирајФилтрира текстове власника понуђене за превођење (Pro додаје своје проактивне поруке).ниједноБесплатно издање
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_assignedРадњаAn agent assigned a ticket to an agent (2.14.0: the notification centre tells them).int $id, int $assignee, int $byБесплатно издање
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).ниједноБесплатно издање