Pengembang

Referensi kemampuan Zinn® Chat

Zinn® Chat mendaftarkan aksinya ke WordPress Abilities API. Kemampuan yang sama adalah alat MCP pada server situs itu sendiri dan rute REST di bawah /wp-json/wp-abilities/v1. Halaman ini dihasilkan dari registri plugin itu sendiri.

Panduan pengguna: menghubungkan aplikasi AI

Titik Akhir

MCP melalui HTTP (dapat dialirkan)

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

MCP melalui WP-CLI (masukan dan keluaran standar)

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

REST: daftar kemampuan

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

JALANKAN: jalankan kemampuan

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

Otentikasi dan izin

Permintaan HTTP diautentikasi dengan kata sandi aplikasi WordPress (HTTP Basic). Menghubungkan ke server MCP memerlukan kemampuan yang ditunjukkan di bawah ini; setiap kemampuan kemudian memeriksa izinnya sendiri, per objek. Kemampuan hanya-baca berjalan dengan GET dan inputnya di string kueri; kemampuan lainnya dengan POST dan isi JSON {"input": {…}}.

Contoh

# JALANKAN: jalankan kemampuan
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":{}}}

Semua kemampuan

Dibuat dari abilities.json milik plugin, yang sendiri dibuat dari situs yang sedang berjalan; pengujian gagal ketika keduanya tidak cocok.

Kemampuan	Cara kerjanya	Edisi	REST	Izin	Parameter
`zinn-chat/answer-ticket` `zinn-chat-answer-ticket`	Jawab tiket Membalas pelanggan melalui email (text), atau menambahkan catatan internal (note: true); status opsional mengubah status tiket.	Edisi gratis	`POST …/abilities/zinn-chat/answer-ticket/run`	the REST route's own per-item permission check	id: string (wajib)
`zinn-chat/ask-assistant` `zinn-chat-ask-assistant`	Tanya asisten Mengajukan pertanyaan ke asisten AI situs dan mengembalikan jawabannya beserta setiap sumber yang ditemukan.	Edisi gratis	`POST …/abilities/zinn-chat/ask-assistant/run`	the REST route's own per-item permission check	tidak ada
`zinn-chat/bulk-update-tickets` `zinn-chat-bulk-update-tickets`	Ubah banyak tiket sekaligus (Pro) Mengubah status, prioritas, atau pihak yang ditugaskan dari hingga 100 tiket (id). Setiap tiket melewati pemeriksaan yang sama seperti saat diubah secara mandiri; hasilnya mencantumkan setiap tiket tersebut.	Edisi Pro	`POST …/abilities/zinn-chat/bulk-update-tickets/run`	zinn_chat_answer	ids: array (wajib), status: open\|pending\|solved\|closed, priority: low\|normal\|high\|urgent, assignee_id: integer
`zinn-chat/chat-to-ticket` `zinn-chat-chat-to-ticket`	Ubah obrolan menjadi tiket Membuka tiket dari obrolan sehingga dapat dijawab melalui email (memerlukan alamat email pengunjung).	Edisi gratis	`POST …/abilities/zinn-chat/chat-to-ticket/run`	the REST route's own per-item permission check	id: string (wajib)
`zinn-chat/close-chat` `zinn-chat-close-chat`	Tutup obrolan Mengakhiri obrolan; pengunjung masih dapat meminta transkrip.	Edisi gratis	`POST …/abilities/zinn-chat/close-chat/run`	the REST route's own per-item permission check	id: string (wajib)
`zinn-chat/create-ticket` `zinn-chat-create-ticket`	Buka tiket Membuka tiket atas nama pelanggan (email, subjek, dan pesan pertama mereka).	Edisi gratis	`POST …/abilities/zinn-chat/create-ticket/run`	the REST route's own per-item permission check	tidak ada
`zinn-chat/delete-canned-reply` `zinn-chat-delete-canned-reply`	Hapus balasan tersimpan (Pro) Menghapus balasan yang disimpan.	Edisi Pro	`POST …/abilities/zinn-chat/delete-canned-reply/run`	the REST route's own per-item permission check	id: string (wajib)
`zinn-chat/delete-ticket` `zinn-chat-delete-ticket`	Hapus tiket Menghapus tiket dan percakapannya secara permanen (hanya untuk manajer).	Edisi gratis	`POST …/abilities/zinn-chat/delete-ticket/run`	the REST route's own per-item permission check	id: string (wajib)
`zinn-chat/draft-kb-article` `zinn-chat-draft-kb-article`	Draf artikel bantuan dari tiket (Pro) Menulis draf artikel pusat pengetahuan dari tiket yang telah diselesaikan; artikel tersebut akan tetap berupa draf hingga seseorang mempublikasikannya.	Edisi Pro	`POST …/abilities/zinn-chat/draft-kb-article/run`	edit_posts (the REST route's own check)	tidak ada
`zinn-chat/draft-kb-from-gaps` `zinn-chat-draft-kb-from-gaps`	Draf artikel bantuan untuk pertanyaan yang belum terjawab (Pro) Menulis draf artikel basis pengetahuan yang menjawab pertanyaan (id) yang dipilih; artikel tersebut tetap berupa draf.	Edisi Pro	`POST …/abilities/zinn-chat/draft-kb-from-gaps/run`	edit_posts (the REST route's own check)	tidak ada
`zinn-chat/fill-canned-reply` `zinn-chat-fill-canned-reply`	Isi balasan yang disimpan (Pro) Mengembalikan teks balasan yang disimpan dengan placeholder yang diisi untuk satu obrolan atau tiket.	Edisi Pro	`POST …/abilities/zinn-chat/fill-canned-reply/run`	the REST route's own per-item permission check	id: string (wajib)
`zinn-chat/get-chat` `zinn-chat-get-chat`	Baca obrolan Mengembalikan pesan satu chat dan detail pengunjung (after: hanya pesan yang lebih baru dari id ini).	Edisi gratis	`GET …/abilities/zinn-chat/get-chat/run`	the REST route's own per-item permission check	id: string (wajib)
`zinn-chat/get-overview` `zinn-chat-get-overview`	Baca ringkasan dukungan Mengembalikan jumlah tiket di setiap status dan berapa banyak chat yang sedang menunggu agen (beserta pesan yang belum dibaca), serta apakah chat, asisten, dan tiket diaktifkan.	Edisi gratis	`GET …/abilities/zinn-chat/get-overview/run`	zinn_chat_answer	tidak ada
`zinn-chat/get-settings` `zinn-chat-get-settings`	Baca pengaturan obrolan Mengembalikan setiap pengaturan obrolan: widget, asisten, orang dan jam buka, tiket dan email, indeks situs, privasi, serta spam.	Edisi gratis	`GET …/abilities/zinn-chat/get-settings/run`	zinn_chat_manage	tidak ada
`zinn-chat/get-stats` `zinn-chat-get-stats`	Baca statistik dukungan (Pro) Mengembalikan nomor obrolan dan tiket, waktu respons, dan peringkat untuk N hari terakhir (hari).	Edisi Pro	`GET …/abilities/zinn-chat/get-stats/run`	the REST route's own per-item permission check	tidak ada
`zinn-chat/get-ticket` `zinn-chat-get-ticket`	Baca tiket Mengembalikan satu tiket beserta seluruh percakapan, status, prioritas, dan pihak yang ditugaskan.	Edisi gratis	`GET …/abilities/zinn-chat/get-ticket/run`	the REST route's own per-item permission check	id: string (wajib)
`zinn-chat/hand-chat-to-assistant` `zinn-chat-hand-chat-to-assistant`	Kembalikan obrolan ke asisten Mengembalikan chat ke asisten AI, yang menjawab pengunjung dari konten situs.	Edisi gratis	`POST …/abilities/zinn-chat/hand-chat-to-assistant/run`	the REST route's own per-item permission check	id: string (wajib)
`zinn-chat/list-canned-replies` `zinn-chat-list-canned-replies`	Daftar balasan yang disimpan (Pro) Menampilkan daftar balasan tersimpan yang dapat disisipkan oleh agen, beserta pintasannya.	Edisi Pro	`GET …/abilities/zinn-chat/list-canned-replies/run`	the REST route's own per-item permission check	tidak ada
`zinn-chat/list-chats` `zinn-chat-list-chats`	Daftar obrolan langsung Menampilkan daftar obrolan yang sedang menunggu, sedang berlangsung, dan baru saja ditutup, beserta pihak yang menangani masing-masing obrolan.	Edisi gratis	`GET …/abilities/zinn-chat/list-chats/run`	the REST route's own per-item permission check	tidak ada
`zinn-chat/list-indexed-content` `zinn-chat-list-indexed-content`	Daftar apa yang diketahui oleh asisten Mencantumkan konten yang digunakan asisten untuk menjawab, beserta status indeksnya, satu halaman setiap kalinya.	Edisi gratis	`GET …/abilities/zinn-chat/list-indexed-content/run`	the REST route's own per-item permission check	tidak ada
`zinn-chat/list-kb-gaps` `zinn-chat-list-kb-gaps`	Daftar pertanyaan yang belum terjawab (Pro) Menampilkan daftar pertanyaan yang diajukan pengunjung yang tidak dapat dijawab oleh basis pengetahuan.	Edisi Pro	`GET …/abilities/zinn-chat/list-kb-gaps/run`	the REST route's own per-item permission check	tidak ada
`zinn-chat/list-tickets` `zinn-chat-list-tickets`	Daftar tiket Menampilkan daftar tiket dukungan, difilter berdasarkan status atau pencarian, satu halaman dalam satu waktu.	Edisi gratis	`GET …/abilities/zinn-chat/list-tickets/run`	the REST route's own per-item permission check	tidak ada
`zinn-chat/reembed-content` `zinn-chat-reembed-content`	Bangun ulang indeks pencarian asisten Membangun ulang vektor pencarian untuk satu item (item_id) atau semuanya (all: true) (khusus manajer).	Edisi gratis	`POST …/abilities/zinn-chat/reembed-content/run`	the REST route's own per-item permission check	tidak ada
`zinn-chat/reindex-content` `zinn-chat-reindex-content`	Baca ulang konten ke dalam asisten Membaca ulang satu item (item_id) atau semuanya (all: true) ke dalam indeks asisten (khusus manajer).	Edisi gratis	`POST …/abilities/zinn-chat/reindex-content/run`	the REST route's own per-item permission check	tidak ada
`zinn-chat/reply-chat` `zinn-chat-reply-chat`	Balas di obrolan Mengirim pesan ke pengunjung (text), atau menambahkan catatan internal yang hanya dapat dilihat oleh agen (note: true).	Edisi gratis	`POST …/abilities/zinn-chat/reply-chat/run`	the REST route's own per-item permission check	id: string (wajib)
`zinn-chat/save-canned-reply` `zinn-chat-save-canned-reply`	Simpan balasan tersimpan (Pro) Membuat atau mengubah balasan tersimpan (judul, pintasan, isi, departemen; id untuk mengubah salah satu).	Edisi Pro	`POST …/abilities/zinn-chat/save-canned-reply/run`	the REST route's own per-item permission check	tidak ada
`zinn-chat/save-kb-article` `zinn-chat-save-kb-article`	Tulis artikel bantuan (Pro) Membuat artikel basis pengetahuan, atau mengubahnya (id): judul, konten, ringkasan, kategori, dan status (draf, atau terbitkan saat Anda diizinkan menerbitkan).	Edisi 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`	Cari di basis pengetahuan (Pro) Mencari artikel bantuan untuk ditautkan dalam balasan (q: pencarian).	Edisi Pro	`GET …/abilities/zinn-chat/search-kb/run`	the REST route's own per-item permission check	tidak ada
`zinn-chat/set-conversation-details` `zinn-chat-set-conversation-details`	Atur departemen dan label percakapan (Pro) Menetapkan departemen dan tag dari obrolan atau tiket (jenis: obrolan atau tiket; id).	Edisi Pro	`POST …/abilities/zinn-chat/set-conversation-details/run`	the REST route's own per-item permission check	tidak ada
`zinn-chat/set-kb-gap-status` `zinn-chat-set-kb-gap-status`	Tandai pertanyaan yang belum terjawab (Pro) Menandai pertanyaan yang belum terjawab sebagai terbuka, direncanakan, atau diabaikan (id, status).	Edisi Pro	`POST …/abilities/zinn-chat/set-kb-gap-status/run`	the REST route's own per-item permission check	tidak ada
`zinn-chat/set-presence` `zinn-chat-set-presence`	Atur ketersediaan Anda Menandai agen yang masuk sebagai tersedia atau tidak tersedia untuk obrolan baru (away: true atau false).	Edisi gratis	`POST …/abilities/zinn-chat/set-presence/run`	the REST route's own per-item permission check	tidak ada
`zinn-chat/suggest-reply` `zinn-chat-suggest-reply`	Buat draf balasan dengan AI (Pro) Membuat draf balasan untuk obrolan atau tiket dari konten situs; tidak ada yang dikirim.	Edisi Pro	`POST …/abilities/zinn-chat/suggest-reply/run`	the REST route's own per-item permission check	tidak ada
`zinn-chat/summarise-conversation` `zinn-chat-summarise-conversation`	Ringkas percakapan dengan AI (Pro) Merangkum obrolan atau tiket dalam beberapa baris.	Edisi Pro	`POST …/abilities/zinn-chat/summarise-conversation/run`	the REST route's own per-item permission check	tidak ada
`zinn-chat/take-chat` `zinn-chat-take-chat`	Mulai obrolan Menugaskan obrolan yang sedang menunggu kepada agen yang masuk, sehingga pengunjung berbicara dengan seseorang.	Edisi gratis	`POST …/abilities/zinn-chat/take-chat/run`	the REST route's own per-item permission check	id: string (wajib)
`zinn-chat/update-settings` `zinn-chat-update-settings`	Ubah pengaturan obrolan Mengubah pengaturan yang Anda kirim (pengaturan: kunci ke nilai) dan mempertahankan sisanya. Setiap nilai diperiksa persis seperti pada layar pengaturan; get-settings mencantumkan kunci-kuncinya.	Edisi gratis	`POST …/abilities/zinn-chat/update-settings/run`	zinn_chat_manage	settings: object (wajib)
`zinn-chat/update-ticket` `zinn-chat-update-ticket`	Ubah tiket Mengubah status, prioritas, atau pihak yang ditugaskan pada tiket.	Edisi gratis	`POST …/abilities/zinn-chat/update-ticket/run`	the REST route's own per-item permission check	id: string (wajib)