Développeurs

Référence des fonctionnalités de Zinn® Chat

Zinn® Chat enregistre ses actions auprès de l'API WordPress Abilities. Ces mêmes capacités sont des outils MCP sur le propre serveur du site et des routes REST sous /wp-json/wp-abilities/v1. Cette page est générée à partir du propre registre du plugin.

Guide de l'utilisateur : connecter une application d'IA

Points de terminaison

MCP sur HTTP (diffusible en continu)

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

MCP sur WP-CLI (entrée et sortie standard)

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

REST : lister les capacités

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

REST: exécuter une capacité

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

Authentification et autorisations

Les requêtes HTTP s'authentifient à l'aide d'un mot de passe d'application WordPress (HTTP Basic). La connexion au serveur MCP nécessite la capacité indiquée ci-dessous ; chaque fonctionnalité vérifie ensuite sa propre autorisation, par objet. Les fonctionnalités en lecture seule s'exécutent avec GET et leur entrée dans la chaîne de requête ; les autres avec POST et un corps JSON {"input": {…}}.

Exemples

# REST: exécuter une capacité
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":{}}}

Toutes les capacités

Généré à partir du fichier abilities.json du plugin, qui est lui-même généré à partir d'un site en cours d'exécution ; un test échoue lorsque les deux ne correspondent pas.

Capacité	Fonctionnement	Édition	Repos	Permission	Paramètres
`zinn-chat/answer-ticket` `zinn-chat-answer-ticket`	Répondre à un ticket Répond au client par e-mail (texte) ou ajoute une note interne (note: true) ; le statut modifie éventuellement le statut du ticket.	Édition gratuite	`POST …/abilities/zinn-chat/answer-ticket/run`	the REST route's own per-item permission check	id: string (requis)
`zinn-chat/ask-assistant` `zinn-chat-ask-assistant`	Interroger l'assistant Pose une question à l'assistant IA du site et renvoie sa réponse avec toutes les sources qu'il a trouvées.	Édition gratuite	`POST …/abilities/zinn-chat/ask-assistant/run`	the REST route's own per-item permission check	Aucun
`zinn-chat/bulk-update-tickets` `zinn-chat-bulk-update-tickets`	Modifier plusieurs tickets à la fois (Pro) Modifie le statut, la priorité ou le responsable de 100 tickets (identifiants) au maximum. Chaque ticket est soumis aux mêmes vérifications que s'il était modifié individuellement ; le résultat liste chacun d'eux.	Édition Pro	`POST …/abilities/zinn-chat/bulk-update-tickets/run`	zinn_chat_answer	ids: array (requis), status: open\|pending\|solved\|closed, priority: low\|normal\|high\|urgent, assignee_id: integer
`zinn-chat/chat-to-ticket` `zinn-chat-chat-to-ticket`	Transformer un chat en ticket Ouvre un ticket à partir d'un chat pour qu'il puisse être répondu par e-mail (nécessite l'adresse e-mail du visiteur).	Édition gratuite	`POST …/abilities/zinn-chat/chat-to-ticket/run`	the REST route's own per-item permission check	id: string (requis)
`zinn-chat/close-chat` `zinn-chat-close-chat`	Fermer une discussion Met fin à une discussion ; le visiteur peut toujours demander la transcription.	Édition gratuite	`POST …/abilities/zinn-chat/close-chat/run`	the REST route's own per-item permission check	id: string (requis)
`zinn-chat/create-ticket` `zinn-chat-create-ticket`	Ouvrir un ticket Ouvre un ticket au nom d'un client (son e-mail, un objet et le premier message).	Édition gratuite	`POST …/abilities/zinn-chat/create-ticket/run`	the REST route's own per-item permission check	Aucun
`zinn-chat/delete-canned-reply` `zinn-chat-delete-canned-reply`	Supprimer une réponse enregistrée (Pro) Supprime une réponse enregistrée.	Édition Pro	`POST …/abilities/zinn-chat/delete-canned-reply/run`	the REST route's own per-item permission check	id: string (requis)
`zinn-chat/delete-ticket` `zinn-chat-delete-ticket`	Supprimer un ticket Supprime définitivement un ticket et sa conversation (réservé aux gestionnaires).	Édition gratuite	`POST …/abilities/zinn-chat/delete-ticket/run`	the REST route's own per-item permission check	id: string (requis)
`zinn-chat/draft-kb-article` `zinn-chat-draft-kb-article`	Rédiger un article d'aide à partir d'un ticket (Pro) Rédige un article de brouillon pour la base de connaissances à partir d'un ticket résolu ; il reste un brouillon jusqu'à ce qu'une personne le publie.	Édition Pro	`POST …/abilities/zinn-chat/draft-kb-article/run`	edit_posts (the REST route's own check)	Aucun
`zinn-chat/draft-kb-from-gaps` `zinn-chat-draft-kb-from-gaps`	Rédiger des articles d'aide pour les questions sans réponse (Pro) Rédige des brouillons d'articles de la base de connaissances répondant aux questions choisies (ids) ; ils restent au statut de brouillon.	Édition Pro	`POST …/abilities/zinn-chat/draft-kb-from-gaps/run`	edit_posts (the REST route's own check)	Aucun
`zinn-chat/fill-canned-reply` `zinn-chat-fill-canned-reply`	Insérer une réponse enregistrée (Pro) Renvoie le texte d'une réponse enregistrée avec ses espaces réservés remplis pour un chat ou un ticket.	Édition Pro	`POST …/abilities/zinn-chat/fill-canned-reply/run`	the REST route's own per-item permission check	id: string (requis)
`zinn-chat/get-chat` `zinn-chat-get-chat`	Lire une conversation Renvoie les messages d'une discussion et les détails du visiteur (after : uniquement les messages plus récents que cet ID).	Édition gratuite	`GET …/abilities/zinn-chat/get-chat/run`	the REST route's own per-item permission check	id: string (requis)
`zinn-chat/get-overview` `zinn-chat-get-overview`	Consulter l'aperçu du support Renvoie le nombre de tickets dans chaque statut, le nombre de chats en attente d'un agent (ainsi que leurs messages non lus), et indique si le chat, l'assistant et les tickets sont activés.	Édition gratuite	`GET …/abilities/zinn-chat/get-overview/run`	zinn_chat_answer	Aucun
`zinn-chat/get-settings` `zinn-chat-get-settings`	Lire les paramètres du chat Renvoie l'ensemble des paramètres du chat : le widget, l'assistant, les personnes et les horaires d'ouverture, les tickets et l'e-mail, l'index du site, la confidentialité et le spam.	Édition gratuite	`GET …/abilities/zinn-chat/get-settings/run`	zinn_chat_manage	Aucun
`zinn-chat/get-stats` `zinn-chat-get-stats`	Consulter les statistiques d'assistance (Pro) Renvoie les numéros de chat et de ticket, les temps de réponse et les notes pour les N derniers jours (days).	Édition Pro	`GET …/abilities/zinn-chat/get-stats/run`	the REST route's own per-item permission check	Aucun
`zinn-chat/get-ticket` `zinn-chat-get-ticket`	Lire un ticket Renvoie un ticket avec l'intégralité de sa conversation, son statut, sa priorité et son assigné.	Édition gratuite	`GET …/abilities/zinn-chat/get-ticket/run`	the REST route's own per-item permission check	id: string (requis)
`zinn-chat/hand-chat-to-assistant` `zinn-chat-hand-chat-to-assistant`	Renvoyer une conversation à l'assistant Retourne un chat à l'assistant IA, qui répond au visiteur à partir du contenu du site.	Édition gratuite	`POST …/abilities/zinn-chat/hand-chat-to-assistant/run`	the REST route's own per-item permission check	id: string (requis)
`zinn-chat/list-canned-replies` `zinn-chat-list-canned-replies`	Afficher les réponses enregistrées (Pro) Répertorie les réponses enregistrées que les agents peuvent insérer, avec leurs raccourcis.	Édition Pro	`GET …/abilities/zinn-chat/list-canned-replies/run`	the REST route's own per-item permission check	Aucun
`zinn-chat/list-chats` `zinn-chat-list-chats`	Afficher les chats en direct Répertorie les chats en attente, en cours et récemment fermés, avec le nom de la personne qui gère chacun d'eux.	Édition gratuite	`GET …/abilities/zinn-chat/list-chats/run`	the REST route's own per-item permission check	Aucun
`zinn-chat/list-indexed-content` `zinn-chat-list-indexed-content`	Lister ce que l'assistant sait Liste le contenu à partir duquel l'assistant répond, avec son statut d'indexation, page par page.	Édition gratuite	`GET …/abilities/zinn-chat/list-indexed-content/run`	the REST route's own per-item permission check	Aucun
`zinn-chat/list-kb-gaps` `zinn-chat-list-kb-gaps`	Lister les questions sans réponse (Pro) Affiche la liste des questions posées par les visiteurs auxquelles la base de connaissances n'a pas pu répondre.	Édition Pro	`GET …/abilities/zinn-chat/list-kb-gaps/run`	the REST route's own per-item permission check	Aucun
`zinn-chat/list-tickets` `zinn-chat-list-tickets`	Liste des tickets Répertorie les tickets de support, filtrés par statut ou par une recherche, page par page.	Édition gratuite	`GET …/abilities/zinn-chat/list-tickets/run`	the REST route's own per-item permission check	Aucun
`zinn-chat/reembed-content` `zinn-chat-reembed-content`	Reconstruire l'index de recherche de l'assistant Reconstruit les vecteurs de recherche pour un élément (item_id) ou l'ensemble (all: true) (réservé aux gestionnaires).	Édition gratuite	`POST …/abilities/zinn-chat/reembed-content/run`	the REST route's own per-item permission check	Aucun
`zinn-chat/reindex-content` `zinn-chat-reindex-content`	Relire le contenu dans l'assistant Relit un élément (item_id) ou l'ensemble (all: true) dans l'index de l'assistant (réservé aux gestionnaires).	Édition gratuite	`POST …/abilities/zinn-chat/reindex-content/run`	the REST route's own per-item permission check	Aucun
`zinn-chat/reply-chat` `zinn-chat-reply-chat`	Répondre dans un chat Envoie un message au visiteur (text) ou ajoute une note interne visible uniquement par les agents (note: true).	Édition gratuite	`POST …/abilities/zinn-chat/reply-chat/run`	the REST route's own per-item permission check	id: string (requis)
`zinn-chat/save-canned-reply` `zinn-chat-save-canned-reply`	Enregistrer une réponse enregistrée (Pro) Crée ou modifie une réponse enregistrée (titre, raccourci, corps, département ; id pour en modifier une).	Édition Pro	`POST …/abilities/zinn-chat/save-canned-reply/run`	the REST route's own per-item permission check	Aucun
`zinn-chat/save-kb-article` `zinn-chat-save-kb-article`	Rédiger un article d'aide (Pro) Crée un article de base de connaissances ou en modifie un (id) : titre, contenu, extrait, catégories et statut (brouillon, ou publier si vous pouvez publier).	Édition 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`	Rechercher dans la base de connaissances (Pro) Trouve des articles d'aide à lier dans une réponse (q : la recherche).	Édition Pro	`GET …/abilities/zinn-chat/search-kb/run`	the REST route's own per-item permission check	Aucun
`zinn-chat/set-conversation-details` `zinn-chat-set-conversation-details`	Définir le service et les étiquettes d'une conversation (Pro) Définit le département et les étiquettes d'un chat ou d'un ticket (type : chat ou ticket ; id).	Édition Pro	`POST …/abilities/zinn-chat/set-conversation-details/run`	the REST route's own per-item permission check	Aucun
`zinn-chat/set-kb-gap-status` `zinn-chat-set-kb-gap-status`	Marquer les questions sans réponse (Pro) Marque les questions sans réponse comme ouvertes, planifiées ou rejetées (identifiants, statut).	Édition Pro	`POST …/abilities/zinn-chat/set-kb-gap-status/run`	the REST route's own per-item permission check	Aucun
`zinn-chat/set-presence` `zinn-chat-set-presence`	Définissez vos disponibilités Indique si l'agent connecté est disponible ou absent pour de nouvelles discussions (absent : true ou false).	Édition gratuite	`POST …/abilities/zinn-chat/set-presence/run`	the REST route's own per-item permission check	Aucun
`zinn-chat/suggest-reply` `zinn-chat-suggest-reply`	Rédiger une réponse avec l'IA (Pro) Rédige une réponse à un chat ou un ticket à partir du contenu du site ; rien n'est envoyé.	Édition Pro	`POST …/abilities/zinn-chat/suggest-reply/run`	the REST route's own per-item permission check	Aucun
`zinn-chat/summarise-conversation` `zinn-chat-summarise-conversation`	Résumer une conversation avec l'IA (Pro) Résume un chat ou un ticket en quelques lignes.	Édition Pro	`POST …/abilities/zinn-chat/summarise-conversation/run`	the REST route's own per-item permission check	Aucun
`zinn-chat/take-chat` `zinn-chat-take-chat`	Démarrer une discussion Associe un chat en attente à l'agent connecté, afin que le visiteur parle à une personne.	Édition gratuite	`POST …/abilities/zinn-chat/take-chat/run`	the REST route's own per-item permission check	id: string (requis)
`zinn-chat/update-settings` `zinn-chat-update-settings`	Modifier les paramètres du chat Modifie les paramètres que vous envoyez (paramètres : clé vers valeur) et conserve le reste. Chaque valeur est vérifiée exactement comme sur l'écran des paramètres ; get-settings liste les clés.	Édition gratuite	`POST …/abilities/zinn-chat/update-settings/run`	zinn_chat_manage	settings: object (requis)
`zinn-chat/update-ticket` `zinn-chat-update-ticket`	Modifier un ticket Modifie le statut, la priorité ou le responsable d'un ticket.	Édition gratuite	`POST …/abilities/zinn-chat/update-ticket/run`	the REST route's own per-item permission check	id: string (requis)