Προγραμματιστές
Zinn® Chat αναφορά δυνατοτήτων
Το Zinn® Chat καταχωρεί τις ενέργειές του στο WordPress Abilities API. Οι ίδιες δυνατότητες αποτελούν εργαλεία MCP στον δικό του διακομιστή του ιστότοπου και διαδρομές REST στη διεύθυνση /wp-json/wp-abilities/v1. Αυτή η σελίδα δημιουργείται από το μητρώο του ίδιου του πρόσθετου.
Τελικά σημεία
MCP μέσω HTTP (με δυνατότητα ροής)
https://example.com/wp-json/zinn-chat/v1/mcpMCP μέσω WP-CLI (τυπική είσοδος και έξοδος)
wp mcp-adapter serve --server=zinn-chat --user=<login>REST: εμφάνιση δυνατοτήτων
/wp-json/wp-abilities/v1/abilities?category=zinn-chatREST: εκτέλεση ικανότητας
/wp-json/wp-abilities/v1/abilities/<name>/runΠιστοποίηση και δικαιώματα
Τα HTTP αιτήματα πραγματοποιούν έλεγχο ταυτότητας με έναν κωδικό πρόσβασης εφαρμογής WordPress (HTTP Basic). Η σύνδεση στον διακομιστή MCP απαιτεί τη δυνατότητα που εμφανίζεται παρακάτω· κάθε δυνατότητα στη συνέχεια ελέγχει τη δική της άδεια, ανά αντικείμενο. Οι δυνατότητες μόνο για ανάγνωση εκτελούνται με GET και την είσοδό τους στη συμβολοσειρά ερωτήματος, ενώ οι υπόλοιπες με POST και ένα σώμα JSON {"input": {…}}.
Παραδείγματα
# REST: εκτέλεση ικανότητας
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":{}}}Όλες οι δυνατότητες
Δημιουργήθηκε από το αρχείο abilities.json του πρόσθετου, το οποίο με τη σειρά του δημιουργείται από έναν ιστότοπο σε λειτουργία· μια δοκιμή αποτυγχάνει όταν τα δύο δεν συμφωνούν.
| Δυνατότητα | Τι κάνει | Έκδοση | Υπόλοιπο | Δικαίωμα | Παράμετροι |
|---|---|---|---|---|---|
zinn-chat/answer-ticketzinn-chat-answer-ticket | Απάντηση σε αίτημα υποστήριξης Απαντά στον πελάτη μέσω email (text), ή προσθέτει μια εσωτερική σημείωση (note: true)· η κατάσταση αλλάζει προαιρετικά την κατάσταση του αιτήματος. | Δωρεάν έκδοση | POST …/abilities/zinn-chat/answer-ticket/run | the REST route's own per-item permission check | id: string (απαιτούμενο) |
zinn-chat/ask-assistantzinn-chat-ask-assistant | Ρωτήστε τον βοηθό Κάνει μια ερώτηση στον βοηθό τεχνητής νοημοσύνης του ιστότοπου και επιστρέφει την απάντησή του μαζί με κάθε πηγή που βρήκε. | Δωρεάν έκδοση | POST …/abilities/zinn-chat/ask-assistant/run | the REST route's own per-item permission check | κανένα |
zinn-chat/bulk-update-ticketszinn-chat-bulk-update-tickets | Μαζική αλλαγή πολλών εισιτηρίων (Pro) Αλλάζει την κατάσταση, την προτεραιότητα ή τον υπεύθυνο ανάθεσης έως και 100 δελτίων (ids). Κάθε δελτίο περνά από τους ίδιους ελέγχους όπως και η μεμονωμένη αλλαγή του· το αποτέλεσμα απαριθμεί το καθένα. | Έκδοση Pro | POST …/abilities/zinn-chat/bulk-update-tickets/run | zinn_chat_answer | ids: array (απαιτούμενο), status: open|pending|solved|closed, priority: low|normal|high|urgent, assignee_id: integer |
zinn-chat/chat-to-ticketzinn-chat-chat-to-ticket | Μετατρέψτε μια συνομιλία σε δελτίο υποστήριξης Ανοίγει ένα ticket από μια συνομιλία ώστε να μπορεί να απαντηθεί μέσω email (απαιτεί τη διεύθυνση email του επισκέπτη). | Δωρεάν έκδοση | POST …/abilities/zinn-chat/chat-to-ticket/run | the REST route's own per-item permission check | id: string (απαιτούμενο) |
zinn-chat/close-chatzinn-chat-close-chat | Κλείσιμο συνομιλίας Τερματίζει μια συνομιλία· ο επισκέπτης μπορεί ακόμα να ζητήσει την απομαγνητοφώνηση. | Δωρεάν έκδοση | POST …/abilities/zinn-chat/close-chat/run | the REST route's own per-item permission check | id: string (απαιτούμενο) |
zinn-chat/create-ticketzinn-chat-create-ticket | Άνοιγμα αιτήματος Ανοίγει ένα εισιτήριο εξυπηρέτησης εκ μέρους ενός πελάτη (το email του, ένα θέμα και το πρώτο μήνυμα). | Δωρεάν έκδοση | POST …/abilities/zinn-chat/create-ticket/run | the REST route's own per-item permission check | κανένα |
zinn-chat/delete-canned-replyzinn-chat-delete-canned-reply | Διαγραφή αποθηκευμένης απάντησης (Pro) Διαγράφει μια αποθηκευμένη απάντηση. | Έκδοση Pro | POST …/abilities/zinn-chat/delete-canned-reply/run | the REST route's own per-item permission check | id: string (απαιτούμενο) |
zinn-chat/delete-ticketzinn-chat-delete-ticket | Διαγραφή αιτήματος υποστήριξης Διαγράφει οριστικά ένα αίτημα υποστήριξης και τη συνομιλία του (μόνο για διαχειριστές). | Δωρεάν έκδοση | POST …/abilities/zinn-chat/delete-ticket/run | the REST route's own per-item permission check | id: string (απαιτούμενο) |
zinn-chat/draft-kb-articlezinn-chat-draft-kb-article | Σύνταξη άρθρου βοήθειας από υποστήριξη (Pro) Δημιουργεί ένα πρόχειρο άρθρο βάσης γνώσεων από ένα επιλυμένο δελτίο υποστήριξης· παραμένει πρόχειρο έως ότου το δημοσιεύσει κάποιος χρήστης. | Έκδοση Pro | POST …/abilities/zinn-chat/draft-kb-article/run | edit_posts (the REST route's own check) | κανένα |
zinn-chat/draft-kb-from-gapszinn-chat-draft-kb-from-gaps | Σύνταξη άρθρων βοήθειας για αναπάντητες ερωτήσεις (Pro) Γράφει πρόχειρα άρθρα της βάσης γνώσεων που απαντούν στις επιλεγμένες ερωτήσεις (ids)· παραμένουν πρόχειρα. | Έκδοση Pro | POST …/abilities/zinn-chat/draft-kb-from-gaps/run | edit_posts (the REST route's own check) | κανένα |
zinn-chat/fill-canned-replyzinn-chat-fill-canned-reply | Συμπλήρωση αποθηκευμένης απάντησης (Pro) Επιστρέφει το κείμενο μιας αποθηκευμένης απάντησης με τα σύμβολα κράτησης θέσης συμπληρωμένα για μία συνομιλία ή ένα δελτίο. | Έκδοση Pro | POST …/abilities/zinn-chat/fill-canned-reply/run | the REST route's own per-item permission check | id: string (απαιτούμενο) |
zinn-chat/get-chatzinn-chat-get-chat | Ανάγνωση συνομιλίας Επιστρέφει τα μηνύματα μιας συνομιλίας και τα στοιχεία του επισκέπτη (after: μόνο μηνύματα νεότερα από αυτό το αναγνωριστικό). | Δωρεάν έκδοση | GET …/abilities/zinn-chat/get-chat/run | the REST route's own per-item permission check | id: string (απαιτούμενο) |
zinn-chat/get-overviewzinn-chat-get-overview | Διαβάστε την επισκόπηση υποστήριξης Επιστρέφει πόσα δεlτία υποστήριξης βρίσκονται σε κάθε κατάσταση και πόσες συνομιλίες αναμένουν έναν εκπρόσωπο (καθώς και τα μη αναγνωσμένα μηνύματά τους), καθώς και το αν η συνομιλία, ο βοηθός και τα δελτία είναι ενεργοποιημένα. | Δωρεάν έκδοση | GET …/abilities/zinn-chat/get-overview/run | zinn_chat_answer | κανένα |
zinn-chat/get-settingszinn-chat-get-settings | Ανάγνωση ρυθμίσεων συνομιλίας Επιστρέφει κάθε ρύθμιση συνομιλίας: το widget, ο βοηθός, τα άτομα και οι ώρες λειτουργίας, τα αιτήματα υποστήριξης και το email, ο δείκτης του ιστότοπου, το απόρρητο και το spam. | Δωρεάν έκδοση | GET …/abilities/zinn-chat/get-settings/run | zinn_chat_manage | κανένα |
zinn-chat/get-statszinn-chat-get-stats | Ανάγνωση στατιστικών υποστήριξης (Pro) Επιστρέφει αριθμούς συνομιλιών και εισιτηρίων, χρόνους απόκρισης και αξιολογήσεις για τις τελευταίες N ημέρες (days). | Έκδοση Pro | GET …/abilities/zinn-chat/get-stats/run | the REST route's own per-item permission check | κανένα |
zinn-chat/get-ticketzinn-chat-get-ticket | Ανάγνωση δελτίου Επιστρέφει ένα εισιτήριο με ολόκληρη τη συνομιλία του, την κατάσταση, την προτεραιότητα και τον υπεύθυνο ανάθεσης. | Δωρεάν έκδοση | GET …/abilities/zinn-chat/get-ticket/run | the REST route's own per-item permission check | id: string (απαιτούμενο) |
zinn-chat/hand-chat-to-assistantzinn-chat-hand-chat-to-assistant | Επιστροφή συνομιλίας στον βοηθό Επιστρέφει μια συνομιλία στον βοηθό τεχνητής νοημοσύνης, ο οποίος απαντά στον επισκέπτη από το περιεχόμενο του ιστότοπου. | Δωρεάν έκδοση | POST …/abilities/zinn-chat/hand-chat-to-assistant/run | the REST route's own per-item permission check | id: string (απαιτούμενο) |
zinn-chat/list-canned-replieszinn-chat-list-canned-replies | Λίστα αποθηκευμένων απαντήσεων (Pro) Παραθέτει τις αποθηκευμένες απαντήσεις που μπορούν να εισάγουν οι πράκτορες, μαζί με τις συντομεύσεις τους. | Έκδοση Pro | GET …/abilities/zinn-chat/list-canned-replies/run | the REST route's own per-item permission check | κανένα |
zinn-chat/list-chatszinn-chat-list-chats | Προβολή ενεργών συνομιλιών Παραθέτει τις συνομιλίες που βρίσκονται σε αναμονή, σε εξέλιξη και έχουν κλείσει πρόσφατα, μαζί με το ποιος διαχειρίζεται την κάθε μία. | Δωρεάν έκδοση | GET …/abilities/zinn-chat/list-chats/run | the REST route's own per-item permission check | κανένα |
zinn-chat/list-indexed-contentzinn-chat-list-indexed-content | Απαρίθμηση όσων γνωρίζει ο βοηθός Παραθέτει το περιεχόμενο από το οποίο απαντά ο βοηθός, με την κατάσταση ευρετηρίασής του, ανά σελίδα. | Δωρεάν έκδοση | GET …/abilities/zinn-chat/list-indexed-content/run | the REST route's own per-item permission check | κανένα |
zinn-chat/list-kb-gapszinn-chat-list-kb-gaps | Προβολή αναπάντητων ερωτήσεων (Pro) Παραθέτει τις ερωτήσεις που έθεσαν οι επισκέπτες και στις οποίες η βάση γνώσεων δεν μπόρεσε να απαντήσει. | Έκδοση Pro | GET …/abilities/zinn-chat/list-kb-gaps/run | the REST route's own per-item permission check | κανένα |
zinn-chat/list-ticketszinn-chat-list-tickets | Λίστα αιtημάτων Εμφανίζει τα εισιτήρια υποστήριξης, φιλτραρισμένα ανά κατάσταση ή αναζήτηση, μία σελίδα τη φορά. | Δωρεάν έκδοση | GET …/abilities/zinn-chat/list-tickets/run | the REST route's own per-item permission check | κανένα |
zinn-chat/reembed-contentzinn-chat-reembed-content | Επανόρθωση του ευρετηρίου αναζήτησης του βοηθού Δημιουργεί εκ νέου τα διανύσματα αναζήτησης για ένα στοιχείο (item_id) ή για τα πάντα (all: true) (μόνο για διαχειριστές). | Δωρεάν έκδοση | POST …/abilities/zinn-chat/reembed-content/run | the REST route's own per-item permission check | κανένα |
zinn-chat/reindex-contentzinn-chat-reindex-content | Επαναανάγνωση περιεχομένου στον βοηθό Διαβάζει ξανά ένα στοιχείο (item_id) ή τα πάντα (all: true) στο ευρετήριο του βοηθού (μόνο για διαχειριστές). | Δωρεάν έκδοση | POST …/abilities/zinn-chat/reindex-content/run | the REST route's own per-item permission check | κανένα |
zinn-chat/reply-chatzinn-chat-reply-chat | Απάντηση σε συνομιλία Στέλνει ένα μήνυμα στον επισκέπτη (text), ή προσθέτει μια εσωτερική σημείωση που βλέπουν μόνο οι πράκτορες (note: true). | Δωρεάν έκδοση | POST …/abilities/zinn-chat/reply-chat/run | the REST route's own per-item permission check | id: string (απαιτούμενο) |
zinn-chat/save-canned-replyzinn-chat-save-canned-reply | Αποθήκευση αποθηκευμένης απάντησης (Pro) Δημιουργεί ή αλλάζει μια αποθηκευμένη απάντηση (τίτλος, συντόμευση, κείμενο, τμήμα· αναγνωριστικό για αλλαγή μίας). | Έκδοση Pro | POST …/abilities/zinn-chat/save-canned-reply/run | the REST route's own per-item permission check | κανένα |
zinn-chat/save-kb-articlezinn-chat-save-kb-article | Συγγραφή άρθρου βοήθειας (Pro) Δημιουργεί ένα άρθρο βάσης γνώσεων ή τροποποιεί ένα (id): τίτλος, περιεχόμενο, απόσπασμα, κατηγορίες και κατάσταση (πρόχειρο ή δημοσίευση όταν επιτρέπεται η δημοσίευση). | Έκδοση 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 | Αναζήτηση στη βάση γνώσεων (Pro) Βρίσκει άρθρα βοήθειας για σύνδεση σε απάντηση (q: η αναζήτηση). | Έκδοση Pro | GET …/abilities/zinn-chat/search-kb/run | the REST route's own per-item permission check | κανένα |
zinn-chat/set-conversation-detailszinn-chat-set-conversation-details | Ορίστε το τμήμα και τις ετικέτες μιας συνομιλίας (Pro) Ορίζει το τμήμα και τις ετικέτες μιας συνομιλίας ή ενός δελτίου (kind: chat ή ticket· id). | Έκδοση Pro | POST …/abilities/zinn-chat/set-conversation-details/run | the REST route's own per-item permission check | κανένα |
zinn-chat/set-kb-gap-statuszinn-chat-set-kb-gap-status | Σήμανση αναπάντητων ερωτήσεων (Pro) Σημειώνει τις αναπάντητες ερωτήσεις ως ανοιχτές, προγραμματισμένες ή απορριφθείσες (ids, status). | Έκδοση Pro | POST …/abilities/zinn-chat/set-kb-gap-status/run | the REST route's own per-item permission check | κανένα |
zinn-chat/set-presencezinn-chat-set-presence | Ορισμός διαθεσιμότητας Ορίζει τον συνδεδεμένο πράκτορα ως διαθέσιμο ή μη διαθέσιμο για νέες συνομιλίες (away: true ή false). | Δωρεάν έκδοση | POST …/abilities/zinn-chat/set-presence/run | the REST route's own per-item permission check | κανένα |
zinn-chat/suggest-replyzinn-chat-suggest-reply | Σύνταξη απάντησης με τεχνητή νοημοσύνη (Pro) Συντάσσει μια απάντηση σε συνομιλία ή αίτημα υποστήριξης από το περιεχόμενο του ιστότοπου· τίποτα δεν αποστέλλεται. | Έκδοση Pro | POST …/abilities/zinn-chat/suggest-reply/run | the REST route's own per-item permission check | κανένα |
zinn-chat/summarise-conversationzinn-chat-summarise-conversation | Σύνοψη συνομιλίας με AI (Pro) Συνοψίζει μια συνομιλία ή ένα αίτημα υποστήριξης σε λίγες γραμμές. | Έκδοση Pro | POST …/abilities/zinn-chat/summarise-conversation/run | the REST route's own per-item permission check | κανένα |
zinn-chat/take-chatzinn-chat-take-chat | Ξεκινήστε μια συνομιλία Αναθέτει μια συνομιλία σε αναμονή στον συνδεδεμένο εκπρόσωπο, ώστε ο επισκέπτης να μιλήσει με κάποιο άτομο. | Δωρεάν έκδοση | POST …/abilities/zinn-chat/take-chat/run | the REST route's own per-item permission check | id: string (απαιτούμενο) |
zinn-chat/update-settingszinn-chat-update-settings | Αλλαγή ρυθμίσεων συνομιλίας Αλλάζει τις ρυθμίσεις που στέλνετε (ρυθμίσεις: κλειδί σε τιμή) και διατηρεί τις υπόλοιπες. Κάθε τιμή ελέγχεται ακριβώς όπως στην οθόνη ρυθμίσεων· το get-settings παραθέτει τα κλειδιά. | Δωρεάν έκδοση | POST …/abilities/zinn-chat/update-settings/run | zinn_chat_manage | settings: object (απαιτούμενο) |
zinn-chat/update-ticketzinn-chat-update-ticket | Αλλαγή αιtήματος Αλλάζει την κατάσταση, την προτεραιότητα ή τον υπεύθυνο ενός αιτήματος. | Δωρεάν έκδοση | POST …/abilities/zinn-chat/update-ticket/run | the REST route's own per-item permission check | id: string (απαιτούμενο) |