Automação do Zendesk via Rube MCP

Automatize operações do Zendesk através do kit de ferramentas Zendesk do Composio via Rube MCP.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa com o Zendesk via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas zendesk
• 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 zendesk
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar a autenticação do Zendesk
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 visualizar, filtrar ou pesquisar tickets de suporte

Sequência de ferramentas:

1. ZENDESK_LIST_ZENDESK_TICKETS - Listar todos os tickets com paginação [Obrigatório]
2. ZENDESK_GET_ZENDESK_TICKET_BY_ID - Obter detalhes de um ticket específico [Opcional]

Parâmetros chave:

• page: Número da página (baseado em 1)
• per_page: Resultados por página (máximo 100)
• sort_by: Campo de ordenação ('created_at', 'updated_at', 'priority', 'status')
• sort_order: 'asc' ou 'desc'
• ticket_id: ID do ticket para recuperação única

Armadilhas:

• LIST usa paginação page/per_page, NÃO baseada em offset; verifique next_page na resposta
• Máximo de 100 resultados por página; itere com números de página até que next_page seja nulo
• Tickets excluídos não são retornados por LIST; use GET_BY_ID que retorna o status 'deleted'
• Comentários e auditorias de tickets estão incluídos em GET_BY_ID, mas não nas respostas de LIST

2. Criar e Atualizar Tickets

Quando usar: O usuário deseja criar novos tickets ou modificar os existentes

Sequência de ferramentas:

1. ZENDESK_SEARCH_ZENDESK_USERS - Encontrar solicitante/atribuído [Pré-requisito]
2. ZENDESK_CREATE_ZENDESK_TICKET - Criar um novo ticket [Obrigatório]
3. ZENDESK_UPDATE_ZENDESK_TICKET - Atualizar campos do ticket [Opcional]
4. ZENDESK_DELETE_ZENDESK_TICKET - Excluir um ticket [Opcional]

Parâmetros chave:

• subject: Linha de assunto do ticket
• description: Corpo do ticket (para criação; torna-se o primeiro comentário)
• priority: 'urgent', 'high', 'normal', 'low'
• status: 'new', 'open', 'pending', 'hold', 'solved', 'closed'
• type: 'problem', 'incident', 'question', 'task'
• assignee_id: ID do usuário agente para atribuir
• requester_id: ID do usuário solicitante
• tags: Array de strings de tags
• ticket_id: ID do ticket (para atualização/exclusão)

Armadilhas:

• Tags em UPDATE SUBSTITUEM completamente as tags existentes; mescle com as tags atuais para preservá-las
• Use safe_update com updated_stamp para evitar conflitos de modificação concorrente
• DELETE é permanente e irreversível; tickets não podem ser recuperados
• description é usado apenas na criação; use REPLY_ZENDESK_TICKET para adicionar comentários após a criação
• Tickets fechados não podem ser atualizados; crie um ticket de acompanhamento em vez disso

3. Responder a Tickets

Quando usar: O usuário deseja adicionar comentários ou respostas a tickets

Sequência de ferramentas:

1. ZENDESK_GET_ZENDESK_TICKET_BY_ID - Obter o estado atual do ticket [Pré-requisito]
2. ZENDESK_REPLY_ZENDESK_TICKET - Adicionar uma resposta/comentário [Obrigatório]

Parâmetros chave:

• ticket_id: ID do ticket para responder
• body: Conteúdo do texto da resposta
• public: Booleano; true para resposta pública, false para nota interna
• author_id: ID do usuário autor (padrão para usuário autenticado)

Armadilhas:

• Defina public: false para notas internas visíveis apenas para agentes
• O padrão é resposta pública, que envia e-mail para o solicitante
• HTML é suportado no texto do corpo
• Responder também pode atualizar o status do ticket simultaneamente

4. Gerenciar Usuários

Quando usar: O usuário deseja encontrar ou criar usuários do Zendesk (agentes, usuários finais)

Sequência de ferramentas:

1. ZENDESK_SEARCH_ZENDESK_USERS - Pesquisar usuários [Obrigatório]
2. ZENDESK_CREATE_ZENDESK_USER - Criar um novo usuário [Opcional]
3. ZENDESK_GET_ABOUT_ME - Obter informações do usuário autenticado [Opcional]

Parâmetros chave:

• query: String de pesquisa (corresponde a nome, e-mail, telefone, etc.)
• name: Nome completo do usuário (obrigatório para criação)
• email: Endereço de e-mail do usuário
• role: 'end-user', 'agent' ou 'admin'
• verified: Se o e-mail foi verificado

Armadilhas:

• A pesquisa de usuário é imprecisa; pode retornar correspondências parciais
• Criar um usuário com um e-mail existente retorna o usuário existente (comportamento de upsert)
• Funções de agente e administrador podem exigir recursos de plano específicos

5. Gerenciar Organizações

…