Discourse Zendesk

[Discourse]

	Summary	Create Zendesk tickets from Discourse topics.
	Install Guide	This plugin is bundled with Discourse core. There is no need to install the plugin separately.

As this is an official plugin maintained by the Discourse team, Support, Bug, UX, and Feature requests can be made in the respective categories here on Meta, and tagged with the appropriate plugin tag. Click on a link below to get one started.

 Support  Bug  UX  Feature

Features

Create Zendesk tickets

This plugin allows you to create Zendesk tickets from Discourse topics. This can be done either by configuring the plugin so that all topics in a category automatically generate Zendesk tickets, or by pushing individual topics to Zendesk by clicking the “Create Zendesk Ticket” button that’s displayed for site staff below each topic:

When the ticket is created, the author of the topic’s first post will be set as the Requester on Zendesk. They will also be added to your Zendesk customers list.

After the ticket has been created, the “Create Zendesk Ticket” button will be updated to “View on Zendesk.” Clicking that button will take you to the associated Zendesk ticket:

Push replies created on Discourse to Zendesk

The plugin allows you to optionally push all replies to the Discourse topic to the Zendesk ticket, or to only push replies created by the topic’s author. Both of these features are configurable via the plugin’s settings.

Sync Zendesk comments with Discourse

Zendesk comment can be synced with the Discourse topic that the ticket originated on.

Configuration

The Discourse Zendesk settings can be accessed from the Plugins page of your Discourse site’s Admin section. Click the “Settings” button for the “discourse-zendesk-plugin” entry on that page to access the settings.

• zendesk url : enter the URL of your Zendesk account, followed by api/v2 . For example, https://example.zendesk.com/api/v2

• zendesk enabled : used to enable and disable the plugin.

• zendesk jobs api token : details for generating the API token on Zendesk are here: Generating a new API token – Zendesk help. Copy that token to this Discourse setting.

• zendesk jobs email : the email address of a staff user on your Zendesk account that also has an admin account on your Discourse site.

• zendesk autogenerate all categories (formerly zendesk enable all categories) : if enabled, all topics on your Discourse site will automatically generate Zendesk tickets. This setting is disabled by default.

• zendesk autogenerate categories (formerly zendesk enabled categories) : a list of Discourse categories that will have all new topics automatically pushed to Zendesk.

• zendesk job push all posts and zendesk job push only author posts : both of these settings are disabled by default. Enable one of them if you want to push either all replies, or only the topic author’s replies to Zendesk.

• sync comments from zendesk and zendesk incoming webhook token : these two settings are used to sync comments from Zendesk to Discourse. Details about how to configure syncing Zendesk comments to Discourse are here: How to enable Zendesk two-way sync

• zendesk tags : an optional list of tags to append to all Zendesk tickets that originate on your Discourse site.

Last edited by @tobiaseigen 2025-07-16T21:55:24Z

Check document

Perform check on document:

[Rob_Lauer]

Adoraria fazer uma solicitação de recurso para esta integração do Zendesk:

A capacidade de enviar respostas para o Zendesk como comentários e puxar comentários do Zendesk como respostas é realmente crítica para nós. No entanto, a única maneira de realizar o último é ter tópicos de categoria do Discourse especificados que criem automaticamente tickets do Zendesk.

Eu preferiria muito mais que houvesse uma maneira de ter tickets do Zendesk criados manualmente também com essa capacidade de puxar comentários como respostas! Isso ocorre porque temos um processo de triagem em vigor onde apenas alguns tópicos criados pelo cliente precisariam ser encaminhados para o Zendesk. Não gostaríamos de permitir que nossos usuários finais também criassem tickets do Zendesk nos bastidores.

Obrigado!

[acorrea]

Muito obrigado pelo plugin, ele nos ajudou muito!

Gostaria de ajuda com o seguinte problema:

• No Zendesk, quando criamos “notas internas” (notas privadas) em um ticket, essas notas internas não produzem um whisper no Discourse.
• Implementei um webhook no Zendesk para criar um whisper para cada nota interna, no entanto, esse whisper é então enviado para o Zendesk por causa do funcionamento normal do plugin.

Portanto, minha pergunta é: existe alguma maneira de impedir que o plugin crie um novo comentário no Zendesk quando eu crio os whispers a partir das notas internas, como descrito acima?

Sei que posso desativar a sincronização para todas as postagens, mas o objetivo seria não sincronizar apenas os whispers que crio via API do Discourse.

Você sabe se há uma solução fácil para isso?

[TheDevBird (Shane Vandegrift)]

Olá!

Não tenho certeza se este é o lugar certo para relatar um bug, então me avisem se devo mover isso para outro lugar.

Temos usado este plugin por algumas semanas e ele funcionou bem no geral. No entanto, encontramos um problema em que o plugin parece sincronizar comentários em duplicidade. O que eu acho que está acontecendo é:

1. O usuário envia uma postagem no Discourse
2. Ela é sincronizada no Zendesk
3. O plugin de sincronização vê o novo comentário no Zendesk e o sincroniza de volta para o Discourse

É isso que estamos vendo visualmente, onde John (o administrador que configurou o plugin) às vezes envia duplicatas de mensagens de outros usuários sem sua intervenção. Isso está vindo do plugin de sincronização do Discourse:

No lado do Zendesk, não vemos nenhuma Resposta duplicada, e vemos apenas a do usuário (não posso postar uma segunda captura de tela devido aos limites deste fórum).

Expandir a visualização do histórico do ticket não mostra nenhuma anormalidade no Zendesk.

Alguma ideia sobre o que pode estar dando errado ou como podemos depurar isso?

Obrigado!

[jessii]

Olá Shane! Tentei testar isso para ver se consigo replicar o problema, mas até agora não estou encontrando o mesmo problema.

@TheDevBird

O plugin de sincronização vê o novo comentário no Zendesk e o sincroniza de volta no Discourse

Para confirmar, parece que o ZD está apenas enviando automaticamente o comentário de volta para o Discourse. John não está citando ou copiando/colando o comentário?

Você configurou algum gatilho adicional no ZD quando configurou o plugin pela primeira vez?

[TheDevBird (Shane Vandegrift)]

Obrigado por ajudar! Sim, este é um problema de software, o John não está postando essas mensagens sozinho.

Vou verificar nossos gatilhos e testar desativá-los e reativá-los. Infelizmente, não encontrei nenhuma semelhança sobre quando ou por que isso acontece, então não tenho uma maneira direta de reproduzir.

[TheDevBird (Shane Vandegrift)]

Encontrei um gatilho que, sempre que um ticket é atualizado e possui a tag discourse, ele notificará o webhook de sincronização do Discourse através de uma requisição PUT. Eu não fui quem configurou o plugin, mas isso poderia ser o culpado?

Além desse gatilho, não vejo nenhuma outra automação que possa estar interferindo. Pedi aos nossos administradores do Discourse para retornarem uma lista de todos os comentários de John (incluindo os que excluímos) para que eu possa referenciar cruzadamente cada instância para tentar encontrar uma conexão.

[PeakProsperity (Aaron McKeon)]

Tenho usado e gostado muito do plugin Zendesk. No entanto, algo inesperado acabou de acontecer. Quando outro membro da equipe (alguém que costumava ser um agente no Zendesk) respondeu a um tópico no Discourse, o Zendesk enviou a mensagem de volta para o Discourse. Portanto, ela foi postada no tópico do Discourse duas vezes, uma com a autoria do membro da equipe que a postou no Discourse e outra pelo atual responsável pelo ticket no Zendesk.

Alguém já passou por isso e tem uma solução?

[abinash889 (Abinash Bhatta)]

Olá,

Estou encontrando um problema em que tópicos privados criados no lado da comunidade não estão sendo gerados no Zendesk. Alguém poderia me informar se há alguma configuração específica necessária para garantir que os tópicos privados sejam sincronizados corretamente com o Zendesk?

Agradeço antecipadamente pela ajuda.

[gormus (Osman Görmüş)]

Tenho uma solicitação de recurso : )

Vejo que os botões “Criar/Ver Ticket Zendesk” só estão visíveis para a equipe.

Seria possível controlar a visibilidade desses botões por novas configurações de plugin zendesk_create_ticket_allowed_groups e zendesk_view_ticket_allowed_groups para maior flexibilidade?

Eu não quero necessariamente conceder funções de administrador ou moderador às nossas equipes de suporte. Eles são, claro, os administradores de seu (Zendesk) domínio, mas, na minha opinião, isso nem sempre justifica privilégios estendidos no Discourse.

[tobiaseigen]

Este plugin agora está incluído no core do Discourse como parte de Bundling more popular plugins with Discourse core. Se você auto-hospeda e usa o plugin, precisa removê-lo do seu app.yml antes da sua próxima atualização.