Shopify-anslutning
Fungerar med Shopify
Anslut Shopify till FreeScout så att konversationer visar matchade kundorder och köpkontext. Du skapar en skrivskyddad anpassad app i din Shopify-admin och klistrar in dess åtkomsttoken i FreeScout, så det krävs inget Partner-konto eller appgranskning. ReplyRabbit matar också in produktägarskapskontext i AI-lagret så att utkast kan referera till vad en kund har köpt.
Letar du efter översikten?
Översikt
Shopify-anslutningen lägger till ett ordersidofält i FreeScout-konversationer. När en konversation har en kund-e-postadress frågar anslutningen Shopify GraphQL Admin API på din butik efter matchande ordrar och visar dem bredvid konversationen.
Sidofältet visar en kundpanel, fullständig orderhistorik, orderrader per order med antal och priser, ekonomiska summor, kundens livstidsvärde (CLV), genomsnittligt ordervärde (AOV) och produktäganderätt som flödar in i ReplyRabbit AI-kontexten för mer relevanta utkast.
Det finns en komponent att installera: FreeScout Shopify-anslutningsmodul. Det läser Shopify GraphQL Admin API över HTTPS med en Admin API-åtkomsttoken från en anpassad app och renderar sedan ordersidofältet. Det har sin egen inställningssida per brevlåda i FreeScout.
Ordersidofältet fungerar på egen hand. Produktägarskapsbehörigheten som flödar in i AI-utkast är den del som använder ReplyRabbit.
Förutsättningar
Innan du börjar, se till att du har:
- En fungerande FreeScout-installation.
- En Shopify-butik på en
your-store.myshopify.comdomän (eller en anpassad domän som mappar till en), med personalbehörigheter för att utveckla appar. - ReplyRabbit installerat och aktiverat om du vill ha produktägandekontext i AI-utkast.
- En Shopify Connector-licens (18 EUR engångsbelopp, för en FreeScout-installation), eller en aktiv ReplyRabbit Pro- eller Team-plan, som inkluderar den.
Om ReplyRabbit inte är installerat än, börja med Hur du installerar ReplyRabbit-modulen, sedan slutför Hur du konfigurerar ReplyRabbit.
Skapa en anpassad app i Shopify
Anslutningen autentiserar med en Admin API-åtkomsttoken från en anpassad app som finns i din egen butik.
Öppna Utveckla appar
I Shopify-administrationen, gå till Inställningar, sedan Appar och försäljningskanaler, sedan Utveckla appar. Tillåt utveckling av anpassade appar om du uppmanas till det.Skapa appen
Klicka Skapa en app, namnge den "ReplyRabbit Connector" och skapa den.Ange Admin API-behörighetsomfången
Öppna Konfigurera Admin API-omfattningar och markeraread_customers,read_orders, ochread_products. Markeraread_all_ordersockså om du vill ha orderhistorik äldre än 60 dagar. Spara.Installera och kopiera token
Klicka Installera app, sedan Visa token en gång och kopiera Admin API-åtkomsttoken (det börjar medshpat_). Shopify visar den bara en gång, så förvara den på ett säkert ställe.
Läsbehörighet
Installera FreeScout-anslutningsmodulen
Ladda ner anslutningsmodulen
Ladda ner FreeScout-anslutningsmodulens ZIP från ReplyRabbit-instrumentpanel. Nedladdningen visas när du har köpt anslutningen eller har en aktiv ReplyRabbit Pro- eller Team-plan.Ladda upp till FreeScout
I FreeScout, gå till Moduler, klicka på uppladdningsknappen, välj ZIP-filen och installera den.Aktivera modulen
Aktivera Shopify-integration modul från modullistan.
Konfigurera per brevlåda
Öppna inställningarna för anslutningen
I FreeScout, öppna brevlådan som ska visa Shopify-orderdata, öppna menyn för brevlådeinställningar och välj Butiksanslutning. Detta är Shopify-anslutningens inställningssida, inte ett avsnitt inuti ReplyRabbit-inställningarna.Ange butikens domän och åtkomsttoken
Ange din butiksdomän, till exempelyour-store.myshopify.com, och klistra in Admin API-åtkomsttoken. Spara. Anslutningen kontrollerar token och behörigheter mot din butik innan den lagras; token lagras krypterad och visas aldrig igen.Lägg till din connector-licensnyckel
Om du köpte anslutningsmodulen, angeSHOPIFYINTEGRATION_LICENSE_KEYi din FreeScout.envtill dess licensnyckel. Hoppa över detta steg om en aktiv ReplyRabbit Pro- eller Team-plan täcker installationen.Test
Öppna en FreeScout-konversation där kundens e-post matchar en Shopify-beställning och bekräfta att beställningssidofältet visas.
Varje FreeScout-brevlåda lagrar sin egen butiksdomän och åtkomsttoken, så du kan ansluta olika brevlådor till olika butiker.
Vad anslutningen visar
- En kundpanel för personen i konversationen.
- Fullständig orderhistorik med ordernummer, datum, status och totalsumma.
- Radposter per order med kvantiteter och priser.
- Ekonomiska summor (delsumma, rabatt, frakt, skatt, återbetalningar).
- Kundlivstidsvärde (CLV) och genomsnittligt ordervärde (AOV).
- Rättighet till produktägande för AI-utkast.
Hur du får anslutningen
Shopify Connector är en betald modul. Du kan få den på två sätt:
- Köp Shopify Connector för 18 EUR som en engångslicens för en FreeScout-installation och ange sedan dess licensnyckel som
SHOPIFYINTEGRATION_LICENSE_KEYi FreeScout.env. - Använd en aktiv ReplyRabbit Pro- eller Team-plan, som inkluderar anslutningen utan extra kostnad.
Köp licensen eller ladda ner connectorn från ditt ReplyRabbit-instrumentpanel. Besök prissidan för alternativ för ReplyRabbit-planer. Om en aktiv ReplyRabbit Pro- eller Team-plan täcker installationen fungerar anslutningen när den är konfigurerad, utan separat licensnyckel.
Felsökning
| Symptom | Vad man ska kontrollera |
|---|---|
| "Shopify avvisade anslutningen" vid sparning | Token skrevs fel, återkallades eller tillhör en annan butik. Visa en ny token genom att installera om den anpassade appen och klistra in den igen. |
| "Saknar dessa Admin API-behörigheter" vid sparning | Öppna den anpassade appen och lägg till de saknade behörigheterna under Konfigurera Admin API-omfattningar, spara och installera om appen. Ominstallation utfärdar en ny token. |
| Butiksdomänen avvisas | Använd your-store.myshopify.com domän, eller en anpassad domän som mappar till den. Privata värdar och IP-adresser avvisas. |
| Order-sidofältet visas inte | Bekräfta att brevlådepanelen är aktiverad och att anslutningen visas som ansluten på inställningssidan. |
| Ordrar är tomma för en känd kund | Bekräfta att kundens e-postadress i FreeScout-konversationen matchar e-postadressen på deras Shopify-beställningar. |
| Endast de senaste 60 dagarnas beställningar visas | Lägg till read_all_orders omfattning till den anpassade appen, installera om den och klistra in den nya token. |
| Radposter, ekonomi eller CLV visas inte | Bekräfta att kopplingens licensnyckel är sparad, eller att en aktiv ReplyRabbit Pro- eller Team-plan täcker installationen. |
| Kontext om produktägande visas inte i utkast | Bekräfta att kopplingen är licensierad, att ReplyRabbit är installerat, att kopplingen returnerar beställningar och att AI-kontextfunktionen är aktiverad för brevlådan. |
För bredare problem, se Felsökning av ReplyRabbit.
Integritet och datahantering
När anslutningen frågar Shopify skickar den kundens e-postadress till Shopify GraphQL Admin API över HTTPS med din anpassade apps token. Orderdata som returneras från din butik fyller FreeScout-sidopanelen och, med ReplyRabbit, bygger AI-kontextet för utkast.
Den anpassade appen har endast läsbehörigheter, så anslutningen skriver aldrig till din butik. Åtkomsttoken lagras krypterad i FreeScout, och utgående förfrågningar verifierar TLS och följer inga omdirigeringar.
Inga Shopify-beställningsdata skickas till tredje part utom via den AI-leverantör som valts för postlådan, och endast när AI-kontextfunktionen använder dem. Om din policy kräver att beställningsdata stannar helt på dina egna servrar använder du en lokal AI-leverantör (till exempel Ollama) för postlådan.
Nästa steg
- Slutför Hur du konfigurerar ReplyRabbit om mailboxen fortfarande behöver leverantörs-, kontext- eller stilinställningar.
- Även på WooCommerce eller Magento? Se WooCommerce-anslutning och Magento-anslutning guider.
Vanliga frågor
Hur ansluter Shopify-anslutningen till min butik?
Med en anpassad app som du skapar i Shopify-administrationen (Settings, Apps and sales channels, Develop apps). Ge den scope:en read_customers, read_orders och read_products, installera den och klistra in dess Admin API-åtkomsttoken tillsammans med din butiksdomän i FreeScout-anslutningens inställningar. Anslutningen verifierar token mot din butik innan den sparas.
Behöver jag ett Shopify Partner-konto eller en App Store-listning?
Nej. En anpassad app skapas i din egen butiksadmin och kräver inget Partner-konto, ingen appgranskning och ingen offentlig listning.
Hur mycket kostar Shopify Connector?
Shopify Connector ingår med en aktiv ReplyRabbit Pro- eller Team-plan. Annars kostar den 18 EUR som en engångslicens för en FreeScout-installation. Om du köper den, ange dess licensnyckel som SHOPIFYINTEGRATION_LICENSE_KEY i din FreeScout .env.
Varför ser jag bara ordrar från de senaste 60 dagarna?
Shopify begränsar appar till 60 dagars orderhistorik om inte appen har behörighetsomfånget read_all_orders. Markera read_all_orders när du konfigurerar den anpassade appen för att se hela historiken.
Kan varje FreeScout-brevlåda ansluta till en annan Shopify-butik?
Ja. Varje brevlåda lagrar sin egen butiksdomän och åtkomsttoken i anslutningsinställningarna, så olika butiker kan ansluta till olika brevlådor.