Integração do Dust com GitHub e Zendesk: Guia para Otimizar o Atendimento Interno e a Triagem de Incidentes

Engenheiros de suporte técnico e equipes de operações de TI (TechOps) enfrentam rotineiramente um gargalo operacional crítico: os chamados de clientes, SLAs e o histórico de atendimento ficam centralizados no Zendesk, enquanto correções de código, rastreamento de bugs e discussões de engenharia ocorrem no GitHub. Quando esses dois ambientes operam isolados, analistas de suporte perdem horas alternando entre abas, buscando manualmente issues em repositórios, copiando rastreamentos de pilha (stack traces) e perguntando a desenvolvedores no Slack sobre o status de cada correção. Essa fragmentação gera relatórios duplicados e atrasa o tempo de resolução.

A plataforma Dust (dust.tt) resolve esse desafio não por meio de sincronizações rígidas de campos, mas com orquestração inteligente via IA contextual. Ao integrar o Zendesk e o GitHub ao Dust, as organizações criam agentes de IA personalizados que compreendem simultaneamente o histórico de atendimento e a base de código dos projetos. Esses agentes são capazes de triar tickets recebidos, correlacionar sintomas a falhas já conhecidas no GitHub, redigir notas internas com diagnósticos técnicos e abrir issues padronizadas para engenharia de forma totalmente automatizada.

Abaixo está o guia prático para planejar, configurar e implementar esse ecossistema unificado de triagem com Dust, Zendesk e GitHub.

Visão Geral da Arquitetura: Como o Dust Conecta Suporte e Engenharia

Para entender o funcionamento do Dust entre o Zendesk e o GitHub, é fundamental separar a solução em três camadas operacionais distintas:

Essa divisão assegura que o Dust atue como um cérebro analítico: ele interpreta a solicitação do cliente no Zendesk à luz do repositório no GitHub e executa ações seguras e controladas em ambas as plataformas.

Passo 1: Configurar Conexões de Dados no Espaço de Trabalho

Para que os agentes executem a triagem com precisão, eles precisam de permissão de leitura sobre a base de conhecimento de suporte e o histórico de problemas de engenharia.

1. Conectando o Zendesk ao Dust

1. No seu espaço de trabalho do Dust, acesse Spaces > Connections e clique em Zendesk.
2. Digite o subdomínio da sua instância do Zendesk (https://<subdominio>.zendesk.com).
3. Conclua a autenticação OAuth usando uma conta com privilégios de administrador no Dust e no Zendesk (com acesso de administrador ao Support e ao Guide).
4. Acesse as configurações da conexão em Manage para ajustar os filtros:
   • Escopo e Retenção de Tickets: Por padrão, o Dust sincroniza tickets resolvidos e fechados atualizados nos últimos 180 dias, mantendo uma retenção contínua de 120 dias. Ative Sync Unresolved Tickets apenas se for necessário que os agentes consultem incidentes abertos em andamento.
   • Privacidade de Dados (Ocultação de PII): Ative Hide Customer Information para remover nomes e e-mails de clientes dos metadados indexados, mantendo intacto o conteúdo técnico do chamado.
   • Filtros por Tags e Campos Customizados: Configure Included Tags (como tier-2 ou bug) para restringir a sincronização a chamados técnicos. Se você utiliza campos personalizados para indicar o serviço afetado ou a severidade, insira o ID numérico do campo em Custom Field Tags; o Dust converterá o campo em marcadores pesquisáveis no formato fieldName:value.
   • Limite de Taxa de API (TPS): Defina um limite de transações por segundo para proteger a cota da sua conta no Zendesk, caso seu plano possua restrições severas de chamadas.

2. Conectando o GitHub ao Dust

1. No Dust, vá até Spaces > Connections > GitHub e clique em Connect.
2. Autentique-se como administrador da organização no GitHub.
3. Selecione os repositórios específicos que o Dust deve indexar (como APIs principais, frontends e bibliotecas de integração).
4. Opcionalmente, ative a opção Code synchronization: isso permite que os agentes inspecionem arquivos de código na branch padrão além de issues e PRs. A base de código é sincronizada a cada 8 horas, enquanto issues e PRs são atualizados quase em tempo real.
5. Salve as configurações. O Dust criará índices semânticos com base nos títulos, descrições, tags e autores de cada item.

Passo 2: Ativar Ferramentas de Ação (Tools)

As conexões fornecem conhecimento passivo. Para permitir que os agentes busquem chamados em tempo real, rascunhem notas de diagnóstico e criem issues no GitHub, é necessário habilitar as Tools:

1. Navegue até Spaces > Tools e clique em Add Tools.
2. Adicione as Zendesk Tools:
   • Search Tickets: Realiza buscas avançadas usando sintaxes específicas (ex.: status:open priority:urgent tags:bug).
   • Get Ticket: Resgata todo o histórico de comentários, metadados e métricas de SLA do ticket.
   • Draft Reply: Cria notas internas privadas (Private Comments) no chamado, inacessíveis ao cliente final e voltadas para validação do analista.
3. Adicione as GitHub Tools:
   • Escolha o modelo de autenticação: Recomenda-se selecionar Workspace Credentials, o que atribui todas as ações e issues ao bot oficial @dust-agent (ou escolha Personal Credentials caso as ações devam refletir estritamente as permissões do usuário logado).

Passo 3: Construir o Agente de Triagem no Agent Builder

Com os dados e ferramentas preparados, crie no Agent Builder um agente focado na triagem e no escalonamento para engenharia (ex.: @tier2-triage).

Configurações Recomendadas do Agente

• Modelo de IA: Utilize um modelo com alta capacidade de raciocínio técnico e interpretação de código (como Claude 3.5 Sonnet, GPT-4o ou Gemini 1.5 Pro).
• Fontes de Conhecimento: Conecte a conexão do Zendesk (tickets e central de ajuda) e a do GitHub (repositórios e código).
• Ferramentas Habilitadas: Ative Search Tickets, Get Ticket e Draft Reply do Zendesk, além das ferramentas de busca e criação de issues do GitHub.
• Instruções do Sistema (Prompt): Escreva regras estritas de diagnóstico, checagem de duplicidade e estrutura de notas internas.

Você é o Copiloto de Suporte Nível 2 e Triagem de Incidentes (Tier-2 Triage Copilot). Seu objetivo é analisar chamados técnicos do Zendesk, cruzá-los com nossos repositórios no GitHub e fornecer um diagnóstico técnico estruturado.

Ao analisar um chamado do Zendesk:
1. Extraia o erro reportado, rastreamento de pilha ou comportamento inesperado e busque nos repositórios pertinentes do GitHub (padrão: dust-tt/app-backend) se já existe uma issue aberta ou recentemente fechada equivalente.
2. Pesquise no histórico de chamados do Zendesk para verificar se esse problema já ocorreu anteriormente e se existe uma solução de contorno (workaround) validada.
3. Se houver correspondência com uma issue existente no GitHub:
   - Use a ferramenta "Draft Reply" do Zendesk para registrar uma nota interna privada (Private Comment).
   - Inclua no texto: (a) URL da issue no GitHub e status atual, (b) Resumo da causa raiz, (c) Resposta técnica recomendada ou solução paliativa para orientar o cliente.
4. Se for constatado um bug inédito e reproduzível:
   - Crie uma nova issue no GitHub usando a ferramenta correspondente com o formato: [Triage] Descrição concisa da falha. No corpo, detalhe o ID do chamado no Zendesk, ambiente, passos para reprodução e logs de erro completos.
   - Registre uma nota interna privada no Zendesk referenciando o ID da issue do GitHub recém-criada.
5. Nunca envie mensagens públicas diretamente ao cliente final. Todas as saídas devem ser notas internas privadas ou respostas exibidas no painel lateral do Dust para revisão de um operador humano.

Passo 4: Implementar Interface e Automação com Webhooks

O agente pode operar em dois formatos complementares: como assistente sob demanda na interface do Zendesk ou em execução autônoma orientada a eventos.

Formato A: Copiloto Interativo na Barra Lateral do Zendesk

1. Acesse o Zendesk Marketplace e instale o aplicativo oficial Dust.
2. Na Central de Administração do Zendesk, abra as configurações do app Dust.
3. Insira o seu Workspace ID do Dust e uma API Key gerada por um administrador do workspace.
4. No campo Default Agent IDs, informe o ID do agente @tier2-triage. Isso garante que, ao abrir qualquer ticket, o analista visualize imediatamente esse assistente na barra lateral direita.
5. Garanta que o e-mail do analista no Zendesk seja o mesmo cadastrado no Dust. O analista pode abrir um chamado difícil e simplesmente perguntar: "Esse erro de timeout na finalização de compra já foi corrigido em alguma branch?", recebendo imediatamente a correlação com os PRs e issues do GitHub.

Formato B: Triagem Autônoma Orientada a Webhooks

Para diagnosticar automaticamente tickets urgentes assim que chegarem à fila:

1. No Dust, acesse Spaces > Triggers e clique em Add source.
2. Selecione o provedor integrado Zendesk e conecte sua conta.
3. No Agent Builder do @tier2-triage, vá em Triggers > Add triggers e selecione a fonte de webhook criada.
4. Configure as condições:
   • Evento: Ticket Created (Chamado Criado) ou Ticket Updated (Chamado Atualizado).
   • Condição de Disparo: Descreva em linguagem natural o filtro, como "priority is urgent or tags contain technical-escalation".
   • Payload do Evento: Habilite Include webhook payload para que título, descrição e tags sejam enviados diretamente à IA.
   • Limite de Taxa: Defina um teto máximo de execuções em 24 horas para evitar surpresas de consumo em caso de incidentes massivos.
5. Salve o agente. Quando um ticket elegível for criado, o Dust executará a triagem em segundo plano e registrará a nota de diagnóstico antes mesmo de o analista abrir o chamado.

Comparativo: Triagem com Dust vs. Plugins Tradicionais de Sincronização

Governança, Custos e Melhores Práticas

1. Priorize a Abordagem Human-in-the-Loop: Configure os agentes para sempre utilizarem Draft Reply em vez de comentários públicos. Um operador humano deve validar o parecer técnico e a previsão de correção antes de comunicar o cliente final.
2. Defina Filtros Restritivos nos Webhooks: Evite disparar modelos de linguagem avançados para tickets triviais de redefinição de senha ou dúvidas comerciais. Use tags e prioridades para restringir as automações apenas a chamados que realmente envolvam engenharia.
3. Planejamento de Planos e Créditos: Os planos Business do Dust contam com opções self-serve, incluindo o Pro (24 €/assento/mês com cobrança anual, com 8.000 créditos/mês) e o Max (120 €/assento/mês com cobrança anual, com 40.000 créditos/mês). Organizações de grande escala podem recorrer ao plano Enterprise, que oferece pool compartilhado de créditos, provisionamento SCIM, logs de auditoria e SLAs dedicados. Estime com precisão a demanda de créditos para chamadas automáticas via webhook.

Ao unificar o fluxo de atendimento do Zendesk com o repositório técnico do GitHub por meio do Dust, as equipes eliminam tarefas repetitivas, agilizam o escalonamento de bugs e constroem uma colaboração transparente entre suporte e engenharia.

Referências

• Zendesk Tools - Dust Docs
• GitHub Tools - Dust Docs
• Zendesk Connection - Dust Docs
• GitHub Connection - Dust Docs
• Dust in Zendesk - Dust Docs
• Webhooks - Dust Docs
• Customer Support - Dust Docs
• Dust Pricing: Business and Enterprise Plans for AI Agents