Riepilogo
In questa documentazione, tratteremo:
- Abilitazione delle impostazioni di sincronizzazione di Zendesk in Discourse
- Configurazione di un webhook di Zendesk
- Impostazione di un trigger di Zendesk
Abilitazione delle impostazioni di sincronizzazione di Zendesk
Per iniziare, dovrai abilitare il plugin Zendesk, abilitare l’impostazione di sincronizzazione e fornire un token sicuro.
- Accedi alle Impostazioni del Plugin: Vai al tuo sito Discourse e naviga alla pagina delle impostazioni del plugin Zendesk all’indirizzo
/admin/plugins/discourse-zendesk-plugin. In alternativa, puoi trovare le impostazioni cercando in/admin/site_settings. - Abilita il Plugin: Trova e abilita l’impostazione
zendesk enabledse non è già abilitata. - Abilita Impostazione Sincronizzazione: Trova e abilita l’impostazione
sync comments from zendesk. - Fornisci Token Webhook: Nel campo
zendesk incoming webhook token, genera e aggiungi una stringa casuale sicura. Questo token verrà utilizzato in seguito per configurare il webhook di Zendesk. - Configura Categorie Autogenerate: La sincronizzazione bidirezionale funziona solo per gli argomenti nelle categorie configurate per l’autogenerazione dei ticket Zendesk. Abilita
zendesk autogenerate all categoriesoppure aggiungi categorie specifiche all’impostazionezendesk autogenerate categories. Senza questa configurazione, il webhook ignorerà silenziosamente i commenti in arrivo.
Configurazione di un webhook di Zendesk
Segui questi passaggi per configurare un webhook in Zendesk:
- Accedi alla Pagina Webhook: Naviga alla sezione Webhook in Zendesk sotto App e integrazioni → Webhook.
- URL di esempio:
https://\u003cinstance_name\u003e.zendesk.com/admin/apps-integrations/webhooks/webhooks
- URL di esempio:
- Crea un Webhook:
- Clicca sul pulsante Azioni nell’angolo in alto a destra.
- Seleziona Crea Webhook.
- Compila i dettagli del webhook:
- Metodo di richiesta:
PUT - URL endpoint:
https://\u003cdiscourse.example.com\u003e/zendesk-plugin/sync - Formato richiesta: JSON
- Metodo di richiesta:
- Testa il Webhook:
- Clicca sul pulsante Testa Webhook.
- Seleziona ‘Test Personalizzato’ dal menu a discesa.
- Sostituisci il JSON con il seguente, inserendo il tuo token:
{
"ticket_id": "{{ticket.id}}",
"topic_id": "{{ticket.external_id}}",
"email": "{{current_user.email}}",
"token": "INSERISCI TOKEN QUI"
}
- Premi Invia Test. Aspettati un
400 Bad Requestcome segnale positivo con la pagina HTML visualizzata che indica il successo.
Impostazione di un trigger di Zendesk
Configura un trigger in Zendesk per automatizzare le azioni:
- Accedi alla Pagina Trigger: Vai alla sezione Trigger in Zendesk sotto Admin → Oggetti e Regole → Regole di Business → Trigger.
- URL di esempio:
https://\u003cinstance_name\u003e.zendesk.com/admin/objects-rules/rules/triggers
- URL di esempio:
- Crea un Trigger:
- Clicca su Aggiungi trigger.
- Assegnagli il nome “Discourse Sync” e imposta la categoria su “Notifiche”.
- Configura le condizioni e le azioni come mostrato di seguito.
- Utilizza lo stesso corpo JSON del passaggio del test del webhook, sostituendo nuovamente “INSERISCI TOKEN QUI” con il tuo token.
- Salva il Trigger: Una volta configurato, assicurati di salvare il trigger.
Tuttavia, c’è un problema quando un commento in Zendesk contiene un allegato: il messaggio arriva, ma l’allegato manca. Non sono sicuro se ci sia un parametro aggiuntivo che debba essere passato nel webhook per gestire gli allegati. Qualcuno potrebbe chiarire se sono necessari parametri specifici per questo?
