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.

İstifadəçi bələdçisi: Süni intellekt tətbiqini qoşun

Son nöqtələr

HTTP üzərindən MCP (axın edilə bilən)

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

WP-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-chat

REST: qabiliyyəti işə salın

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

Doğ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.

İmkanNə edirBuraxılışRESTİcazəParametrlər
zinn-chat/answer-ticket
zinn-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/runthe REST route's own per-item permission checkid: string (tələb olunur)
zinn-chat/ask-assistant
zinn-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/runthe REST route's own per-item permission checkheç biri
zinn-chat/bulk-update-tickets
zinn-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əşrPOST …/abilities/zinn-chat/bulk-update-tickets/runzinn_chat_answerids: array (tələb olunur), status: open|pending|solved|closed, priority: low|normal|high|urgent, assignee_id: integer
zinn-chat/chat-to-ticket
zinn-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/runthe REST route's own per-item permission checkid: string (tələb olunur)
zinn-chat/close-chat
zinn-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/runthe REST route's own per-item permission checkid: string (tələb olunur)
zinn-chat/create-ticket
zinn-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/runthe REST route's own per-item permission checkheç biri
zinn-chat/delete-canned-reply
zinn-chat-delete-canned-reply
Yadda saxlanılan cavabı silin (Pro)
Yadda saxlanılan cavabı silir.
Pro nəşrPOST …/abilities/zinn-chat/delete-canned-reply/runthe REST route's own per-item permission checkid: string (tələb olunur)
zinn-chat/delete-ticket
zinn-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/runthe REST route's own per-item permission checkid: string (tələb olunur)
zinn-chat/draft-kb-article
zinn-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əşrPOST …/abilities/zinn-chat/draft-kb-article/runedit_posts (the REST route's own check)heç biri
zinn-chat/draft-kb-from-gaps
zinn-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əşrPOST …/abilities/zinn-chat/draft-kb-from-gaps/runedit_posts (the REST route's own check)heç biri
zinn-chat/fill-canned-reply
zinn-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əşrPOST …/abilities/zinn-chat/fill-canned-reply/runthe REST route's own per-item permission checkid: string (tələb olunur)
zinn-chat/get-chat
zinn-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/runthe REST route's own per-item permission checkid: string (tələb olunur)
zinn-chat/get-overview
zinn-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/runzinn_chat_answerheç biri
zinn-chat/get-settings
zinn-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/runzinn_chat_manageheç biri
zinn-chat/get-stats
zinn-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əşrGET …/abilities/zinn-chat/get-stats/runthe REST route's own per-item permission checkheç biri
zinn-chat/get-ticket
zinn-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/runthe REST route's own per-item permission checkid: string (tələb olunur)
zinn-chat/hand-chat-to-assistant
zinn-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/runthe REST route's own per-item permission checkid: string (tələb olunur)
zinn-chat/list-canned-replies
zinn-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əşrGET …/abilities/zinn-chat/list-canned-replies/runthe REST route's own per-item permission checkheç biri
zinn-chat/list-chats
zinn-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/runthe REST route's own per-item permission checkheç biri
zinn-chat/list-indexed-content
zinn-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/runthe REST route's own per-item permission checkheç biri
zinn-chat/list-kb-gaps
zinn-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əşrGET …/abilities/zinn-chat/list-kb-gaps/runthe REST route's own per-item permission checkheç biri
zinn-chat/list-tickets
zinn-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/runthe REST route's own per-item permission checkheç biri
zinn-chat/reembed-content
zinn-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/runthe REST route's own per-item permission checkheç biri
zinn-chat/reindex-content
zinn-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/runthe REST route's own per-item permission checkheç biri
zinn-chat/reply-chat
zinn-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/runthe REST route's own per-item permission checkid: string (tələb olunur)
zinn-chat/save-canned-reply
zinn-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əşrPOST …/abilities/zinn-chat/save-canned-reply/runthe REST route's own per-item permission checkheç biri
zinn-chat/save-kb-article
zinn-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əşrPOST …/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
Bilik bazasında axtarış (Pro)
Cavabda əlaqələndirmək üçün kömək məqalələri tapır (q: axtarış).
Pro nəşrGET …/abilities/zinn-chat/search-kb/runthe REST route's own per-item permission checkheç biri
zinn-chat/set-conversation-details
zinn-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əşrPOST …/abilities/zinn-chat/set-conversation-details/runthe REST route's own per-item permission checkheç biri
zinn-chat/set-kb-gap-status
zinn-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əşrPOST …/abilities/zinn-chat/set-kb-gap-status/runthe REST route's own per-item permission checkheç biri
zinn-chat/set-presence
zinn-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/runthe REST route's own per-item permission checkheç biri
zinn-chat/suggest-reply
zinn-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əşrPOST …/abilities/zinn-chat/suggest-reply/runthe REST route's own per-item permission checkheç biri
zinn-chat/summarise-conversation
zinn-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əşrPOST …/abilities/zinn-chat/summarise-conversation/runthe REST route's own per-item permission checkheç biri
zinn-chat/take-chat
zinn-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/runthe REST route's own per-item permission checkid: string (tələb olunur)
zinn-chat/update-settings
zinn-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/runzinn_chat_managesettings: object (tələb olunur)
zinn-chat/update-ticket
zinn-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/runthe REST route's own per-item permission checkid: string (tələb olunur)