Tərtibatçılar
Zinn® Chat imkanları arayışı
Zinn® Chat öz əməliyyatlarını WordPress Abilities API ilə qeydiyyatdan keçirir. Eyni imkanlar saytın öz serverində MCP alətləri və /wp-json/wp-abilities/v1 altındakı REST marşrutlarıdır. Bu səhifə pleyninin öz reyestrindən yaradılıb.
Son nöqtələr
HTTP üzərindən MCP (axın edilə bilən)
https://example.com/wp-json/zinn-chat/v1/mcpWP-CLI üzərindən MCP (standart daxiletmə və xaricetmə)
wp mcp-adapter serve --server=zinn-chat --user=<login>REST: imkanları siyahıya al
/wp-json/wp-abilities/v1/abilities?category=zinn-chatREST: qabiliyyəti işə salın
/wp-json/wp-abilities/v1/abilities/<name>/runDoğrulama və icazələr
HTTP sorğuları WordPress tətbiq şifrəsi ilə (HTTP Basic) autentifikasiya olunur. MCP serverinə qoşulmaq aşağıda göstərilən imkanları tələb edir; bundan sonra hər bir imkan hər obyekt üzrə öz icazəsini yoxlayır. Yalnız oxumaq üçün olan imkanlar GET sorğusu və onların daxiletmə məlumatı sorğu sətrində (query string) olmaqla işləyir; qalanları isə POST və JSON gövdəsi ilə {"input": {…}}.
Nümunələr
# REST: qabiliyyəti işə salın
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":{}}}Bütün imkanlar
İşləyən saytdan özü də yaradılan plajinin abilities.json faylından yaradılmışdır; ikisi uyğun gəlmədikdə test uğursuz olur.
| İmkan | Nə edir | Buraxılış | REST | İcazə | Parametrlər |
|---|---|---|---|---|---|
zinn-chat/answer-ticketzinn-chat-answer-ticket | Sorğunu cavablandır Müştəriyə e-poçt (mətn) vasitəsilə cavab verir və ya daxili qeyd əlavə edir (note: true); status istəyə görə müraciətin statusunu dəyişir. | Pulsuz buraxılış | POST …/abilities/zinn-chat/answer-ticket/run | the REST route's own per-item permission check | id: string (tələb olunur) |
zinn-chat/ask-assistantzinn-chat-ask-assistant | Köməkçidən soruş Saytın süni intellekt köməkçisinə sual verir və tapdığı hər bir mənbə ilə birlikdə onun cavabını qaytarır. | Pulsuz buraxılış | POST …/abilities/zinn-chat/ask-assistant/run | the REST route's own per-item permission check | heç biri |
zinn-chat/bulk-update-ticketszinn-chat-bulk-update-tickets | Bir anda çoxsaylı biletləri dəyişdirin (Pro) 100-ə qədər tiketin (id-lərin) statusunu, prioritetini və ya təyin olunmuş şəxsini dəyişir. Hər bir tiket təkbaşına dəyişdirildiyi kimi eyni yoxlamalardan keçir; nəticə hər birini siyahıya alır. | Pro nəşr | POST …/abilities/zinn-chat/bulk-update-tickets/run | zinn_chat_answer | ids: array (tələb olunur), status: open|pending|solved|closed, priority: low|normal|high|urgent, assignee_id: integer |
zinn-chat/chat-to-ticketzinn-chat-chat-to-ticket | Çatı tikete çevirin Çatdan bilet açır ki, e-poçt vasitəsilə cavablandırılsın (ziyarətçinin e-poçt ünvanı tələb olunur). | Pulsuz buraxılış | POST …/abilities/zinn-chat/chat-to-ticket/run | the REST route's own per-item permission check | id: string (tələb olunur) |
zinn-chat/close-chatzinn-chat-close-chat | Çatı bağla Çatı bitirir; ziyarətçi hələ də transkript istəyə bilər. | Pulsuz buraxılış | POST …/abilities/zinn-chat/close-chat/run | the REST route's own per-item permission check | id: string (tələb olunur) |
zinn-chat/create-ticketzinn-chat-create-ticket | Bilet açın Müştərinin adından müraciət açır (onların e-poçtu, mövzu və ilk mesaj). | Pulsuz buraxılış | POST …/abilities/zinn-chat/create-ticket/run | the REST route's own per-item permission check | heç biri |
zinn-chat/delete-canned-replyzinn-chat-delete-canned-reply | Yadda saxlanılan cavabı silin (Pro) Yadda saxlanılan cavabı silir. | Pro nəşr | POST …/abilities/zinn-chat/delete-canned-reply/run | the REST route's own per-item permission check | id: string (tələb olunur) |
zinn-chat/delete-ticketzinn-chat-delete-ticket | Tapanı sil Tikieti və onun müzakirəsini həmişəlik silir (yalnız menecerlər üçün). | Pulsuz buraxılış | POST …/abilities/zinn-chat/delete-ticket/run | the REST route's own per-item permission check | id: string (tələb olunur) |
zinn-chat/draft-kb-articlezinn-chat-draft-kb-article | Dəstək biletindən kömək məqaləsi hazırla (Pro) Həll edilmiş tikesdən bilik bazası üçün qaralama məqalə yazır; kimsə dərc edənə qədər o, qaralama olaraq qalır. | Pro nəşr | POST …/abilities/zinn-chat/draft-kb-article/run | edit_posts (the REST route's own check) | heç biri |
zinn-chat/draft-kb-from-gapszinn-chat-draft-kb-from-gaps | Cavabsız suallar üçün yardım məqalələrinin qaralamalarını hazırlayın (Pro) Seçilmiş sualları (id-ləri) cavablandıran qaralama bilik bazası məqalələri yazır; onlar qaralama olaraq qalır. | Pro nəşr | POST …/abilities/zinn-chat/draft-kb-from-gaps/run | edit_posts (the REST route's own check) | heç biri |
zinn-chat/fill-canned-replyzinn-chat-fill-canned-reply | Yadda saxlanılan cavabı doldurun (Pro) Yadda saxlanılmış cavabın mətnini bir çat və ya müraciət üçün doldurulmuş yer doldurucuları ilə birlikdə qaytarır. | Pro nəşr | POST …/abilities/zinn-chat/fill-canned-reply/run | the REST route's own per-item permission check | id: string (tələb olunur) |
zinn-chat/get-chatzinn-chat-get-chat | Çatı oxu Bir çatın mesajlarını və ziyarətçi təfərrüatlarını qaytarır (after: yalnız bu id-dən yeni olan mesajlar). | Pulsuz buraxılış | GET …/abilities/zinn-chat/get-chat/run | the REST route's own per-item permission check | id: string (tələb olunur) |
zinn-chat/get-overviewzinn-chat-get-overview | Dəstək icmalını oxuyun Hər bir statusda neçə tiket olduğunu, neçə çatın insanı gözlədiyini (və onların oxunmamış mesajlarını), həmçinin çatın, köməkçinin və tiketlərin işlək olub-olmadığını qaytarır. | Pulsuz buraxılış | GET …/abilities/zinn-chat/get-overview/run | zinn_chat_answer | heç biri |
zinn-chat/get-settingszinn-chat-get-settings | Çat parametrlərini oxumaq Bütün çat parametrlərini qaytarır: vidjet, köməkçi, əməkdaşlar və iş saatları, biletlər və e-poçt, sayt indeksi, məxfilik və spam. | Pulsuz buraxılış | GET …/abilities/zinn-chat/get-settings/run | zinn_chat_manage | heç biri |
zinn-chat/get-statszinn-chat-get-stats | Dəstək statistikasını oxu (Pro) Son N gün (gün) ərzində çət və tiket nömrələrini, cavab müddətlərini və reytinqləri qaytarır. | Pro nəşr | GET …/abilities/zinn-chat/get-stats/run | the REST route's own per-item permission check | heç biri |
zinn-chat/get-ticketzinn-chat-get-ticket | Tiketi oxu Bütün söhbəti, statusu, prioriteti və təyin olunmuş şəxsi ilə birlikdə bir bilet qaytarır. | Pulsuz buraxılış | GET …/abilities/zinn-chat/get-ticket/run | the REST route's own per-item permission check | id: string (tələb olunur) |
zinn-chat/hand-chat-to-assistantzinn-chat-hand-chat-to-assistant | Çatı yenidən köməkçiyə qaytarın Səhifənin məzmunundan istifadə edərək ziyarətçiyə cavab verən AI köməkçisinə çat qaytarır. | Pulsuz buraxılış | POST …/abilities/zinn-chat/hand-chat-to-assistant/run | the REST route's own per-item permission check | id: string (tələb olunur) |
zinn-chat/list-canned-replieszinn-chat-list-canned-replies | Yadda saxlanılan cavabların siyahısı (Pro) Agentlərin daxil edə biləcəyi yadda saxlanılmış cavabları qısayolları ilə birlikdə sadalayır. | Pro nəşr | GET …/abilities/zinn-chat/list-canned-replies/run | the REST route's own per-item permission check | heç biri |
zinn-chat/list-chatszinn-chat-list-chats | Canlı söhbətləri siyahıya al Gözləyən, davam edən və bu yaxınlarda bağlanmış çatları, hər birini kimin idarə etdiyini göstərən siyahılar. | Pulsuz buraxılış | GET …/abilities/zinn-chat/list-chats/run | the REST route's own per-item permission check | heç biri |
zinn-chat/list-indexed-contentzinn-chat-list-indexed-content | Köməkçinin nə bildiyini siyahıya alın Köməkçinin cavab verdiyi məzmunu onun indeks statusu ilə birlikdə səhifə-səhifə sadalayır. | Pulsuz buraxılış | GET …/abilities/zinn-chat/list-indexed-content/run | the REST route's own per-item permission check | heç biri |
zinn-chat/list-kb-gapszinn-chat-list-kb-gaps | Cavabsız sualları siyahıya al (Pro) Bilik bazasının cavablandra bilmədiyi ziyarətçi suallarını sadalayır. | Pro nəşr | GET …/abilities/zinn-chat/list-kb-gaps/run | the REST route's own per-item permission check | heç biri |
zinn-chat/list-ticketszinn-chat-list-tickets | Biletləri siyahıya al Status və ya axtarış üzrə filtrlənmiş dəstək biletlərini hər dəfə bir səhifə olmaqla siyahıya alır. | Pulsuz buraxılış | GET …/abilities/zinn-chat/list-tickets/run | the REST route's own per-item permission check | heç biri |
zinn-chat/reembed-contentzinn-chat-reembed-content | Köməkçinin axtarış indeksini yenidən qurun Bir element (item_id) və ya hər şey üçün (all: true) axtarış vektorlarını yenidən qurur (yalnız menecerlər üçün). | Pulsuz buraxılış | POST …/abilities/zinn-chat/reembed-content/run | the REST route's own per-item permission check | heç biri |
zinn-chat/reindex-contentzinn-chat-reindex-content | Məzmunu köməkçiyə yenidən oxudun Bir elementi (item_id) və ya hər şeyi (all: true) köməkçinin indeksinə yenidən oxuyur (yalnız menecerlər üçün). | Pulsuz buraxılış | POST …/abilities/zinn-chat/reindex-content/run | the REST route's own per-item permission check | heç biri |
zinn-chat/reply-chatzinn-chat-reply-chat | Çatda cavab yazın Ziyarətçiyə mesaj göndərir (text) və ya yalnız agentlərin gördüyü daxili qeyd əlavə edir (note: true). | Pulsuz buraxılış | POST …/abilities/zinn-chat/reply-chat/run | the REST route's own per-item permission check | id: string (tələb olunur) |
zinn-chat/save-canned-replyzinn-chat-save-canned-reply | Yadda saxlanılan cavabı yadda saxla (Pro) Saxlanmış cavab yaradır və ya dəyişdirir (başlıq, qısayol, mətn, şöbə; dəyişdirmək üçün id). | Pro nəşr | POST …/abilities/zinn-chat/save-canned-reply/run | the REST route's own per-item permission check | heç biri |
zinn-chat/save-kb-articlezinn-chat-save-kb-article | Yardım məqaləsi yazın (Pro) Bilik bazası məqaləsi yaradır və ya mövcud olanı (id) dəyişdirir: başlıq, məzmun, qısa məzmun, kateqoriyalar və status (qaralama və ya dərc edə biləcəyiniz zaman dərc et). | Pro nəşr | 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 | Bilik bazasında axtarış (Pro) Cavabda əlaqələndirmək üçün kömək məqalələri tapır (q: axtarış). | Pro nəşr | GET …/abilities/zinn-chat/search-kb/run | the REST route's own per-item permission check | heç biri |
zinn-chat/set-conversation-detailszinn-chat-set-conversation-details | Söhbətin şöbəsini və teqlərini təyin edin (Pro) Söhbətin və ya tıketin şöbəsini və teqlərini təyin edir (növ: chat və ya ticket; id). | Pro nəşr | POST …/abilities/zinn-chat/set-conversation-details/run | the REST route's own per-item permission check | heç biri |
zinn-chat/set-kb-gap-statuszinn-chat-set-kb-gap-status | Cavabsız sualları işarələyin (Pro) Cavabsız sualları açıq, planlaşdırılmış və ya rədd edilmiş kimi qeyd edir (kimliklər, status). | Pro nəşr | POST …/abilities/zinn-chat/set-kb-gap-status/run | the REST route's own per-item permission check | heç biri |
zinn-chat/set-presencezinn-chat-set-presence | Əlçatanlığınızı təyin edin Daxil olmuş agenti yeni çatlar üçün əlçatan və ya məşğul olaraq qeyd edir (away: true və ya false). | Pulsuz buraxılış | POST …/abilities/zinn-chat/set-presence/run | the REST route's own per-item permission check | heç biri |
zinn-chat/suggest-replyzinn-chat-suggest-reply | Süni intellektlə cavab layihəsi hazırlayın (Pro) Saytın məzmunundan istifadə edərək çat və ya tiketet cavab qaralaması hazırlayır; heç nə göndərilmir. | Pro nəşr | POST …/abilities/zinn-chat/suggest-reply/run | the REST route's own per-item permission check | heç biri |
zinn-chat/summarise-conversationzinn-chat-summarise-conversation | AI ilə söhbəti ümumiləşdirin (Pro) Çatı və ya müraciəti bir neçə sətirdə xülasə edir. | Pro nəşr | POST …/abilities/zinn-chat/summarise-conversation/run | the REST route's own per-item permission check | heç biri |
zinn-chat/take-chatzinn-chat-take-chat | Söhbətə başla Gözləyən çat-ı daxil olmuş agentə təyin edir ki, ziyarətçi canlı insanla danışsın. | Pulsuz buraxılış | POST …/abilities/zinn-chat/take-chat/run | the REST route's own per-item permission check | id: string (tələb olunur) |
zinn-chat/update-settingszinn-chat-update-settings | Çat parametrlərini dəyişdirin Göndərdiyiniz ayarları dəyişdirir (ayarlar: açardan dəyərə) və qalanını saxlayır. Hər bir dəyər ayarlar ekranında olduğu kimi dəqiq yoxlanılır; get-settings açarları sadalayır. | Pulsuz buraxılış | POST …/abilities/zinn-chat/update-settings/run | zinn_chat_manage | settings: object (tələb olunur) |
zinn-chat/update-ticketzinn-chat-update-ticket | Müraciəti dəyişdir Tiketin statusunu, prioritetini və ya təyin olunmuş şəxsi dəyişdirir. | Pulsuz buraxılış | POST …/abilities/zinn-chat/update-ticket/run | the REST route's own per-item permission check | id: string (tələb olunur) |