Gorgias Automation
Claude Code에서 직접 Gorgias 헬프데스크 운영을 자동화하세요. 지원 티켓을 생성, 업데이트 및 분류하고, 고객을 관리하며, 지원 팀을 구성할 수 있습니다. 모든 작업을 터미널을 떠나지 않고 처리할 수 있습니다.
툴킷 문서: composio.dev/toolkits/gorgias
설정
- Claude Code 설정에 URL이
https://rube.app/mcp인 Rube MCP 서버를 추가합니다. - 프롬프트가 표시되면 제공된 연결 링크를 통해 Gorgias 계정을 인증합니다.
- 자연어로 지원 워크플로 자동화를 시작합니다.
핵심 워크플로
1. 티켓 목록 조회 및 필터링
상태, 채널, 담당자, 날짜 범위 등으로 필터링하여 티켓을 검색합니다.
도구: GORGIAS_LIST_TICKETS
지난 7일 동안 이메일 채널을 통해 생성된 모든 열린 티켓을 나열해줘
주요 매개변수:
status-- 티켓 상태별 필터 (예: "open", "closed")channel-- 채널별 필터 (예: "email", "chat")assignee_user_id/assignee_team_id-- 담당 에이전트 또는 팀별 필터created_from/created_to-- ISO 날짜 범위 필터limit(최대 100) /offset-- 페이지네이션 컨트롤order_by/order_dir-- 정렬 옵션
2. 티켓 생성 및 업데이트
담당자, 우선순위, 상태 변경을 포함하여 새 티켓을 생성하거나 기존 티켓을 업데이트합니다.
도구: GORGIAS_CREATE_TICKET, GORGIAS_UPDATE_TICKET, GORGIAS_GET_TICKET
"주문 #9876이 배송되지 않음"이라는 제목으로 고객 12345의 누락된 주문에 대한 높은 우선순위 티켓을 생성해줘
GORGIAS_CREATE_TICKET은customer_id가 필요하며,subject,status,priority,channel,messages,tags를 허용합니다.GORGIAS_UPDATE_TICKET은ticket_id가 필요하며, 다른 모든 필드는 선택적 부분 업데이트입니다.GORGIAS_GET_TICKET은ticket_id로 전체 티켓 세부 정보를 검색합니다.
3. 티켓 태그 관리
분류, 라우팅 및 보고를 위해 티켓에 태그를 추가합니다.
도구: GORGIAS_ADD_TICKET_TAGS, GORGIAS_LIST_TICKET_TAGS
티켓 5678에 태그 101과 202를 추가하고, 해당 티켓의 모든 태그를 보여줘
GORGIAS_ADD_TICKET_TAGS는ticket_id와tag_ids(정수 배열)가 필요합니다.GORGIAS_LIST_TICKET_TAGS는 현재 태그를 검색하기 위해ticket_id가 필요합니다.
4. 고객 관리
새 고객을 생성하거나 중복된 고객 레코드를 병합합니다.
도구: GORGIAS_CREATE_CUSTOMER, GORGIAS_MERGE_CUSTOMERS, GORGIAS_LIST_CUSTOMERS
"Jane Doe"라는 이름의 새 고객을 이메일 [email protected] 및 전화 채널로 생성해줘
GORGIAS_CREATE_CUSTOMER는name이 필요하며,email,channels(type및value가 있는 배열),external_id,address,data를 허용합니다.GORGIAS_MERGE_CUSTOMERS는source_customer_id와target_customer_id가 필요합니다. 소스가 타겟으로 병합됩니다.GORGIAS_LIST_CUSTOMERS는 필터링 옵션으로 고객을 검색합니다.
5. 팀 및 계정 작업
팀 목록을 조회하고, 계정 정보를 검색하며, 티켓 사용자 정의 필드를 검사합니다.
도구: GORGIAS_LIST_TEAMS, GORGIAS_GET_TEAM, GORGIAS_GET_ACCOUNT, GORGIAS_LIST_TICKET_FIELD_VALUES
Gorgias 계정의 모든 지원 팀을 보여줘
GORGIAS_GET_ACCOUNT는 계정 수준의 지표 및 구성을 반환합니다.GORGIAS_LIST_TEAMS/GORGIAS_GET_TEAM은 팀 조회를 관리합니다.GORGIAS_LIST_TICKET_FIELD_VALUES는 지정된 티켓의 사용자 정의 필드 값을 반환합니다.
6. 활동 및 이벤트 추적
티켓 활동 및 고객 이벤트 기록을 모니터링합니다.
도구: GORGIAS_LIST_EVENTS
지원 큐 전체에서 어떤 활동이 있었는지 확인하기 위해 최근 이벤트를 나열해줘
GORGIAS_LIST_EVENTS는 필터링 옵션이 포함된 활동 타임라인을 제공합니다.
알려진 문제점
- 페이지네이션 필요:
GORGIAS_LIST_TICKETS는limit/offset페이지네이션을 사용합니다. 페이지를 반복해서 가져오지 않으면 오래된 티켓을 놓쳐 불완전한 데이터가 생성됩니다. - 필터 구체성:
GORGIAS_LIST_TICKETS에서 필터가 누락되거나 너무 광범위하면 내보내기가 과부하되거나 원하는 보고 기간이 누락될 수 있습니다. 시간 기반 쿼리에는 항상created_from/created_to를 설정하세요. - 사용자 정의 필드는 별도: 주요 비즈니스 KPI는 사용자 정의 필드에만 있을 수 있습니다. 이를 포함하려면
GORGIAS_LIST_TICKET_FIELD_VALUES를 명시적으로 쿼리해야 합니다. - 속도 제한:
GORGIAS_LIST_TICKETS및 관련 엔드포인트에 대한 대량 내보내기는 Gorgias 속도 제한에 도달할 수 있습니다. 백오프를 추가하고 마지막 오프셋에서 다시 시작하세요. - 인증 오류: 모든 Gorgias 도구에서 401/403 응답은 토큰 또는 권한 문제를 나타냅니다. 부분 데이터를 완전한 데이터 세트로 취급하지 마세요.
빠른 참조
| 도구 슬러그 | 설명 |
|---|---|
GORGIAS_LIST_TICKETS | 필터(상태, 채널, 날짜, 담당자)로 티켓 목록 조회 |
GORGIAS_GET_TICKET | 특정 티켓을 ID로 검색 |
GORGIAS_CREATE_TICKET | 새 티켓 생성 (customer_id 필요) |
GORGIAS_UPDATE_TICKET | 티켓 필드 업데이트 (ticket_id 필요) |
GORGIAS_ADD_TICKET_TAGS | 티켓에 태그 추가 |
GORGIAS_LIST_TICKET_TAGS | 티켓의 모든 태그 목록 조회 |
GORGIAS_LIST_TICKET_FIELD_VALUES | 티켓의 사용자 정의 필드 값 목록 조회 |
GORGIAS_CREATE_CUSTOMER | 새 고객 생성 (name 필요) |
GORGIAS_MERGE_CUSTOMERS | 두 고객 레코드 병합 |
GORGIAS_LIST_CUSTOMERS | 필터로 고객 목록 조회 |
GORGIAS_LIST_TEAMS | 모든 팀 목록 조회 |
GORGIAS_GET_TEAM | 특정 팀 검색 |
GORGIAS_GET_ACCOUNT | 계정 정보 검색 |
GORGIAS_LIST_EVENTS | 필터로 활동 이벤트 목록 조회 |
Composio 제공