Resumen
En esta documentación, cubriremos:
- Habilitación de la configuración de sincronización de Zendesk en Discourse
- Configuración de un webhook de Zendesk
- Configuración de un trigger (disparador) de Zendesk
Habilitación de la configuración de sincronización de Zendesk
Para comenzar, deberá habilitar el complemento de Zendesk, habilitar la configuración de sincronización y proporcionar un token seguro.
- Navegar a la Configuración del Complemento: Vaya a su sitio de Discourse y navegue a la página de configuración del complemento de Zendesk en
/admin/plugins/discourse-zendesk-plugin. Alternativamente, puede encontrar la configuración buscando en/admin/site_settings. - Habilitar el Complemento: Busque y habilite la configuración
zendesk enabledsi aún no está habilitada. - Habilitar la Configuración de Sincronización: Busque y habilite la configuración
sync comments from zendesk(sincronizar comentarios desde zendesk). - Proporcionar Token del Webhook: En el campo
zendesk incoming webhook token(token del webhook entrante de zendesk), genere y añada una cadena segura aleatoria. Este token se utilizará más tarde para configurar el webhook de Zendesk. - Configurar Categorías de Autogeneración: La sincronización bidireccional solo funciona para temas en categorías que están configuradas para la autogeneración de tickets de Zendesk. Habilite
zendesk autogenerate all categories(autogenerar todas las categorías de zendesk) o añada categorías específicas a la configuraciónzendesk autogenerate categories(categorías de autogeneración de zendesk). Sin esto, el webhook ignorará silenciosamente los comentarios entrantes.
Configuración de un webhook de Zendesk
Siga estos pasos para configurar un webhook en Zendesk:
- Acceder a la Página de Webhooks: Navegue a la sección Webhooks en Zendesk, en Aplicaciones e integraciones → Webhooks.
- URL de ejemplo:
https://\u003cinstance_name\u003e.zendesk.com/admin/apps-integrations/webhooks/webhooks
- URL de ejemplo:
- Crear un Webhook:
- Haga clic en el botón Acciones en la esquina superior derecha.
- Seleccione Crear webhook.
- Rellene los detalles del webhook:
- Método de solicitud (Request method):
PUT - URL del endpoint (Endpoint URL):
https://\u003cdiscourse.example.com\u003e/zendesk-plugin/sync - Formato de solicitud (Request format): JSON
- Método de solicitud (Request method):
- Probar el Webhook:
- Haga clic en el botón Probar webhook (Test Webhook).
- Seleccione ‘Prueba personalizada’ (Custom Test) en el menú desplegable.
- Reemplace el JSON con el siguiente, insertando su token:
{
"ticket_id": "{{ticket.id}}",
"topic_id": "{{ticket.external_id}}",
"email": "{{current_user.email}}",
"token": "INSERT TOKEN HERE"
}
- Presione Enviar prueba (Send Test). Espere una señal positiva de
400 Bad Requestcon la página HTML mostrada indicando éxito.
Configuración de un trigger (disparador) de Zendesk
Configure un trigger en Zendesk para automatizar acciones:
- Acceder a la Página de Triggers: Vaya a la sección Triggers en Zendesk, en Admin → Objetos y reglas → Reglas de negocio → Triggers.
- URL de ejemplo:
https://\u003cinstance_name\u003e.zendesk.com/admin/objects-rules/rules/triggers
- URL de ejemplo:
- Crear un Trigger:
- Haga clic en Añadir trigger (Add trigger).
- Asígnele el nombre “Sincronización Discourse” y establezca la categoría en “Notificaciones”.
- Configure las condiciones y acciones como se muestra a continuación.
- Utilice el mismo cuerpo JSON que en el paso de prueba del webhook, reemplazando nuevamente “INSERT TOKEN HERE” con su token.
- Guardar el Trigger: Una vez configurado, asegúrese de guardar el trigger.
Sin embargo, hay un problema cuando un comentario en Zendesk contiene un archivo adjunto: el mensaje llega, pero el archivo adjunto falta. No estoy seguro si hay un parámetro adicional que deba pasarse en el webhook para manejar los archivos adjuntos. ¿Alguien podría aclarar si se requieren parámetros específicos para esto?
