Shopify-acties
Verbind een Shopify-winkel zodat je agent je catalogus kan doorzoeken en de bestelstatus kan opzoeken in de chat.
Verbind een Shopify-winkel met je agent, en hij kan productvragen beantwoorden vanuit je live catalogus en tijdens een gesprek de status van een bestelling opzoeken. Dit is iets anders dan de chatwidget op je storefront plaatsen — zie Shopify-embed daarvoor.
Verbind eerst je winkel
Beide acties hebben een verbonden winkel nodig.
- Ga naar het tabblad Acties van je agent
- Open Integrations en zoek de kaart Shopify
- Voer je winkeldomein in, in de vorm
store-name.myshopify.com - Doorloop het toestemmingsscherm van Shopify
De kaart toont vervolgens de verbindingsstatus en biedt de opties Opnieuw verbinden of Loskoppelen. Als de verbinding aandacht nodig heeft, verschijnt er een oranje banner met een verzoek om opnieuw te verbinden.
De verbinding geldt per agent. Elke agent verbindt zijn eigen winkel, dus een agent die voor een andere winkel moet antwoorden, krijgt zijn eigen verbinding in plaats van er een te delen.
Welke toegang wordt gevraagd
Op het toestemmingsscherm vraagt Agentkit precies twee leesscopes aan:
| Scope | Gebruikt voor |
|---|---|
read_products | Je catalogus doorzoeken |
read_orders | De status van een bestelling opzoeken |
Er worden geen schrijfscopes aangevraagd. De verbinding gebruikt bovendien Shopify's standaard offline token — het verzoek laat bewust de optie voor toestemming per gebruiker weg — zodat de agent blijft werken nadat de persoon die de winkel heeft verbonden zich heeft afgemeld.
Dit zijn de scopes die de huidige implementatie aanvraagt. Shopify bepaalt zelf welke gegevens een app mag ontvangen: sommige klant- en bestelvelden zijn beschermd, en het toekennen van read_orders garandeert op zich niet dat elk veld wordt geretourneerd.
De twee acties
Elke actie wordt afzonderlijk toegevoegd en geconfigureerd onder Acties.
Producten zoeken
Hiermee kan de agent de catalogus van de verbonden winkel doorzoeken wanneer een bezoeker vraagt naar producten, prijzen of beschikbaarheid. De resultaten kunnen worden beperkt op basis van een zoekopdracht, een optionele maximumprijs en een resultatenlimiet.
De zoekresultaten bevatten alleen actieve producten die in je webwinkel zijn gepubliceerd. De beschikbaarheid komt uit de totale productvoorraad in Shopify en houdt ook rekening met producten waarvan de voorraad niet wordt bijgehouden.
De standaardinstructie voor 'wanneer te gebruiken' is "Use when the user wants to find products, compare prices, or check whether an item is available." Pas deze aan zodat hij past bij hoe je bezoekers dingen verwoorden.
Bestelstatus opvragen
Zoekt een enkele bestelling op. De bezoeker moet zowel het bestelnummer als het afrekenmailadres opgeven, en beide moeten overeenkomen met dezelfde bestelling voordat er iets wordt geretourneerd.
Die combinatie is een privacymaatregel: een bestelnummer alleen is makkelijk te raden of op te vangen, dus dat is nooit genoeg. Bestaat de bestelling niet, of komt het e-mailadres niet overeen met de bestelling, dan krijgt de agent dezelfde generieke reactie: "We could not find an order matching those details." — hij kan niet zien welke van de twee fout was, en de bezoeker ook niet.
Oudere bestellingen kunnen dezelfde 'niet gevonden'-reactie opleveren, zelfs als het nummer en e-mailadres kloppen: Agentkit vraagt Shopify's standaard read_orders-scope aan, die de recente bestellingen van de winkel dekt (ruwweg de laatste 60 dagen), niet de apart goedgekeurde volledige bestelgeschiedenis. Als opzoekingen van oudere bestellingen belangrijk zijn voor je winkel, verwacht dan dat je bezoekers met oudere bestellingen in plaats daarvan naar je support moet doorverwijzen.
De standaardinstructie voor 'wanneer te gebruiken' is "Use when the user asks for an order status or tracking details and can provide the order number and checkout email."
Twee voorwaarden om een actie in te schakelen
Beide moeten waar zijn voordat een actie kan worden ingeschakeld:
- Een verbonden winkel - zonder deze toont de inschakelknop een melding met een link naar Acties → Integrations
- Een betaald plan - dezelfde vereiste als voor Aangepaste API, Websearch, Documentlinks lezen en de boekingsacties
Je kunt beide acties nog steeds aanmaken, bewerken en opslaan terwijl ze uitgeschakeld zijn, zonder dat aan een van beide voorwaarden is voldaan. De voorwaarden gelden alleen voor het inschakelen.
Problemen oplossen
OAuth voltooid, maar bestelopzoekingen leveren niets op. Controleer het bestelnummerformaat dat je winkel gebruikt en bevestig dat het e-mailadres waarmee je test het afrekenmailadres van die bestelling is. Controleer daarna of de app in aanmerking komt voor beschermde klant- en bestelgegevens van de winkel — toegang tot die gegevens moet noodzakelijk zijn voor de app en kan door Shopify worden beperkt. Bredere scopes aanvragen verandert hier niets aan, en opnieuw verbinden garandeert geen goedkeuring.
De agent antwoordt vanuit de trainingsinhoud in plaats van de catalogus. Verscherp de instructie 'wanneer te gebruiken' zodat vragen over producten, prijzen en beschikbaarheid duidelijk naar de zoekactie worden geleid.
De kaart toont een waarschuwing om opnieuw te verbinden. De opgeslagen autorisatie is niet meer bruikbaar. Klik op Opnieuw verbinden en doorloop het toestemmingsscherm opnieuw. Opnieuw verbinden herstelt de verbinding, maar niet de acties: wanneer de opgeslagen autorisatie faalt, worden beide Shopify-acties automatisch uitgeschakeld, en het toestemmingsscherm schakelt ze niet automatisch weer in. Ga na het opnieuw verbinden terug naar Acties en schakel elke actie die je actief wilt hebben opnieuw in.