HomeDocumentatie

Shopify Integration

Voeg ChatReact AI-chatbots, contactformulieren en FAQ-accordeons toe aan uw Shopify-winkel met de officiële ChatReact Shopify App.

Installatie

  1. Installeer de ChatReact-app vanuit de Shopify App Store
  2. Open de app in uw Shopify-beheerpaneel

Er is geen afzonderlijke accountverbinding nodig — u koppelt de app aan uw chatbots en formulieren door hun ID's uit het ChatReact-dashboard te plakken.

Functies

De Shopify-app biedt drie widgettypes:

WidgetBeschrijvingPlaatsing
Chat WidgetAI-chatbot met livechat-ondersteuningSite-breed of specifieke pagina's via App Embed
Form WidgetContactformulieren met spambeveiligingInline via App Block in de Theme Editor
FAQ WidgetFAQ-weergave in accordeonstijlInline via App Block in de Theme Editor

Het Chat Widget instellen

Het instellen van het chatwidget bestaat uit twee stappen: maak een widgettoewijzing in de ChatReact-app en schakel vervolgens de App Embed in uw theme in.

Stap 1: Maak een widgettoewijzing

  1. Open de ChatReact-app in uw Shopify-beheer
  2. Ga naar het Chat Widget-tabblad en klik op Add Assignment
  3. Voer uw Chatbot-ID in (te vinden in het ChatReact-dashboard op het Insluiten-tabblad van uw chatbot)
  4. Klik op Save Assignment

Stap 2: Schakel de App Embed in

  1. Ga naar Online Store → Themes → Edit theme
  2. Klik op het App embeds-pictogram (puzzelstuk) in de linkerbenedenzijbalk
  3. Zet ChatReact Chat Widget op ON
  4. Klik Save

U hoeft de App Embed slechts eenmaal in te schakelen. Daarna beheert u volledig vanuit de ChatReact-app waar de widget wordt weergegeven.

Het chatwidget verschijnt op elke pagina die onder een van uw widgettoewijzingen valt.

Widgettoewijzingen

Elke toewijzing koppelt een chatbot aan uw storefront. Er zijn twee toewijzingstypen:

  • Everywhere: Widget verschijnt op alle pagina's (standaard). U kunt optioneel Exclude URLs toevoegen — één pad per regel, met *-wildcards ondersteund (bijv. /blogs/*)
  • Specific Page: Widget verschijnt alleen op het paginapad dat u invoert (bijv. /pages/about)

Als een pagina een eigen Specific Page-toewijzing heeft, wordt daar in plaats van de Everywhere-chatbot die specifieke chatbot weergegeven.

Form- en FAQ-widgets toevoegen

Form- en FAQ-widgets worden toegevoegd als App Blocks in de Theme Editor:

  1. Ga naar Online Store → Themes → Edit theme
  2. Navigeer naar de pagina waar u de widget wilt plaatsen
  3. Klik op Add block en zoek naar "ChatReact"
  4. Kies ChatReact Form of ChatReact FAQ
  5. Voer de Form ID of Chatbot ID in bij de block-instellingen

Handmatige embed (Liquid)

Als u liever direct templates bewerkt, kunt u de widgets ook aan elk Liquid-template toevoegen:

<!-- Form widget -->
<div id="chatreact-form"></div>
<script src="https://www.chatreact.ai/embed/form.js"
  data-form-id="YOUR_FORM_ID"
  data-container="chatreact-form"
  async></script>
<!-- FAQ widget -->
<div id="chatreact-faq"></div>
<script src="https://www.chatreact.ai/embed/faq-widget.js"
  data-chatbot-id="YOUR_CHATBOT_ID"
  data-container="chatreact-faq"
  async></script>

Styling van het Form Widget

Pas het uiterlijk van het formulier aan in de Theme Editor:

SettingOptions
AlignmentLeft, Center, Right
Max Width200–1200px
Font Size12–28px
Margin Bottom0–120px
TaalAuto-detect (default) or one of 24 languages

Styling van het FAQ Widget

SettingOptions
CategorieënOptional comma-separated category slugs (e.g. general,pricing) to show only selected FAQ categories
Font Size12–28px
Margin Bottom0–120px
TaalAuto-detect (default) or one of 24 languages

Widgets beheren

De ChatReact-app in uw Shopify-beheer biedt drie tabbladen:

  1. Chat Widget — Maak en beheer de widgettoewijzingen die bepalen welke pagina's het chatwidget tonen
  2. Formulieren — Stapsgewijze embedinstructies, de handmatige Liquid-snippet en waar u uw Form ID kunt vinden
  3. FAQ Widget — Embedinstructies voor het FAQ-widget en waar u uw Chatbot ID kunt vinden

Selectie van Form en FAQ gebeurt in de Theme Editor: voer de Form ID of Chatbot ID in bij de block-instellingen.

Taalondersteuning

De app ondersteunt alle 24 EU-talen:

  • Het chat widget detecteert automatisch de browsertaal van elke bezoeker en vergelijkt deze met de talen die uw chatbot ondersteunt, met fallback naar de primaire taal van de chatbot
  • De Form- en FAQ-blocks hebben elk hun eigen Taal-instelling in de Theme Editor — deze staat standaard op Auto-detect en kan per block worden overschreven

Verwijderen

Wanneer u de ChatReact-app verwijdert, worden alle widgetconfiguraties en opgeslagen gegevens automatisch uit uw Shopify-winkel verwijderd.


Volgende stappen