 |
Resumen | Crear tickets de Zendesk a partir de temas de Discourse. |
 |
Guía de instalación | Este plugin viene incluido con el núcleo de Discourse. No es necesario instalar el plugin por separado. |
Dado que Zendesk desactivará permanentemente la autenticación mediante token de API el 30 de abril de 2027, las instalaciones existentes deben migrar a la autenticación mediante OAuth.
Funciones
Crear tickets de Zendesk
Este plugin te permite crear tickets de Zendesk a partir de temas de Discourse. Esto se puede hacer configurando el plugin para que todos los temas de una categoría generen automáticamente tickets de Zendesk, o bien enviando temas individuales a Zendesk haciendo clic en el botón «Crear ticket de Zendesk» que se muestra para el personal del sitio debajo de cada tema:
Cuando se crea el ticket, el autor de la primera publicación del tema se establecerá como Solicitante en Zendesk. También se añadirá a tu lista de clientes de Zendesk.
Después de que se haya creado el ticket, el botón «Crear ticket de Zendesk» se actualizará a «Ver en Zendesk». Hacer clic en ese botón te llevará al ticket de Zendesk asociado:
Enviar respuestas creadas en Discourse a Zendesk
El plugin te permite opcionalmente enviar todas las respuestas al tema de Discourse al ticket de Zendesk, o solo enviar las respuestas creadas por el autor del tema. Ambas funciones son configurables a través de la configuración del plugin.
Sincronizar comentarios de Zendesk con Discourse
Los comentarios de Zendesk pueden sincronizarse con el tema de Discourse del que se originó el ticket.
Configuración
La configuración de Discourse Zendesk se puede acceder desde la página de Plugins de la sección de Administración de tu sitio de Discourse. Haz clic en el botón «Configuración» para la entrada «discourse-zendesk-plugin» en esa página.
Configurar OAuth
Primero, crea un cliente OAuth en Zendesk:
- En el Centro de Administración de Zendesk, ve a Apps and integrations > APIs > OAuth clients.
- Haz clic en Add OAuth client.
- Introduce un name, una description y selecciona Confidential como tipo de cliente. No se requiere una URL de redirección.
- Configura los Scopes en
tickets:read,tickets:write,users:readyusers:writepara restringir el cliente OAuth solo a los ámbitos requeridos por el plugin. - Guarda el cliente.
- Copia el Identifier y el Secret del cliente. Zendesk muestra el secreto completo solo una vez.
Configura estos ajustes de Discourse:
zendesk oauth client id: introduce el Identifier del cliente OAuth.zendesk oauth client secret: introduce el Secret del cliente OAuth.
Otros ajustes
-
zendesk url: introduce la URL de tu cuenta de Zendesk seguida de/api/v2. Por ejemplo,https://example.zendesk.com/api/v2. -
zendesk enabled: habilitar o deshabilitar el plugin. -
zendesk jobs api token: Obsoleto. Las instalaciones existentes deben migrar a OAuth. -
zendesk jobs email: Obsoleto. Las instalaciones existentes deben migrar a OAuth. -
zendesk autogenerate all categories(anteriormentezendesk enable all categories): crear automáticamente tickets de Zendesk para temas en todas las categorías. Esta configuración está deshabilitada de forma predeterminada. -
zendesk autogenerate categories(anteriormentezendesk enabled categories): selecciona las categorías de Discourse cuyos nuevos temas deben crear automáticamente tickets de Zendesk. -
zendesk job push all posts: enviar respuestas a Zendesk como comentarios del ticket. Esta configuración está habilitada de forma predeterminada. -
zendesk job push only author posts: solo enviar respuestas escritas por el autor original del tema. Esta configuración se aplica cuandozendesk job push all postsestá habilitado y está deshabilitada de forma predeterminada. -
sync comments from zendeskyzendesk incoming webhook token: sincronizar comentarios de Zendesk con Discourse. Consulta Cómo habilitar la sincronización bidireccional de Zendesk. -
zendesk tags: una lista opcional de etiquetas para añadir a los tickets de Zendesk creados desde Discourse.