Shopify-kobling
Fungerer med Shopify
Koble Shopify til FreeScout slik at samtaler viser matchede kundeordrer og kjøpskontekst. Du oppretter en skrivebeskyttet egendefinert app i Shopify-administrasjonen og limer inn tilgangstokenet i FreeScout, så det er ingen Partner-konto eller appgjennomgang involvert. ReplyRabbit mater også produkteterskapskontekst inn i AI-laget slik at utkast kan referere til det en kunde har kjøpt.
Ser du etter oversikten?
Oversikt
Shopify-koblingen legger til et ordre-sidepanel i FreeScout-samtaler. Når en samtale har en kundes e-postadresse, spør koblingen Shopify GraphQL Admin API på butikken din etter samsvarende ordrer og viser dem ved siden av samtalen.
Sidepanelet viser et kundepanel, full ordrehistorikk, ordrelinjer per ordre med antall og priser, økonomiske totaler, kundens livstidsverdi (CLV), gjennomsnittlig ordreverdi (AOV) og produktrettigheter som flyter inn i ReplyRabbit AI-konteksten for mer relevante utkast.
Det er én komponent å installere: FreeScout Shopify connector-modul. Den leser Shopify GraphQL Admin API over HTTPS ved hjelp av et Admin API-tilgangstoken fra en egendefinert app, og viser deretter ordresidepanelet. Den har sin egen innstillingsside per postkasse i FreeScout.
Ordre-sidepanelet fungerer på egen hånd. Produkteterskapsrettighetene som flyter inn i AI-utkast, er delen som bruker ReplyRabbit.
Forutsetninger
Før du starter, må du sørge for at du har:
- En fungerende FreeScout-installasjon.
- En Shopify-butikk på en
your-store.myshopify.comdomene (eller et egendefinert domene som peker til ett), med personaltillatelser til å utvikle apper. - ReplyRabbit installert og aktivert hvis du vil ha produkteterskapskontekst i AI-utkast.
- En Shopify Connector-lisens (18 EUR engangsbeløp, for én FreeScout-installasjon), eller en aktiv ReplyRabbit Pro- eller Team-plan, som inkluderer den.
Hvis ReplyRabbit ikke er installert ennå, start med Hvordan installere ReplyRabbit-modulen, og fullfør deretter Hvordan sette opp ReplyRabbit.
Opprett en egendefinert app i Shopify
Konnektoren autentiserer med et Admin API-tilgangstoken fra en egendefinert app som ligger i din egen butikk.
Åpne Utvikle apper
I Shopify-administrasjonen, gå til Innstillinger, deretter Apper og salgskanaler, deretter Utvikle apper. Hvis du blir bedt om det, tillat utvikling av egendefinerte apper.Opprett appen
Klikk Opprett en app, gi den navnet "ReplyRabbit Connector" og opprett den.Angi Admin API-omfangene
Åpne Konfigurer Admin API-omfang og kryss avread_customers,read_orders, ogread_products. Merk av forread_all_ordersogså hvis du vil ha ordrehistorikk eldre enn 60 dager. Lagre.Installer og kopier tokenet
Klikk Installer app, deretter Vis token én gang og kopier Admin API-tilgangstoken (det starter medshpat_). Shopify viser den bare én gang, så lagre den et trygt sted.
Skrivebeskyttet tilgang
Installer FreeScout-konnektormodulen
Last ned koblingsmodulen
Last ned FreeScout-koblingsmodulen ZIP fra ReplyRabbit-dashbord. Nedlastingen vises når du har kjøpt koblingen eller har en aktiv ReplyRabbit Pro- eller Team-plan.Last opp til FreeScout
I FreeScout, gå til Moduler, klikk på opplastingsknappen, velg ZIP-filen og installer den.Aktiver modulen
Aktiver Shopify-integrasjon modul fra Modullisten.
Konfigurer per postkasse
Åpne innstillingene for koblingen
I FreeScout, åpne postkassen som skal vise Shopify-ordredata, åpne menyen for postkasseinnstillinger og velg Butikkobling. Dette er innstillingssiden for Shopify-koblingen, ikke en seksjon inne i ReplyRabbit-innstillingene.Skriv inn butikkdomenet og tilgangstokenet
Skriv inn butikkdomenet ditt, for eksempelyour-store.myshopify.com, og lim inn Admin API-tilgangstokenet. Lagre. Koblingen sjekker tokenet og tillatelsene mot butikken din før den lagres; tokenet lagres kryptert og vises aldri igjen.Legg til connector-lisensnøkkelen din
Hvis du kjøpte koblingen, angiSHOPIFYINTEGRATION_LICENSE_KEYi FreeScout.envtil lisensnøkkelen. Hopp over dette trinnet hvis en aktiv ReplyRabbit Pro- eller Team-plan dekker installasjonen.Test
Åpne en FreeScout-samtale der kundens e-post matcher en Shopify-ordre og bekreft at ordre-sidepanelet vises.
Hver FreeScout-postkasse lagrer sitt eget butikkdomene og tilgangstoken, slik at du kan koble ulike postkasser til ulike butikker.
Hva koblingen viser
- Et kundepanel for personen i samtalen.
- Full ordrehistorikk med ordrenummer, dato, status og total.
- Ordrelinjer per ordre med antall og priser.
- Økonomiske totaler (delsum, rabatt, frakt, mva, refusjoner).
- Kundens livstidsverdi (CLV) og gjennomsnittlig ordreverdi (AOV).
- Produkteierskapsrettighet for AI-utkast.
Hvordan få koblingen
Shopify Connector er en betalt modul. Du kan få den på to måter:
- Kjøp Shopify Connector for 18 EUR som en engangslisens for én FreeScout-installasjon, og sett deretter lisensnøkkelen som
SHOPIFYINTEGRATION_LICENSE_KEYi FreeScout.env. - Bruk en aktiv ReplyRabbit Pro- eller Team-plan, som inkluderer koblingen uten ekstra kostnad.
Kjøp lisensen eller last ned connectoren fra ReplyRabbit-dashbord. Besøk prisside for alternativer for ReplyRabbit-planer. Hvis en aktiv ReplyRabbit Pro- eller Team-plan dekker installasjonen, fungerer koblingen når den er konfigurert, uten en separat lisensnøkkel.
Feilsøking
| Symptom | Hva du bør sjekke |
|---|---|
| "Shopify avviste tilkoblingen" ved lagring | Tokenet ble skrevet feil, tilbakekalt eller tilhører en annen butikk. Vis et nytt token ved å installere den tilpassede appen på nytt og lim det inn igjen. |
| "Mangler disse Admin API-tillatelsene" ved lagring | Åpne den egendefinerte appen, legg til de manglende omfangene under Konfigurer Admin API-omfang, lagre og installer appen på nytt. Ny installasjon utsteder et nytt token. |
| Domenet avvises | Bruk your-store.myshopify.com domene, eller et egendefinert domene som peker til det. Private verter og IP-adresser avvises. |
| Ordresidepanelet vises ikke | Bekreft at postkassepanelet er aktivert og at tilkoblingen vises som tilkoblet på innstillingssiden. |
| Ordrer er tomme for en kjent kunde | Bekreft at kundens e-post i FreeScout-samtalen samsvarer med e-posten på Shopify-ordrene deres. |
| Bare de siste 60 dagene med ordrer vises | Legg til read_all_orders omfang til den egendefinerte appen, installer den på nytt og lim inn det nye tokenet. |
| Ordrelinjer, økonomi eller CLV vises ikke | Bekreft at lisensnøkkelen for koblingen er lagret, eller at en aktiv ReplyRabbit Pro- eller Team-plan dekker installasjonen. |
| Produkteierskapskontekst vises ikke i utkast | Bekreft at koblingen er lisensiert, at ReplyRabbit er installert, at koblingen returnerer ordrer, og at AI-kontekstfunksjonen er aktivert for postkassen. |
For bredere problemer, se Feilsøking av ReplyRabbit.
Personvern og datahåndtering
Når koblingen spør Shopify, sender den kundens e-postadresse til Shopify GraphQL Admin API over HTTPS ved hjelp av tokenet til din egendefinerte app. Ordredataene som returneres fra butikken din, fyller FreeScout-sidepanelet og bygger, med ReplyRabbit, AI-konteksten for utkast.
Den egendefinerte appen har bare lesetilganger, så konnektoren skriver aldri til butikken din. Tilgangstokenet lagres kryptert i FreeScout, og utgående forespørsler verifiserer TLS og følger ingen omdirigeringer.
Ingen Shopify-ordredata sendes til tredjeparter unntatt gjennom AI-leverandøren som er valgt for postkassen, og bare når AI-kontekstfunksjonen bruker dem. Hvis policyen din krever at ordredata skal holde seg helt på dine egne servere, bruk en lokal AI-leverandør (for eksempel Ollama) for postkassen.
Neste trinn
- Fullfør Hvordan sette opp ReplyRabbit hvis postkassen fortsatt trenger leverandør-, kontekst- eller stilinnstillinger.
- Også på WooCommerce eller Magento? Se WooCommerce-kobling og Magento-kobling guider.
FAQ
Hvordan kobler Shopify-koblingen seg til butikken min?
Med en egendefinert app du oppretter i Shopify-administrasjonen (Innstillinger, Apper og salgskanaler, Utvikle apper). Gi den read_customers, read_orders og read_products-tilgangene, installer den, og lim inn Admin API-tilgangstokenet med butikkdomenet ditt i FreeScout-koblingens innstillinger. Koblingen verifiserer tokenet mot butikken din før den lagres.
Trenger jeg en Shopify Partner-konto eller App Store-oppføring?
Nei. En tilpasset app opprettes i din egen butikkadministrasjon og krever ingen Partner-konto, ingen appgjennomgang og ingen offentlig oppføring.
Hvor mye koster Shopify-koblingen?
Shopify Connector er inkludert med en aktiv ReplyRabbit Pro- eller Team-plan. Ellers koster den 18 EUR som en engangslicens for én FreeScout-installasjon. Hvis du kjøper den, sett lisensnøkkelen som SHOPIFYINTEGRATION_LICENSE_KEY i FreeScout .env.
Hvorfor ser jeg bare ordrer fra de siste 60 dagene?
Shopify begrenser apper til 60 dagers ordrehistorikk med mindre appen har read_all_orders-omfanget. Kryss av for read_all_orders når du konfigurerer den egendefinerte appen for å se hele historikken.
Kan hver FreeScout-postkasse kobles til en annen Shopify-butikk?
Ja. Hver postkasse lagrer sitt eget store-domene og access token i connector-innstillingene, så ulike butikker kan kobles til ulike postkasser.