Met deze integratie kun je je Botpress chatbot verbinden met Shopify, een toonaangevend e-commerce platform. Met deze integratie kun je naadloze interacties met betrekking tot winkelactiviteiten rechtstreeks vanuit je chatbot faciliteren. Om de integratie effectief te gebruiken, moet je de naam van je Shopify-winkel opgeven (zoals te zien in de browser/URL) en het toegangstoken dat is gegenereerd na het maken van een Shopify-app. ## Setup video [![image](https://i.imgur.com/mWb0uV9.png)](https://youtu.be/yjvsoaCvjmU) ## Configuratie instellen Om de Shopify integratie in Botpress in te stellen, zijn de volgende configuraties vereist: 1. **Winkelnaam**: Staat in de URL wanneer je je Shopify winkel opent. Bijvoorbeeld, als de URL naar je winkeladministratie \https://admin.shopify.com/store/botpress-test-store` is, dan is de winkelnaam die je invoert \`botpress-test-store`. 2. **API Toegangstoken**: Dit token is essentieel om Botpress te laten communiceren met je Shopify winkel. Om een token te krijgen moet je een nieuwe Shopify app aanmaken (instructies hieronder). ## Shopify App aanmaken 1. Ga naar 'Apps en verkoopkanalen' in het Shopify dashboard. 2. Klik op 'Apps ontwikkelen'. 3. Selecteer 'App maken' en geef je app een naam. 4. Klik op 'API Credentials' en selecteer onder 'Access Tokens' 'Configure Admin API Scopes'. 5. Voor deze integratie moet je het vakje 'Read' access aanvinken voor 'Customers', 'Orders' en 'Products'. Dit geeft de bot de toegang om elk van deze eigenschappen te lezen. 6. Klik op 'Opslaan' en vervolgens op 'App installeren' om de installatie te voltooien. 7. Na de installatie kunt u naar 'API Credentials' en 'Admin API access token' gaan om uw token te bekijken/kopiëren. ## Integratie inschakelen Om de Shopify integratie te activeren in Botpress: 1. Ga naar het Botpress admin dashboard. 2. Ga naar het tabblad "Integraties". 3. Zoek naar de Shopify integratie en selecteer "Inschakelen" of "Configureren". 4. Voer de vereiste Shop/Store Naam en Admin API toegangstoken in. 5. Sla uw configuraties op. ## Gebruik ### Acties Na het inschakelen van de integratie kan je Botpress chatbot communiceren met Shopify voor product- en klantvragen met behulp van de onderstaande acties: - Get Customer List: Retourneert een lijst met klanten. - Klantenlijst ophalen: Retourneert een lijst met orders voor een specifieke klant op status (open, gesloten, geannuleerd of elke). - Productlijst opvragen: Retourneert een lijst met producten op basis van Id, Titel of Producttype. - Lijst met productvarianten opvragen: Retourneert een lijst met varianten van een product op Id. ### Gebeurtenissen Na het inschakelen van de integratie kan je Botpres chatbot gebeurtenissen ontvangen van Shopify met behulp van de onderstaande gebeurtenissen: - Order Aangemaakt: Wordt geactiveerd wanneer een bestelling wordt aangemaakt. - Bestelling bijgewerkt: Getriggerd wanneer een bestelling wordt bijgewerkt. - Order geannuleerd: Wordt geactiveerd wanneer een order wordt geannuleerd. - Klant aangemaakt: Wordt geactiveerd wanneer een klant wordt aangemaakt. - Klant bijgewerkt: Wordt geactiveerd wanneer een klant wordt bijgewerkt. Opmerking: Je kunt deze gebeurtenissen niet koppelen aan specifieke conversaties. Deze gebeurtenissen zijn voor het opslaan van gebeurtenisinformatie binnen je chatbot (bijv. opslaan van klant-/bestelgegevens in een tabel om op te vragen) ## Beperkingen 1. Er kunnen tariefgrenzen worden toegepast door Shopify's API. 2. Gebeurtenissen zijn niet gekoppeld aan gesprekken.