Integração com Zendesk
Ligue a Threada ao Zendesk para criação e atualização governadas de tickets a partir de WorkItems, com uma trilha de auditoria completa.
Visão geral
A integração com Zendesk permite à Threada criar, atualizar e resolver registros Zendesk como ações governadas dentro dos seus fluxos de trabalho. Credenciais com escopo definido garantem que cada espaço de trabalho opera com o mínimo de privilégios.
Capacidades
- Criar registros Zendesk a partir de escalações de WorkItem com contexto completo
- Atualizar tickets do Zendesk (status, campos, tags) a partir de ações governadas de WorkItem
- Mapear campos personalizados e tags entre sistemas
- Encaminhar por prioridade, equipe e classificação de política
- Trilha de auditoria para cada operação Zendesk
Um exemplo prático
Um fluxo de ponta a ponta que a Threada executa com o Zendesk:
- Um ticket do Zendesk chega e se torna um WorkItem governado, normalizado em um schema tipado com o ticket anexado.
- A Threada elabora uma resposta fundamentada em modo de citação estrita, ou encaminha o ticket a um responsável quando a política exige um humano.
- Uma resposta ou atualização aprovada é executada como uma ação governada de volta no Zendesk — status, campos e tags mapeados — com idempotência.
- Cada operação no Zendesk roda como uma ação governada com idempotência e é registrada na trilha de auditoria imutável do WorkItem.
Configuração
Configure a integração no Studio sob a governança do pack. Forneça credenciais de API com escopo limitado e mapeie campos para o esquema do seu fluxo de trabalho. A conexão é validada antes da ativação.
- No Studio, adicione a integração do Zendesk sob a governança de pack.
- Forneça credenciais da API do Zendesk com escopo restrito e acesso de privilégio mínimo.
- Mapeie campos, tags e status do Zendesk para o seu schema de WorkItem.
- Valide a conexão; a integração só é ativada após o teste ser bem-sucedido.
Permissões e acesso a dados
O Zendesk usa credenciais que você fornece — não um app OAuth hospedado pela Threada.
- A Threada autentica-se com credenciais de API do Zendesk com escopo restrito que você fornece, armazenadas no Secret Manager.
- A Threada chama a REST API do Zendesk (/api/v2/tickets.json) para criar e atualizar tickets; a sincronização de entrada do status do Zendesk de volta para o WorkItem não é suportada hoje.
- Cada operação de ticket roda como uma ação governada e é registrada na trilha de auditoria do WorkItem.
Perguntas frequentes
A Threada responde no Zendesk automaticamente?
Apenas sob política. As respostas e atualizações rodam como ações governadas, então se elas são enviadas automaticamente ou aguardam um aprovador é decidido pela sua sobreposição de políticas. Qualquer coisa não sustentada por evidências é encaminhada a um humano em vez de ser respondida.
A Threada lê o status do Zendesk de volta para o WorkItem?
Atualmente não. A Threada escreve no Zendesk — criando e atualizando tickets como ações governadas. A sincronização de entrada do status do Zendesk de volta ao WorkItem não é suportada hoje; o WorkItem reflete as ações que a Threada executou.
Qual acesso a integração necessita?
Credenciais da API do Zendesk com escopo restrito e acesso de privilégio mínimo. A conexão é validada antes da ativação, e cada operação no Zendesk é registrada na trilha de auditoria.