Geliştiriciler

Zinn® Chat yetenekleri başvurusu

Zinn® Chat, eylemlerini WordPress Abilities API'ye kaydeder. Aynı yetenekler, sitenin kendi sunucusunda MCP araçları ve /wp-json/wp-abilities/v1 altında REST rotalarıdır. Bu sayfa, eklentinin kendi kayıt defterinden oluşturulmuştur.

Kullanıcı kılavuzu: bir yapay zeka uygulaması bağlama

Uç Noktalar

HTTP üzerinden MCP (akışlı)

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

WP-CLI üzerinden MCP (standart girdi ve çıktı)

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

REST: yetenekleri listele

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

REST: bir yeteneği çalıştır

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

Kimlik doğrulama ve izinler

HTTP istekleri bir WordPress uygulama parolası (HTTP Basic) ile kimlik doğrulaması yapar. MCP sunucusuna bağlanmak aşağıda gösterilen yeteneği gerektirir; her yetki daha sonra her nesne için kendi iznini kontrol eder. Salt okunur yetenekler GET ile ve girdileri sorgu dizesinde çalışır; diğerleri ise POST ve JSON gövdesi {"input": {…}} ile çalışır.

Örnekler

# REST: bir yeteneği çalıştır
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":{}}}

Tüm yetenekler

Çalışan bir siteden otomatik olarak üretilen eklentinin abilities.json dosyasından oluşturulmuştur; ikisi uyuşmadığında bir test başarısız olur.

Yetenek	Ne işe yarar	Sürüm	Dinlendir	İzin	Parametreler
`zinn-chat/answer-ticket` `zinn-chat-answer-ticket`	Destek talebini yanıtla Müşteriye e-posta (text) ile yanıt verir veya dahili bir not ekler (note: true); durum, isteğe bağlı olarak talebin durumunu değiştirir.	Ücretsiz sürüm	`POST …/abilities/zinn-chat/answer-ticket/run`	the REST route's own per-item permission check	id: string (zorunlu)
`zinn-chat/ask-assistant` `zinn-chat-ask-assistant`	Asistana sor Sitenin yapay zeka asistanına bir soru sorar ve bulduğu her kaynakla birlikte yanıtını döndürür.	Ücretsiz sürüm	`POST …/abilities/zinn-chat/ask-assistant/run`	the REST route's own per-item permission check	hiçbiri
`zinn-chat/bulk-update-tickets` `zinn-chat-bulk-update-tickets`	Birden fazla biletin durumunu aynı anda değiştirin (Pro) En fazla 100 talebin (kimliklerin) durumunu, önceliğini veya atanan kişisini değiştirir. Her talep, tek başına değiştirildiğinde olduğu gibi aynı kontrollerden geçer; sonuç her birini listeler.	Pro sürüm	`POST …/abilities/zinn-chat/bulk-update-tickets/run`	zinn_chat_answer	ids: array (zorunlu), status: open\|pending\|solved\|closed, priority: low\|normal\|high\|urgent, assignee_id: integer
`zinn-chat/chat-to-ticket` `zinn-chat-chat-to-ticket`	Bir sohbeti bilete dönüştürün Bir sohbetten, e-posta yoluyla yanıtlanabilmesi için bir destek talebi açar (ziyaretçinin e-posta adresi gereklidir).	Ücretsiz sürüm	`POST …/abilities/zinn-chat/chat-to-ticket/run`	the REST route's own per-item permission check	id: string (zorunlu)
`zinn-chat/close-chat` `zinn-chat-close-chat`	Sohbeti kapat Bir sohbeti sonlandırır; ziyaretçi yine de döküm isteyebilir.	Ücretsiz sürüm	`POST …/abilities/zinn-chat/close-chat/run`	the REST route's own per-item permission check	id: string (zorunlu)
`zinn-chat/create-ticket` `zinn-chat-create-ticket`	Destek talebi aç Müşteri adına bir destek talebi açar (e-postası, konu ve ilk mesaj).	Ücretsiz sürüm	`POST …/abilities/zinn-chat/create-ticket/run`	the REST route's own per-item permission check	hiçbiri
`zinn-chat/delete-canned-reply` `zinn-chat-delete-canned-reply`	Kayıtlı yanıtı sil (Pro) Kayıtlı yanıtı siler.	Pro sürüm	`POST …/abilities/zinn-chat/delete-canned-reply/run`	the REST route's own per-item permission check	id: string (zorunlu)
`zinn-chat/delete-ticket` `zinn-chat-delete-ticket`	Destegi sil Bir talebi ve yazışmalarını kalıcı olarak siler (yalnızca yöneticiler).	Ücretsiz sürüm	`POST …/abilities/zinn-chat/delete-ticket/run`	the REST route's own per-item permission check	id: string (zorunlu)
`zinn-chat/draft-kb-article` `zinn-chat-draft-kb-article`	Destekten bir yardım makalesi taslağı oluştur (Pro) Çözülmüş bir bilet üzerinden taslak bilgi bankası makalesi yazar; bir kişi bunu yayınlayana kadar taslak olarak kalır.	Pro sürüm	`POST …/abilities/zinn-chat/draft-kb-article/run`	edit_posts (the REST route's own check)	hiçbiri
`zinn-chat/draft-kb-from-gaps` `zinn-chat-draft-kb-from-gaps`	Yanıtlanmamış sorular için yardım makaleleri taslağı oluşturun (Pro) Seçilen soruları (ids) yanıtlayan taslak bilgi tabanı makaleleri yazar; bunlar taslak olarak kalır.	Pro sürüm	`POST …/abilities/zinn-chat/draft-kb-from-gaps/run`	edit_posts (the REST route's own check)	hiçbiri
`zinn-chat/fill-canned-reply` `zinn-chat-fill-canned-reply`	Kayıtlı yanıt doldur (Pro) Bir sohbet veya bilet için yer tutucuları doldurulmuş kaydedilmiş bir yanıtın metnini döndürür.	Pro sürüm	`POST …/abilities/zinn-chat/fill-canned-reply/run`	the REST route's own per-item permission check	id: string (zorunlu)
`zinn-chat/get-chat` `zinn-chat-get-chat`	Sohbeti oku Bir sohbetin mesajlarını ve ziyaretçi detaylarını döndürür (after: yalnızca bu kimlikten daha yeni mesajlar).	Ücretsiz sürüm	`GET …/abilities/zinn-chat/get-chat/run`	the REST route's own per-item permission check	id: string (zorunlu)
`zinn-chat/get-overview` `zinn-chat-get-overview`	Destek genel bakışını okuyun Her bir durumda kaç bilet olduğunu, kaç sohbetin bir kişiyi beklediğini (ve okunmamış mesajlarını) ile sohbetin, asistanın ve biletlerin açık olup olmadığını döndürür.	Ücretsiz sürüm	`GET …/abilities/zinn-chat/get-overview/run`	zinn_chat_answer	hiçbiri
`zinn-chat/get-settings` `zinn-chat-get-settings`	Sohbet ayarlarını oku Tüm sohbet ayarlarını döndürür: widget, asistan, kişiler ve çalışma saatleri, biletler ve e-posta, site dizini, gizlilik ve spam.	Ücretsiz sürüm	`GET …/abilities/zinn-chat/get-settings/run`	zinn_chat_manage	hiçbiri
`zinn-chat/get-stats` `zinn-chat-get-stats`	Destek istatistiklerini oku (Pro) Son N gün (gün) için sohbet ve bilet sayılarını, yanıt sürelerini ve derecelendirmeleri döndürür.	Pro sürüm	`GET …/abilities/zinn-chat/get-stats/run`	the REST route's own per-item permission check	hiçbiri
`zinn-chat/get-ticket` `zinn-chat-get-ticket`	Destek talebini oku Tüm yazışmaları, durumu, önceliği ve atanan kişisi ile birlikte bir bilet döndürür.	Ücretsiz sürüm	`GET …/abilities/zinn-chat/get-ticket/run`	the REST route's own per-item permission check	id: string (zorunlu)
`zinn-chat/hand-chat-to-assistant` `zinn-chat-hand-chat-to-assistant`	Sohbeti asistana geri ver Yapay zeka asistanına, ziyaretçinin sorularını sitenin içeriğinden yanıtlayan bir sohbet döndürür.	Ücretsiz sürüm	`POST …/abilities/zinn-chat/hand-chat-to-assistant/run`	the REST route's own per-item permission check	id: string (zorunlu)
`zinn-chat/list-canned-replies` `zinn-chat-list-canned-replies`	Kayıtlı yanıtları listele (Pro) Destek yetkililerinin ekleyebileceği kayıtlı yanıtları kısayollarıyla birlikte listeler.	Pro sürüm	`GET …/abilities/zinn-chat/list-canned-replies/run`	the REST route's own per-item permission check	hiçbiri
`zinn-chat/list-chats` `zinn-chat-list-chats`	Canlı sohbetleri listele Bekleyen, devam eden ve yakın zamanda kapatılan sohbetleri ve her birini kimin yürüttüğünü listeler.	Ücretsiz sürüm	`GET …/abilities/zinn-chat/list-chats/run`	the REST route's own per-item permission check	hiçbiri
`zinn-chat/list-indexed-content` `zinn-chat-list-indexed-content`	Asistanın bildiklerini listele Asistanın yanıt verdiği içeriği, indeks durumuyla birlikte, her seferinde bir sayfa olarak listeler.	Ücretsiz sürüm	`GET …/abilities/zinn-chat/list-indexed-content/run`	the REST route's own per-item permission check	hiçbiri
`zinn-chat/list-kb-gaps` `zinn-chat-list-kb-gaps`	Yanıtlanmamış soruları listele (Pro) Bilgi tabanının yanıtlayamadığı, ziyaretçilerin sorduğu soruları listeler.	Pro sürüm	`GET …/abilities/zinn-chat/list-kb-gaps/run`	the REST route's own per-item permission check	hiçbiri
`zinn-chat/list-tickets` `zinn-chat-list-tickets`	Biletleri listele Destek biletlerini durum veya aramaya göre filtreleyerek, her seferinde bir sayfa olmak üzere listeler.	Ücretsiz sürüm	`GET …/abilities/zinn-chat/list-tickets/run`	the REST route's own per-item permission check	hiçbiri
`zinn-chat/reembed-content` `zinn-chat-reembed-content`	Asistanın arama indeksini yeniden oluştur Bir öğenin (item_id) veya her şeyin (all: true) arama vektörlerini yeniden oluşturur (yalnızca yöneticiler).	Ücretsiz sürüm	`POST …/abilities/zinn-chat/reembed-content/run`	the REST route's own per-item permission check	hiçbiri
`zinn-chat/reindex-content` `zinn-chat-reindex-content`	İçeriği asistana yeniden okuyun Asistanın dizinine tek bir öğeyi (item_id) veya her şeyi (all: true) yeniden okutur (yalnızca yöneticiler).	Ücretsiz sürüm	`POST …/abilities/zinn-chat/reindex-content/run`	the REST route's own per-item permission check	hiçbiri
`zinn-chat/reply-chat` `zinn-chat-reply-chat`	Sohbette yanıtla Ziyaretçiye bir mesaj gönderir (text) veya yalnızca temsilcilerin gördüğü dahili bir not ekler (note: true).	Ücretsiz sürüm	`POST …/abilities/zinn-chat/reply-chat/run`	the REST route's own per-item permission check	id: string (zorunlu)
`zinn-chat/save-canned-reply` `zinn-chat-save-canned-reply`	Kayıtlı yanıtı kaydet (Pro) Kayıtlı bir yanıt oluşturur veya değiştirir (başlık, kısayol, gövde, departman; değiştirmek için ID).	Pro sürüm	`POST …/abilities/zinn-chat/save-canned-reply/run`	the REST route's own per-item permission check	hiçbiri
`zinn-chat/save-kb-article` `zinn-chat-save-kb-article`	Yardım makalesi yaz (Pro) Bir bilgi tabanı makalesi oluşturur veya birini değiştirir (id): başlık, içerik, özet, kategoriler ve durum (taslak veya yayınlayabileceğiniz zaman yayınla).	Pro sürüm	`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`	Bilgi tabanında ara (Pro) Yanıtta bağlantı verilecek yardım makalelerini bulur (s: arama).	Pro sürüm	`GET …/abilities/zinn-chat/search-kb/run`	the REST route's own per-item permission check	hiçbiri
`zinn-chat/set-conversation-details` `zinn-chat-set-conversation-details`	Bir görüşmenin departmanını ve etiketlerini belirleyin (Pro) Bir sohbetin veya biletin departmanını ve etiketlerini ayarlar (tür: sohbet veya bilet; kimlik).	Pro sürüm	`POST …/abilities/zinn-chat/set-conversation-details/run`	the REST route's own per-item permission check	hiçbiri
`zinn-chat/set-kb-gap-status` `zinn-chat-set-kb-gap-status`	Cevaplanmamış soruları işaretle (Pro) Yanıtlanmamış soruları açık, planlanmış veya reddedilmiş olarak işaretler (kimlikler, durum).	Pro sürüm	`POST …/abilities/zinn-chat/set-kb-gap-status/run`	the REST route's own per-item permission check	hiçbiri
`zinn-chat/set-presence` `zinn-chat-set-presence`	Müsaitliğinizi ayarlayın Oturum açmış temsilcisin yeni sohbetler için uygun veya meşgul olduğunu işaretler (meşgul: true veya false).	Ücretsiz sürüm	`POST …/abilities/zinn-chat/set-presence/run`	the REST route's own per-item permission check	hiçbiri
`zinn-chat/suggest-reply` `zinn-chat-suggest-reply`	Yapay zeka ile yanıt taslağı oluştur (Pro) Sitenin içeriğinden bir sohbet veya destek talebine yanıt taslağı oluşturur; hiçbir şey gönderilmez.	Pro sürüm	`POST …/abilities/zinn-chat/suggest-reply/run`	the REST route's own per-item permission check	hiçbiri
`zinn-chat/summarise-conversation` `zinn-chat-summarise-conversation`	Yapay zeka ile yapılan bir konuşmayı özetleyin (Pro) Bir sohbeti veya destek talebini birkaç satırda özetler.	Pro sürüm	`POST …/abilities/zinn-chat/summarise-conversation/run`	the REST route's own per-item permission check	hiçbiri
`zinn-chat/take-chat` `zinn-chat-take-chat`	Sohbet başlat Bekleyen bir sohbeti oturum açmış olan temsilciye atar, böylece ziyaretçi gerçek bir kişiyle konuşur.	Ücretsiz sürüm	`POST …/abilities/zinn-chat/take-chat/run`	the REST route's own per-item permission check	id: string (zorunlu)
`zinn-chat/update-settings` `zinn-chat-update-settings`	Sohbet ayarlarını değiştir Gönderdiğiniz ayarları (ayarlar: anahtar - değer) değiştirir ve geri kalanını korur. Her değer, ayarlar ekranındakilerle birebir kontrol edilir; get-settings komutu anahtarları listeler.	Ücretsiz sürüm	`POST …/abilities/zinn-chat/update-settings/run`	zinn_chat_manage	settings: object (zorunlu)
`zinn-chat/update-ticket` `zinn-chat-update-ticket`	Destek talebini değiştir Bir biletin durumunu, önceliğini veya atanan kişisini değiştirir.	Ücretsiz sürüm	`POST …/abilities/zinn-chat/update-ticket/run`	the REST route's own per-item permission check	id: string (zorunlu)