Gorgias Automation

Automatize suas operações do helpdesk Gorgias diretamente do Claude Code. Crie, atualize e trie tickets de suporte, gerencie clientes e organize sua equipe de suporte -- tudo sem sair do seu terminal.

Documentação das Ferramentas: composio.dev/toolkits/gorgias

Configuração

1. Adicione o servidor Rube MCP à sua configuração do Claude Code com o URL: https://rube.app/mcp
2. Quando solicitado, autentique sua conta Gorgias através do link de conexão fornecido
3. Comece a automatizar seus fluxos de trabalho de suporte com linguagem natural

Fluxos de Trabalho Principais

1. Listar e Filtrar Tickets

Recupere tickets com filtros por status, canal, responsável, intervalo de datas e mais.

Ferramenta: GORGIAS_LIST_TICKETS

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

Parâmetros principais:

• status -- filtra por status do ticket (ex: "aberto", "fechado")
• channel -- filtra por canal (ex: "email", "chat")
• assignee_user_id / assignee_team_id -- filtra por agente ou equipe atribuída
• created_from / created_to -- filtros de intervalo de datas ISO
• limit (máximo 100) / offset -- controles de paginação
• order_by / order_dir -- opções de ordenação

2. Criar e Atualizar Tickets

Crie novos tickets ou atualize os existentes com atribuição, prioridade e mudanças de status.

Ferramentas: 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 requer customer_id; aceita subject, status, priority, channel, messages, tags
• GORGIAS_UPDATE_TICKET requer ticket_id; todos os outros campos são atualizações parciais opcionais
• GORGIAS_GET_TICKET recupera detalhes completos do ticket por ticket_id

3. Gerenciar Tags de Ticket

Adicione tags aos tickets para categorização, roteamento e relatórios.

Ferramentas: 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 requer ticket_id e tag_ids (array de inteiros)
• GORGIAS_LIST_TICKET_TAGS requer ticket_id para recuperar tags atuais

4. Gerenciamento de Clientes

Crie novos clientes ou mescle registros de clientes duplicados.

Ferramentas: 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 requer name; aceita email, channels (array com type e value), external_id, address, data
• GORGIAS_MERGE_CUSTOMERS requer source_customer_id e target_customer_id -- a origem é mesclada no destino
• GORGIAS_LIST_CUSTOMERS recupera clientes com opções de filtro

5. Operações de Equipe e Conta

Liste equipes, recupere informações da conta e inspecione campos personalizados de tickets.

Ferramentas: 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 retorna métricas e configuração em nível de conta
• GORGIAS_LIST_TEAMS / GORGIAS_GET_TEAM gerenciam a consulta de equipes
• GORGIAS_LIST_TICKET_FIELD_VALUES retorna valores de campos personalizados para um determinado ticket

6. Rastreamento de Atividade e Eventos

Monitore a atividade de tickets e o histórico de eventos de clientes.

Ferramentas: GORGIAS_LIST_EVENTS

List recent events to see what activity has happened across our support queue

• GORGIAS_LIST_EVENTS fornece uma linha do tempo de atividades com opções de filtro

Armadilhas Conhecidas

• Paginação necessária: GORGIAS_LIST_TICKETS usa paginação limit/offset. Falhar em percorrer as páginas resultará na perda de tickets mais antigos e na produção de dados incompletos.
• Especificidade do filtro: Filtros ausentes ou excessivamente amplos em GORGIAS_LIST_TICKETS podem sobrecarregar a exportação ou omitir a janela de relatórios desejada. Sempre defina created_from/created_to para consultas com limite de tempo.
• Campos personalizados são separados: KPIs de negócios importantes podem existir apenas em campos personalizados. Você deve consultar GORGIAS_LIST_TICKET_FIELD_VALUES explicitamente para incluí-los.
• Limites de taxa: Exportações de alto volume através de GORGIAS_LIST_TICKETS e endpoints relacionados podem atingir os limites de taxa do Gorgias. Adicione backoff e retome a partir do último deslocamento.
• Erros de autenticação: Respostas 401/403 em qualquer ferramenta Gorgias indicam problemas de token ou permissão. Não trate dados parciais como um conjunto de dados completo.

Referência Rápida

…