Shopify-integratie instellen
Met de Shopify-integratie leest je AI agent live data uit je Shopify-winkel. Klanten die vragen "waar is mijn bestelling?", "hebben jullie dit nog op voorraad?" of "is mijn retour goedgekeurd?" krijgen direct een antwoord, in natuurlijke taal, 24/7.
In het kort
Heyloha verbindt met je Shopify-winkel via een custom app. Je regelt het zelf in 5 minuten vanuit het Heyloha-dashboard. Alleen-lezen, versleuteld opgeslagen, geen code nodig.
Wat je agent nu kan
- Bestelstatus opvragen. De agent zoekt een bestelling op nummer en antwoordt met verzend- en trackinggegevens.
- Producten zoeken. De agent doorzoekt je catalogus op zoekwoord, merk of type en geeft tot 10 resultaten met prijs en beschikbaarheid.
- Voorraad controleren. De agent haalt live voorraadaantallen op per variant. Bij lage voorraad zegt hij "nog een paar op voorraad" in plaats van een exact getal.
- Retourstatus opvragen. De agent zoekt retouren bij een bestelling en meldt de status in natuurlijke taal.
Alle vier zijn alleen-lezen. De agent kan geen bestellingen wijzigen, annuleren of voorraad aanpassen.
Wat heb je nodig?
- Een Heyloha-account met minimaal een AI agent aangemaakt.
- Adminrechten in je Shopify-winkel, specifiek de mogelijkheid om custom apps aan te maken.
- Ongeveer 5 minuten.
Je hoeft geen developer, Shopify Partner-account of code te hebben. De custom-app-flow werkt op elk Shopify-plan.
Shopify verbinden
Open Shopify-instellingen in Heyloha
Klik in het Heyloha-dashboard op Instellingen in het linkermenu. Onder Externe systemen klik je op Shopify. Je ziet een kaart per website. Klik op "Shopify verbinden" bij de website die je wilt koppelen.
Sta custom-app-ontwikkeling toe (alleen nieuwe stores)
Winkels die vanaf 2026 zijn aangemaakt hebben custom-app-ontwikkeling standaard uitgeschakeld. Ga in Shopify admin naar Instellingen → Apps en verkoopkanalen → Apps ontwikkelen. Als daar een knop "Custom-app-ontwikkeling toestaan" staat, klik erop en bevestig.
Maak de custom app aan in Shopify
Ga naar Instellingen → Apps en verkoopkanalen → Apps ontwikkelen en klik op "Een app maken". Geef de app een herkenbare naam, bijvoorbeeld "Heyloha".
Configureer de Admin API-scopes
Klik op het tabblad Configuratie en vervolgens op Configureren naast Admin API-integratie. Vink exact deze vier scopes aan: read_orders, read_products, read_inventory en read_returns. Sla op.
Installeer de app en kopieer de token
Ga naar het tabblad API-credentials en klik bovenaan op "App installeren". Direct daarna verschijnt de Admin API-token (begint met shpat_ gevolgd door 32 tekens). Kopieer hem meteen: Shopify toont de token maar een keer.
Plak shopdomein en token in Heyloha
Plak in het Heyloha-venster je shopdomein (eindigt altijd op .myshopify.com, ook als je een custom domein gebruikt) en de Admin API-token. Klik op Verbinden. De kaart springt naar de status Verbonden met je shopdomein en de verbindingsdatum.
Mis je het kopieren van de token? Shopify toont hem maar een keer. Je moet dan de app verwijderen en opnieuw installeren om een nieuwe token te krijgen.
Werkt het?
Om te testen of de koppeling werkt:
- Open de Heyloha-chatwidget op je website (of een ander kanaal).
- Stel een vraag als "Verkopen jullie [bekend product]?". De agent zou productresultaten met prijs en beschikbaarheid moeten geven.
- Vraag naar de status van een eigen bestelling (bijvoorbeeld "waar is bestelling #1001?"). De agent antwoordt of vraagt eerst om het e-mailadres van de klant, afhankelijk van je verificatiebeleid.
Zegt de agent nog steeds "iemand neemt contact met je op" na het koppelen? Dan ontbreekt waarschijnlijk een scope of klopt de token niet. Zie Problemen oplossen verderop.
Koppeling beheren
Pauzeren
Zet de Actief-schakelaar op de kaart uit. De agent stopt direct met het aanroepen van Shopify voor deze website. Geen bestellingen meer opzoeken, geen productzoekopdrachten. Weer aanzetten is een klik, geen herverbinding nodig.
Token roteren
Op de verbonden kaart klik je op het drie-puntjes-menu en kies je "Token roteren". Genereer een nieuwe Admin API-token in Shopify (dezelfde app, tabblad API-credentials) en plak hem. De nieuwe token vervangt de oude in Heyloha zonder onderbreking.
Doe dit als de oude token per ongeluk gedeeld is, een teamlid de app opnieuw heeft geinstalleerd, of als een security-audit periodieke rotatie vereist.
Verbinding verbreken
Klik in het drie-puntjes-menu op Verbreken. Heyloha vraagt om bevestiging en toont wat de agent zal missen: bestelstatus, productzoekopdrachten, voorraadcontrole en retourstatus. Na bevestiging wordt de token definitief verwijderd.
Meerdere websites of winkels
In Heyloha is elke website een eigen AI-agent-omgeving met een eigen Shopify-koppeling. Een Shopify-winkel kan in v1 maar aan een Heyloha-website tegelijk gekoppeld zijn. Heb je meerdere regiowinkels (NL, DE, BE)? Maak dan per regio een aparte Heyloha-website aan en koppel elk aan zijn eigen Shopify.
Beveiliging
- De Admin API-token wordt versleuteld opgeslagen (AES-256). De sleutel staat buiten de database.
- De token verschijnt nooit in API-responses, logs of foutmeldingen. Bij een 401 logt Heyloha "auth mislukt voor integratie X", niet de token zelf.
- De agent kan alleen lezen: geen wijzigingen aan bestellingen, voorraad of producten.
- Per website geisoleerd. Een agent voor winkel A kan letterlijk geen data van winkel B zien. Dit wordt bij elke aanroep gecontroleerd.
Problemen oplossen
"Custom-app-ontwikkeling toestaan" ontbreekt in Shopify
Je Shopify-rol heeft geen "Apps ontwikkelen"-rechten. De winkeleigenaar (of een andere admin met volledige rechten) moet de optie een keer aanzetten, of jouw account de juiste rechten geven.
"Shopdomein moet eindigen op .myshopify.com"
Je plakte een custom domein (bijvoorbeeld www.acme.com) in plaats van het interne Shopify-domein (acme.myshopify.com). Je vindt het interne domein in Shopify admin → Instellingen → Domeinen onder "Door Shopify beheerd".
"Dit lijkt geen geldige Shopify-token"
De token moet beginnen met shpat_ en gevolgd worden door 32 hexadecimale tekens. Veelvoorkomende fouten: je hebt de API key of API secret gekopieerd in plaats van de Admin API-token, je hebt omliggende witruimte meegekopieerd, of je hebt een Storefront API-token gebruikt.
Agent zegt nog steeds "iemand neemt contact op"
Mogelijke oorzaken: de koppeling staat uitgeschakeld (check de kaart), de relevante scope ontbreekt (zie banner), of de token is ingetrokken in Shopify. Installeer de app opnieuw, kopieer de nieuwe token en gebruik "Token roteren" in Heyloha.
Veelgestelde vragen
Werkt dit op elk Shopify-plan?
Ja. De custom-app-flow is beschikbaar op elk Shopify-plan, inclusief Basic, Advanced, Plus en gratis trials.
Kan de agent bestellingen wijzigen?
Nog niet. Alle vier de capabilities zijn alleen-lezen. Schrijfacties zoals annuleren of terugbetalen zijn bewust nog niet uitgerold: die vragen om zorgvuldigere klantverificatie.
Zien mijn klanten "Shopify" in de chat?
Nee. De agent antwoordt in natuurlijke taal zonder het achterliggende systeem te noemen. Hij zegt "je bestelling is verzonden met DHL", niet "volgens Shopify is je bestelling...".
CRM- en webhook-koppelingen instellenHubSpot-integratie instellen