Automação do Freshservice via Rube MCP

Automatize operações de Gerenciamento de Serviços de TI do Freshservice através do kit de ferramentas Freshservice da Composio via Rube MCP.

Pré-requisitos

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

Configuração

Obtenha o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar 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 kit de ferramentas freshservice
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir a autenticação do Freshservice
4. Confirme se o status da conexão mostra ATIVO antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Listar e Pesquisar Tickets

Quando usar: O usuário deseja encontrar, listar ou pesquisar tickets

Sequência de ferramentas:

1. FRESHSERVICE_LIST_TICKETS - Listar tickets com filtragem e paginação opcionais [Obrigatório]
2. FRESHSERVICE_GET_TICKET - Obter informações detalhadas para um ticket específico [Opcional]

Parâmetros chave para listagem:

• filter: Filtro predefinido ('all_tickets', 'deleted', 'spam', 'watching')
• updated_since: Timestamp no formato ISO 8601 para obter tickets atualizados após este horário
• order_by: Campo de ordenação ('created_at', 'updated_at', 'status', 'priority')
• order_type: Direção da ordenação ('asc' ou 'desc')
• page: Número da página (indexado em 1)
• per_page: Resultados por página (1-100, padrão 30)
• include: Campos adicionais ('requester', 'stats', 'description', 'conversations', 'assets')

Parâmetros chave para obter:

• ticket_id: ID único do ticket ou display_id
• include: Campos adicionais a serem incluídos

Armadilhas:

• Por padrão, apenas tickets criados nos últimos 30 dias são retornados
• Use updated_since para recuperar tickets mais antigos
• Cada valor de include consome créditos de API adicionais
• page é indexado em 1; o valor mínimo é 1
• per_page máximo é 100; o padrão é 30
• IDs de ticket podem ser o ID interno ou o display_id mostrado na interface do usuário

2. Criar um Ticket

Quando usar: O usuário deseja registrar um novo incidente ou solicitação

Sequência de ferramentas:

1. FRESHSERVICE_CREATE_TICKET - Criar um novo ticket [Obrigatório]

Parâmetros chave:

• subject: Linha de assunto do ticket (obrigatório)
• description: Descrição em HTML do ticket (obrigatório)
• status: Status do ticket - 2 (Aberto), 3 (Pendente), 4 (Resolvido), 5 (Fechado) (obrigatório)
• priority: Prioridade do ticket - 1 (Baixa), 2 (Média), 3 (Alta), 4 (Urgente) (obrigatório)
• email: Endereço de e-mail do solicitante (forneça e-mail ou requester_id)
• requester_id: ID do usuário do solicitante
• type: Tipo de ticket ('Incidente' ou 'Solicitação de Serviço')
• source: Canal - 1 (E-mail), 2 (Portal), 3 (Telefone), 4 (Chat), 5 (Twitter), 6 (Facebook)
• impact: Nível de impacto - 1 (Baixo), 2 (Médio), 3 (Alto)
• urgency: Nível de urgência - 1 (Baixo), 2 (Médio), 3 (Alto), 4 (Crítico)

Armadilhas:

• subject, description, status e priority são todos obrigatórios
• email ou requester_id devem ser fornecidos para identificar o solicitante
• Status e prioridade usam códigos numéricos, não nomes de string
• A descrição suporta formatação HTML
• Se o e-mail não corresponder a um contato existente, um novo contato é criado

3. Atualizar Tickets em Massa

Quando usar: O usuário deseja atualizar vários tickets de uma vez

Sequência de ferramentas:

1. FRESHSERVICE_LIST_TICKETS - Encontrar tickets para atualizar [Pré-requisito]
2. FRESHSERVICE_BULK_UPDATE_TICKETS - Atualizar vários tickets [Obrigatório]

Parâmetros chave:

• ids: Array de IDs de ticket para atualizar (obrigatório)
• update_fields: Dicionário de campos para atualizar (obrigatório)
  • Chaves permitidas: 'subject', 'description', 'status', 'priority', 'responder_id', 'group_id', 'type', 'tags', 'custom_fields'

Armadilhas:

• A atualização em massa executa atualizações sequenciais internamente; grandes lotes podem levar tempo
• Todos os tickets especificados recebem as mesmas atualizações de campo
• Se a atualização de um ticket falhar, outros ainda podem ter sucesso; verifique a resposta para resultados individuais
• Não é possível atualizar seletivamente campos diferentes por ticket em uma única chamada
• Campos personalizados devem usar seus nomes de campo internos, não nomes de exibição

4. Criar Ticket via E-mail de Saída

Quando usar: O usuário deseja criar um ticket enviando uma notificação por e-mail de saída

Sequência de ferramentas:

1. FRESHSERVICE_CREATE_TICKET_OUTBOUND_EMAIL - Criar ticket com notificação por e-mail [Obrigatório]

…