Shopify-connector
Werkt met Shopify
Verbind Shopify met FreeScout zodat gesprekken overeenkomende klantorders en aankoopcontext tonen. Je maakt een alleen-lezen custom app aan in je Shopify-beheer en plakt het toegangstoken in FreeScout, dus er is geen Partner-account of app-review nodig. ReplyRabbit voert ook producteigendomcontext aan de AI-laag zodat concepten kunnen verwijzen naar wat een klant heeft gekocht.
Op zoek naar het overzicht?
Overzicht
De Shopify-connector voegt een bestelzijbalk toe aan FreeScout-gesprekken. Wanneer een gesprek een e-mailadres van een klant heeft, bevraagt de connector de Shopify GraphQL Admin API op je winkel voor overeenkomende bestellingen en toont deze naast het gesprek.
De zijbalk toont een klantenpaneel, volledige ordergeschiedenis, regelitems per order met aantallen en prijzen, financiële totalen, customer lifetime value (CLV), gemiddelde orderwaarde (AOV) en producteigendom-rechten die doorstromen naar de ReplyRabbit AI-context voor relevantere concepten.
Er is één component te installeren: de FreeScout Shopify-connectormodule. Het leest de Shopify GraphQL Admin API via HTTPS met een Admin API-toegangstoken van een aangepaste app en toont vervolgens de bestellingszijbalk. Het heeft een eigen instellingenpagina per mailbox in FreeScout.
De orderzijbalk werkt op zichzelf. Het producteigendom-recht dat naar AI-concepten stroomt, is het deel dat ReplyRabbit gebruikt.
Vereisten
Voordat je begint, zorg dat je het volgende hebt:
- Een werkende FreeScout-installatie.
- Een Shopify-winkel op een
your-store.myshopify.comdomein (of een aangepast domein dat erheen verwijst), met personeelsrechten om apps te ontwikkelen. - ReplyRabbit geïnstalleerd en geactiveerd als je producteigendom-context in AI-concepten wilt.
- Een Shopify Connector-licentie (18 EUR eenmalig, voor één FreeScout-installatie), of een actief ReplyRabbit Pro- of Team-abonnement, dat deze bevat.
Als ReplyRabbit nog niet is geïnstalleerd, begin dan met Hoe je de ReplyRabbit-module installeert, en voltooi dan Hoe je ReplyRabbit instelt.
Een custom app aanmaken in Shopify
De connector authenticeert met een Admin API-toegangstoken van een aangepaste app die in je eigen winkel staat.
Ontwikkelaars-apps openen
Ga in de Shopify-beheeromgeving naar Instellingen, dan Apps en verkoopkanalen, dan Ontwikkel apps. Sta indien gevraagd aangepaste app-ontwikkeling toe.De app aanmaken
Klik Een app aanmaken, noem het "ReplyRabbit Connector" en maak het aan.Stel de Admin API-scopes in
Openen Admin API-scopes configureren en vinkread_customers,read_orders, enread_products. Vinkread_all_ordersook als je ordergeschiedenis ouder dan 60 dagen wilt. Sla op.Installeren en het token kopiëren
Klik App installeren, dan Token eenmalig tonen en kopieer de Admin API-toegangstoken (het begint metshpat_). Shopify toont het slechts één keer, dus bewaar het op een veilige plek.
Alleen-lezen toegang
Installeer de FreeScout-connector-module
De connector-module downloaden
Download de FreeScout-connector module ZIP van de ReplyRabbit-dashboard. De download verschijnt zodra je de connector hebt gekocht of een actief ReplyRabbit Pro- of Team-abonnement hebt.Uploaden naar FreeScout
Ga in FreeScout naar Modules, klik op de uploadknop, kies de ZIP en installeer deze.Activeer de module
Activeer de Shopify-integratie module uit de modulelijst.
Per mailbox configureren
Open de connectorinstellingen
Open in FreeScout de mailbox die Shopify-ordergegevens moet tonen, open het menu met mailboxinstellingen en kies Winkelconnector. Dit is de instellingenpagina van de Shopify-connector, geen sectie binnen de ReplyRabbit-instellingen.Voer het winkeldomein en toegangstoken in
Voer je winkeldomein in, bijvoorbeeldyour-store.myshopify.com, en plak het Admin API-toegangstoken. Sla op. De connector controleert het token en de scopes tegen je winkel voordat hij het opslaat; het token wordt versleuteld opgeslagen en nooit meer getoond.Voeg je connectorlicentiesleutel toe
Als je de connector hebt gekocht, stel danSHOPIFYINTEGRATION_LICENSE_KEYin je FreeScout.envnaar de licentiesleutel ervan. Sla deze stap over als een actief ReplyRabbit Pro- of Team-plan de installatie dekt.Testen
Open een FreeScout-gesprek waar het klant-e-mailadres overeenkomt met een Shopify-bestelling en bevestig dat de bestellingszijbalk verschijnt.
Elke FreeScout-mailbox slaat zijn eigen winkeldomein en access token op, zodat u verschillende mailboxen aan verschillende winkels kunt koppelen.
Wat de connector toont
- Een klantpaneel voor de persoon in het gesprek.
- Volledige bestelgeschiedenis met ordernummer, datum, status en totaal.
- Regelitems per bestelling met aantallen en prijzen.
- Financiële totalen (subtotaal, korting, verzending, belasting, terugbetalingen).
- Customer lifetime value (CLV) en gemiddelde orderwaarde (AOV).
- Producteigendom-recht voor AI-concepten.
Hoe je de connector krijgt
De Shopify Connector is een betaalde module. Je kunt hem op twee manieren krijgen:
- Koop de Shopify Connector voor 18 EUR als eenmalige licentie voor één FreeScout-installatie en stel daarna de licentiesleutel in als
SHOPIFYINTEGRATION_LICENSE_KEYin de FreeScout.env. - Gebruik een actief ReplyRabbit Pro- of Team-plan, dat de connector zonder extra kosten bevat.
Koop de licentie of download de connector vanuit je ReplyRabbit-dashboard. Bezoek de prijzenpagina voor ReplyRabbit-planopties. Als een actief ReplyRabbit Pro- of Team-plan de installatie dekt, werkt de connector zodra deze is geconfigureerd, zonder aparte licentiesleutel.
Probleemoplossing
| Symptoom | Wat te controleren |
|---|---|
| "Shopify heeft de verbinding geweigerd" bij opslaan | Het token is verkeerd getypt, ingetrokken of hoort bij een andere winkel. Onthul een nieuw token door de aangepaste app opnieuw te installeren en plak het opnieuw. |
| "Deze Admin API-scopes ontbreken" bij opslaan | Open de custom app en voeg de ontbrekende scopes toe onder Admin API-scopes configureren, sla op en installeer de app opnieuw. Opnieuw installeren geeft een nieuw token. |
| Domein van winkel wordt geweigerd | Gebruik de your-store.myshopify.com domein, of een aangepast domein dat erheen verwijst. Privéhosts en IP-adressen worden geweigerd. |
| Bestelzijbalk verschijnt niet | Bevestig dat het mailboxpaneel is ingeschakeld en de verbinding als verbonden wordt weergegeven op de instellingenpagina. |
| Bestellingen zijn leeg voor een bekende klant | Bevestig dat het klant-e-mailadres in het FreeScout-gesprek overeenkomt met het e-mailadres in hun Shopify-bestellingen. |
| Alleen de laatste 60 dagen aan bestellingen worden getoond | Voeg de read_all_orders scope naar de custom app, installeer deze opnieuw en plak het nieuwe token. |
| Regelitems, financiën of CLV worden niet getoond | Bevestig dat de licentiesleutel van de connector is opgeslagen, of dat een actief ReplyRabbit Pro- of Team-plan de installatie dekt. |
| Producteigendom-context verschijnt niet in concepten | Bevestig dat de connector is gelicentieerd, ReplyRabbit is geïnstalleerd, de connector bestellingen retourneert en de AI-contextfunctie is ingeschakeld voor de mailbox. |
Voor bredere problemen, zie Probleemoplossing ReplyRabbit.
Privacy en gegevensverwerking
Wanneer de connector Shopify bevraagt, stuurt hij het e-mailadres van de klant via HTTPS naar de Shopify GraphQL Admin API met de token van je aangepaste app. De ordergegevens die je winkel retourneert, vullen de FreeScout-zijbalk en bouwen, met ReplyRabbit, de AI-context voor concepten op.
De aangepaste app heeft alleen leesrechten, dus de connector schrijft nooit naar je winkel. Het toegangstoken wordt versleuteld opgeslagen in FreeScout, en uitgaande verzoeken verifiëren TLS en volgen geen redirects.
Er worden geen Shopify-bestelgegevens naar derden verzonden, behalve via de AI-provider die voor de mailbox is geselecteerd, en alleen wanneer de AI-contextfunctie deze gebruikt. Als je beleid vereist dat bestelgegevens volledig op je eigen servers blijven, gebruik dan een lokale AI-provider (zoals Ollama) voor de mailbox.
Volgende stappen
- Voltooien Hoe je ReplyRabbit instelt als de mailbox nog provider-, context- of stijlinstellingen nodig heeft.
- Ook op WooCommerce of Magento? Zie de WooCommerce-connector en Magento-connector handleidingen.
FAQ
Hoe verbindt de Shopify-connector met mijn winkel?
Met een aangepaste app die je in de Shopify-beheeromgeving aanmaakt (Instellingen, Apps en verkoopkanalen, Apps ontwikkelen). Geef die de scopes read_customers, read_orders en read_products, installeer hem en plak het Admin API-toegangstoken met je winkeldomein in de connectorinstellingen van FreeScout. De connector verifieert het token bij je winkel voordat hij het opslaat.
Heb ik een Shopify Partner-account of App Store-vermelding nodig?
Nee. Een aangepaste app wordt aangemaakt in je eigen winkelbeheer en vereist geen Partner-account, geen app-review en geen openbare vermelding.
Hoeveel kost de Shopify Connector?
De Shopify Connector is inbegrepen bij een actief ReplyRabbit Pro- of Teamplan. Anders kost hij 18 EUR als eenmalige licentie voor één FreeScout-installatie. Als je hem koopt, stel je de licentiesleutel in als SHOPIFYINTEGRATION_LICENSE_KEY in je FreeScout .env.
Waarom zie ik alleen orders van de laatste 60 dagen?
Shopify beperkt apps tot 60 dagen ordergeschiedenis, tenzij de app de scope read_all_orders heeft. Vink read_all_orders aan bij het configureren van de custom app om de volledige geschiedenis te zien.
Kan elke FreeScout-mailbox verbinden met een andere Shopify-winkel?
Ja. Elk mailbox slaat zijn eigen winkeldomein en toegangstoken op in de connectorinstellingen, zodat verschillende winkels verbinding kunnen maken met verschillende mailboxen.