Come collegare Zendesk a Shopify Flow
Zendesk può attivare un Webhook tramite un trigger o un’automazione ogni volta che un ticket subisce una modifica. Workflow Webhooks trasforma tale chiamata in un Webhook Shopify Flow, in modo che il Suo negozio possa reagire di conseguenza: assegnare un Tag a un cliente, aggiungere una nota all’ordine, inviare un’e-mail interna, aggiornare un metacampo - qualsiasi operazione che Shopify Flow sia in grado di eseguire.
La presente guida illustra l'intero percorso - Zendesk invia, Workflow Webhooks riceve e verifica, Shopify Flow esegue l'azione - con la firma HMAC di Zendesk verificata ad ogni richiesta, in modo che solo Zendesk possa avviare il Suo workflow.
Cosa potete realizzare
- Tag il cliente Shopify associato a un ticket che è stato inoltrato a un livello superiore, in modo che il Suo team possa visualizzarlo nella pannello di amministrazione.
- Si prega di aggiungere una nota all'ordine quando viene risolto un ticket di assistenza relativo a tale ordine.
- Si prega di inviare un’e-mail a un responsabile qualora un cliente di grande valore esprima un giudizio negativo in merito alla soddisfazione.
Eventi tipici da inviare: viene creato un ticket, viene risolto un ticket, viene ricevuta una valutazione di soddisfazione.
Prima di iniziare
- Workflow Webhooks installato sul vostro negozio Shopify.
- Shopify Flow installata, disponibile gratuitamente dall’App Store all’indirizzo Shopify.
- Un account su Zendesk con l'autorizzazione a creare webhook.
Fase 1 - Creare il webhook all'indirizzo Workflow Webhooks
- Acceda a Workflow Webhooks -> Webhook -> Crea webhook e assegni al webhook un nome che potrà riconoscere in Shopify Flow, ad esempio
Zendesk events. - Nella sezione "Autenticazione", selezioni HMAC.
- Nella sezione “Fornitore di firma”, selezioni Zendesk. L’app compila automaticamente i campi relativi all’intestazione, all’algoritmo, al payload firmato e alla finestra di replay; non è necessario configurare nient’altro.
- Per il momento lasci il campo “segreto” vuoto e clicchi su “Salva”. Copi l’URL del webhook visualizzato nella pagina.
Per ulteriori informazioni sulle altre modalità di autenticazione, consulti il sito Autenticazione; per scegliere quali campi inviare a Shopify Flow, consulti il sito Mappatura del payload e variabili di flusso.
Fase 2 - Aggiungere l’endpoint in Zendesk
Nel Centro di amministrazione di Zendesk, apra “App e integrazioni” -> “Webhook”, crei un webhook che punti all’URL che ha copiato, lo colleghi a un trigger, quindi utilizzi la funzione “Rivelare segreto”.
Come individuare il proprio segreto di firma Zendesk
Il segreto di firma del webhook (Centro di amministrazione -> App e integrazioni -> Webhook -> Mostra segreto).
La documentazione ufficiale di Zendesk sulle firme dei webhook, disponibile all'indirizzo, riporta il testo esatto e le schermate relative al Suo account.
Inserisca tale codice segreto nel campo "Secret" del webhook all'indirizzo Workflow Webhooks e salvi. Da quel momento in poi, ogni messaggio inviato da Zendesk verrà verificato prima di raggiungere Shopify Flow.
Cosa verifica questa operazione
| Cosa | Valore |
|---|---|
| Intestazione della firma | X-Zendesk-Webhook-Signature |
| Dove si trova la firma | Il valore completo dell'intestazione |
| Cosa è stato firmato | {header:x-zendesk-webhook-signature-timestamp}{body} |
| Firma | HMAC-SHA256, codificato in base64 |
| Data e ora | Non utilizzato da questo mittente |
| Protezione contro la riproduzione | Nessuna - questo mittente non appone una firma sul timestamp, pertanto ogni firma valida rimane valida |
| Il segreto | Da utilizzare come testo semplice. Lo incolli esattamente come appare nel messaggio del mittente |
Nel payload firmato, {body} rappresenta il corpo della richiesta in formato grezzo, byte per byte, mentre {header:x-zendesk-webhook-signature-timestamp} rappresenta l'intestazione della richiesta x-zendesk-webhook-signature-timestamp.
Una richiesta che non soddisfi uno qualsiasi di questi requisiti viene respinta con l'errore 401, viene registrata in Cronologia e risoluzione dei problemi e non avvia mai un workflow.
Fase 3 - Creare il workflow Shopify Flow
- In "Shopify Flow", crei un workflow e selezioni il trigger "Workflow Webhooks".
- Clicchi su “Registra eventi”, quindi invii un evento di prova da Zendesk (oppure utilizzi l’opzione “Invia prova” in Workflow Webhooks) in modo che Shopify Flow apprenda la struttura dei Suoi dati.
- Ogni webhook di cui disponete attiva lo stesso trigger del flusso; pertanto, aggiungete una prima condizione relativa all’ID del webhook per limitare questo workflow esclusivamente a Zendesk. L’ID è riportato nella pagina dedicata ai webhook.
- Aggiunga le sue azioni: contrassegni un cliente, aggiunga una nota, invii un’e-mail interna, aggiorni un metacampo.
Fase 4 - Eseguire un test end-to-end
Attivi un evento reale in Zendesk. In Workflow Webhooks -> Cronologia dovrebbe visualizzare la richiesta con lo stato “Successo”. Se la firma non era corretta, verrà invece visualizzata una voce con lo stato “Fallito” e il motivo corrispondente; all’indirizzo Verifica dei webhook firmati è disponibile lo strumento di verifica della firma che le mostra esattamente quale fase non è andata a buon fine.
La firma non corrisponde▾
In questo ordine: il segreto (la causa più comune: uno spazio in eccesso o una chiave proveniente da un ambiente errato), se il mittente sta utilizzando il segreto di un endpoint diverso e se qualcosa tra Zendesk e l’app riscrive il corpo del messaggio. Le firme coprono i byte grezzi, pertanto un proxy che riformatta il JSON le invalida. Il tester delle firme nella pagina dei webhook mostra il testo esatto che è stato firmato.
Ricevo un errore 401 ad ogni richiesta▾
Verifichi che l'autenticazione del webhook sia impostata su HMAC con il provider Zendesk selezionato, che il codice segreto sia stato inserito e che Zendesk effettui l'invio all'URL esattamente come indicato dall'app, compreso il codice alla fine.
Nella cronologia non compare nulla▾
La richiesta non è mai pervenuta. Verifichi nuovamente l’URL in Zendesk e consulti il registro di consegna di Zendesk per verificare la risposta ricevuta. Un errore del tipo 404 indica un webhook errato o eliminato, mentre un errore del tipo 429 significa che ha superato il limite di invocazioni previsto dal Suo piano; per ulteriori informazioni, consulti Piani e utilizzo.
Il workflow viene eseguito per eventi non corretti▾
Ogni webhook del Suo negozio attiva lo stesso trigger di Shopify Flow. Aggiunga una condizione relativa all**’ID** del webhook come primo passaggio del workflow, oppure restringa il campo degli eventi inviati da Zendesk.
Correlati
- Verifica dei webhook firmati - ogni fornitore che verifichiamo e come descrivere quelli che non verifichiamo.
- Mappatura del payload e variabili di flusso - estrarre i campi corretti dal payload e inserirli in Shopify Flow.
- Protezione contro le consegne duplicate - cosa succede quando Zendesk riprova a effettuare una consegna.
- Cronologia e risoluzione dei problemi - il registro di ogni richiesta, con la possibilità di riprodurla.