Pergunta

Como posso depurar a Zendesk Apps framework (ZAF)?

Resposta

A estrutura de aplicativos do Zendesk permite que você crie aplicativos com funcionalidades e recursos complexos. Este artigo fornece diretrizes sobre como abordar problemas nos cenários mais comuns.

Aviso: O Suporte ao cliente Zendesk pode apenas ajudar na demonstração dos recursos e funcionalidades do Zendesk Apps framework (ZAF). Qualquer problema relacionado a implementações ou código personalizado deve ser discutido com os desenvolvedores do aplicativo.

Para solucionar esses problemas, siga as etapas abaixo:

  • Capture os erros
  • Gerar uma lista dos aplicativos instalados
  • Identificar o aplicativo
  • Gerar um arquivo HAR
  • Usar a API de aplicativos

Capture os erros

Use a ferramenta do desenvolvedor do navegador. Se um aplicativo mostrar comportamentos inesperados, colete uma lista de erros para pesquisas adicionais na ferramenta de desenvolvedor do navegador.

Acesse a ferramenta do desenvolvedor em diferentes navegadores:

  • Chrome: Abra o Chrome DevTools 
  • Firefox: Console web 
  • Safari: Use as ferramentas para desenvolvedores no menu Desenvolver no Safari do Mac 
  • Microsoft Edge: Abra o Microsoft Edge DevTools

O console exibe as mensagens de erro ou de aviso. Para erros de solicitação de rede, consulte a aba Rede da ferramenta.

Gerar uma lista dos aplicativos instalados

Gere uma lista de todos os aplicativos instalados na conta.

O ponto de extremidade da API, Listar instalações de aplicativos gera uma lista JSON de aplicativos instalados. As propriedades incluídas podem ser usadas para noapps e app_ids parâmetros de consulta discutidos posteriormente:

  • enabled:indica se o aplicativo está ativo no momento
  • app_id: a ID do aplicativo. Isso é necessário ao usar a palavra-chave app_ids.
  • ID de instalação: a ID de instalação do aplicativo. Opcionalmente, ele pode ser usado para a palavra-chave noapps. Os aplicativos podem ser instalados várias vezes se o aplicativo permitir. Cada instalação terá uma ID de instalação diferente, mas com a mesma ID de aplicativo.

Como acessar o ponto de extremidade:

  • Usar curl 
    curl https://{subdomain}.zendesk.com/api/v2/apps/installations.json\
    -u{email_address}:{password}
  • Ou anexar /api/v2/apps/installations.json para a URL do subdomínio da conta: 
    https://your_subdomain.zendesk.com/api/v2/apps/installations.json

Você deve ser um agente na conta do Zendesk

Identificar o aplicativo

Desative os aplicativos de maneira seletiva para encontrar o culpado. Como desativar um aplicativo:

  • No Support, siga as instruções deste artigo: Gerenciamento dos seus aplicativos instalados.
  • Ou então, anexe o termo ?noapps à URL do ticket: 
https://your_subdomain.zendesk.com/agent/tickets/123456?noapps

Gerar um arquivo HAR

O arquivo HAR é um formato padrão para monitorar informações e eventos entre um navegador e um website. Registre os eventos de rede em um arquivo HAR para solucionar problemas de desempenho ou renderização. Para gerar um arquivo HAR, consulte este artigo: Geração de arquivo HAR para solução de problemas.

Usar a API de aplicativos

Resolva o problema aproveitando o ponto de extremidade da API, Listar instalações de aplicativos para gerar uma lista dos aplicativos instalados. Entre as propriedades contidas na resposta JSON, use a ID de instalação como parâmetro de consulta para noapps para desativar vários aplicativos ao mesmo tempo:

https://your_subdomain.zendesk.com/agent/tickets/123456?noapps=11111,22222,44444

Se você quiser obter informações sobre como criar um aplicativo do Support do zero, consulte este artigo: Criar seu primeiro aplicativo do Support - Parte 1: Preparando as bases. Se precisar de informações sobre como criar um aplicativo do lado do servidor, consulte este artigo: Criação de um aplicativo do lado do servidor - Parte 1: Principais conceitos.

Aviso sobre a tradução: este artigo foi traduzido por um software de tradução automática para oferecer a você uma compreensão básica do conteúdo. Medidas razoáveis foram tomadas para fornecer uma tradução precisa, no entanto, a Zendesk não garante a precisão da tradução.

Em caso de dúvidas relacionadas à precisão das informações contidas no artigo traduzido, consulte a versão oficial do artigo em inglês.

Powered by Zendesk