 |
Resumo | Crie tickets no Zendesk a partir de tópicos do Discourse. |
 |
Guia de Instalação | Este plugin é incluído no núcleo do Discourse. Não é necessário instalá-lo separadamente. |
Como o Zendesk desativará permanentemente a autenticação por token de API em 30 de abril de 2027, as instalações existentes precisam migrar para a autenticação via OAuth.
Recursos
Criar tickets no Zendesk
Este plugin permite criar tickets no Zendesk a partir de tópicos do Discourse. Isso pode ser feito configurando o plugin para que todos os tópicos em uma categoria gerem automaticamente tickets no Zendesk, ou enviando tópicos individuais para o Zendesk clicando no botão “Criar Ticket no Zendesk”, que é exibido para a equipe do site abaixo de cada tópico:
Quando o ticket é criado, o autor da primeira publicação do tópico será definido como o Solicitante no Zendesk. Eles também serão adicionados à sua lista de clientes do Zendesk.
Após a criação do ticket, o botão “Criar Ticket no Zendesk” será atualizado para “Ver no Zendesk”. Clicar nesse botão levará você ao ticket correspondente no Zendesk:
Enviar respostas criadas no Discourse para o Zendesk
O plugin permite, opcionalmente, enviar todas as respostas ao tópico do Discourse para o ticket do Zendesk, ou apenas enviar respostas criadas pelo autor do tópico. Ambos os recursos são configuráveis nas configurações do plugin.
Sincronizar comentários do Zendesk com o Discourse
Comentários do Zendesk podem ser sincronizados com o tópico do Discourse de origem do ticket.
Configuração
As configurações do Discourse Zendesk podem ser acessadas na página de Plugins da seção Admin do seu site Discourse. Clique no botão “Configurações” para a entrada “discourse-zendesk-plugin” nessa página.
Configurar OAuth
Primeiro, crie um cliente OAuth no Zendesk:
- No Zendesk Admin Center, vá para Apps and integrations > APIs > OAuth clients.
- Clique em Add OAuth client.
- Insira um nome, descrição e selecione Confidential como o tipo de cliente. Uma URL de redirecionamento não é necessária.
- Configure os Scopes para
tickets:read,tickets:write,users:readeusers:writepara restringir o cliente OAuth apenas aos escopos necessários para o plugin. - Salve o cliente.
- Copie o Identifier e o Secret do cliente. O Zendesk exibe o segredo completo apenas uma vez.
Configure estas configurações do Discourse:
zendesk oauth client id: insira o Identifier do cliente OAuth.zendesk oauth client secret: insira o Secret do cliente OAuth.
Outras configurações
-
zendesk url: insira a URL da sua conta do Zendesk seguida de/api/v2. Por exemplo,https://example.zendesk.com/api/v2. -
zendesk enabled: ativar ou desativar o plugin. -
zendesk jobs api token: Descontinuado. Instalações existentes devem migrar para OAuth. -
zendesk jobs email: Descontinuado. Instalações existentes devem migrar para OAuth. -
zendesk autogenerate all categories(anteriormentezendesk enable all categories): cria automaticamente tickets no Zendesk para tópicos em todas as categorias. Esta configuração está desativada por padrão. -
zendesk autogenerate categories(anteriormentezendesk enabled categories): selecione as categorias do Discourse cujos novos tópicos devem criar automaticamente tickets no Zendesk. -
zendesk job push all posts: envia respostas para o Zendesk como comentários de ticket. Esta configuração está ativada por padrão. -
zendesk job push only author posts: envia apenas respostas escritas pelo autor original do tópico. Esta configuração se aplica quandozendesk job push all postsestá ativado e está desativada por padrão. -
sync comments from zendeskezendesk incoming webhook token: sincroniza comentários do Zendesk para o Discourse. Veja Como ativar a sincronização bidirecional do Zendesk. -
zendesk tags: uma lista opcional de tags para adicionar aos tickets do Zendesk criados a partir do Discourse.