Integrazione Zendesk Chat

Setup

Seguire tutti i punti elencati per il setup del bot su Zendesk.

1. Creazione agente

Creare un agente su Zendesk chat con nome “bot” (deve essere unico).

2. Client API e access token

Generare Client API andando nella sezione Impostazioni > Account > API e SDK > Aggiugi Client API e impostare come url reindirizzamento http://localhost e http://localhost/token.

Sostituire il CLIENT_ID e SUBDOMAIN fornito da Zendesk nell’url sottostante e aprire il link nel browser:

https://www.zopim.com/oauth2/authorizations/new?response_type=token&client_id={CLIENT_ID}&scope=read%20write%20chat&redirect_uri=http%3A%2F%2Flocalhost%2Ftoken&subdomain={SUBDOMAIN}

Una volta aperto il link, bisogna accettare la richiesta di permesso (deve essere accettata con l’account dell’agente “bot”). A quel punto si verrà reindirizzati verso una nuova pagina e l’url conterrà l’ACCESS_TOKEN necessario per l’integrazione.

L’access token verrà ritornato nell’url, esempio:

http://localhost/token#access_token={ACCESS_TOKEN}&token_type=Bearer&scope=read+write+chat

Successivamente, dare il seguente ACCESS_TOKEN a Heres.

3. Account key

Per attivare la comunicazione della chat Heres con Zendesk bisogna ottenere l’account key che si trova nella sezione Chat > Verifica connessione > Account key (Zendesk Chat Web SDK).

Dare il seguente ACCOUNT_KEY a Heres.

4. Secret shared key

Per attivare l’autenticazione degli utenti bisogna generare la chiave segreta condivisa (Enabling authenticated visitors in the Chat widget) andando nella sezione Chat > Impostazioni > Widget > Sicurezza Widget > Autenticazione visitatori.

Dare il SECRET_KEY a Heres.

Note

1. Nel caso di richiesta di escalation vengono notificati i dipartimenti indicati, altrimenti viene notificato di default il dipartimento con il nome “escalation”. Se questo non esiste non viene notificato nessun dipartimento.
2. I dipartimenti vengono sincronizzati ogni 10 minuti circa in caso di creazione, modifica ed eliminazione.