AGENT SKILL

Gorgias Automation

Automate e-commerce customer support workflows in Gorgias -- manage tickets, customers, tags, and teams through natural language commands.

License 许可
MIT
最近更新
2026-10-22
Stars
★ 0
Forks
0

01 前言 Front Matter

name
Gorgias Automation
requires
{ "mcp": [ "rube" ] }
description
Automate e-commerce customer support workflows in Gorgias -- manage tickets, customers, tags, and teams through natural language commands.

03 SKILL.md 正文

Gorgias Automation

Automate your Gorgias helpdesk operations directly from Claude Code. Create, update, and triage support tickets, manage customers, and organize your support team -- all without leaving your terminal.

Toolkit docs: composio.dev/toolkits/gorgias


Setup

  1. Add the Rube MCP server to your Claude Code config with URL: https://rube.app/mcp
  2. When prompted, authenticate your Gorgias account through the connection link provided
  3. Start automating your support workflows with natural language

Core Workflows

1. List and Filter Tickets

Retrieve tickets with filtering by status, channel, assignee, date range, and more.

Tool: GORGIAS_LIST_TICKETS

List all open tickets from the email channel created in the last 7 days

Key parameters:

  • status -- filter by ticket status (e.g., "open", "closed")
  • channel -- filter by channel (e.g., "email", "chat")
  • assignee_user_id / assignee_team_id -- filter by assigned agent or team
  • created_from / created_to -- ISO date range filters
  • limit (max 100) / offset -- pagination controls
  • order_by / order_dir -- sorting options

2. Create and Update Tickets

Create new tickets or update existing ones with assignment, priority, and status changes.

Tools: GORGIAS_CREATE_TICKET, GORGIAS_UPDATE_TICKET, GORGIAS_GET_TICKET

Create a high-priority ticket for customer 12345 about a missing order with subject "Order #9876 not delivered"
  • GORGIAS_CREATE_TICKET requires customer_id; accepts subject, status, priority, channel, messages, tags
  • GORGIAS_UPDATE_TICKET requires ticket_id; all other fields are optional partial updates
  • GORGIAS_GET_TICKET retrieves full ticket details by ticket_id

3. Manage Ticket Tags

Add tags to tickets for categorization, routing, and reporting.

Tools: GORGIAS_ADD_TICKET_TAGS, GORGIAS_LIST_TICKET_TAGS

Add tags 101 and 202 to ticket 5678, then show me all tags on that ticket
  • GORGIAS_ADD_TICKET_TAGS requires ticket_id and tag_ids (array of integers)
  • GORGIAS_LIST_TICKET_TAGS requires ticket_id to retrieve current tags

4. Customer Management

Create new customers or merge duplicate customer records.

Tools: GORGIAS_CREATE_CUSTOMER, GORGIAS_MERGE_CUSTOMERS, GORGIAS_LIST_CUSTOMERS

Create a new customer named "Jane Doe" with email jane@example.com and phone channel
  • GORGIAS_CREATE_CUSTOMER requires name; accepts email, channels (array with type and value), external_id, address, data
  • GORGIAS_MERGE_CUSTOMERS requires source_customer_id and target_customer_id -- source is merged into target
  • GORGIAS_LIST_CUSTOMERS retrieves customers with filtering options

5. Team and Account Operations

List teams, retrieve account info, and inspect ticket custom fields.

Tools: GORGIAS_LIST_TEAMS, GORGIAS_GET_TEAM, GORGIAS_GET_ACCOUNT, GORGIAS_LIST_TICKET_FIELD_VALUES

Show me all support teams in our Gorgias account
  • GORGIAS_GET_ACCOUNT returns account-level metrics and configuration
  • GORGIAS_LIST_TEAMS / GORGIAS_GET_TEAM manage team lookup
  • GORGIAS_LIST_TICKET_FIELD_VALUES returns custom field values for a given ticket

6. Activity and Event Tracking

Monitor ticket activity and customer event history.

Tools: GORGIAS_LIST_EVENTS

List recent events to see what activity has happened across our support queue
  • GORGIAS_LIST_EVENTS provides an activity timeline with filtering options

Known Pitfalls

  • Pagination required: GORGIAS_LIST_TICKETS uses limit/offset pagination. Failing to loop through pages will miss older tickets and produce incomplete data.
  • Filter specificity: Missing or overly broad filters on GORGIAS_LIST_TICKETS can overload the export or omit the desired reporting window. Always set created_from/created_to for time-bound queries.
  • Custom fields are separate: Key business KPIs may only exist in custom fields. You must query GORGIAS_LIST_TICKET_FIELD_VALUES explicitly to include them.
  • Rate limits: High-volume exports across GORGIAS_LIST_TICKETS and related endpoints can hit Gorgias rate limits. Add backoff and resume from the last offset.
  • Auth errors: 401/403 responses on any Gorgias tool indicate token or permission issues. Do not treat partial data as a complete dataset.

Quick Reference

Tool Slug Description
GORGIAS_LIST_TICKETS List tickets with filters (status, channel, date, assignee)
GORGIAS_GET_TICKET Retrieve a specific ticket by ID
GORGIAS_CREATE_TICKET Create a new ticket (requires customer_id)
GORGIAS_UPDATE_TICKET Update ticket fields (requires ticket_id)
GORGIAS_ADD_TICKET_TAGS Add tags to a ticket
GORGIAS_LIST_TICKET_TAGS List all tags on a ticket
GORGIAS_LIST_TICKET_FIELD_VALUES List custom field values for a ticket
GORGIAS_CREATE_CUSTOMER Create a new customer (requires name)
GORGIAS_MERGE_CUSTOMERS Merge two customer records
GORGIAS_LIST_CUSTOMERS List customers with filters
GORGIAS_LIST_TEAMS List all teams
GORGIAS_GET_TEAM Retrieve a specific team
GORGIAS_GET_ACCOUNT Retrieve account information
GORGIAS_LIST_EVENTS List activity events with filters

Powered by Composio

04 同仓库更多 Skills

wsmsistemassuporte
wsmsistemassuporte/SISTEMAS-INTEGRADOS

webapp-testing

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

★ 0
wsmsistemassuporte
wsmsistemassuporte/SISTEMAS-INTEGRADOS

youtube-downloader

Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.

★ 0
wsmsistemassuporte
wsmsistemassuporte/SISTEMAS-INTEGRADOS

theme-factory

Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.

★ 0
wsmsistemassuporte
wsmsistemassuporte/SISTEMAS-INTEGRADOS

template-skill

Replace with description of the skill and when Claude should use it.

★ 0
wsmsistemassuporte
wsmsistemassuporte/SISTEMAS-INTEGRADOS

tailored-resume-generator

Analyzes job descriptions and generates tailored resumes that highlight relevant experience, skills, and achievements to maximize interview chances

★ 0
wsmsistemassuporte
wsmsistemassuporte/SISTEMAS-INTEGRADOS

slack-gif-creator

Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives. This skill applies when users request animated GIFs or emoji animations for Slack from descriptions like "make me a GIF for Slack of X doing Y".

★ 0