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.
Endpoint
MCP su HTTP (streamable)
https://example.com/wp-json/zinn-chat/v1/mcpMCP 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-chatREST: esegui un'abilità
/wp-json/wp-abilities/v1/abilities/<name>/runAutenticazione 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 | Autorizzazione | Parametri |
|---|---|---|---|---|---|
zinn-chat/answer-ticketzinn-chat-answer-ticket | Rispondi a un ticket Risponde al cliente via email (text) o aggiunge una nota interna (note: true); status modifica 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-assistantzinn-chat-ask-assistant | Chiedi all'assistente Pone una domanda all'assistente IA del sito e restituisce la sua risposta con tutte le fonti trovate. | Edizione gratuita | POST …/abilities/zinn-chat/ask-assistant/run | the REST route's own per-item permission check | question: string (obbligatorio), language: string |
zinn-chat/bulk-update-ticketszinn-chat-bulk-update-tickets | Modifica più ticket contemporaneamente (Pro) Modifica lo stato, la priorità o l'assegnatario di un massimo di 100 ticket (ids). Ogni ticket viene sottoposto agli stessi controlli di una modifica singola; il risultato li elenca tutti. | 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-ticketzinn-chat-chat-to-ticket | Converti una chat in un ticket Apre un ticket da una chat in modo da potervi rispondere via email (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-chatzinn-chat-close-chat | Chiudi una chat Termina una chat; il visitatore può ancora 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-ticketzinn-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 | email: string (obbligatorio), subject: string (obbligatorio), body: string (obbligatorio), name: string |
zinn-chat/delete-canned-replyzinn-chat-delete-canned-reply | Elimina una 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-ticketzinn-chat-delete-ticket | Elimina un ticket Elimina definitivamente un ticket e la sua conversazione (solo per i gestori). | 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-articlezinn-chat-draft-kb-article | Crea una bozza di articolo di aiuto da un ticket (Pro) Scrive una bozza di articolo per la knowledge base da un ticket risolto; rimane una bozza finché qualcuno non la pubblica. | Edizione Pro | POST …/abilities/zinn-chat/draft-kb-article/run | edit_posts (the REST route's own check) | ticket: integer (obbligatorio) |
zinn-chat/draft-kb-from-gapszinn-chat-draft-kb-from-gaps | Crea bozze di articoli di supporto per le domande senza risposta (Pro) Scrive bozze di articoli della knowledge base che rispondono alle domande selezionate (id); rimangono bozze. | Edizione Pro | POST …/abilities/zinn-chat/draft-kb-from-gaps/run | edit_posts (the REST route's own check) | ids: array (obbligatorio) |
zinn-chat/fill-canned-replyzinn-chat-fill-canned-reply | Inserisci una risposta salvata (Pro) Restituisce il testo di una risposta salvata con i segnaposto compilati per una singola chat o 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-chatzinn-chat-get-chat | Leggi una chat Restituisce i messaggi di una chat e i dettagli del visitatore (after: solo i messaggi più recenti di 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-overviewzinn-chat-get-overview | Leggi la panoramica del supporto Restituisce quanti ticket si trovano in ciascuno stato, quante chat sono in attesa di un operatore (e i relativi messaggi non letti) e se la chat, l'assistente e i ticket sono attivati. | Edizione gratuita | GET …/abilities/zinn-chat/get-overview/run | zinn_chat_answer | nessuno |
zinn-chat/get-settingszinn-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-statszinn-chat-get-stats | Leggi le statistiche del supporto (Pro) Restituisce il numero di chat e ticket, i tempi di risposta e le valutazioni per gli ultimi N giorni (giorni). | Edizione Pro | GET …/abilities/zinn-chat/get-stats/run | the REST route's own per-item permission check | days: integer |
zinn-chat/get-ticketzinn-chat-get-ticket | Leggi un ticket Restituisce un ticket con l'intera conversazione, lo stato, la priorità e la persona assegnata. | 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-assistantzinn-chat-hand-chat-to-assistant | Riassegna la chat all'assistente Restituisce una chat all'assistente IA, che risponde al visitatore in base ai 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-replieszinn-chat-list-canned-replies | Elenca le risposte salvate (Pro) Elenca le risposte salvate che gli agenti possono inserire, insieme alle relative scorciatoie. | Edizione Pro | GET …/abilities/zinn-chat/list-canned-replies/run | the REST route's own per-item permission check | nessuno |
zinn-chat/list-chatszinn-chat-list-chats | Elenca le chat dal vivo Elenca le chat in attesa, in corso e chiuse di recente, indicando chi si occupa di ciascuna. | Edizione gratuita | GET …/abilities/zinn-chat/list-chats/run | the REST route's own per-item permission check | view: active|bot|closed|all |
zinn-chat/list-indexed-contentzinn-chat-list-indexed-content | Elenca cosa sa l'assistente Elenca i contenuti da 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 | search: string, status: indexed|pending|error, page: integer |
zinn-chat/list-kb-gapszinn-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 | status: open|drafted|answered|ignored|all, page: integer |
zinn-chat/list-ticketszinn-chat-list-tickets | Elenca ticket Elenca i ticket di supporto, filtrati per stato o ricerca, una pagina alla volta. | Edizione gratuita | GET …/abilities/zinn-chat/list-tickets/run | the REST route's own per-item permission check | status: active|open|pending|solved|closed|all, search: string, page: integer |
zinn-chat/reembed-contentzinn-chat-reembed-content | Ricostruisci l'indice di ricerca dell'assistente Ricostruisce i vettori di ricerca per un elemento (item_id) o per tutto (all: true) (solo gestori). | Edizione gratuita | POST …/abilities/zinn-chat/reembed-content/run | the REST route's own per-item permission check | all: boolean, item_id: integer |
zinn-chat/reindex-contentzinn-chat-reindex-content | Rileggi il contenuto nell'assistente Rilegge 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 | all: boolean, item_id: integer |
zinn-chat/reply-chatzinn-chat-reply-chat | Rispondi in chat Invia un messaggio al visitatore (text) 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-replyzinn-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 | id: integer, title: string (obbligatorio), body: string (obbligatorio), shortcut: string, department: string |
zinn-chat/save-kb-articlezinn-chat-save-kb-article | Scrivi un articolo della guida (Pro) Crea un articolo della knowledge base o ne modifica uno (id): titolo, contenuto, riassunto, categorie e stato (bozza o pubblica quando puoi 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-kbzinn-chat-search-kb | Cerca nella knowledge base (Pro) Trova articoli di supporto da collegare in una risposta (q: la ricerca). | Edizione Pro | GET …/abilities/zinn-chat/search-kb/run | the REST route's own per-item permission check | q: string (obbligatorio) |
zinn-chat/set-conversation-detailszinn-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 (kind: chat o ticket; id). | Edizione Pro | POST …/abilities/zinn-chat/set-conversation-details/run | the REST route's own per-item permission check | kind: ticket|chat, id: integer (obbligatorio), department: string, tags: array |
zinn-chat/set-kb-gap-statuszinn-chat-set-kb-gap-status | Contrassegna le domande senza risposta (Pro) Contrassegna le domande senza risposta come aperte, pianificate o archiviate (ids, status). | Edizione Pro | POST …/abilities/zinn-chat/set-kb-gap-status/run | the REST route's own per-item permission check | ids: array (obbligatorio), status: open|drafted|answered|ignored (obbligatorio) |
zinn-chat/set-presencezinn-chat-set-presence | Imposta la tua disponibilità Contrassegna l'agente che ha effettuato l'accesso come disponibile o assente per nuove chat (away: true o false). | Edizione gratuita | POST …/abilities/zinn-chat/set-presence/run | the REST route's own per-item permission check | away: boolean |
zinn-chat/suggest-replyzinn-chat-suggest-reply | Scrivi una bozza di risposta con l'IA (Pro) Prepara una bozza di risposta a una chat o a un ticket dal contenuto del sito; non viene inviato nulla. | Edizione Pro | POST …/abilities/zinn-chat/suggest-reply/run | the REST route's own per-item permission check | kind: ticket|chat, id: integer (obbligatorio) |
zinn-chat/summarise-conversationzinn-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 | kind: ticket|chat, id: integer (obbligatorio) |
zinn-chat/take-chatzinn-chat-take-chat | Accetta 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-settingszinn-chat-update-settings | Modifica le impostazioni della chat Modifica le impostazioni che invii (impostazioni: chiave in valore) e mantiene il resto. Ogni valore viene controllato 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-ticketzinn-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) |
Azioni e filtri
Ogni gancio offerto dal plugin, con la descrizione tratta dal suo codice sorgente. I filtri modificano un valore; le azioni consentono di eseguire codice in un determinato momento; i punti di ingresso sono azioni attivate per richiedere al plugin di eseguire un'operazione.
| Webhook | Genere | Cosa fa | Parametri | Edizione |
|---|---|---|---|---|
zinn_chat_admin_pages | Filtra | Filtra le schermate di amministrazione di Zinn® Chat (la versione Pro aggiunge le proprie). | nessuno | Edizione gratuita |
zinn_chat_agent_chat | Filtra | Filtra il payload della chat per la console degli agenti (la versione Pro aggiunge dettagli dei visitatori, note e suggerimenti della KB). | nessuno | Edizione gratuita |
zinn_chat_agent_pages | Filtra | Filtra le schermate di Zinn® Chat che un account di supporto può aprire. | nessuno | Edizione Pro |
zinn_chat_agent_script_src | Filtra | Filtra l'URL da cui viene caricato l'agente di chat IA autonomo. | string $src | Edizione gratuita |
zinn_chat_agent_ticket | Filtra | Filtra il payload dei ticket per wp-admin (Pro aggiunge risposte predefinite, SLA, suggerimenti KB). | nessuno | Edizione gratuita |
zinn_chat_answer | Filtra | Filtra la risposta di un assistente prima che venga mostrata (Pro aggiunge qui i suoi extra). | string $question | Edizione gratuita |
zinn_chat_assistant_answered | Azione | L'assistente ha risposto a un visitatore. | int $id, string $text | Edizione gratuita |
zinn_chat_challenge | Filtra | Filtra il controllo umano mostrato ai visitatori (URL dello script, chiave del sito e oggetto globale definito dallo script con un metodo `render( element, { sitekey, callback } )`). | nessuno | Edizione gratuita |
zinn_chat_challenge_ok | Filtra | Filtra se il visitatore ha superato il controllo anti-bot. Un controllo che non può essere verificato deve restituire false (fail closed): un modulo che lascia passare qualsiasi cosa ogni volta che il servizio non è raggiungibile è un modulo che un bot può far riuscire sfruttando i tempi di risposta. | bool $ok, string $ip, string $where | Edizione gratuita |
zinn_chat_client_ip | Filtra | Filtra l'indirizzo IP del visitatore utilizzato per i limiti di frequenza e i record. | string $ip | Edizione gratuita |
zinn_chat_console_config | Filtra | Filtra la configurazione extra passata allo script della console dell'operatore; Zinn® Chat Pro aggiunge qui le sue funzionalità. | nessuno | Edizione gratuita |
zinn_chat_conversation_started | Azione | Un visitatore ha iniziato una chat. | int $id | Edizione gratuita |
zinn_chat_conversation_status | Azione | Lo stato di una conversazione è cambiato. | int $id, string $status, string $old | Edizione gratuita |
zinn_chat_customer_ticket_url | Filtra | Filtra il link inviato a un cliente per il suo biglietto. | string $url | Edizione gratuita |
zinn_chat_elements | Filtra | Filtra gli elementi del frontend offerti come blocchi e moduli del builder. | nessuno | Edizione gratuita |
zinn_chat_email | Filtra | Filtra un'email prima che venga inviata. Restituisci un `to` vuoto per interromperla. | nessuno | Edizione gratuita |
zinn_chat_fs_loaded | Azione | Si attiva una volta caricato l'SDK di licenza (nel file principale, prima di qualsiasi codice Zinn® Chat). Eseguire l'hook qui per comunicare con `zinn_chat_fs()`. | nessuno | Edizione gratuita |
zinn_chat_index_extract | Filtra | Filtra un oggetto estratto (o ne fornisce uno per un tipo di oggetto personalizzato). | string $type, int $id | Edizione gratuita |
zinn_chat_index_language | Filtra | Filtra la lingua (localizzazione) di un post indicizzato. | string $language, \WP_Post $post | Edizione gratuita |
zinn_chat_index_object | Punto di ingresso (lo attiva Lei) | Hook | nessuno | Edizione gratuita |
zinn_chat_index_post_types | Filtra | Filtra i tipi di post letti dall'assistente. | nessuno | Edizione gratuita |
zinn_chat_indexable | Filtra | Filtra se un post viene indicizzato. | bool $indexable, \WP_Post $post | Edizione gratuita |
zinn_chat_indexed | Azione | Un oggetto è stato (ri)indicizzato. | string $type, int $id | Edizione gratuita |
zinn_chat_is_pro | Filtra | Filtra se le funzionalità Pro sono attive (una licenza acquistata o una prova, da Freemius). Il codice Pro viene fornito solo nel pacchetto premium, quindi questo non può aggiungere ciò che manca a quello gratuito. | bool $pro | Edizione gratuita |
zinn_chat_loaded | Azione | Zinn® Chat è stato caricato (il punto di estensione per i componenti aggiuntivi). | nessuno | Edizione gratuita |
zinn_chat_message_added | Azione | È stato aggiunto un messaggio a una conversazione. | int $id, int $conversation_id, string $role | Edizione gratuita |
zinn_chat_order_tracking | Filtra | Filtra le informazioni di tracciamento fornite all'assistente per un ordine. | \WC_Order $order | Edizione gratuita |
zinn_chat_pro_alert | Azione | Si è verificato un evento che merita un avviso (le notifiche push sono in ascolto qui). | string $alert, int $id, string $text, string $link | Edizione Pro |
zinn_chat_pro_assigned | Azione | Un ticket è stato assegnato automaticamente a un agente. | int $id, int $agent | Edizione Pro |
zinn_chat_pro_loaded | Azione | Il livello Pro è stato caricato. | nessuno | Edizione Pro |
zinn_chat_pro_priority_changed | Azione | La priorità di un ticket è cambiata (gli obiettivi SLA seguono questa modifica). | int $id | Edizione Pro |
zinn_chat_pro_sla_breach | Azione | È stato mancato un obiettivo SLA. | int $ticket_id, string $which | Edizione Pro |
zinn_chat_pro_ticket_rated | Azione | Un cliente ha valutato un ticket risolto (1-5). | int $id, int $score | Edizione Pro |
zinn_chat_rated | Azione | Si attiva dopo che un visitatore valuta una conversazione, fornendo l'ID della conversazione e la valutazione (1 per utile, -1 per non utile). | int $conversation_id, int $rating | Edizione gratuita |
zinn_chat_role_capabilities | Filtra | Filtra quali ruoli ricevono quali funzionalità di Zinn® Chat. | nessuno | Edizione gratuita |
zinn_chat_save_settings | Filtra | Configura i filtri prima che vengano salvati (Pro aggiunge le proprie chiavi qui). | nessuno | Edizione gratuita |
zinn_chat_script_src | Filtra | Filtra l'URL da cui viene caricato il widget di chat ospitato (modalità connessa). | string $src | Edizione gratuita |
zinn_chat_settings_before | Azione | Testo sopra il modulo di una scheda delle impostazioni. | string $tab | Edizione gratuita |
zinn_chat_settings_fields | Filtra | Filtra i campi di una scheda delle impostazioni (Pro aggiunge i propri). | string $tab | Edizione gratuita |
zinn_chat_settings_tabs | Filtra | Filtra le schede delle impostazioni. | nessuno | Edizione gratuita |
zinn_chat_setup_after | Azione | Output sotto la checklist di configurazione (l'edizione gratuita mostra qui la scheda Pro). | nessuno | Edizione gratuita |
zinn_chat_should_render | Filtra | Filtra se la chat viene visualizzata in questa richiesta (i ganci di targeting delle pagine di Pro si collegano qui). | bool $render | Edizione gratuita |
zinn_chat_site_facts | Filtra | Filtra i dati relativi al sito forniti all'assistente a ogni domanda. Ciascuno è composto da `title`, `url` (su questo sito) e `text` (testo normale, massimo 3.000 caratteri); ne vengono utilizzati al massimo quattro. | string $language | Edizione gratuita |
zinn_chat_site_strings | Filtra | Filtra i testi del proprietario offerti per la traduzione (Pro aggiunge i suoi messaggi proattivi). | nessuno | Edizione gratuita |
zinn_chat_system_prompt | Filtra | Filtra il prompt di sistema dell'assistente (Pro: persona e regole di passaggio). | string $rules | Edizione gratuita |
zinn_chat_team_online | Filtra | Filtra se una persona può rispondere adesso (Pro aggiunge qui gli orari di apertura). | bool $online | Edizione gratuita |
zinn_chat_ticket_assigned | Azione | An agent assigned a ticket to an agent (2.14.0: the notification centre tells them). | int $id, int $assignee, int $by | Edizione gratuita |
zinn_chat_ticket_created | Azione | È stato aperto un ticket. Il mailer invia da qui la conferma e l'avviso per il team. | int $id, string $token | Edizione gratuita |
zinn_chat_ticket_form_extra | Filtra | Filtra il markup extra alla fine di un modulo di ticket per ospiti (il controllo umano di Pro viene inserito qui). | string $html | Edizione gratuita |
zinn_chat_ticket_form_fields | Filtra | Filtri i campi extra mostrati sopra il messaggio in ogni modulo di ticket (Pro: una scelta di dipartimento). Nominali `zinn_chat_extra[<key>]`; arrivano a `zinn_chat_ticket_created` come `$fields['extra']`, non sanificati, affinché chi li ha aggiunti possa validarli. | string $html | Edizione gratuita |
zinn_chat_ticket_reply | Azione | È stata aggiunta una risposta a un ticket. Mailer invia un'email all'altra parte da qui. | int $id, int $ticket_id, string $author | Edizione gratuita |
zinn_chat_ticket_status | Azione | Un ticket ha cambiato stato. | int $id, string $status, string $old | Edizione gratuita |
zinn_chat_uninstall | Azione | Zinn® Chat è in fase di disinstallazione (Pro rimuove i propri dati qui). | nessuno | Edizione gratuita |
zinn_chat_widget_config | Filtra | Filtra la configurazione del launcher stampata sulla pagina. | nessuno | Edizione gratuita |
zinn_chat_widget_status | Filtra | Filtra ciò che la chat aperta riceve (Pro aggiunge i propri interruttori e parole). | nessuno | Edizione gratuita |