B Blengi docs

Start met Blengi

Snelstart

Van aanmelding tot een live-medewerker die binnen vijf minuten je vragen op je site beantwoordt. Elke stap is zo kort dat je er tussendoor mee kunt stoppen en later weer verder kunt gaan.

1. Maak een account aan

Ga naar de startpagina en klik op Aan de slag. Blengi gebruikt Laravel Fortify voor authenticatie, dus je krijgt een standaardregistratie via e-mail en wachtwoord, plus later optionele tweefactorauthenticatie (2FA) in je accountinstellingen.

Bij het aanmelden maken we je eerste werkruimte aan. Als je tijdens het aanmelden je website hebt opgegeven, maken we daar ook meteen je eerste AI-medewerker voor aan: genoemd naar je domein, waarbij het domein al is goedgekeurd en die meteen je startpagina leest. Zonder website kom je op de startpagina terecht, waar je wordt gevraagd er een op te geven: Laat ons je AI-medewerker bouwen.

2. Start de onboarding-wizard

De wizard op /onboarding is de enige manier om een AI-medewerker aan te maken. Het websiteveld op de startpagina opent de wizard en begint de site meteen te lezen; Nieuwe AI-medewerker op de pagina met AI-medewerkers maakt een nieuwe aan en opent de wizard daarvoor (het limiet voor AI-medewerkers van je abonnement is van toepassing). De wizard leidt je door het volgende:

  1. Bevestig de URL van je website. De agent leert van deze site.
  2. Zoek automatisch crawlbare pagina’s op. We onderzoeken je sitemap en een aantal veelvoorkomende paden (/about, /pricing, /faq, /docs, enz.).
  3. Kies welke pagina’s je wilt opnemen. Elke pagina wordt een kennisbron — de tekst wordt in stukjes verdeeld en opgeslagen in de vectoropslag.
  4. Zie hoe ze veranderen in "geïndexeerd". Er wordt om de paar seconden gecontroleerd. Bij de meeste sites is dit binnen een minuut klaar.
  5. Kopieer het insluitfragment. Eén regel HTML.

Het laatste scherm opent een livechat met de nieuwe AI-medewerker (een testchat, die nooit als bezoeker wordt geteld). Klaar: als je naar Home gaat, kom je op de startpagina, waar de installatiechecklist laat zien wat er nog moet gebeuren.

3. De widget insluiten

Plak dit vlak voor </body> op elke pagina waar je de agent wilt laten verschijnen. Als je bent ingelogd, bevat het de ID van je eigen AI-medewerker; hetzelfde fragment, met een kopieerknop, vind je op het tabblad Website van de AI-medewerker onder Code installeren.

<script src="https://blengi.com/w/widget.js?v=97e3674e6b4d" data-agent-id="YOUR-AGENT-ID" async></script>
Toegestane bronnen zijn belangrijk
De widget wordt alleen geladen vanaf bronnen die in de allowed_origins van de agent staan vermeld. Een lege lijst betekent ‘overal weigeren’. Zie Toegestane bronnen voor de regels voor exacte overeenkomsten.

4. Publiceer de agent

Een agent in conceptstart niet op een website: de /widget/init-aanroep van de widget wordt vervangen door 404. Alleen het voorbeeld in het dashboard kan communiceren met een concept. Klik op ‘Publiceren’ bovenaan de pagina’s van de AI-medewerker (de agent wordt ook automatisch gepubliceerd zodra de eerste bron is gelezen). Vanaf dat moment leest de widget de huidige instellingen van de agent, dus elke keer dat je opslaat, is het direct live voor bezoekers. Bij elke publicatie wordt ook een kopie van de instellingen bewaard als een agent_version-rij, die je via Geavanceerd › Eerdere versies kunt herstellen; de widget leest die kopieën nooit.

5. Startpagina

Op Home zie je wat er van je verwacht wordt: een bezoeker die op iemand wacht, nieuwe leads, vragen die je AI-medewerker niet kon beantwoorden. Gesprekken verschijnen live onder Gesprekken , waar je transcripties kunt lezen en een chat kunt overnemen; vastgelegde leads staan onder Leads (/app/leads ).

Wat nu?

Kies uit welke pagina’s de agent leert

Op het eerste instellingsscherm, onder het websiteadres, kies je hoe de startkennis wordt verzameld:

  • Laat me zien wat je hebt gevonden — de standaardinstelling. We scannen, daarna vink je de pagina’s aan voordat er iets wordt toegevoegd.
  • Laat Blengi kiezen — we scannen en voegen de meest nuttige pagina’s meteen toe, zodat je een werkende agent hebt zonder dat je een keuze hoeft te maken. Niets wordt verborgen: de pagina’s verschijnen in Bronnen, en je kunt ze achteraf allemaal toevoegen of verwijderen .
  • Ik voer ze zelf in — sla de scan over en plak de exacte adressen, één per regel. Duplicaten worden genegeerd en een kale example.com/about wordt opgevat als https://.

Wat ‘scannen’ precies inhoudt: we lezen je sitemap.xml (inclusief alles wat in robots.txt staat) en, als er geen sitemap is, de links op je startpagina. We doorlopen niet de hele site. Wat je over het hoofd ziet, kun je later toevoegen, en pagina’s die een bezoeker opent, worden automatisch opgepikt als die instelling aanstaat.

Een pagina die niet kan worden opgehaald — een typefout, een doorverwijzingslus, een inlogscherm — wordt geregistreerd als een mislukte bron en overgeslagen. De rest van de batch wordt hoe dan ook toegevoegd. Een bron die om een tijdelijke reden is mislukt (een time-out, een rate limit, een serverfout) wordt elke 15 minuten opnieuw geprobeerd, maximaal drie keer; een typefout, een ontbrekende pagina of een inlogscherm wordt niet automatisch opnieuw geprobeerd.

Even met je agent praten voordat je hem installeert

Je hoeft het codefragment niet op je site te plaatsen om te zien of de agent werkt. Zodra de eerste pagina is geïndexeerd, toont het laatste instellingsscherm je echte widget en nodigt het je uit om er iets aan te vragen — terwijl de overige pagina’s nog steeds op de achtergrond worden ingelezen.

Het is de echte widget, geen demo: dezelfde code, hetzelfde uiterlijk, en hij geeft antwoord op basis van de pagina’s die hij tot nu toe heeft gelezen. Niets wat je hem daar vraagt, telt mee als een gesprek of een inhoudslek. Een leadformulier dat je vanaf daar verstuurt, levert wel een echte lead op: die komt terecht in Leads, dus je kunt het formulier en de e-mail controleren, maar het wordt niet meegeteld in Resultaten.

Het installatiefragment staat hieronder. Kopieer het pas als je tevreden bent met wat je ziet, in plaats van zomaar code te plakken en er maar op te hopen.