名称: Gorgias 自动化 描述: “自动化电子商务客户支持工作流程在 Gorgias 中——通过自然语言命令管理票证、客户、标签和团队。” 要求: mcp: - rube
Gorgias 自动化
直接从 Claude Code 自动化您的 Gorgias 帮助台操作。创建、更新和分类支持票证,管理客户,并组织您的支持团队——所有这些都无需离开终端。
工具包文档: composio.dev/toolkits/gorgias
设置
- 将 Rube MCP 服务器添加到您的 Claude Code 配置中,URL:
https://rube.app/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
为客户 12345 创建一个关于缺失订单的高优先级票证,主题为“订单 #9876 未交付”
GORGIAS_CREATE_TICKET需要customer_id;接受subject,status,priority,channel,messages,tagsGORGIAS_UPDATE_TICKET需要ticket_id;所有其他字段是可选的局部更新GORGIAS_GET_TICKET通过ticket_id检索完整票证详情
3. 管理票证标签
为票证添加标签以进行分类、路由和报告。
工具: GORGIAS_ADD_TICKET_TAGS, GORGIAS_LIST_TICKET_TAGS
将标签 101 和 202 添加到票证 5678,然后显示该票证上的所有标签
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”的新客户,电子邮件为 jane@example.com,电话渠道
GORGIAS_CREATE_CUSTOMER需要name;接受email,channels(带有type和value的数组),external_id,address,dataGORGIAS_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 提供支持