개발자

Zinn® Chat 기능 참조

Zinn® Chat은(는) WordPress Abilities API에 액션을 등록합니다. 동일한 어빌리티는 사이트 자체 서버의 MCP 도구이자 /wp-json/wp-abilities/v1 아래의 REST 라우트입니다. 이 페이지는 플러그인 자체 레지스트리에서 생성되었습니다.

사용자 가이드: AI 앱 연결하기

AI 어시스턴트가 플랫폼의 도구에 연결되자 환호하는 우리의 바이킹 Zinn®.

엔드포인트

HTTP 기반 MCP (스트리밍 가능)

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

WP-CLI를 통한 MCP(표준 입력 및 출력)

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

REST: 기능 목록 보기

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

REST: 능력 실행

/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-ticket
zinn-chat-answer-ticket
티켓 답변하기
이메일로 고객에게 회신하거나(text), 내부 메모를 추가하고(note: true); 상태를 선택적으로 변경할 수 있습니다.
무료 버전POST …/abilities/zinn-chat/answer-ticket/runthe REST route's own per-item permission checkid: string (필수)
zinn-chat/ask-assistant
zinn-chat-ask-assistant
어시스턴트에게 물어보기
사이트의 AI 어시스턴트에게 질문을 던지고 찾은 모든 출처와 함께 그 답변을 반환합니다.
무료 버전POST …/abilities/zinn-chat/ask-assistant/runthe REST route's own per-item permission checkquestion: string (필수), language: string
zinn-chat/bulk-update-tickets
zinn-chat-bulk-update-tickets
한 번에 여러 티켓 변경 (Pro)
최대 100개의 티켓(ID) 상태, 우선순위 또는 담당자를 변경합니다. 각 티켓은 개별적으로 변경할 때와 동일한 검사를 거치며, 결과는 각각의 항목을 나열합니다.
프로 에디션POST …/abilities/zinn-chat/bulk-update-tickets/runzinn_chat_answerids: array (필수), status: open|pending|solved|closed, priority: low|normal|high|urgent, assignee_id: integer
zinn-chat/chat-to-ticket
zinn-chat-chat-to-ticket
채팅을 티켓으로 전환하기
채팅에서 티켓을 생성하여 이메일로 답변할 수 있도록 합니다(방문자의 이메일 주소가 필요함).
무료 버전POST …/abilities/zinn-chat/chat-to-ticket/runthe REST route's own per-item permission checkid: string (필수)
zinn-chat/close-chat
zinn-chat-close-chat
채팅 닫기
채팅을 종료합니다. 방문자는 여전히 대화 기록을 요청할 수 있습니다.
무료 버전POST …/abilities/zinn-chat/close-chat/runthe REST route's own per-item permission checkid: string (필수)
zinn-chat/create-ticket
zinn-chat-create-ticket
티켓 열기
고객을 대신하여 티켓을 엽니다(고객의 이메일, 제목, 첫 번째 메시지).
무료 버전POST …/abilities/zinn-chat/create-ticket/runthe REST route's own per-item permission checkemail: string (필수), subject: string (필수), body: string (필수), name: string
zinn-chat/delete-canned-reply
zinn-chat-delete-canned-reply
저장된 답변 삭제 (Pro)
저장된 회신을 삭제합니다.
프로 에디션POST …/abilities/zinn-chat/delete-canned-reply/runthe REST route's own per-item permission checkid: string (필수)
zinn-chat/delete-ticket
zinn-chat-delete-ticket
티켓 삭제
티켓과 해당 대화를 영구적으로 삭제합니다(관리자 전용).
무료 버전POST …/abilities/zinn-chat/delete-ticket/runthe REST route's own per-item permission checkid: string (필수)
zinn-chat/draft-kb-article
zinn-chat-draft-kb-article
지원 티켓에서 도움말 문서 초안 작성 (Pro)
해결된 티켓을 바탕으로 지식베이스 초안 아티클을 작성합니다. 사람이 발행하기 전까지는 초안 상태로 유지됩니다.
프로 에디션POST …/abilities/zinn-chat/draft-kb-article/runedit_posts (the REST route's own check)ticket: integer (필수)
zinn-chat/draft-kb-from-gaps
zinn-chat-draft-kb-from-gaps
미답변 질문에 대한 도움말 문서 초안 작성 (Pro)
선택한 질문(ID)에 답변하는 지식 베이스 초안 문서를 작성합니다. 초안 상태로 유지됩니다.
프로 에디션POST …/abilities/zinn-chat/draft-kb-from-gaps/runedit_posts (the REST route's own check)ids: array (필수)
zinn-chat/fill-canned-reply
zinn-chat-fill-canned-reply
저장된 답변 채우기 (Pro)
하나의 채팅 또는 티켓에 대해 저장된 답변의 텍스트에 자리표시자가 채워진 상태로 반환합니다.
프로 에디션POST …/abilities/zinn-chat/fill-canned-reply/runthe REST route's own per-item permission checkid: string (필수)
zinn-chat/get-chat
zinn-chat-get-chat
채팅 읽기
하나의 채팅 메시지와 방문자 세부 정보를 반환합니다(after: 이 ID보다 최신 메시지만 해당).
무료 버전GET …/abilities/zinn-chat/get-chat/runthe REST route's own per-item permission checkid: string (필수)
zinn-chat/get-overview
zinn-chat-get-overview
지원 개요 읽기
각 상태별 티켓 수, 상담원을 기다리는 채팅 수(및 읽지 않은 메시지 수), 그리고 채팅, 어시스턴트, 티켓 기능의 활성화 여부를 반환합니다.
무료 버전GET …/abilities/zinn-chat/get-overview/runzinn_chat_answer없음
zinn-chat/get-settings
zinn-chat-get-settings
채팅 설정 읽기
모든 채팅 설정(위젯, 어시스턴트, 담당자 및 운영 시간, 티켓 및 이메일, 사이트 색인, 개인정보 보호 및 스팸)을 반환합니다.
무료 버전GET …/abilities/zinn-chat/get-settings/runzinn_chat_manage없음
zinn-chat/get-stats
zinn-chat-get-stats
지원 통계 읽기 (Pro)
최근 N일(일) 동안의 채팅 및 티켓 수, 응답 시간, 평점을 반환합니다.
프로 에디션GET …/abilities/zinn-chat/get-stats/runthe REST route's own per-item permission checkdays: integer
zinn-chat/get-ticket
zinn-chat-get-ticket
티켓 읽기
티켓 하나의 전체 대화, 상태, 우선순위, 담당자를 반환합니다.
무료 버전GET …/abilities/zinn-chat/get-ticket/runthe REST route's own per-item permission checkid: string (필수)
zinn-chat/hand-chat-to-assistant
zinn-chat-hand-chat-to-assistant
어시스턴트에게 채팅 돌려주기
사이트의 콘텐츠를 바탕으로 방문자의 질문에 답변하는 AI 어시스턴트에 채팅을 반환합니다.
무료 버전POST …/abilities/zinn-chat/hand-chat-to-assistant/runthe REST route's own per-item permission checkid: string (필수)
zinn-chat/list-canned-replies
zinn-chat-list-canned-replies
저장된 답변 목록 (Pro)
상담원이 삽입할 수 있는 저장된 답변을 단축키와 함께 나열합니다.
프로 에디션GET …/abilities/zinn-chat/list-canned-replies/runthe REST route's own per-item permission check없음
zinn-chat/list-chats
zinn-chat-list-chats
실시간 채팅 목록 표시
대기 중, 진행 중, 최근 종료된 채팅과 각각을 담당하는 상담원을 표시합니다.
무료 버전GET …/abilities/zinn-chat/list-chats/runthe REST route's own per-item permission checkview: active|bot|closed|all
zinn-chat/list-indexed-content
zinn-chat-list-indexed-content
어시스턴트가 아는 내용 나열하기
어시스턴트가 답변하는 콘텐츠를 인덱싱 상태와 함께 한 페이지씩 나열합니다.
무료 버전GET …/abilities/zinn-chat/list-indexed-content/runthe REST route's own per-item permission checksearch: string, status: indexed|pending|error, page: integer
zinn-chat/list-kb-gaps
zinn-chat-list-kb-gaps
답변되지 않은 질문 목록 (Pro)
지식 베이스가 답변하지 못한 방문자의 질문 목록을 표시합니다.
프로 에디션GET …/abilities/zinn-chat/list-kb-gaps/runthe REST route's own per-item permission checkstatus: open|drafted|answered|ignored|all, page: integer
zinn-chat/list-tickets
zinn-chat-list-tickets
티켓 목록
상태 또는 검색어로 필터링된 지원 티켓을 한 번에 한 페이지씩 나열합니다.
무료 버전GET …/abilities/zinn-chat/list-tickets/runthe REST route's own per-item permission checkstatus: active|open|pending|solved|closed|all, search: string, page: integer
zinn-chat/reembed-content
zinn-chat-reembed-content
어시스턴트의 검색 색인 재구축하기
단일 항목(item_id) 또는 전체 항목(all: true)에 대한 검색 벡터를 재생성합니다(관리자 전용).
무료 버전POST …/abilities/zinn-chat/reembed-content/runthe REST route's own per-item permission checkall: boolean, item_id: integer
zinn-chat/reindex-content
zinn-chat-reindex-content
어시스턴트에 콘텐츠 다시 읽히기
어시스턴트의 색인에 하나의 항목(item_id) 또는 전체 항목(all: true)을 다시 읽어 들입니다(관리자 전용).
무료 버전POST …/abilities/zinn-chat/reindex-content/runthe REST route's own per-item permission checkall: boolean, item_id: integer
zinn-chat/reply-chat
zinn-chat-reply-chat
채팅으로 답장하기
방문자에게 메시지를 보내거나(text), 상담원만 볼 수 있는 내부 메모를 추가합니다(note: true).
무료 버전POST …/abilities/zinn-chat/reply-chat/runthe REST route's own per-item permission checkid: string (필수)
zinn-chat/save-canned-reply
zinn-chat-save-canned-reply
저장된 답변 저장 (Pro)
저장된 답변을 생성하거나 변경합니다(제목, 바로 가기, 본문, 부서; 변경할 ID).
프로 에디션POST …/abilities/zinn-chat/save-canned-reply/runthe REST route's own per-item permission checkid: integer, title: string (필수), body: string (필수), shortcut: string, department: string
zinn-chat/save-kb-article
zinn-chat-save-kb-article
도움말 문서 작성 (Pro)
지식 베이스 문서를 생성하거나 수정합니다(id): 제목, 본문, 요약, 카테고리 및 상태(초안, 또는 게시할 수 있는 경우 게시).
프로 에디션POST …/abilities/zinn-chat/save-kb-article/runedit_postsid: integer, title: string, content: string, excerpt: string, categories: array, status: draft|publish
zinn-chat/search-kb
zinn-chat-search-kb
지식 베이스 검색(Pro)
답변에 연결할 도움말 문서를 찾습니다 (q: 검색어).
프로 에디션GET …/abilities/zinn-chat/search-kb/runthe REST route's own per-item permission checkq: string (필수)
zinn-chat/set-conversation-details
zinn-chat-set-conversation-details
대화 부서 및 태그 설정 (Pro)
채팅 또는 티켓의 부서 및 태그를 설정합니다(종류: 채팅 또는 티켓; ID).
프로 에디션POST …/abilities/zinn-chat/set-conversation-details/runthe REST route's own per-item permission checkkind: ticket|chat, id: integer (필수), department: string, tags: array
zinn-chat/set-kb-gap-status
zinn-chat-set-kb-gap-status
답변되지 않은 질문 표시 (Pro)
답변되지 않은 질문을 열림, 계획됨 또는 기각됨으로 표시합니다(ID, 상태).
프로 에디션POST …/abilities/zinn-chat/set-kb-gap-status/runthe REST route's own per-item permission checkids: array (필수), status: open|drafted|answered|ignored (필수)
zinn-chat/set-presence
zinn-chat-set-presence
예약 가능 여부 설정
로그인된 상담원을 새 채팅에 대해 가능 또는 자리 비움 상태로 표시합니다(자리 비움: true 또는 false).
무료 버전POST …/abilities/zinn-chat/set-presence/runthe REST route's own per-item permission checkaway: boolean
zinn-chat/suggest-reply
zinn-chat-suggest-reply
AI로 답글 초안 작성 (Pro)
사이트 콘텐츠를 바탕으로 채팅이나 티켓에 대한 답변 초안을 작성하지만, 전송되지는 않습니다.
프로 에디션POST …/abilities/zinn-chat/suggest-reply/runthe REST route's own per-item permission checkkind: ticket|chat, id: integer (필수)
zinn-chat/summarise-conversation
zinn-chat-summarise-conversation
AI와 대화 요약하기 (Pro)
채팅이나 티켓을 몇 줄로 요약합니다.
프로 에디션POST …/abilities/zinn-chat/summarise-conversation/runthe REST route's own per-item permission checkkind: ticket|chat, id: integer (필수)
zinn-chat/take-chat
zinn-chat-take-chat
채팅하기
로그인한 상담원에게 대기 중인 채팅을 할당하여 방문자가 상담원과 대화할 수 있도록 합니다.
무료 버전POST …/abilities/zinn-chat/take-chat/runthe REST route's own per-item permission checkid: string (필수)
zinn-chat/update-settings
zinn-chat-update-settings
채팅 설정 변경
보내는 설정(설정: 키-값)을 변경하고 나머지는 유지합니다. 각 값은 설정 화면과 정확히 동일하게 확인되며, get-settings로 키를 나열할 수 있습니다.
무료 버전POST …/abilities/zinn-chat/update-settings/runzinn_chat_managesettings: object (필수)
zinn-chat/update-ticket
zinn-chat-update-ticket
티켓 변경
티켓의 상태, 우선순위 또는 담당자를 변경합니다.
무료 버전POST …/abilities/zinn-chat/update-ticket/runthe REST route's own per-item permission checkid: string (필수)

작업 및 필터

플러그인이 제공하는 모든 훅과 소스 코드의 설명입니다. 필터는 값을 변경하고, 액션은 특정 시점에 코드를 실행할 수 있게 하며, 진입점은 플러그인에 작업을 요청하기 위해 실행하는 액션입니다.

웹훅종류기능매개변수에디션
zinn_chat_admin_pages필터Zinn® Chat 관리자 화면을 필터링합니다(Pro는 자체 화면을 추가함).없음무료 버전
zinn_chat_agent_chat필터상담원 콘솔의 채팅 페이로드를 필터링합니다(Pro 요금제에서는 방문자 세부 정보, 메모, KB 제안이 추가됨).없음무료 버전
zinn_chat_agent_pages필터지원 상담원 계정이 열 수 있는 Zinn® Chat 화면을 필터링합니다.없음프로 에디션
zinn_chat_agent_script_src필터독립형 AI 채팅 에이전트가 로드되는 URL을 필터링합니다.string $src무료 버전
zinn_chat_agent_ticket필터wp-admin용 티켓 페이로드를 필터링합니다(Pro 버전에는 상용구 답변, SLA, KB 제안 기능이 추가됨).없음무료 버전
zinn_chat_answer필터어시스턴트의 답변이 표시되기 전에 필터링합니다(Pro 버전은 여기에 추가 기능을 더합니다).string $question무료 버전
zinn_chat_assistant_answered작업어시스턴트가 방문자의 질문에 답변했습니다.int $id, string $text무료 버전
zinn_chat_challenge필터방문자에게 표시되는 휴먼 체크를 필터링합니다(스크립트 URL, 사이트 키, 그리고 스크립트가 `render( element, { sitekey, callback } )` 메서드로 정의하는 전역 객체).없음무료 버전
zinn_chat_challenge_ok필터방문자가 사람 인증을 통과했는지 여부를 필터링합니다. 확인할 수 없는 인증은 거짓을 반환해야 합니다(fail closed). 서비스에 연결할 수 없을 때마다 모든 것을 통과시키는 양식은 봇이 타이밍을 통해 성공시킬 수 있는 양식입니다.bool $ok, string $ip, string $where무료 버전
zinn_chat_client_ip필터요청 제한 및 기록에 사용되는 방문자 IP 주소를 필터링합니다.string $ip무료 버전
zinn_chat_console_config필터운영자 콘솔 스크립트에 전달되는 추가 구성을 필터링합니다. Zinn® Chat Pro가 여기에 기능을 추가합니다.없음무료 버전
zinn_chat_conversation_started작업방문자가 채팅을 시작했습니다.int $id무료 버전
zinn_chat_conversation_status작업대화 상태가 변경되었습니다.int $id, string $status, string $old무료 버전
zinn_chat_customer_ticket_url필터고객의 티켓으로 발송되는 링크를 필터링합니다.string $url무료 버전
zinn_chat_elements필터블록 및 빌더 모듈로 제공되는 프론트엔드 요소를 필터링합니다.없음무료 버전
zinn_chat_email필터이메일이 전송되기 전에 필터링합니다. 중단하려면 빈 `to`를 반환하세요.없음무료 버전
zinn_chat_fs_loaded작업라이선싱 SDK가 로드되면(기본 파일에서, 모든 Zinn® Chat 코드 이전에) 실행됩니다. `zinn_chat_fs()`와 통신하려면 여기에 연결하세요.없음무료 버전
zinn_chat_index_extract필터추출된 객체를 필터링하거나(또는 커스텀 객체 유형에 하나를 제공합니다).string $type, int $id무료 버전
zinn_chat_index_language필터인덱싱된 게시물의 언어(로캘)를 필터링합니다.string $language, \WP_Post $post무료 버전
zinn_chat_index_object진입 지점(직접 실행)후속 작업없음무료 버전
zinn_chat_index_post_types필터어시스턴트가 읽을 포스트 형식을 필터링합니다.없음무료 버전
zinn_chat_indexable필터게시물이 색인되는지 여부를 필터링합니다.bool $indexable, \WP_Post $post무료 버전
zinn_chat_indexed작업개체가 색인되었습니다(다시 색인됨).string $type, int $id무료 버전
zinn_chat_is_pro필터Pro 기능이 실행되는지 여부(Freemius를 통한 구매한 라이선스 또는 체험판)를 필터링합니다. Pro 코드는 프리미엄 패키지에만 포함되어 있으므로, 무료 버전에서 부족한 부분을 이것으로 추가할 수는 없습니다.bool $pro무료 버전
zinn_chat_loaded작업Zinn® Chat이 로드되었습니다 (추가 기능을 위한 확장 지점).없음무료 버전
zinn_chat_message_added작업대화에 메시지가 추가되었습니다.int $id, int $conversation_id, string $role무료 버전
zinn_chat_order_tracking필터주문과 관련하여 어시스턴트에 제공되는 추적 정보를 필터링합니다.\WC_Order $order무료 버전
zinn_chat_pro_alert작업경보를 울릴 만한 이벤트가 발생했습니다(푸시 알림이 여기에서 수신 대기합니다).string $alert, int $id, string $text, string $link프로 에디션
zinn_chat_pro_assigned작업상담원에게 티켓이 자동으로 할당되었습니다.int $id, int $agent프로 에디션
zinn_chat_pro_loaded작업Pro 레이어가 로드되었습니다.없음프로 에디션
zinn_chat_pro_priority_changed작업티켓의 우선순위가 변경되었습니다(SLA 목표가 이에 따릅니다).int $id프로 에디션
zinn_chat_pro_sla_breach작업SLA 목표를 달성하지 못했습니다.int $ticket_id, string $which프로 에디션
zinn_chat_pro_ticket_rated작업고객이 해결된 티켓을 평가했습니다 (1-5).int $id, int $score프로 에디션
zinn_chat_rated작업방문자가 대화에 평점을 매긴 후 발생하며, 대화 ID와 평점(도움이 됨은 1, 아니요는 -1)이 함께 전달됩니다.int $conversation_id, int $rating무료 버전
zinn_chat_role_capabilities필터어떤 역할이 Zinn® Chat 기능을 사용할 수 있는지 필터링합니다.없음무료 버전
zinn_chat_save_settings필터저장되기 전에 필터 설정을 지정합니다 (Pro 버전은 여기에 고유한 키를 추가합니다).없음무료 버전
zinn_chat_script_src필터호스팅된 채팅 위젯이 로드되는 URL을 필터링합니다(연결된 모드).string $src무료 버전
zinn_chat_settings_before작업설정 탭 양식 위에 표시됩니다.string $tab무료 버전
zinn_chat_settings_fields필터설정 탭의 필드를 필터링합니다(Pro 버전은 자체 필드를 추가함).string $tab무료 버전
zinn_chat_settings_tabs필터설정 탭을 필터링합니다.없음무료 버전
zinn_chat_setup_after작업설정 검토 목록 아래에 출력됩니다 (무료 에디션에서는 여기에 프로 카드가 표시됩니다).없음무료 버전
zinn_chat_should_render필터이 요청에 채팅이 렌더링될지 여부를 필터링합니다(Pro의 페이지 타겟팅 훅이 여기에 연결됩니다).bool $render무료 버전
zinn_chat_site_facts필터질문마다 어시스턴트에게 제공되는 사이트 관련 정보를 필터링합니다. 각 항목은 `title`, `url`(이 사이트 내), `text`(일반 텍스트, 최대 3,000자)로 구성되며, 최대 4개까지 사용됩니다.string $language무료 버전
zinn_chat_site_strings필터번역용으로 제공된 소유자 텍스트를 필터링합니다(Pro는 사전 예방적 메시지를 추가함).없음무료 버전
zinn_chat_system_prompt필터어시스턴트의 시스템 프롬프트를 필터링합니다(Pro: 페르소나 및 핸드오프 규칙).string $rules무료 버전
zinn_chat_team_online필터사람이 지금 답변할 수 있는지 여부를 필터링합니다(Pro 버전에서는 여기에 영업시간이 추가됩니다).bool $online무료 버전
zinn_chat_ticket_assigned작업An agent assigned a ticket to an agent (2.14.0: the notification centre tells them).int $id, int $assignee, int $by무료 버전
zinn_chat_ticket_created작업티켓이 접수되었습니다. 메일러가 여기서 확인 메시지와 팀 알림을 발송합니다.int $id, string $token무료 버전
zinn_chat_ticket_form_extra필터게스트 티켓 양식 끝의 추가 마크업을 필터링합니다(프로의 인간 확인 기능이 여기에 들어갑니다).string $html무료 버전
zinn_chat_ticket_form_fields필터모든 티켓 양식의 메시지 위에 표시되는 추가 필드를 필터링합니다(Pro: 부서 선택). 이름을 `zinn_chat_extra[<key>]`로 지정하세요. 해당 필드는 추가한 사람이 검증할 수 있도록 정제되지 않은 상태로 `$fields['extra']`로 `zinn_chat_ticket_created`에 전달됩니다.string $html무료 버전
zinn_chat_ticket_reply작업티켓에 답변이 추가되었습니다. 메일러가 여기서 상대방에게 이메일을 보냅니다.int $id, int $ticket_id, string $author무료 버전
zinn_chat_ticket_status작업티켓의 상태가 변경되었습니다.int $id, string $status, string $old무료 버전
zinn_chat_uninstall작업Zinn® Chat 제거 중입니다(Pro는 여기에서 자체 데이터를 삭제합니다).없음무료 버전
zinn_chat_widget_config필터페이지에 출력되는 런처 설정을 필터링합니다.없음무료 버전
zinn_chat_widget_status필터열린 채팅이 수신하는 내용을 필터링합니다(Pro 버전은 자체 스위치와 단어를 추가함).없음무료 버전