A integração com o Zendesk Guide traz para o Base os artigos que você já mantém na sua central de ajuda do Zendesk. Assim, esses artigos passam a ser usados também pelo Droz AI e pela extensão do Base no navegador, sem que você precise copiá-los um a um.
Quem pode fazer: pessoas com Pode Administrar na organização. Veja Permissões e acessos no Base.
Atenção: defina as configurações na implantação. A frequência de importação e a regra de remoção precisam ficar certas desde o início. Depois que a integração está rodando, mudar essas opções não ajusta o que já foi importado.
Se precisar mudar alguma delas, por exemplo a frequência de importação, é preciso refazer a integração do zero:
1. Apague no Base todos os Espaços e artigos que vieram da integração.
2. Esvazie esses itens também da Lixeira.
3. Configure a integração de novo, já com as opções que você quer.
Onde ficam as integrações
Clique na sua foto, no canto superior direito, e vá em Configurações do ambiente > Integrações. A tela lista as integrações da organização, com o Título, a URL da integração (o endereço da sua central de ajuda) e o Status. Uma integração funcionando aparece como Ativa.
Configure a integração
- Em Integrações, clique no menu ⋮ da linha Integração com Zendesk e escolha Editar integração.
- Em Dados para integração, preencha os três campos:
- Endereço: a URL da sua central de ajuda no Zendesk.
-
Usuário: o e-mail de um usuário do Zendesk seguido de
/token, comonome@suaempresa.com.br/token. Esse usuário precisa ter acesso à API do Zendesk. - Senha ou APIkey: o token de API gerado no Zendesk, e não a senha do usuário.
- Em Frequência de importação, marque Importar sempre que houver atualização nos artigos se quiser que as mudanças feitas no Zendesk cheguem também ao Base.
- Em Remoção de artigos, escolha o que acontece no Base quando um artigo é removido do Zendesk (veja a tabela abaixo).
- Clique em Salvar alterações.
- Clique em Sincronizar artigos para trazer os artigos para o Base.
Como funciona a autenticação: o Base se conecta ao Zendesk por token de API. Por isso, o usuário leva /token no fim do e-mail, e o campo de senha recebe o token.
Para gerar o token, entre na Central de administração do Zendesk, vá em Aplicativos e integrações > APIs, confira se o acesso por token está ativado e crie um novo token. Copie o token na hora, porque o Zendesk mostra ele uma vez só.
Acompanhe a importação
Depois de clicar em Sincronizar artigos, acompanhe o andamento pelo ícone de notificações (o sino), no topo do Base. Cada artigo e cada Espaço criado pela importação gera uma notificação, então dá para ver o que já chegou sem sair da tela em que você está.
O que acontece quando um artigo sai do Zendesk
| Opção | O que o Base faz |
|---|---|
| Remover artigos do Base após remoção do Zendesk | Quando um artigo é removido do Zendesk, o Base remove também a cópia dele. |
| Manter artigos no Base após remoção do Zendesk | O artigo continua no Base, mesmo depois de sair do Zendesk. |
Dica: se o Zendesk continua sendo o lugar onde a equipe escreve, marque a frequência de importação e a remoção junto com o Zendesk. Assim o Base fica sempre igual à central. Se a ideia é migrar de vez para o Base, prefira manter os artigos.
Pausar a integração
Para parar a importação, clique no menu ⋮ da integração e escolha Desativar integração.