개발자
Zinn® Chat 기능 참조
Zinn® Chat은(는) WordPress Abilities API에 액션을 등록합니다. 동일한 어빌리티는 사이트 자체 서버의 MCP 도구이자 /wp-json/wp-abilities/v1 아래의 REST 라우트입니다. 이 페이지는 플러그인 자체 레지스트리에서 생성되었습니다.
엔드포인트
HTTP 기반 MCP (스트리밍 가능)
https://example.com/wp-json/zinn-chat/v1/mcpWP-CLI를 통한 MCP(표준 입력 및 출력)
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 기본 인증)를 사용하여 인증됩니다. 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 | 티켓 답변하기 이메일(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 | 어시스턴트에게 물어보기 사이트의 AI 어시스턴트에게 질문하고 찾은 모든 출처와 함께 그 답변을 반환합니다. | 무료 버전 | 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개의 티켓(ID) 상태, 우선순위 또는 담당자를 변경합니다. 각 티켓은 개별적으로 변경할 때와 동일한 검사를 거치며, 결과는 각 항목을 나열합니다. | 프로 에디션 | 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 | 채팅을 티켓으로 전환하기 채팅에서 티켓을 열어 이메일로 답변할 수 있도록 합니다(방문자의 이메일 주소가 필요함). | 무료 버전 | 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 | 티켓 열기 고객의 대리하여 티켓을 엽니다(고객의 이메일, 제목 및 첫 번째 메시지 포함). | 무료 버전 | 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) 저장된 답변을 삭제합니다. | 프로 에디션 | 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) 해결된 티켓을 바탕으로 지식베이스 초안 아티클을 작성합니다. 사람이 발행하기 전까지는 초안 상태로 유지됩니다. | 프로 에디션 | 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) 선택된 질문(id)에 대한 지식 베이스 초안 문서를 작성합니다. 초안 상태로 유지됩니다. | 프로 에디션 | 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) 하나의 채팅 또는 티켓에 대해 저장된 답변의 텍스트에 자리표시자가 채워진 상태로 반환합니다. | 프로 에디션 | 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: 이 ID보다 최신 메시지만 해당). | 무료 버전 | 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 | 지원 개요 읽기 각 상태별 티켓 수, 상담원을 기다리는 채팅 수(및 읽지 않은 메시지 수), 그리고 채팅, 어시스턴트, 티켓 기능의 활성화 여부를 반환합니다. | 무료 버전 | GET …/abilities/zinn-chat/get-overview/run | zinn_chat_answer | 없음 |
zinn-chat/get-settingszinn-chat-get-settings | 채팅 설정 읽기 모든 채팅 설정(위젯, 어시스턴트, 담당자와 운영 시간, 티켓과 이메일, 사이트 색인, 개인정보 보호 및 스팸)을 반환합니다. | 무료 버전 | GET …/abilities/zinn-chat/get-settings/run | zinn_chat_manage | 없음 |
zinn-chat/get-statszinn-chat-get-stats | 지원 통계 읽기 (Pro) 최근 N일간(days)의 채팅 및 티켓 수, 응답 시간, 평점을 반환합니다. | 프로 에디션 | 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 | 챗봇에게 대화 다시 넘기기 사이트 콘텐츠를 바탕으로 방문자의 질문에 답변하는 AI 어시스턴트에 채팅을 반환합니다. | 무료 버전 | 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) 상담원이 삽입할 수 있는 저장된 답변과 단축키를 나열합니다. | 프로 에디션 | 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) 지식 베이스가 답변하지 못한 방문자의 질문 목록을 표시합니다. | 프로 에디션 | GET …/abilities/zinn-chat/list-kb-gaps/run | the REST route's own per-item permission check | 없음 |
zinn-chat/list-ticketszinn-chat-list-tickets | 티켓 목록 상태 또는 검색어로 필터링된 지원 티켓을 한 번에 한 페이지씩 나열합니다. | 무료 버전 | 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) 저장된 답변을 생성하거나 변경합니다(제목, 단축키, 본문, 부서; 변경할 경우 id). | 프로 에디션 | 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): 제목, 본문, 요약, 카테고리 및 상태(초안, 또는 발행 가능한 경우 발행). | 프로 에디션 | 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: 검색어). | 프로 에디션 | 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) 채팅 또는 티켓의 부서 및 태그를 설정합니다(종류: 채팅 또는 티켓; ID). | 프로 에디션 | 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) 답변되지 않은 질문을 미해결, 예정 또는 기각됨으로 표시합니다(ID, 상태). | 프로 에디션 | 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 | 가용성 설정 새 채팅에 대해 로그인한 상담원의 상태를 가능 또는 자리 비움으로 표시합니다(자리 비움: 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 | AI로 답글 초안 작성 (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) 채팅이나 티켓을 몇 줄로 요약합니다. | 프로 에디션 | 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 | 문의 변경 티켓의 상태, 우선순위 또는 담당자를 변경합니다. | 무료 버전 | POST …/abilities/zinn-chat/update-ticket/run | the REST route's own per-item permission check | id: string (필수) |