Sviluppatori

Riferimento capacità di Zinn® Chat

Zinn® Chat registra le proprie azioni con WordPress Abilities API. Le stesse capacità sono strumenti MCP sul server del sito e route REST sotto /wp-json/wp-abilities/v1. Questa pagina viene generata dal registro del plugin stesso.

Guida utente: collega un'app di IA

Endpoint

MCP su HTTP (streamable)

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

MCP su WP-CLI (standard input e output)

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

REST: elenca le capacità

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

REST: esegui un'abilità

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

Autenticazione e autorizzazioni

Le richieste HTTP si autenticano con una password applicativa WordPress (HTTP Basic). La connessione al server MCP richiede la funzionalità mostrata di seguito; ogni abilità verifica quindi la propria autorizzazione, per singolo oggetto. Le abilità di sola lettura vengono eseguite con GET e il relativo input nella query string; le altre con POST e un corpo JSON {"input": {…}}.

Esempi

# REST: esegui un'abilità
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":{}}}

Tutte le funzionalità

Generato dalle capacità del plugin tramite abilities.json, che a sua volta viene generato da un sito in esecuzione; un test fallisce quando i due non concordano.

Abilitazione	Cosa fa	Edizione	REST	Permesso	Parametri
`zinn-chat/answer-ticket` `zinn-chat-answer-ticket`	Rispondi a un ticket Risponde al cliente via email (testo) o aggiunge una nota interna (note: true); lo stato cambia facoltativamente lo stato del ticket.	Edizione gratuita	`POST …/abilities/zinn-chat/answer-ticket/run`	the REST route's own per-item permission check	id: string (obbligatorio)
`zinn-chat/ask-assistant` `zinn-chat-ask-assistant`	Chiedi all'assistente Pone una domanda all'assistente IA del sito e restituisce la sua risposta con ogni fonte trovata.	Edizione gratuita	`POST …/abilities/zinn-chat/ask-assistant/run`	the REST route's own per-item permission check	nessuno
`zinn-chat/bulk-update-tickets` `zinn-chat-bulk-update-tickets`	Modifica più ticket contemporaneamente (Pro) Modifica lo stato, la priorità o il responsabile di un massimo di 100 ticket (id). Ciascun ticket viene sottoposto agli stessi controlli previsti per la modifica singola; il risultato elenca ciascuno di essi.	Edizione Pro	`POST …/abilities/zinn-chat/bulk-update-tickets/run`	zinn_chat_answer	ids: array (obbligatorio), status: open\|pending\|solved\|closed, priority: low\|normal\|high\|urgent, assignee_id: integer
`zinn-chat/chat-to-ticket` `zinn-chat-chat-to-ticket`	Trasforma una chat in un ticket Apre un ticket da una chat in modo che possa essere risposto via setEmail (richiede l'indirizzo email del visitatore).	Edizione gratuita	`POST …/abilities/zinn-chat/chat-to-ticket/run`	the REST route's own per-item permission check	id: string (obbligatorio)
`zinn-chat/close-chat` `zinn-chat-close-chat`	Chiudi una chat Termina una chat; il visitatore può comunque richiedere la trascrizione.	Edizione gratuita	`POST …/abilities/zinn-chat/close-chat/run`	the REST route's own per-item permission check	id: string (obbligatorio)
`zinn-chat/create-ticket` `zinn-chat-create-ticket`	Apri un ticket Apre un ticket per conto di un cliente (la sua email, un oggetto e il primo messaggio).	Edizione gratuita	`POST …/abilities/zinn-chat/create-ticket/run`	the REST route's own per-item permission check	nessuno
`zinn-chat/delete-canned-reply` `zinn-chat-delete-canned-reply`	Elimina risposta salvata (Pro) Elimina una risposta salvata.	Edizione Pro	`POST …/abilities/zinn-chat/delete-canned-reply/run`	the REST route's own per-item permission check	id: string (obbligatorio)
`zinn-chat/delete-ticket` `zinn-chat-delete-ticket`	Elimina un ticket Elimina definitivamente un ticket e la relativa conversazione (solo per i manager).	Edizione gratuita	`POST …/abilities/zinn-chat/delete-ticket/run`	the REST route's own per-item permission check	id: string (obbligatorio)
`zinn-chat/draft-kb-article` `zinn-chat-draft-kb-article`	Crea un articolo della guida da un ticket (Pro) Scrive una bozza di articolo della knowledge base da un ticket risolto; rimane una bozza finché una persona non la pubblica.	Edizione Pro	`POST …/abilities/zinn-chat/draft-kb-article/run`	edit_posts (the REST route's own check)	nessuno
`zinn-chat/draft-kb-from-gaps` `zinn-chat-draft-kb-from-gaps`	Bozze di articoli di aiuto per le domande senza risposta (Pro) Scrive bozze di articoli della knowledge base che rispondono alle domande scelte (id); rimangono in formato bozza.	Edizione Pro	`POST …/abilities/zinn-chat/draft-kb-from-gaps/run`	edit_posts (the REST route's own check)	nessuno
`zinn-chat/fill-canned-reply` `zinn-chat-fill-canned-reply`	Inserisci una risposta salvata (Pro) Restituisce il testo di una risposta salvata con i relativi segnaposto compilati per una chat o un ticket.	Edizione Pro	`POST …/abilities/zinn-chat/fill-canned-reply/run`	the REST route's own per-item permission check	id: string (obbligatorio)
`zinn-chat/get-chat` `zinn-chat-get-chat`	Leggi una chat Restituisce i messaggi e i dettagli del visitatore di una chat (after: solo i messaggi più recenti rispetto a questo id).	Edizione gratuita	`GET …/abilities/zinn-chat/get-chat/run`	the REST route's own per-item permission check	id: string (obbligatorio)
`zinn-chat/get-overview` `zinn-chat-get-overview`	Leggi la panoramica del supporto Restituisce il numero di ticket in ciascuno stato, il numero di chat in attesa di un operatore (con i relativi messaggi non letti) e lo stato di attivazione di chat, assistente e ticket.	Edizione gratuita	`GET …/abilities/zinn-chat/get-overview/run`	zinn_chat_answer	nessuno
`zinn-chat/get-settings` `zinn-chat-get-settings`	Leggi le impostazioni della chat Restituisce ogni impostazione della chat: il widget, l'assistente, le persone e gli orari di apertura, i ticket e l'email, l'indice del sito, la privacy e lo spam.	Edizione gratuita	`GET …/abilities/zinn-chat/get-settings/run`	zinn_chat_manage	nessuno
`zinn-chat/get-stats` `zinn-chat-get-stats`	Leggi le statistiche di supporto (Pro) Restituisce il numero di chat e ticket, i tempi di risposta e le valutazioni per gli ultimi N giorni (days).	Edizione Pro	`GET …/abilities/zinn-chat/get-stats/run`	the REST route's own per-item permission check	nessuno
`zinn-chat/get-ticket` `zinn-chat-get-ticket`	Leggi un ticket Restituisce un ticket con l'intera conversazione, lo stato, la priorità e l'assegnatario.	Edizione gratuita	`GET …/abilities/zinn-chat/get-ticket/run`	the REST route's own per-item permission check	id: string (obbligatorio)
`zinn-chat/hand-chat-to-assistant` `zinn-chat-hand-chat-to-assistant`	Restituisci una chat all'assistente Restituisce una chat all'assistente IA, che risponde al visitatore utilizzando i contenuti del sito.	Edizione gratuita	`POST …/abilities/zinn-chat/hand-chat-to-assistant/run`	the REST route's own per-item permission check	id: string (obbligatorio)
`zinn-chat/list-canned-replies` `zinn-chat-list-canned-replies`	Elenco risposte salvate (Pro) Elenca le risposte salvate che gli operatori possono inserire, con le relative abbreviazioni.	Edizione Pro	`GET …/abilities/zinn-chat/list-canned-replies/run`	the REST route's own per-item permission check	nessuno
`zinn-chat/list-chats` `zinn-chat-list-chats`	Elenca chat dal vivo Elenca le chat in attesa, in corso e chiuse di recente, indicando chi sta gestendo ciascuna di esse.	Edizione gratuita	`GET …/abilities/zinn-chat/list-chats/run`	the REST route's own per-item permission check	nessuno
`zinn-chat/list-indexed-content` `zinn-chat-list-indexed-content`	Elenca ciò che l'assistente sa Elenca i contenuti a cui l'assistente risponde, con il relativo stato di indicizzazione, una pagina alla volta.	Edizione gratuita	`GET …/abilities/zinn-chat/list-indexed-content/run`	the REST route's own per-item permission check	nessuno
`zinn-chat/list-kb-gaps` `zinn-chat-list-kb-gaps`	Elenca domande senza risposta (Pro) Elenca le domande poste dai visitatori a cui la knowledge base non ha saputo rispondere.	Edizione Pro	`GET …/abilities/zinn-chat/list-kb-gaps/run`	the REST route's own per-item permission check	nessuno
`zinn-chat/list-tickets` `zinn-chat-list-tickets`	Elenco ticket Elenca i ticket di supporto, filtrati per stato o per ricerca, una pagina alla volta.	Edizione gratuita	`GET …/abilities/zinn-chat/list-tickets/run`	the REST route's own per-item permission check	nessuno
`zinn-chat/reembed-content` `zinn-chat-reembed-content`	Ricostruisci l'indice di ricerca dell'assistente Ricostruisce i vettori di ricerca per un singolo elemento (item_id) o per tutto (all: true) (solo per manager).	Edizione gratuita	`POST …/abilities/zinn-chat/reembed-content/run`	the REST route's own per-item permission check	nessuno
`zinn-chat/reindex-content` `zinn-chat-reindex-content`	Riassorbi il contenuto nell'assistente Legge nuovamente un elemento (item_id) o tutto (all: true) nell'indice dell'assistente (solo per i gestori).	Edizione gratuita	`POST …/abilities/zinn-chat/reindex-content/run`	the REST route's own per-item permission check	nessuno
`zinn-chat/reply-chat` `zinn-chat-reply-chat`	Rispondi in una chat Invia un messaggio al visitatore (testo) o aggiunge una nota interna visibile solo agli agenti (note: true).	Edizione gratuita	`POST …/abilities/zinn-chat/reply-chat/run`	the REST route's own per-item permission check	id: string (obbligatorio)
`zinn-chat/save-canned-reply` `zinn-chat-save-canned-reply`	Salva una risposta salvata (Pro) Crea o modifica una risposta salvata (titolo, scorciatoia, corpo, reparto; id per modificarne una).	Edizione Pro	`POST …/abilities/zinn-chat/save-canned-reply/run`	the REST route's own per-item permission check	nessuno
`zinn-chat/save-kb-article` `zinn-chat-save-kb-article`	Scrivi un articolo di aiuto (Pro) Crea un articolo della base di conoscenza o ne modifica uno (id): titolo, contenuto, estratto, categorie e stato (bozza o pubblica quando è possibile pubblicare).	Edizione 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`	Cerca nella base di conoscenza (Pro) Trova gli articoli della guida da collegare a una risposta (q: la ricerca).	Edizione Pro	`GET …/abilities/zinn-chat/search-kb/run`	the REST route's own per-item permission check	nessuno
`zinn-chat/set-conversation-details` `zinn-chat-set-conversation-details`	Imposta il reparto e i tag di una conversazione (Pro) Imposta il reparto e i tag di una chat o di un ticket (tipo: chat o ticket; id).	Edizione Pro	`POST …/abilities/zinn-chat/set-conversation-details/run`	the REST route's own per-item permission check	nessuno
`zinn-chat/set-kb-gap-status` `zinn-chat-set-kb-gap-status`	Contrassegna le domande senza risposta (Pro) Contrassegna le domande senza risposta come aperte, pianificate o scartate (ID, stato).	Edizione Pro	`POST …/abilities/zinn-chat/set-kb-gap-status/run`	the REST route's own per-item permission check	nessuno
`zinn-chat/set-presence` `zinn-chat-set-presence`	Imposta la Sua disponibilità Segnala l'agente connesso come disponibile o assente per le nuove chat (away: true o false).	Edizione gratuita	`POST …/abilities/zinn-chat/set-presence/run`	the REST route's own per-item permission check	nessuno
`zinn-chat/suggest-reply` `zinn-chat-suggest-reply`	Crea una bozza di risposta con l'IA (Pro) Redige una bozza di risposta a una chat o a un ticket basata sui contenuti del sito; non viene inviato nulla.	Edizione Pro	`POST …/abilities/zinn-chat/suggest-reply/run`	the REST route's own per-item permission check	nessuno
`zinn-chat/summarise-conversation` `zinn-chat-summarise-conversation`	Riassumi una conversazione con l'IA (Pro) Riassume una chat o un ticket in poche righe.	Edizione Pro	`POST …/abilities/zinn-chat/summarise-conversation/run`	the REST route's own per-item permission check	nessuno
`zinn-chat/take-chat` `zinn-chat-take-chat`	Avviare una chat Assegna una chat in attesa all'agente connesso, in modo che il visitatore parli con una persona.	Edizione gratuita	`POST …/abilities/zinn-chat/take-chat/run`	the REST route's own per-item permission check	id: string (obbligatorio)
`zinn-chat/update-settings` `zinn-chat-update-settings`	Modifica le impostazioni della chat Modifica le impostazioni inviate (settings: chiave-valore) e mantiene il resto. Ciascun valore viene verificato esattamente come nella schermata delle impostazioni; get-settings elenca le chiavi.	Edizione gratuita	`POST …/abilities/zinn-chat/update-settings/run`	zinn_chat_manage	settings: object (obbligatorio)
`zinn-chat/update-ticket` `zinn-chat-update-ticket`	Modifica un ticket Modifica lo stato, la priorità o l'assegnatario di un ticket.	Edizione gratuita	`POST …/abilities/zinn-chat/update-ticket/run`	the REST route's own per-item permission check	id: string (obbligatorio)