Automação do Freshdesk via Rube MCP

Automatize fluxos de trabalho de suporte ao cliente do Freshdesk, incluindo gerenciamento de tickets, operações de contato e empresa, notas, respostas e busca de tickets através do toolkit Freshdesk da Composio.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa com o Freshdesk via RUBE_MANAGE_CONNECTIONS com o toolkit freshdesk
• 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 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 toolkit freshdesk
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar a autenticação do Freshdesk
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Criar e Gerenciar Tickets

Quando usar: O usuário deseja criar um novo ticket de suporte, atualizar um ticket existente ou visualizar detalhes do ticket.

Sequência de ferramentas:

1. FRESHDESK_SEARCH_CONTACTS - Encontrar solicitante por e-mail para obter requester_id [Opcional]
2. FRESHDESK_LIST_TICKET_FIELDS - Verificar campos personalizados e status disponíveis [Opcional]
3. FRESHDESK_CREATE_TICKET - Criar um novo ticket com assunto, descrição, informações do solicitante [Obrigatório]
4. FRESHDESK_UPDATE_TICKET - Modificar status, prioridade, agente atribuído ou outros campos do ticket [Opcional]
5. FRESHDESK_VIEW_TICKET - Recuperar detalhes completos do ticket por ID [Opcional]

Parâmetros-chave para FRESHDESK_CREATE_TICKET:

• subject: Assunto do ticket (obrigatório)
• description: Conteúdo HTML do ticket (obrigatório)
• email: E-mail do solicitante (pelo menos um identificador de solicitante é necessário)
• requester_id: ID do usuário do solicitante (alternativa ao e-mail)
• status: 2=Aberto, 3=Pendente, 4=Resolvido, 5=Fechado (padrão 2)
• priority: 1=Baixa, 2=Média, 3=Alta, 4=Urgente (padrão 1)
• source: 1=E-mail, 2=Portal, 3=Telefone, 7=Chat (padrão 2)
• responder_id: ID do agente para atribuir o ticket
• group_id: Grupo para atribuir o ticket
• tags: Array de strings de tags
• custom_fields: Objeto com chaves cf_<field_name>

Armadilhas:

• Pelo menos um identificador de solicitante é necessário: requester_id, email, phone, facebook_id, twitter_id ou unique_external_id
• Se phone for fornecido sem email, então name se torna obrigatório
• description suporta formatação HTML
• O campo attachments espera formato multipart/form-data, não caminhos de arquivo ou URLs
• As chaves de campos personalizados devem ser prefixadas com cf_ (por exemplo, cf_reference_number)
• Status e prioridade são inteiros, não strings

2. Buscar e Filtrar Tickets

Quando usar: O usuário deseja encontrar tickets por status, prioridade, intervalo de datas, agente ou campos personalizados.

Sequência de ferramentas:

1. FRESHDESK_GET_TICKETS - Listar tickets com filtros simples (status, prioridade, agente) [Obrigatório]
2. FRESHDESK_GET_SEARCH - Busca avançada de tickets com sintaxe de consulta [Obrigatório]
3. FRESHDESK_VIEW_TICKET - Obter detalhes completos para tickets específicos dos resultados [Opcional]
4. FRESHDESK_LIST_TICKET_FIELDS - Verificar campos disponíveis para consultas de busca [Opcional]

Parâmetros-chave para FRESHDESK_GET_TICKETS:

• status: Filtrar por status inteiro (2=Aberto, 3=Pendente, 4=Resolvido, 5=Fechado)
• priority: Filtrar por prioridade inteira (1-4)
• agent_id: Filtrar por agente atribuído
• requester_id: Filtrar por solicitante
• email: Filtrar por e-mail do solicitante
• created_since: Timestamp no formato ISO 8601
• page / per_page: Paginação (padrão 30 por página)
• sort_by / sort_order: Campo e direção de ordenação

Parâmetros-chave para FRESHDESK_GET_SEARCH:

• query: String de consulta como "status:2 AND priority:3" ou "(created_at:>'2024-01-01' AND tag:'urgent')"
• page: Número da página (1-10, máximo de 300 resultados totais)

Armadilhas:

• A consulta FRESHDESK_GET_SEARCH deve estar entre aspas duplas
• String de consulta limitada a 512 caracteres
• Máximo de 10 páginas (300 resultados) dos endpoints de busca
• Campos de data nas consultas usam formato UTC YYYY-MM-DD
• Use a palavra-chave null para encontrar tickets com campos vazios (por exemplo, "agent_id:null")
• FRESHDESK_LIST_ALL_TICKETS não aceita parâmetros e retorna todos os tickets (use GET_TICKETS para filtrar)

3. Responder e Adicionar Notas em Tickets

Quando usar: O usuário deseja enviar uma resposta a um cliente, adicionar notas internas ou visualizar o histórico de conversas.

Sequência de ferramentas:

1. FRESHDESK_VIEW_TICKET - Verificar se o ticket existe e checar o estado atual [Pré-requisito]

…