A conexão com o Zendesk é feita pelo login do próprio Zendesk: você informa o endereço da sua conta, é direcionado à tela do Zendesk, vê as permissões do aplicativo da Toca, clica em Allow e volta à Toca. Nenhuma chave ou token é digitado à mão. A conexão vale para a conta do endereço informado e age com a permissão de quem autorizou.
Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.
Antes de começar
- Tenha à mão o endereço do seu Zendesk, o que aparece no navegador quando você abre o painel de agente, no formato suaempresa.zendesk.com. Se a sua central de ajuda usa um domínio próprio, use mesmo assim o endereço que termina em zendesk.com.
- Autorize com um usuário agente ou administrador. Usuário final (cliente) não conecta.
- Para a Toca também mexer em gatilhos, automações, SLAs, horários de atendimento e campos de ticket, conecte com um administrador. Com um agente comum a conexão funciona, mas o Zendesk recusa essas alterações.
- A Toca enxerga o que o usuário conectado enxerga. Agente com acesso restrito a alguns grupos ou organizações vê só esses tickets, e as respostas da Toca também.
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Zendesk e clique em Conectar.
- No campo Endereço do Zendesk, informe o endereço da sua conta (por exemplo, suaempresa.zendesk.com) e clique em Autorizar no Zendesk.
- Na tela do Zendesk, entre com o seu usuário de agente ou administrador, se ainda não estiver logado.
- Revise as permissões solicitadas e clique em Allow (Permitir).
- De volta à Toca, o card fica marcado como conectado.
O que a Toca acessa
Com a conexão ativa, a Toca lê os tickets e as conversas com os clientes (comentários públicos e notas internas), o status, a prioridade, o grupo e o agente de cada atendimento, as métricas de tempo de primeira resposta e de resolução, os SLAs, as notas de satisfação, os tickets suspensos e os apagados, os clientes e as organizações, os grupos e agentes, as macros, as visualizações, os gatilhos e as automações, os campos e formulários, os objetos personalizados e os artigos, seções e a comunidade da central de ajuda.
A Toca também altera: responde ao cliente e registra notas internas, muda status, prioridade, grupo e agente, inclui e tira tags, cria, mescla, marca como spam e apaga tickets, abre conversas paralelas, cadastra e atualiza clientes e organizações, e cria e ajusta macros, visualizações, gatilhos, automações, SLAs, horários de atendimento, campos e artigos da central de ajuda. Toda alteração só acontece mediante sua aprovação explícita, pedido a pedido, dentro do chat, e o pedido de aprovação diz se a mensagem vai ao cliente ou fica interna.
Ficam de fora o envio de anexos e imagens, a administração da conta (marcas, papéis, agentes e licenças, endereços de e-mail, segurança e aplicativos), os webhooks e targets, a importação de tickets antigos e as notas de satisfação e votos, que são do cliente. Isso continua no painel do Zendesk.
Manutenção da conexão
A Toca renova a autorização automaticamente. O Zendesk encerra a autorização se ela ficar 90 dias sem uso ou se o acesso do aplicativo for revogado no Zendesk. Nesses casos, clique em Reconectar no card em Configurações → Integrações.
As consultas usam o limite de requisições por minuto da sua conta no Zendesk, o mesmo dos outros aplicativos conectados (de 200 a 700 por minuto, conforme o plano).
Problemas comuns
- A Toca não reconhece o endereço — informe o endereço que termina em zendesk.com (suaempresa.zendesk.com), e não o domínio próprio da central de ajuda.
- A conexão foi recusada por ser de usuário final — conecte de novo entrando no Zendesk com um agente ou administrador.
- Uma alteração em gatilho, automação, SLA ou campo foi recusada — essas alterações pedem um administrador. Conecte de novo com um administrador da conta.
- Um ticket não aparece — a Toca enxerga só o que o usuário conectado enxerga no Zendesk. Ajuste o acesso do agente ou conecte com quem vê todos os tickets.
- Um ticket fechado não muda — no Zendesk, ticket fechado não aceita alteração. Peça à Toca um ticket de acompanhamento.
- A Toca diz que o limite do Zendesk acabou — o limite por minuto da conta foi consumido pela Toca e pelos outros aplicativos. Ele volta no minuto seguinte.
- Conectou a conta errada — use Excluir integração no menu ⋯ do card e conecte de novo.