Ontwikkelaars

Referentie van Zinn® Chat-functionaliteiten

Zinn® Chat registreert zijn acties bij de WordPress Abilities API. Dezelfde vaardigheden zijn MCP-tools op de eigen server van de site en REST-routes onder /wp-json/wp-abilities/v1. Deze pagina is gegenereerd vanuit het eigen register van de plugin.

Gebruikershandleiding: een AI-app verbinden

Eindpunten

MCP over HTTP (streamable)

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

MCP over WP-CLI (standaard invoer en uitvoer)

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

REST: toon de mogelijkheden

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

REST: voer een functie uit

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

Authenticatie en machtigingen

HTTP-verzoeken verifiëren met een WordPress-applicatiewachtwoord (HTTP Basic). Voor verbinding met de MCP-server is de hieronder weergegeven functionaliteit vereist; elke functie controleert vervolgens per object zijn eigen permissie. Alleen-lezenfuncties worden uitgevoerd met GET en hun invoer in de query-string; de overige met POST en een JSON-body {"input": {…}}.

Voorbeelden

# REST: voer een functie uit
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":{}}}

Alle bevoegdheden

Gegenereerd op basis van abilities.json van de plug-in, die op zijn beurt is gegenereerd vanuit een actieve site; een test mislukt wanneer deze twee niet met elkaar overeenkomen.

Mogelijkheid	Wat het doet	Editie	REST	Toestemming	Parameters
`zinn-chat/answer-ticket` `zinn-chat-answer-ticket`	Ticket beantwoorden Beantwoordt de klant per e-mail (tekst), of voegt een interne notitie toe (note: true); de status wijzigt optioneel de status van de ticket.	Gratis editie	`POST …/abilities/zinn-chat/answer-ticket/run`	the REST route's own per-item permission check	id: string (verplicht)
`zinn-chat/ask-assistant` `zinn-chat-ask-assistant`	Vraag het aan de assistent Stelt een vraag aan de AI-assistent van de website en geeft het antwoord terug samen met elke bron die is gevonden.	Gratis editie	`POST …/abilities/zinn-chat/ask-assistant/run`	the REST route's own per-item permission check	geen
`zinn-chat/bulk-update-tickets` `zinn-chat-bulk-update-tickets`	Meerdere tickets tegelijk wijzigen (Pro) Wijzigt de status, prioriteit of toegewezen persoon van maximaal 100 tickets (ids). Elk ticket doorloopt dezelfde controles als wanneer dit individueel wordt gewijzigd; het resultaat somt ze stuk voor stuk op.	Pro-editie	`POST …/abilities/zinn-chat/bulk-update-tickets/run`	zinn_chat_answer	ids: array (verplicht), status: open\|pending\|solved\|closed, priority: low\|normal\|high\|urgent, assignee_id: integer
`zinn-chat/chat-to-ticket` `zinn-chat-chat-to-ticket`	Zet een chat om in een ticket Opent een ticket vanuit een chat zodat dit per e-mail kan worden beantwoord (vereist het e-mailadres van de bezoeker).	Gratis editie	`POST …/abilities/zinn-chat/chat-to-ticket/run`	the REST route's own per-item permission check	id: string (verplicht)
`zinn-chat/close-chat` `zinn-chat-close-chat`	Chat sluiten Beëindigt een chat; de bezoeker kan nog steeds om het transcript vragen.	Gratis editie	`POST …/abilities/zinn-chat/close-chat/run`	the REST route's own per-item permission check	id: string (verplicht)
`zinn-chat/create-ticket` `zinn-chat-create-ticket`	Een ticket openen Opent een ticket namens een klant (hun e-mailadres, een onderwerp en het eerste bericht).	Gratis editie	`POST …/abilities/zinn-chat/create-ticket/run`	the REST route's own per-item permission check	geen
`zinn-chat/delete-canned-reply` `zinn-chat-delete-canned-reply`	Een opgeslagen antwoord verwijderen (Pro) Hiermee wordt een opgeslagen antwoord verwijderd.	Pro-editie	`POST …/abilities/zinn-chat/delete-canned-reply/run`	the REST route's own per-item permission check	id: string (verplicht)
`zinn-chat/delete-ticket` `zinn-chat-delete-ticket`	Ticket verwijderen Verwijdert een ticket en de bijbehorende conversatie definitief (alleen voor managers).	Gratis editie	`POST …/abilities/zinn-chat/delete-ticket/run`	the REST route's own per-item permission check	id: string (verplicht)
`zinn-chat/draft-kb-article` `zinn-chat-draft-kb-article`	Een help-artikel opstellen op basis van een ticket (Pro) Schrijft een conceptartikel voor de kennisbank op basis van een opgelost ticket; dit blijft een concept totdat iemand het publiceert.	Pro-editie	`POST …/abilities/zinn-chat/draft-kb-article/run`	edit_posts (the REST route's own check)	geen
`zinn-chat/draft-kb-from-gaps` `zinn-chat-draft-kb-from-gaps`	Concept-help artikelen opstellen voor onbeantwoorde vragen (Pro) Schrijft conceptartikelen voor de kennisbank als antwoord op de gekozen vragen (ids); deze blijven concepten.	Pro-editie	`POST …/abilities/zinn-chat/draft-kb-from-gaps/run`	edit_posts (the REST route's own check)	geen
`zinn-chat/fill-canned-reply` `zinn-chat-fill-canned-reply`	Vul een opgeslagen antwoord in (Pro) Geeft de tekst van een opgeslagen antwoord terug met de tijdelijke aanduidingen ingevuld voor één chat of ticket.	Pro-editie	`POST …/abilities/zinn-chat/fill-canned-reply/run`	the REST route's own per-item permission check	id: string (verplicht)
`zinn-chat/get-chat` `zinn-chat-get-chat`	Chat lezen Geeft de berichten en bezoekersgegevens van één chat terug (after: alleen berichten die newer zijn dan dit ID).	Gratis editie	`GET …/abilities/zinn-chat/get-chat/run`	the REST route's own per-item permission check	id: string (verplicht)
`zinn-chat/get-overview` `zinn-chat-get-overview`	Lees het ondersteuningsoverzicht Geeft het aantal tickets per status terug, hoeveel chats er wachten op een medewerker (inclusief ongelezen berichten), en of de chat, de assistent en tickets zijn ingeschakeld.	Gratis editie	`GET …/abilities/zinn-chat/get-overview/run`	zinn_chat_answer	geen
`zinn-chat/get-settings` `zinn-chat-get-settings`	Chatinstellingen lezen Geeft alle chatinstellingen terug: de widget, de assistent, personen en openingstijden, tickets en e-mail, de site-index, privacy en spam.	Gratis editie	`GET …/abilities/zinn-chat/get-settings/run`	zinn_chat_manage	geen
`zinn-chat/get-stats` `zinn-chat-get-stats`	Ondersteuningsstatistieken lezen (Pro) Geeft chat- en ticketnummers, reactietijden en beoordelingen terug voor de laatste N dagen (dagen).	Pro-editie	`GET …/abilities/zinn-chat/get-stats/run`	the REST route's own per-item permission check	geen
`zinn-chat/get-ticket` `zinn-chat-get-ticket`	Ticket lezen Geeft één ticket terug met de volledige conversatie, status, prioriteit en toegewezen persoon.	Gratis editie	`GET …/abilities/zinn-chat/get-ticket/run`	the REST route's own per-item permission check	id: string (verplicht)
`zinn-chat/hand-chat-to-assistant` `zinn-chat-hand-chat-to-assistant`	Draag een chat over aan de assistent Stuurt een chat naar de AI-assistent, die de bezoeker beantwoordt op basis van de inhoud van de website.	Gratis editie	`POST …/abilities/zinn-chat/hand-chat-to-assistant/run`	the REST route's own per-item permission check	id: string (verplicht)
`zinn-chat/list-canned-replies` `zinn-chat-list-canned-replies`	Opgeslagen antwoorden weergeven (Pro) Toont de opgeslagen antwoorden die medewerkers kunnen invoegen, inclusief de bijbehorende sneltoetsen.	Pro-editie	`GET …/abilities/zinn-chat/list-canned-replies/run`	the REST route's own per-item permission check	geen
`zinn-chat/list-chats` `zinn-chat-list-chats`	Livechats weergeven Toont wachtende, lopende en recent gesloten chats, inclusief de medewerker die elke chat behandelt.	Gratis editie	`GET …/abilities/zinn-chat/list-chats/run`	the REST route's own per-item permission check	geen
`zinn-chat/list-indexed-content` `zinn-chat-list-indexed-content`	Geef een overzicht van wat de assistent weet Geeft per pagina een lijst weer van de inhoud waar de assistent op antwoordt, inclusief de indexeringsstatus.	Gratis editie	`GET …/abilities/zinn-chat/list-indexed-content/run`	the REST route's own per-item permission check	geen
`zinn-chat/list-kb-gaps` `zinn-chat-list-kb-gaps`	Onbeantwoorde vragen weergeven (Pro) Toont de vragen van bezoekers die de kennisbank niet kon beantwoorden.	Pro-editie	`GET …/abilities/zinn-chat/list-kb-gaps/run`	the REST route's own per-item permission check	geen
`zinn-chat/list-tickets` `zinn-chat-list-tickets`	Tickets weergeven Toont supporttickets, gefilterd op status of een zoekopdracht, per pagina.	Gratis editie	`GET …/abilities/zinn-chat/list-tickets/run`	the REST route's own per-item permission check	geen
`zinn-chat/reembed-content` `zinn-chat-reembed-content`	Herbouw de zoekindex van de assistent Bouwt de zoekvectoren opnieuw op voor één item (item_id) of voor alles (all: true) (alleen voor managers).	Gratis editie	`POST …/abilities/zinn-chat/reembed-content/run`	the REST route's own per-item permission check	geen
`zinn-chat/reindex-content` `zinn-chat-reindex-content`	Inhoud opnieuw inlezen in de assistent Leest één item (item_id) of alles (all: true) opnieuw in de index van de assistent (alleen voor managers).	Gratis editie	`POST …/abilities/zinn-chat/reindex-content/run`	the REST route's own per-item permission check	geen
`zinn-chat/reply-chat` `zinn-chat-reply-chat`	Reageren in een chat Stuurt een bericht naar de bezoeker (text), of voegt een interne notitie toe die alleen medewerkers zien (note: true).	Gratis editie	`POST …/abilities/zinn-chat/reply-chat/run`	the REST route's own per-item permission check	id: string (verplicht)
`zinn-chat/save-canned-reply` `zinn-chat-save-canned-reply`	Een opgeslagen antwoord opslaan (Pro) Maakt een opgeslagen antwoord aan of wijzigt dit (titel, snelkoppeling, hoofdtekst, afdeling; id om er een te wijzigen).	Pro-editie	`POST …/abilities/zinn-chat/save-canned-reply/run`	the REST route's own per-item permission check	geen
`zinn-chat/save-kb-article` `zinn-chat-save-kb-article`	Schrijf een hulppagina (Pro) Maakt een kennisbankartikel aan of wijzigt er een (id): titel, inhoud, samenvatting, categorieën en status (concept, of publiceren wanneer u mag publiceren).	Pro-editie	`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`	Doorzoek de kennisbank (Pro) Zoekt helpartikelen om in een antwoord te linken (q: de zoekopdracht).	Pro-editie	`GET …/abilities/zinn-chat/search-kb/run`	the REST route's own per-item permission check	geen
`zinn-chat/set-conversation-details` `zinn-chat-set-conversation-details`	Stel de afdeling en tags van een gesprek in (Pro) Stelt de afdeling en labels van een chat of ticket in (soort: chat of ticket; id).	Pro-editie	`POST …/abilities/zinn-chat/set-conversation-details/run`	the REST route's own per-item permission check	geen
`zinn-chat/set-kb-gap-status` `zinn-chat-set-kb-gap-status`	Markeer onbeantwoorde vragen (Pro) Markeert onbeantwoorde vragen als open, gepland of afgewezen (id's, status).	Pro-editie	`POST …/abilities/zinn-chat/set-kb-gap-status/run`	the REST route's own per-item permission check	geen
`zinn-chat/set-presence` `zinn-chat-set-presence`	Stel uw beschikbaarheid in Markeert de ingelogde medewerker als beschikbaar of afwezig voor nieuwe chats (afwezig: true of false).	Gratis editie	`POST …/abilities/zinn-chat/set-presence/run`	the REST route's own per-item permission check	geen
`zinn-chat/suggest-reply` `zinn-chat-suggest-reply`	Antwoord opstellen met AI (Pro) Stelt een antwoord op een chat of ticket op op basis van de site-inhoud; er wordt niets verzonden.	Pro-editie	`POST …/abilities/zinn-chat/suggest-reply/run`	the REST route's own per-item permission check	geen
`zinn-chat/summarise-conversation` `zinn-chat-summarise-conversation`	Vat een gesprek met AI (Pro) samen Vat een chat of ticket in een paar regels samen.	Pro-editie	`POST …/abilities/zinn-chat/summarise-conversation/run`	the REST route's own per-item permission check	geen
`zinn-chat/take-chat` `zinn-chat-take-chat`	Chat starten Wijst een wachtende chat toe aan de ingelogde medewerker, zodat de bezoeker met een persoon spreekt.	Gratis editie	`POST …/abilities/zinn-chat/take-chat/run`	the REST route's own per-item permission check	id: string (verplicht)
`zinn-chat/update-settings` `zinn-chat-update-settings`	Chatinstellingen wijzigen Wijzigt de instellingen die u verzendt (instellingen: sleutel naar waarde) en behoudt de rest. Elke waarde wordt exact gecontroleerd zoals op het instellingenscherm; get-settings vermeldt de sleutels.	Gratis editie	`POST …/abilities/zinn-chat/update-settings/run`	zinn_chat_manage	settings: object (verplicht)
`zinn-chat/update-ticket` `zinn-chat-update-ticket`	Ticket wijzigen Wijzigt de status, prioriteit of toegewezen persoon van een ticket.	Gratis editie	`POST …/abilities/zinn-chat/update-ticket/run`	the REST route's own per-item permission check	id: string (verplicht)