Automação Gorgias

O que Automação Gorgias faz?

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

Documentação do toolkit: composio.dev/toolkits/gorgias

---

Configuração

1. Adicione o servidor MCP Rube à configuração do seu Claude Code com a 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 muito mais.

Ferramenta: GORGIAS_LIST_TICKETS

Liste todos os tickets abertos do canal de e-mail criados nos últimos 7 dias

Parâmetros principais:

• status – filtra por status do ticket (ex.: "open", "closed")
• channel – filtra por canal (ex.: "email", "chat")
• assignee_user_id / assignee_team_id – filtra por agente ou equipe responsável
• created_from / created_to – filtros de intervalo de data ISO
• limit (máx. 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 alterações de responsável, prioridade e status.

Ferramentas: GORGIAS_CREATE_TICKET, GORGIAS_UPDATE_TICKET, GORGIAS_GET_TICKET

Crie um ticket de alta prioridade para o cliente 12345 sobre um pedido faltante com o assunto "Pedido #9876 não entregue"

• 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 Tickets

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

Ferramentas: GORGIAS_ADD_TICKET_TAGS, GORGIAS_LIST_TICKET_TAGS

Adicione as tags 101 e 202 ao ticket 5678, depois mostre todas as tags desse ticket

• GORGIAS_ADD_TICKET_TAGS requer ticket_id e tag_ids (array de inteiros)
• GORGIAS_LIST_TICKET_TAGS requer ticket_id para recuperar as tags atuais

4. Gerenciamento de Clientes

Crie novos clientes ou mescle registros duplicados.

Ferramentas: GORGIAS_CREATE_CUSTOMER, GORGIAS_MERGE_CUSTOMERS, GORGIAS_LIST_CUSTOMERS

Crie um novo cliente chamado "Jane Doe" com e-mail [email protected] e canal de telefone

• 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 fonte é 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

Mostre todas as equipes de suporte na minha conta Gorgias

• GORGIAS_GET_ACCOUNT retorna métricas e configuração no nível da conta
• GORGIAS_LIST_TEAMS / GORGIAS_GET_TEAM gerenciam consultas de equipe
• GORGIAS_LIST_TICKET_FIELD_VALUES retorna valores de campos personalizados para um determinado ticket

6. Monitoramento de Atividades e Eventos

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

Ferramentas: GORGIAS_LIST_EVENTS

Liste eventos recentes para ver quais atividades ocorreram em toda a nossa fila de suporte

• 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. Não percorrer as páginas fará com que tickets mais antigos sejam perdidos e produza 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ório desejada. Sempre defina created_from/created_to para consultas com limite de tempo.
• Campos personalizados são separados: KPIs-chave do negócio 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 em GORGIAS_LIST_TICKETS e endpoints relacionados podem atingir os limites de taxa do Gorgias. Adicione backoff e retome a partir do último offset.
• 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

Slug da Ferramenta	Descrição
GORGIAS_LIST_TICKETS	Lista tickets com filtros (status, canal, data, responsável)
GORGIAS_GET_TICKET	Recupera um ticket específico por ID
GORGIAS_CREATE_TICKET	Cria um novo ticket (requer customer_id)
GORGIAS_UPDATE_TICKET	Atualiza campos do ticket (requer ticket_id)
GORGIAS_ADD_TICKET_TAGS	Adiciona tags a um ticket
GORGIAS_LIST_TICKET_TAGS	Lista todas as tags de um ticket
GORGIAS_LIST_TICKET_FIELD_VALUES	Lista valores de campos personalizados de um ticket
GORGIAS_CREATE_CUSTOMER	Cria um novo cliente (requer name)
GORGIAS_MERGE_CUSTOMERS	Mescla dois registros de clientes
GORGIAS_LIST_CUSTOMERS	Lista clientes com filtros
GORGIAS_LIST_TEAMS	Lista todas as equipes
GORGIAS_GET_TEAM	Recupera uma equipe específica
GORGIAS_GET_ACCOUNT	Recupera informações da conta
GORGIAS_LIST_EVENTS	Lista eventos de atividade com filtros

---

Desenvolvido por Composio