Automação de HelpDesk via Rube MCP

Automatize operações de ticketing de HelpDesk através do toolkit de HelpDesk da Composio via Rube MCP.

Pré-requisitos

• Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa de HelpDesk via RUBE_MANAGE_CONNECTIONS com o toolkit helpdesk
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na sua configuração de cliente. Nenhuma chave de API é necessária — apenas adicione o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit helpdesk
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar a autenticação do HelpDesk
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Listar e Navegar por Tickets

Quando usar: O usuário deseja recuperar, navegar ou paginar por tickets de suporte

Sequência de ferramentas:

1. HELPDESK_LIST_TICKETS - Listar tickets com ordenação e paginação [Obrigatório]

Parâmetros chave:

• silo: Pasta de tickets - 'tickets', 'archive', 'trash' ou 'spam' (padrão: 'tickets')
• sortBy: Campo de ordenação - 'createdAt', 'updatedAt' ou 'lastMessageAt' (padrão: 'createdAt')
• order: Direção de ordenação - 'asc' ou 'desc' (padrão: 'desc')
• pageSize: Resultados por página, 1-100 (padrão: 20)
• next.value: Cursor de timestamp para paginação para frente
• next.ID: Cursor de ID para paginação para frente
• prev.value: Cursor de timestamp para paginação para trás
• prev.ID: Cursor de ID para paginação para trás

Armadilhas:

• A paginação usa uma abordagem baseada em cursor com pares de timestamp + ID
• A paginação para frente requer tanto next.value quanto next.ID da resposta anterior
• A paginação para trás requer tanto prev.value quanto prev.ID
• silo determina de qual pasta listar; o padrão são os tickets ativos
• pageSize máximo é 100; o padrão é 20
• Tickets arquivados e na lixeira estão em silos separados

2. Gerenciar Visualizações de Tickets

Quando usar: O usuário deseja ver visualizações de agente salvas para organizar tickets

Sequência de ferramentas:

1. HELPDESK_LIST_VIEWS - Listar todas as visualizações de agente [Obrigatório]

Parâmetros chave: (nenhum obrigatório)

Armadilhas:

• Visualizações são filtros salvos predefinidos configurados por agentes na interface do usuário do HelpDesk
• Definições de visualização incluem critérios de filtro que podem ser usados para entender a organização dos tickets
• Visualizações não podem ser criadas ou modificadas via API; elas são gerenciadas na interface do usuário do HelpDesk

3. Usar Respostas Prontas

Quando usar: O usuário deseja listar respostas prontas (modelos) disponíveis para tickets

Sequência de ferramentas:

1. HELPDESK_LIST_CANNED_RESPONSES - Recuperar todos os modelos de resposta predefinidos [Obrigatório]

Parâmetros chave: (nenhum obrigatório)

Armadilhas:

• Respostas prontas são modelos predefinidos para respostas comuns
• Elas podem incluir variáveis de espaço reservado que precisam ser preenchidas
• Respostas prontas são gerenciadas através da interface do usuário do HelpDesk
• O conteúdo da resposta pode incluir formatação HTML

4. Inspecionar Campos Personalizados

Quando usar: O usuário deseja visualizar definições de campos personalizados para a conta

Sequência de ferramentas:

1. HELPDESK_LIST_CUSTOM_FIELDS - Listar todas as definições de campos personalizados [Obrigatório]

Parâmetros chave: (nenhum obrigatório)

Armadilhas:

• Campos personalizados estendem o esquema de ticket padrão com dados específicos da organização
• Definições de campo incluem tipo de campo, nome e regras de validação
• Campos personalizados são configurados no painel de administração do HelpDesk
• Valores de campo aparecem nos tickets quando o campo foi preenchido

Padrões Comuns

Padrão de Navegação de Tickets

1. Call HELPDESK_LIST_TICKETS with desired silo and sortBy
2. Process the returned page of tickets
3. Extract next.value and next.ID from the response
4. Call HELPDESK_LIST_TICKETS with those cursor values for next page
5. Continue until no more cursor values are returned

Navegação de Pasta de Tickets

Active tickets:  silo='tickets'
Archived:        silo='archive'
Trashed:         silo='trash'
Spam:            silo='spam'

Paginação Baseada em Cursor

Forward pagination:
  - Use next.value (timestamp) and next.ID from response
  - Pass as next.value and next.ID parameters in next call

Backward pagination:
  - Use prev.value (timestamp) and prev.ID from response
  - Pass as prev.value and prev.ID parameters in next call

Armadilhas Conhecidas

Paginação por Cursor:

• Tanto o timestamp quanto o ID são necessários para navegação por cursor
• Valores de cursor são timestamps no formato de data e hora ISO 8601

…