LucaFlow plugin installatie

Voeg een AI-assistent toe aan uw website in één scriptregeltje

De LucaFlow websiteplugin maakt het mogelijk om een AI-assistent rechtstreeks op een externe website te plaatsen. De plugin koppelt aan een specifieke workflow en tenant, en kan worden geconfigureerd als popup, popover of inline widget.

Wat is de LucaFlow websiteplugin?

De LucaFlow websiteplugin is een lichtgewicht JavaScript-component die u op elke website kunt plaatsen. De plugin laadt de geconfigureerde AI-assistent en maakt een chatinterface beschikbaar voor websitebezoekers. De plugin communiceert uitsluitend met de LucaFlow backend via de publieke pluginsleutel.

Geen server-side installatie vereist
Eén scriptregeltje volstaat
Configuratie via pluginsleutel en HTML-attributen
Modus: popup, popover of inline

Weergavemodi

De plugin ondersteunt drie weergavemodi:

Popup: een zwevend chatvenster dat wordt geopend via een knop of automatisch.
Popover: een popover-paneel dat openklapt naast een triggerelement.
Inline: een widget die direct in de pagina-inhoud is ingebed.

Stel de modus in via het data-mode-attribuut of via de plugin-configuratie in het LucaFlow-dashboard.

Publieke pluginsleutel

Elke plugin heeft een unieke publieke pluginsleutel (plugin key). Deze sleutel identificeert de plugin en de bijbehorende workflow en tenant. De pluginsleutel is bewust publiek en geeft alleen toegang tot de geconfigureerde publieke plugin-instellingen. Geheime gegevens, API-sleutels en tenant-interne data zijn nooit toegankelijk via de pluginsleutel.

U vindt de pluginsleutel in het LucaFlow-dashboard onder de plugin-instellingen.

Allowed origins

Allowed origins beperken op welke domeinen de plugin mag worden geladen. Stel per plugin één of meerdere toegestane domeinen in, bijvoorbeeld https://www.uwwebsite.nl. De plugin zal niet reageren op verzoeken van niet-toegestane domeinen.

Wildcard-subdomeinen ondersteund, bijv. https://*.uwwebsite.nl
Meerdere origins per plugin mogelijk
Wijzigingen worden direct actief zonder herinstallatie

Workflow- en persona-koppeling

Een plugin is altijd gekoppeld aan één workflow en één persona. De workflow bepaalt de logica van de assistent; de persona bepaalt het gedrag en de toon. U configureert beide in het dashboard bij de plugin-instellingen.

White-label styling

Pas de weergave van de plugin volledig aan via de white-label instellingen: kleuren, logo, teksten, widgetvorm en introductieberichten. Zo past de assistent naadloos in de huisstijl van uw website of die van uw klant.

Basis embedcode

Voeg de volgende code toe aan de <body> van uw webpagina. Vervang UW-PLUGIN-SLEUTEL door de pluginsleutel uit het dashboard.

<!-- LucaFlow websiteplugin -->
<script
  src="https://plugin.lucaflow.nl/embed.js"
  data-plugin-key="UW-PLUGIN-SLEUTEL"
  data-mode="popup"
  async>
</script>

Vervang data-mode="popup" door popover of inline indien gewenst.

Let op: het domein https://plugin.lucaflow.nl is een voorbeeld. Het actuele endpoint staat in het LucaFlow-dashboard.

Veilig gebruik op externe websites

De LucaFlow plugin is ontworpen voor veilig gebruik op externe websites:

De plugin laadt alleen via HTTPS
Allowed origins beperken welke domeinen de plugin mogen activeren
De pluginsleutel geeft nooit toegang tot interne data of andere tenants
Klantdata en conversaties zijn gescheiden per tenant