Desarrolladores
Referencia de funciones de Zinn® Chat
Zinn® Chat registra sus acciones en la WordPress Abilities API. Las mismas capacidades son herramientas MCP en el propio servidor del sitio y rutas REST bajo /wp-json/wp-abilities/v1. Esta página se genera a partir del propio registro del plugin.
Endpoints
MCP sobre HTTP (transmisible)
https://example.com/wp-json/zinn-chat/v1/mcpMCP sobre WP-CLI (entrada y salida estándar)
wp mcp-adapter serve --server=zinn-chat --user=<login>REST: listar las habilidades
/wp-json/wp-abilities/v1/abilities?category=zinn-chatREST: ejecutar una habilidad
/wp-json/wp-abilities/v1/abilities/<name>/runAutenticación y permisos
Las solicitudes HTTP se autentican con una contraseña de aplicación de WordPress (HTTP Basic). Conectarse al servidor MCP requiere la capacidad que se muestra a continuación; cada función verifica luego su propio permiso, por objeto. Las funciones de solo lectura se ejecutan con GET y su entrada en la cadena de consulta; las demás con POST y un cuerpo JSON {"input": {…}}.
Ejemplos
# REST: ejecutar una habilidad
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":{}}}Todas las capacidades
Generado a partir del archivo abilities.json del plugin, que a su vez se genera a partir de un sitio en ejecución; una prueba falla cuando ambos no coinciden.
| Capacidad | Qué hace | Edición | RESTO | Permiso | Parámetros |
|---|---|---|---|---|---|
zinn-chat/answer-ticketzinn-chat-answer-ticket | Responder a un ticket Responde al cliente por correo electrónico (texto) o añade una nota interna (note: true); el estado cambia opcionalmente el estado del ticket. | Edición gratuita | POST …/abilities/zinn-chat/answer-ticket/run | the REST route's own per-item permission check | id: string (obligatorio) |
zinn-chat/ask-assistantzinn-chat-ask-assistant | Preguntar al asistente Hace una pregunta al asistente de inteligencia artificial del sitio y devuelve su respuesta con cada fuente que ha encontrado. | Edición gratuita | POST …/abilities/zinn-chat/ask-assistant/run | the REST route's own per-item permission check | Ninguno |
zinn-chat/bulk-update-ticketszinn-chat-bulk-update-tickets | Cambiar muchos tickets a la vez (Pro) Cambia el estado, la prioridad o el asignado de hasta 100 tickets (identificadores). Cada ticket pasa por las mismas comprobaciones que al cambiarlo individualmente; el resultado enumera cada uno. | Edición Pro | POST …/abilities/zinn-chat/bulk-update-tickets/run | zinn_chat_answer | ids: array (obligatorio), status: open|pending|solved|closed, priority: low|normal|high|urgent, assignee_id: integer |
zinn-chat/chat-to-ticketzinn-chat-chat-to-ticket | Convierte un chat en un ticket Abre un ticket desde un chat para que pueda responderse por correo electrónico (necesita la dirección de correo electrónico del visitante). | Edición gratuita | POST …/abilities/zinn-chat/chat-to-ticket/run | the REST route's own per-item permission check | id: string (obligatorio) |
zinn-chat/close-chatzinn-chat-close-chat | Cerrar un chat Finaliza un chat; el visitante aún puede solicitar la transcripción. | Edición gratuita | POST …/abilities/zinn-chat/close-chat/run | the REST route's own per-item permission check | id: string (obligatorio) |
zinn-chat/create-ticketzinn-chat-create-ticket | Abrir un ticket Abre un ticket en nombre de un cliente (su correo electrónico, un asunto y el primer mensaje). | Edición gratuita | POST …/abilities/zinn-chat/create-ticket/run | the REST route's own per-item permission check | Ninguno |
zinn-chat/delete-canned-replyzinn-chat-delete-canned-reply | Eliminar una respuesta guardada (Pro) Elimina una respuesta guardada. | Edición Pro | POST …/abilities/zinn-chat/delete-canned-reply/run | the REST route's own per-item permission check | id: string (obligatorio) |
zinn-chat/delete-ticketzinn-chat-delete-ticket | Eliminar ticket Elimina un ticket y su conversación de forma definitiva (solo para gestores). | Edición gratuita | POST …/abilities/zinn-chat/delete-ticket/run | the REST route's own per-item permission check | id: string (obligatorio) |
zinn-chat/draft-kb-articlezinn-chat-draft-kb-article | Redactar un artículo de ayuda a partir de un ticket (Pro) Redacta un borrador de artículo de la base de conocimientos a partir de un ticket resuelto; permanece como borrador hasta que una persona lo publica. | Edición Pro | POST …/abilities/zinn-chat/draft-kb-article/run | edit_posts (the REST route's own check) | Ninguno |
zinn-chat/draft-kb-from-gapszinn-chat-draft-kb-from-gaps | Redactar artículos de ayuda para preguntas sin respuesta (Pro) Escribe borradores de artículos para la base de conocimientos que responden a las preguntas seleccionadas (ids); estos permanecen como borradores. | Edición Pro | POST …/abilities/zinn-chat/draft-kb-from-gaps/run | edit_posts (the REST route's own check) | Ninguno |
zinn-chat/fill-canned-replyzinn-chat-fill-canned-reply | Rellenar una respuesta guardada (Pro) Devuelve el texto de una respuesta guardada con sus marcadores de posición rellenados para un chat o un ticket. | Edición Pro | POST …/abilities/zinn-chat/fill-canned-reply/run | the REST route's own per-item permission check | id: string (obligatorio) |
zinn-chat/get-chatzinn-chat-get-chat | Leer un chat Devuelve los mensajes de un chat y los detalles del visitante (after: solo los mensajes posteriores a este id). | Edición gratuita | GET …/abilities/zinn-chat/get-chat/run | the REST route's own per-item permission check | id: string (obligatorio) |
zinn-chat/get-overviewzinn-chat-get-overview | Leer el resumen de soporte Devuelve cuántos tickets hay en cada estado y cuántos chats están esperando a una persona (y sus mensajes no leídos), y si el chat, el asistente y los tickets están activados. | Edición gratuita | GET …/abilities/zinn-chat/get-overview/run | zinn_chat_answer | Ninguno |
zinn-chat/get-settingszinn-chat-get-settings | Leer la configuración del chat Devuelve todos los ajustes del chat: el widget, el asistente, las personas y el horario de apertura, los tickets y el correo electrónico, el índice del sitio, la privacidad y el spam. | Edición gratuita | GET …/abilities/zinn-chat/get-settings/run | zinn_chat_manage | Ninguno |
zinn-chat/get-statszinn-chat-get-stats | Leer estadísticas de soporte (Pro) Devuelve los números de chat y de ticket, los tiempos de respuesta y las valoraciones de los últimos N días (days). | Edición Pro | GET …/abilities/zinn-chat/get-stats/run | the REST route's own per-item permission check | Ninguno |
zinn-chat/get-ticketzinn-chat-get-ticket | Leer un ticket Devuelve un ticket con toda su conversación, estado, prioridad y persona asignada. | Edición gratuita | GET …/abilities/zinn-chat/get-ticket/run | the REST route's own per-item permission check | id: string (obligatorio) |
zinn-chat/hand-chat-to-assistantzinn-chat-hand-chat-to-assistant | Devolver una conversación al asistente Devuelve una charla al asistente de inteligencia artificial, que responde al visitante a partir del contenido del sitio. | Edición gratuita | POST …/abilities/zinn-chat/hand-chat-to-assistant/run | the REST route's own per-item permission check | id: string (obligatorio) |
zinn-chat/list-canned-replieszinn-chat-list-canned-replies | Mostrar respuestas guardadas (Pro) Muestra las respuestas guardadas que los agentes pueden insertar, junto con sus atajos. | Edición Pro | GET …/abilities/zinn-chat/list-canned-replies/run | the REST route's own per-item permission check | Ninguno |
zinn-chat/list-chatszinn-chat-list-chats | Listar chats en vivo Muestra las listas de chats en espera, en curso y cerrados recientemente, indicando quién gestiona cada uno. | Edición gratuita | GET …/abilities/zinn-chat/list-chats/run | the REST route's own per-item permission check | Ninguno |
zinn-chat/list-indexed-contentzinn-chat-list-indexed-content | Enumerar lo que el asistente sabe Muestra el contenido que utiliza el asistente para responder, con su estado de indexación, página por página. | Edición gratuita | GET …/abilities/zinn-chat/list-indexed-content/run | the REST route's own per-item permission check | Ninguno |
zinn-chat/list-kb-gapszinn-chat-list-kb-gaps | Listar preguntas sin responder (Pro) Muestra las preguntas hechas por los visitantes que la base de conocimientos no pudo responder. | Edición Pro | GET …/abilities/zinn-chat/list-kb-gaps/run | the REST route's own per-item permission check | Ninguno |
zinn-chat/list-ticketszinn-chat-list-tickets | Listar tickets Lista los tickets de soporte, filtrados por estado o por una búsqueda, página por página. | Edición gratuita | GET …/abilities/zinn-chat/list-tickets/run | the REST route's own per-item permission check | Ninguno |
zinn-chat/reembed-contentzinn-chat-reembed-content | Reconstruir el índice de búsqueda del asistente Reconstruye los vectores de búsqueda para un elemento (item_id) o para todo (all: true) (solo para administradores). | Edición gratuita | POST …/abilities/zinn-chat/reembed-content/run | the REST route's own per-item permission check | Ninguno |
zinn-chat/reindex-contentzinn-chat-reindex-content | Releer el contenido en el asistente Relee un elemento (item_id) o todo (all: true) en el índice del asistente (solo para administradores). | Edición gratuita | POST …/abilities/zinn-chat/reindex-content/run | the REST route's own per-item permission check | Ninguno |
zinn-chat/reply-chatzinn-chat-reply-chat | Responder en un chat Envía un mensaje al visitante (text) o añade una nota interna que solo los agentes ven (note: true). | Edición gratuita | POST …/abilities/zinn-chat/reply-chat/run | the REST route's own per-item permission check | id: string (obligatorio) |
zinn-chat/save-canned-replyzinn-chat-save-canned-reply | Guardar una respuesta guardada (Pro) Crea o modifica una respuesta guardada (título, atajo, cuerpo, departamento; id para modificar una). | Edición Pro | POST …/abilities/zinn-chat/save-canned-reply/run | the REST route's own per-item permission check | Ninguno |
zinn-chat/save-kb-articlezinn-chat-save-kb-article | Escribir un artículo de ayuda (Pro) Crea un artículo de la base de conocimiento o modifica uno (id): título, contenido, extracto, categorías y estado (borrador, o publicar cuando puedas publicar). | Edición 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 | Buscar en la base de conocimientos (Pro) Busca artículos de ayuda para enlazar en una respuesta (q: la búsqueda). | Edición Pro | GET …/abilities/zinn-chat/search-kb/run | the REST route's own per-item permission check | Ninguno |
zinn-chat/set-conversation-detailszinn-chat-set-conversation-details | Establecer el departamento y las etiquetas de una conversación (Pro) Establece el departamento y las etiquetas de un chat o ticket (tipo: chat o ticket; id). | Edición Pro | POST …/abilities/zinn-chat/set-conversation-details/run | the REST route's own per-item permission check | Ninguno |
zinn-chat/set-kb-gap-statuszinn-chat-set-kb-gap-status | Marcar preguntas sin responder (Pro) Marca las preguntas sin respuesta como abiertas, planificadas o descartadas (identificadores, estado). | Edición Pro | POST …/abilities/zinn-chat/set-kb-gap-status/run | the REST route's own per-item permission check | Ninguno |
zinn-chat/set-presencezinn-chat-set-presence | Establecer su disponibilidad Marca al agente conectado como disponible o ausente para nuevos chats (ausente: true o false). | Edición gratuita | POST …/abilities/zinn-chat/set-presence/run | the REST route's own per-item permission check | Ninguno |
zinn-chat/suggest-replyzinn-chat-suggest-reply | Redactar una respuesta con IA (Pro) Redacta una respuesta a un chat o ticket a partir del contenido del sitio; no se envía nada. | Edición Pro | POST …/abilities/zinn-chat/suggest-reply/run | the REST route's own per-item permission check | Ninguno |
zinn-chat/summarise-conversationzinn-chat-summarise-conversation | Resumir una conversación con IA (Pro) Resume un chat o ticket en pocas líneas. | Edición Pro | POST …/abilities/zinn-chat/summarise-conversation/run | the REST route's own per-item permission check | Ninguno |
zinn-chat/take-chatzinn-chat-take-chat | Iniciar un chat Asigna un chat en espera al agente conectado, para que el visitante hable con una persona. | Edición gratuita | POST …/abilities/zinn-chat/take-chat/run | the REST route's own per-item permission check | id: string (obligatorio) |
zinn-chat/update-settingszinn-chat-update-settings | Cambiar la configuración del chat Modifica la configuración que envías (configuración: clave a valor) y conserva el resto. Cada valor se comprueba exactamente igual que en la pantalla de configuración; get-settings enumera las claves. | Edición gratuita | POST …/abilities/zinn-chat/update-settings/run | zinn_chat_manage | settings: object (obligatorio) |
zinn-chat/update-ticketzinn-chat-update-ticket | Modificar un ticket Cambia el estado, la prioridad o el responsable de un ticket. | Edición gratuita | POST …/abilities/zinn-chat/update-ticket/run | the REST route's own per-item permission check | id: string (obligatorio) |