Shopify

L’integrazione con Shopify abilita le User Story sullo stato dell’ordine tramite il riconoscimento dell’utente loggato e il recupero delle informazioni di dettaglio degli ordini.

Integrazione tecnica

Per integrare Shopify occorre creare un’applicazione privata per autorizzare l’accesso alle informazioni.

Dal backend di Shopify accedere alla sezione Apps, poi scorrere fino alla fine della pagina e cliccare sul link “Working with a developer on your shop? Manage private apps”.

Cliccare sul tasto Create new private app e:

  1. dare un nome all’integrazione (es. “Heres Chatbot”);
  2. fornire la propria email per le segnalazioni;
  3. cliccare su See inactive permissions e consentire accesso readonly a Customers, Orders, Products, Fullfillment services;
  4. selezionare versione API 2021-01 o successive;
  5. salvare l’applicazione, in questo modo nell’elenco delle applicazioni private sarà disponibile il parametro API KEY da fornire a Heres insieme al nome del negozio, alla password e al token di accesso API.

Integrazione della webchat su Shopify

Per fare comparire la webchat su tutte le pagine di Shopify, occorre inserire il widget, come documentato in Integrazione webchat. Nello specifico, è necessario seguire i seguenti passaggi:

  1. Dal backend di Shopify, attivare la sezione Temi dal menu laterale;
  2. Attivare l’azione Modifica codice e aprire il file theme-head.liquid (se presente) oppure theme.liquid. In queste sezioni normalmente si trovano i tag <head></head>; la loro posizione potrebbe essere diversa a seconda del tema utilizzato;
  3. Inserire nella sezione head:
<script>
(function (H, e, r, es, B, o, t) {
       H["heres-widget"] = es;
       H[es] =H[es] || function () { (H[es].q = H[es].q || []).push(arguments);};
       (o = e.createElement(r)), (t = e.getElementsByTagName(r)[0]);
       o.id = es;H.heresAgent = B;
       o.src = "https://widgetv2.heres.ai/heres.js";
       o.async = 1;
       t.parentNode.insertBefore(o, t); 
})(window, document, "script", "heres", "#NOMEAGENTE");
heres('init', { userId: "{{ customer.email }}" });
</script>

4. Sostituire #NOMEAGENTE inserendo il nome dell’agente fornito da Heres al momento dell’attivazione.

Nota bene: queste procedure implementano e chiariscono le normali procedure di installazione della webchat in console nell’ambito specifico di Shopify. È possibile consultare la documentazione completa alla pagina Integrazione webchat.