Shopify-liitin
Toimii yhdessä Shopify
Yhdistä Shopify FreeScoutiin, jotta keskustelut näyttävät vastaavat asiakastilaukset ja osto kontekstin. Luot Shopify-hallinnassasi vain luku -oikeuksin varustetun mukautetun sovelluksen ja liität sen käyttöoikeustokenin FreeScoutiin, joten Partner-tiliä tai sovelluksen tarkistusta ei tarvita. ReplyRabbit syöttää myös tuoteomistuksen kontekstin AI-kerrokseen, jotta luonnokset voivat viitata siihen, mitä asiakas on ostanut.
Etsitkö yleiskatsausta?
Yleiskatsaus
Shopify-liitin lisää tilauksen sivupalkin FreeScout-keskusteluihin. Kun keskustelussa on asiakkaan sähköpostiosoite, liitin kysyy kaupastasi Shopify GraphQL Admin APIsta vastaavia tilauksia ja näyttää ne keskustelun vieressä.
Sivupalkki näyttää asiakaspaneelin, täyden tilaushistorian, tilaustason rivit määrineen ja hintoineen, taloudelliset kokonaissummat, asiakkaan elinkaariarvon (CLV), keskimääräisen tilausarvon (AOV) ja tuoteomistusoikeuden, joka välittyy ReplyRabbit AI -kontekstiin osuvampia luonnoksia varten.
Asennettavia komponentteja on yksi: FreeScout Shopify -liitinmoduuli. Se lukee Shopify GraphQL Admin API:a HTTPS:n yli mukautetun sovelluksen Admin API -käyttöoikeustokenilla ja näyttää sitten tilauksen sivupalkin. Sillä on oma postilaatikkokohtainen asetussivu FreeScoutissa.
Tilaussivupalkki toimii itsenäisesti. Tuoteomistuksen oikeus, joka virtaa AI-luonnoksiin, on osa, joka käyttää ReplyRabbitia.
Edellytykset
Ennen kuin aloitat, varmista, että sinulla on:
- Toimiva FreeScout-asennus.
- Shopify-kauppa alustalla
your-store.myshopify.comverkkotunnus (tai mukautettu verkkotunnus, joka yhdistyy siihen), ja henkilöstöllä on oikeudet kehittää sovelluksia. - ReplyRabbit asennettuna ja aktivoituna, jos haluat tuoteomistajuuskontekstin tekoälyluonnoksiin.
- Shopify Connector -lisenssi (18 EUR kertamaksu yhtä FreeScout-asennusta kohden) tai aktiivinen ReplyRabbit Pro- tai Team-suunnitelma, joka sisältää sen.
Jos ReplyRabbitiä ei ole vielä asennettu, aloita kohdasta Miten ReplyRabbit-moduuli asennetaan, sitten viimeistele Miten ReplyRabbit määritetään.
Luo mukautettu sovellus Shopifyssa
Liitin todentaa Admin API -käyttöoikeustokenilla mukautetusta sovelluksesta, joka sijaitsee omassa kauppasi sisällä.
Avaa Kehitä sovelluksia
Siirry Shopify-ylläpidossa kohtaan Asetukset, sitten Sovellukset ja myyntikanavat, sitten Kehitä sovelluksia. Jos sinulta kysytään, salli mukautetun sovelluksen kehitys.Luo sovellus
Napsauta Luo sovellus, nimeä se "ReplyRabbit Connector" ja luo se.Aseta Admin API -käyttöoikeudet
Avaa Määritä Admin API -laajuudet ja valitseread_customers,read_orders, jaread_products. Valitseread_all_ordersmyös, jos haluat yli 60 päivää vanhempaa tilaushistoriaa. Tallenna.Asenna ja kopioi tunnus
Napsauta Asenna sovellus, sitten Paljasta token kerran ja kopioi Järjestelmänvalvojan API-käyttöoikeustoken (se alkaashpat_). Shopify näyttää sen vain kerran, joten tallenna se turvalliseen paikkaan.
Vain luku -käyttöoikeus
Asenna FreeScout-liitännäismoduuli
Lataa liitinmoduuli
Lataa FreeScout-liitinmoduulin ZIP-tiedosto osoitteesta ReplyRabbit-hallintapaneeli. Lataus tulee näkyviin, kun olet ostanut liittimen tai sinulla on aktiivinen ReplyRabbit Pro- tai Team-suunnitelma.Lataa FreeScoutiin
Siirry FreeScoutissa kohtaan Moduulit, napsauta latauspainiketta, valitse ZIP-tiedosto ja asenna se.Aktivoi moduuli
Aktivoi Shopify-integraatio moduuli Moduulit-luettelosta.
Määritä postilaatikkokohtaisesti
Avaa liittimen asetukset
Avaa FreeScoutissa postilaatikko, jonka pitäisi näyttää Shopify-tilaustiedot, avaa postilaatikon asetusvalikko ja valitse Kauppaliitin. Tämä on Shopify-liittimen asetussivu, ei ReplyRabbit-asetusten osa.Anna kaupan verkkotunnus ja käyttöoikeustoken
Anna kaupan verkkotunnus, esimerkiksiyour-store.myshopify.com, ja liitä Admin API -käyttöoikeustoken. Tallenna. Liitin tarkistaa tokenin ja käyttöoikeudet kauppaasi vasten ennen tallentamista; token tallennetaan salattuna, eikä sitä näytetä enää uudelleen.Lisää liittimen lisenssiavain
Jos ostit liittimen, asetaSHOPIFYINTEGRATION_LICENSE_KEYFreeScoutissasi.envsen lisenssiavain. Ohita tämä vaihe, jos aktiivinen ReplyRabbit Pro- tai Team-tilaus kattaa asennuksen.Testaa
Avaa FreeScout-keskustelu, jossa asiakkaan sähköposti vastaa Shopify-tilausta, ja varmista, että tilausten sivupalkki tulee näkyviin.
Jokainen FreeScout-postilaatikko tallentaa oman kauppaverkkotunnuksensa ja käyttöoikeustunnuksensa, joten voit yhdistää eri postilaatikot eri kauppoihin.
Mitä liitin näyttää
- Asiakaspaneeli keskustelussa olevalle henkilölle.
- Täydellinen tilaushistoria tilausnumerolla, päivämäärällä, tilalla ja summalla.
- Tilauskohtaiset rivitiedot määrineen ja hintoineen.
- Taloudelliset kokonaissummat (välisumma, alennus, toimitus, vero, hyvitykset).
- Asiakkaan elinkaariarvo (CLV) ja keskimääräinen tilausarvo (AOV).
- Tuotteen omistusoikeus tekoälyluonnoksille.
Miten liittimen saa
Shopify Connector on maksullinen moduuli. Voit hankkia sen kahdella tavalla:
- Osta Shopify Connector 18 EUR:lla kertaluonteisena lisenssinä yhdelle FreeScout-asennukselle ja aseta sen lisenssiavain arvoksi
SHOPIFYINTEGRATION_LICENSE_KEYFreeScoutin.env. - Käytä aktiivista ReplyRabbit Pro- tai Team-suunnitelmaa, joka sisältää liittimen ilman lisäkustannuksia.
Osta lisenssi tai lataa liitin ReplyRabbit-hallintapaneeli. Käy osoitteessa hinnoittelusivu ReplyRabbit-suunnitelmavaihtoehtoja varten. Jos aktiivinen ReplyRabbit Pro- tai Team-suunnitelma kattaa asennuksen, liitin toimii, kun se on määritetty, ilman erillistä lisenssiavainta.
Vianmääritys
| Oire | Mitä tarkistaa |
|---|---|
| "Shopify hylkäsi yhteyden" tallennettaessa | Tunnus kirjoitettiin väärin, peruutettiin tai kuuluu eri kauppaan. Paljasta uusi tunnus asentamalla mukautettu sovellus uudelleen ja liitä se uudelleen. |
| "Nämä Admin API -käyttöoikeudet puuttuvat" tallennettaessa | Avaa mukautettu sovellus, lisää puuttuvat käyttöoikeudet kohdassa Määritä Admin API -laajuudet, tallenna ja asenna sovellus uudelleen. Uudelleenasennus myöntää uuden tokenin. |
| Kaupan verkkotunnus hylätään | Käytä your-store.myshopify.com verkkotunnus tai mukautettu verkkotunnus, joka yhdistyy siihen. Yksityiset isännät ja IP-osoitteet hylätään. |
| Tilauksen sivupalkki ei näy | Vahvista, että postilaatikon paneeli on käytössä ja että yhteys näkyy yhdistettynä asetussivulla. |
| Tilaukset ovat tyhjiä tunnetulle asiakkaalle | Vahvista, että FreeScout-keskustelun asiakassähköposti vastaa heidän Shopify-tilaustensa sähköpostia. |
| Vain viimeisten 60 päivän tilaukset näkyvät | Lisää read_all_orders kohdista mukautettuun sovellukseen, asenna se uudelleen ja liitä uusi token. |
| Rivit, taloustiedot tai CLV eivät näy | Vahvista, että liittimen lisenssiavain on tallennettu tai että aktiivinen ReplyRabbit Pro- tai Team-suunnitelma kattaa asennuksen. |
| Tuotteen omistuskonteksti ei näy luonnoksissa | Vahvista, että liitin on lisensoitu, ReplyRabbit on asennettu, liitin palauttaa tilauksia ja tekoälykontekstiominaisuus on käytössä postilaatikolle. |
Laajempia ongelmia varten katso ReplyRabbitin vianmääritys.
Tietosuoja ja tietojen käsittely
Kun liitin tekee kyselyn Shopifyyn, se lähettää asiakkaan sähköpostiosoitteen Shopify GraphQL Admin API:lle HTTPS:n yli mukautetun sovelluksesi tokenilla. Kaupastasi palautetut tilaustiedot täyttävät FreeScout-sivupalkin ja rakentavat ReplyRabbitin kanssa AI-kontekstin luonnoksille.
Mukautetulla sovelluksella on vain luku -oikeudet, joten liitin ei koskaan kirjoita kauppaasi. Käyttöoikeustoken tallennetaan salattuna FreeScoutiin, ja lähtevät pyynnöt vahvistavat TLS:n eivätkä seuraa uudelleenohjauksia.
Shopify-tilaustietoja ei lähetetä kolmansille osapuolille muuten kuin postilaatikolle valitun AI-palveluntarjoajan kautta ja vain silloin, kun AI-kontekstiominaisuus käyttää niitä. Jos käytäntösi edellyttää, että tilaustiedot pysyvät kokonaan omilla palvelimillasi, käytä postilaatikolle paikallista AI-palveluntarjoajaa (kuten Ollama).
Seuraavat vaiheet
- Valmis Miten ReplyRabbit määritetään jos postilaatikko tarvitsee vielä tarjoaja-, konteksti- tai tyyliasetukset.
- Myös WooCommercessa tai Magentossa? Katso WooCommerce-liitin ja Magento-liitin oppaat.
UKK
Miten Shopify-liitin yhdistää kauppaani?
Luo mukautettu sovellus Shopify-hallinnassa (Asetukset, Sovellukset ja myyntikanavat, Kehitä sovelluksia). Anna sille read_customers-, read_orders- ja read_products-käyttöoikeudet, asenna se ja liitä sen Admin API -käyttötoken kauppasi verkkotunnuksen kanssa FreeScout-liittimen asetuksiin. Liitin vahvistaa tokenin kauppaasi vasten ennen tallentamista.
Tarvitsenko Shopify Partner -tilin tai App Store -listauksen?
Ei. Mukautettu sovellus luodaan oman kauppasi ylläpidossa, eikä se vaadi Partner-tiliä, sovelluksen tarkistusta tai julkista listausta.
Paljonko Shopify Connector maksaa?
Shopify Connector sisältyy aktiiviseen ReplyRabbit Pro- tai Team-suunnitelmaan. Muuten se maksaa 18 EUR kertalisenssinä yhdelle FreeScout-asennukselle. Jos ostat sen, aseta sen lisenssiavain SHOPIFYINTEGRATION_LICENSE_KEY -muotoon FreeScout .env-tiedostossasi.
Miksi näen vain viimeisten 60 päivän tilaukset?
Shopify rajoittaa sovellusten tilausten historian 60 päivään, ellei sovelluksella ole read_all_orders-käyttöoikeutta. Rastita read_all_orders, kun määrität mukautettua sovellusta nähdäksesi koko historian.
Voiko jokainen FreeScout-postilaatikko yhdistää eri Shopify-kauppaan?
Kyllä. Jokainen postilaatikko tallentaa oman kauppaverkkotunnuksensa ja käyttöoikeustokeninsa liittimen asetuksiin, joten eri kaupat voivat yhdistyä eri postilaatikoihin.