Shopify-connector
Virker med Shopify
Tilslut Shopify til FreeScout, så samtaler viser matchede kundeordrer og købskontekst. Du opretter en skrivebeskyttet custom app i din Shopify-admin og indsætter dens access token i FreeScout, så der er ingen Partner-konto eller app-gennemgang involveret. ReplyRabbit sender også produkt-ejerskabskontekst ind i AI-laget, så kladder kan referere til, hvad en kunde har købt.
Leder du efter oversigten?
Oversigt
Shopify-connectoren tilføjer et ordre-sidepanel til FreeScout-samtaler. Når en samtale har en kundes e-mailadresse, forespørger connectoren Shopify GraphQL Admin API på din butik efter matchede ordrer og viser dem ved siden af samtalen.
Sidepanelet viser et kundepanel, fuld ordrehistorik, ordrelinjer pr. ordre med antal og priser, økonomiske totaler, kundens livstidsværdi (CLV), gennemsnitlig ordreværdi (AOV) og produktadgangsrettigheder, der flyder ind i ReplyRabbit AI-konteksten for mere relevante kladder.
Der er én komponent at installere: FreeScout Shopify connector-modul. Den læser Shopify GraphQL Admin API over HTTPS ved hjælp af et Admin API-adgangstoken fra en brugerdefineret app og gengiver derefter ordre-sidepanelet. Den har sin egen indstillingsside pr. postkasse i FreeScout.
Ordre-sidebjælken fungerer alene. Produkt ejerskab-rettigheden, der flyder ind i AI-kladder, er den del, der bruger ReplyRabbit.
Forudsætninger
Før du starter, skal du sikre dig, at du har:
- En fungerende FreeScout-installation.
- En Shopify-butik på en
your-store.myshopify.comdomæne (eller et brugerdefineret domæne, der peger på et), med medarbejderrettigheder til at udvikle apps. - ReplyRabbit installeret og aktiveret, hvis du vil have produkt-ejerskabskontekst i AI-udkast.
- En Shopify Connector-licens (18 EUR engangsbeløb for én FreeScout-installation), eller en aktiv ReplyRabbit Pro- eller Team-plan, som inkluderer den.
Hvis ReplyRabbit ikke er installeret endnu, skal du starte med Sådan installerer du ReplyRabbit-modulet, derefter afslut Sådan opsætter du ReplyRabbit.
Opret en custom app i Shopify
Connectoren godkender med et Admin API-adgangstoken fra en custom app, der ligger i din egen butik.
Åbn Develop apps
I Shopify-administrationen skal du gå til Indstillinger, derefter Apps og salgskanaler, derefter Udvikl apps. Hvis du bliver bedt om det, skal du tillade udvikling af brugerdefinerede apps.Opret appen
Klik Opret en app, navngiv den "ReplyRabbit Connector", og opret den.Indstil Admin API-scopes
Åbn Konfigurer Admin API-scopes og markérread_customers,read_orders, ogread_products. Sæt kryds iread_all_ordersogså, hvis du vil have ordrehistorik ældre end 60 dage. Gem.Installer og kopier tokenet
Klik Installer app, derefter Vis token én gang og kopier Admin API-adgangstoken (det starter medshpat_). Shopify viser den kun én gang, så gem den et sikkert sted.
Skrivebeskyttet adgang
Installer FreeScout-connectormodulet
Download connectormodulet
Download FreeScout-connectormodulets ZIP fra ReplyRabbit dashboard. Downloadet vises, når du har købt connectoren eller har et aktivt ReplyRabbit Pro- eller Team-abonnement.Upload til FreeScout
I FreeScout skal du gå til Moduler, klik på upload-knappen, vælg ZIP-filen, og installer den.Aktiver modulet
Aktiver Shopify-integration modul fra Modullisten.
Konfigurer pr. postkasse
Åbn connector-indstillingerne
I FreeScout skal du åbne den postkasse, der skal vise Shopify-ordredata, åbne menuen for postkasseindstillinger og vælge Store Connector. Dette er Shopify-connectorens indstillingsside, ikke et afsnit inde i ReplyRabbit-indstillingerne.Indtast butikkens domæne og access-token
Indtast dit butiksdomæne, for eksempelyour-store.myshopify.com, og indsæt Admin API-adgangstokenet. Gem. Connectoren tjekker tokenet og scopes mod din butik, før den gemmer det; tokenet gemmes krypteret og vises aldrig igen.Tilføj din connector-licensnøgle
Hvis du købte connectoren, skal du indstilleSHOPIFYINTEGRATION_LICENSE_KEYi din FreeScout.envtil dens licensnøgle. Spring dette trin over, hvis en aktiv ReplyRabbit Pro- eller Team-plan dækker installationen.Test
Åbn en FreeScout-samtale, hvor kundens e-mail matcher en Shopify-ordre, og bekræft, at ordre-sidepanelet vises.
Hver FreeScout-postkasse gemmer sit eget butiksdomæne og access token, så du kan forbinde forskellige postkasser med forskellige butikker.
Hvad connectoren viser
- Et kundepanel til personen på samtalen.
- Fuld ordrehistorik med ordrenummer, dato, status og total.
- Linjeposter pr. ordre med antal og priser.
- Økonomiske totaler (subtotal, rabat, forsendelse, moms, refunderinger).
- Kundelivstidsværdi (CLV) og gennemsnitlig ordreværdi (AOV).
- Produkt ejerskabsrettighed for AI-udkast.
Sådan får du connectoren
Shopify Connector er et betalt modul. Du kan få det på to måder:
- Køb Shopify Connector for 18 EUR som en engangslicens til én FreeScout-installation, og angiv derefter dens licensnøgle som
SHOPIFYINTEGRATION_LICENSE_KEYi FreeScout.env. - Brug en aktiv ReplyRabbit Pro- eller Team-plan, som inkluderer connectoren uden ekstra omkostning.
Køb licensen eller download connectoren fra din ReplyRabbit dashboard. Besøg prisside for ReplyRabbit-planmuligheder. Hvis en aktiv ReplyRabbit Pro- eller Team-plan dækker installationen, virker connectoren, når den er konfigureret, uden en separat licensnøgle.
Fejlfinding
| Symptom | Hvad du skal kontrollere |
|---|---|
| "Shopify afviste forbindelsen" ved gem | Tokenet blev skrevet forkert, tilbagekaldt eller tilhører en anden butik. Afslør et nyt token ved at geninstallere den tilpassede app, og indsæt det igen. |
| "Mangler disse Admin API-scopes" ved gem | Åbn den tilpassede app, og tilføj de manglende scopes under Konfigurer Admin API-scopes, gem, og geninstaller appen. Geninstallation udsteder et nyt token. |
| Butiksdomæne afvises | Brug your-store.myshopify.com domæne eller et brugerdefineret domæne, der peger på det. Private hosts og IP-adresser afvises. |
| Ordre-sidebjælken vises ikke | Bekræft, at postkassepanelet er aktiveret, og at forbindelsen vises som forbundet på indstillingssiden. |
| Ordrer er tomme for en kendt kunde | Bekræft, at kundens e-mail på FreeScout-samtalen matcher e-mailen på deres Shopify-ordrer. |
| Kun de sidste 60 dages ordrer vises | Tilføj read_all_orders scope til den tilpassede app, geninstaller den, og indsæt det nye token. |
| Linjeposter, økonomi eller CLV vises ikke | Bekræft, at connector-licensnøglen er gemt, eller at en aktiv ReplyRabbit Pro- eller Team-plan dækker installationen. |
| Produkt ejerskabskontekst vises ikke i udkast | Bekræft, at connectoren er licenseret, at ReplyRabbit er installeret, at connectoren returnerer ordrer, og at AI-kontekstfunktionen er aktiveret for postkassen. |
For bredere problemer, se Fejlfinding af ReplyRabbit.
Privatliv og datahåndtering
Når connectoren forespørger Shopify, sender den kundens e-mailadresse til Shopify GraphQL Admin API over HTTPS ved hjælp af din tilpassede apps token. De ordredata, der returneres fra din butik, udfylder FreeScout-sidepanelet og opbygger sammen med ReplyRabbit AI-konteksten til kladder.
Custom app'en har kun læsetilladelser, så connectoren skriver aldrig til din butik. Adgangstokenet gemmes krypteret i FreeScout, og udgående anmodninger verificerer TLS og følger ingen omdirigeringer.
Ingen Shopify-ordredata sendes til tredjeparter undtagen via den AI-udbyder, der er valgt til postkassen, og kun når AI-kontekstfunktionen bruger dem. Hvis din politik kræver, at ordredata forbliver helt på dine egne servere, skal du bruge en lokal AI-udbyder (såsom Ollama) til postkassen.
Næste trin
- Afslut Sådan opsætter du ReplyRabbit hvis postkassen stadig mangler udbyder-, kontekst- eller stilindstillinger.
- Også på WooCommerce eller Magento? Se WooCommerce-connector og Magento-connector guider.
FAQ
Hvordan forbinder Shopify-connectoren til min butik?
Med en tilpasset app, som du opretter i Shopify-administrationen (Indstillinger, Apps og salgskanaler, Udvikl apps). Giv den scopes read_customers, read_orders og read_products, installer den, og indsæt dens Admin API-adgangstoken sammen med dit butiksdomæne i FreeScout-connectorindstillingerne. Connectoren verificerer tokenet mod din butik, før det gemmes.
Har jeg brug for en Shopify Partner-konto eller App Store-opslag?
Nej. En tilpasset app oprettes i din egen butiksadmin og kræver ingen Partner-konto, ingen app-gennemgang og ingen offentlig visning.
Hvad koster Shopify Connector?
Shopify Connector er inkluderet med en aktiv ReplyRabbit Pro- eller Team-plan. Ellers koster det 18 EUR som engangslicens til én FreeScout-installation. Hvis du køber det, skal du angive dets licensnøgle som SHOPIFYINTEGRATION_LICENSE_KEY i din FreeScout .env.
Hvorfor ser jeg kun ordrer fra de sidste 60 dage?
Shopify begrænser apps til 60 dages ordrehistorik, medmindre appen har read_all_orders-scopet. Markér read_all_orders, når du konfigurerer den tilpassede app, for at se fuld historik.
Kan hver FreeScout-postkasse forbindes til en forskellig Shopify-butik?
Ja. Hver postkasse gemmer sit eget store-domæne og access token i connector-indstillingerne, så forskellige butikker kan forbindes til forskellige postkasser.