> For the complete documentation index, see [llms.txt](https://oswaldai.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://oswaldai.gitbook.io/docs/functionele-documentatie/startersgids.md).

# Startersgids

Wil je meteen aan de slag met Oswald? Volg dan deze startersgids stap voor stap.

## Stappenplan

Elke Oswald functionaliteit wordt in het oranje weergegeven en kort uitgelegd. Als je toch liever een uitgebreidere uitleg wenst over een bepaald functionaliteit kan je erop klikken om de volledige pagina te bekijken.

Hier krijg je alvast een kort overzicht van de stappen die zullen worden besproken in deze gids:

1. Denk na over wat de functie van je bot zal inhouden. Welke vragen moet het kunnen beantwoorden? Op welke sociale media, website of klantendienst platform zal de chatbot weergeven worden?
2. Start met je aan te melden of een account aan te maken op [app.oswald.ai](https://app.oswald.ai). Klik op de organisatie waar je toegang tot hebt en selecteer je chatbot of maak er een nieuwe aan (indien je de juiste [rechten ](https://oswaldai.gitbook.io/docs/functionele-documentatie/overige-functionaliteiten/rollen.md)bezit).
3. Wanneer je klikt op de chatbot, kom je uit bij de Scenario's pagina. Via `Instellingen` in de menubalk kom je bij de [Instellingen](https://oswaldai.gitbook.io/docs/functionele-documentatie/instellingen/instellingen.md) van je chatbot.
4. Maak minstens twee [Intenties](https://oswaldai.gitbook.io/docs/functionele-documentatie/bouwen/trainen-van-de-nlp.md) aan met elk minstens 4 trainingszinnen.
5. Maak indien nodig [entiteiten](https://oswaldai.gitbook.io/docs/functionele-documentatie/bouwen/entiteiten.md) aan.
6. Test je intenties in de [Train interface](https://oswaldai.gitbook.io/docs/functionele-documentatie/bouwen/train-interface.md) en kijk of de bot ze al goed kan herkennen. Pas aan waar nodig.
7. Maak een [scenario](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/conversationele-bomen.md) aan.
8. [Test](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/testen.md) de flow van je scenario’s en maak tests aan.
9. Je kan de Oswald widget en alle andere [integraties](https://oswaldai.gitbook.io/docs/functionele-documentatie/integraties/inleiding.md) aanpassen in de tabs `Widget` en `Integraties` van de Instellingen.
10. [Exporteer](https://oswaldai.gitbook.io/docs/functionele-documentatie/instellingen/exporteren.md) je chatbot en sla dit bestand op.
11. [Publiceer](https://oswaldai.gitbook.io/docs/functionele-documentatie/instellingen/publiceren.md) je chatbot.
12. Test je chatbot volledig.
13. Zet je bot live.
14. Blijf je bot bijtrainen.

### Stap 1: **De functie en vorm van je chatbot.**

Voor je een chatbot begint te bouwen, moet je goed nadenken over welke functie hij of zij zal vervullen. Hier spelen de persoonlijkheid, tone of voice en de integratie keuzes voor je bot een grote rol.

Ben je op zoek naar een formele customer support bot, of eerder een informele en joviale verkopersbot met een grappige persoonlijkheid? De manier waarop je de gebruiker aanspreekt hangt hier sterk van af. Consistentie in je taalgebruik is daarbij belangrijk om de gebruiker niet te verwarren. Ontwerp dus een persoonlijkheid voor je bot met regels rond de aanspreking van de gebruiker die overeenkomt met de professionele marketing van je bedrijf. Hieronder vind je een voorbeeld om je op weg te helpen:

![Persoonlijkheid van je bot opbouwen](https://1621246471-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_IHdvfaXCVi1CBgkrB%2F-M2r6jopl_n3D4uC_QFK%2F-M2rBkfYIW5dALLQNEeQ%2FScreenshot%202020-03-20%20at%2010.07.49.png?alt=media\&token=f607fe54-0258-4dc5-823c-a44fcbe99906)

Wil je bovendien dat de bot op andere platformen beschikbaar is zoals Facebook Messenger en WhatsApp? Vooral deze keuze zal veel invloed hebben op de opbouw van je chatbot, aangezien andere platformen hun eigen regels hebben i.v.m. de inhoud en chatbot functionaliteiten. Raadpleeg de [Facebook for Developers](https://developers.facebook.com/docs/messenger-platform/send-messages) en [WhatsApp Business API](https://developers.facebook.com/docs/whatsapp/overview) documentatie voor een overzicht van de regels en limitaties.

### **Stap 2: Maak een account en een chatbot aan.**

Surf naar [app.oswald.ai](https://app.oswald.ai) en maak een account aan bij “Nog geen account?”. Zorg dat je werkt met Google Chrome, Mozilla Firefox of Apple Safari. Deze browsers worden volledig ondersteund voor Oswald.

Wanneer je dan inlogt via `Inloggen` kom je terecht bij de organisaties waar jij toegang tot hebt. Klik op een organisatie om je chatbot(s) te zien. Selecteer je chatbot door erop te klikken of maak er een nieuwe aan met `Chatbot toevoegen`.

{% hint style="info" %}
Contacteer ons via de [servicedesk](https://raccoons-group.atlassian.net/servicedesk/customer/portal/4) als je geen organisaties ziet verschijnen bij het inloggen. Heb je nog geen toegang tot de servicedesk? Dan kan je mailen naar <hello@oswald.ai>.
{% endhint %}

### **Stap 3: Bekijk de Instellingen van je chatbot.**

Wanneer je een chatbot selecteert kom je uit op de Scenario's pagina. Klik in de menubalk op `Instellingen` om de [Instellingen](https://oswaldai.gitbook.io/docs/functionele-documentatie/instellingen/instellingen.md) pagina te openen. Raadpleeg de Instellingen pagina voor meer uitleg over alle parameters.

<figure><img src="https://1621246471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_IHdvfaXCVi1CBgkrB-887967055%2Fuploads%2Fn5A5ZNmG6bXrrTB2KA3S%2FScreenshot%202026-10-27%20at%2012.39.09.png?alt=media&amp;token=cf4372aa-e4b0-477e-97d4-039f726f4214" alt=""><figcaption></figcaption></figure>

Hier heb je alvast een kort overzicht van de belangrijkste zaken:

**Algemeen:**&#x20;

* [Titel](https://oswaldai.gitbook.io/docs/functionele-documentatie/instellingen/instellingen.md#titel): De titel van je chatbot. Dit is niet de naam van je bot en verschijnt niet in je widget.
* [Drempelwaarde](https://oswaldai.gitbook.io/docs/functionele-documentatie/instellingen/instellingen.md#drempelwaarde): Dit getal representeert hoe zeker Oswald moet zijn van een intentiescore om een antwoord te selecteren. Hoe hoger deze waarde, hoe strenger de bot en hoe zekerder Oswald moet zijn van het antwoord vooraleer hij die effectief zal selecteren en laat zien. Indien je het gevoel hebt dat de chatbot vaak verkeerde antwoorden geeft is het misschien nuttig om deze waarde hoger te zetten.
* [Levensduur context](https://oswaldai.gitbook.io/docs/functionele-documentatie/instellingen/instellingen.md#levensduur-context): Soms wil je dat de gebruiker na bijvoorbeeld een uur het gesprek weer kan oppikken in hetzelfde chatvenster, andere keren wil je dat het gesprek terug van het begin start. De Levensduur context functionaliteit stelt het aantal minuten in dat de context van de conversatie moet bewaard blijven. Wanneer deze waarde op 0 staat, wordt deze oneindig bijgehouden.
* [Ondersteunde talen](https://oswaldai.gitbook.io/docs/functionele-documentatie/instellingen/instellingen.md#ondersteunde-talen): Alle talen die worden ondersteund door de bot.
* [Standaardtaal](https://oswaldai.gitbook.io/docs/functionele-documentatie/instellingen/instellingen.md#standaard-language): De bot zal standaard naar deze taal overschakelen wanneer er geen informatie beschikbaar is over in welke taal de gebruiker hanteert.
* [Omgevingsvariabelen](https://oswaldai.gitbook.io/docs/functionele-documentatie/instellingen/instellingen.md#omgevingsvariabelen): Deze variabelen (in JSON-formaat) kan je overal in de bot gebruiken in code responses.

**Vaste teksten**

* [Welkomstbericht](https://oswaldai.gitbook.io/docs/functionele-documentatie/instellingen/instellingen.md#start) \*: Het bericht dat je chatbot laat zien wanneer de gebruiker de widget het eerst opent.
* [Niet begrepen](https://oswaldai.gitbook.io/docs/functionele-documentatie/instellingen/instellingen.md#niet-begrepen)\*: Het bericht dat je chatbot laat zien wanneer hij de gebruiker niet heeft begrepen.
* [Foutboodschap](https://oswaldai.gitbook.io/docs/functionele-documentatie/instellingen/instellingen.md#foutboodschap)\*: Het bericht dat je chatbot laat zien wanneer er een fout is opgetreden.
* [Bericht bij inactiviteit](https://oswaldai.gitbook.io/docs/functionele-documentatie/instellingen/instellingen.md#bericht-na-tijd) \*: Wanneer de gebruiker een tijdje niet reageert, zal de chatbot automatisch een bericht tonen. Dit is handig om de gebruiker verder op weg te helpen.

\*Bij deze parameters kan je een command activeren met de toggle `Als gebruikersbericht versturen`. Dit betekent dat je de tekst in dit veld op de achtergrond (dus niet zichtbaar voor de gebruiker) naar de bot stuurt die op basis van dit woord of deze zin een [antwoordnode](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/antwoordnode.md) uit een scenario zal activeren.

* [Opties](https://oswaldai.gitbook.io/docs/functionele-documentatie/instellingen/instellingen.md#opties): Rechtsboven in de Instellingen vind je in het `⋯`-menu de opties om de chatbot te exporteren naar een .chatbot bestand (`Exporteren`) en een export terug te zetten (`Herstellen`). De chatbot testen in de widget (`Widget testen`) en publiceren (`Publiceren`) doe je via het trainingsstatus-menu rechts in de menubalk.

<figure><img src="https://1621246471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_IHdvfaXCVi1CBgkrB-887967055%2Fuploads%2FcUbSUiS38qqQEvJTAB7m%2FScreenshot%202026-10-27%20at%2012.39.57.png?alt=media&amp;token=fef95cb1-24c8-4859-82b0-b7c20e9d7f5c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1621246471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_IHdvfaXCVi1CBgkrB-887967055%2Fuploads%2FsB1vpQCaZY1VrEg10Lwq%2FScreenshot%202026-10-27%20at%2012.39.39.png?alt=media&amp;token=fd45e4c3-8841-4a92-a123-fb6004e06193" alt=""><figcaption></figcaption></figure>

### Stap 4: Maak al minstens 2 intenties aan met elk minstens 4 trainingszinnen.

Een [intentie](https://oswaldai.gitbook.io/docs/functionele-documentatie/bouwen/trainen-van-de-nlp.md) is zeer simpel uitgedrukt het doel dat je gebruiker voor ogen heeft bij het stellen van een vraag. Een kort voorbeeld:

* Wat is het weer vandaag?
* Moet ik een paraplu meenemen?
* Gaat het morgen bewolkt zijn?

Dit zijn drie verschillende vragen die je onder dezelfde intentie “#weer” zou kunnen plaatsen, aangezien de gebruiker simpelweg het weer wil weten. Deze zinnen worden trainingszinnen genoemd die worden gebruikt door de bot om de intentie te herkennen.

{% hint style="info" %}
Bij de naamgeving van je intenties hanteren we enkele best practices: gebruik maximum 5 woorden om een intentie te benoemen. Indien dat niet gaat, moet je de intentie herformuleren. Vermijd spaties en gebruik laagliggende streepjes of koppeltekens: forgot\_password, choose-new-password
{% endhint %}

Maak een nieuwe intentie aan en voeg minstens vier goede trainingszinnen toe. Dit is een zeer belangrijk proces, aangezien de chatbot deze zinnen gebruikt om bij te leren. **Je chatbot is maar zo goed als de kwaliteit van je trainingszinnen.** Daarom hou je best enkele aanbevelingen in je achterhoofd:

* Geef zoveel mogelijk kwaliteitsvolle trainingszinnen mee
* Gebruik geen enkele woorden als trainingszinnen, tenzij bij de speciale “#single-entity” intent (bijvoorbeeld wanneer de gebruiker ‘ja’ of ‘nee’ moet antwoorden). Je voegt de entiteiten die je in quickreplies gebruikt toe aan een intentie die je "#single-entity" noemt en gebruikt deze in antwoordnodes om ervoor te zorgen dat de entiteiten een hogere score krijgen dan andere intenties (aangezien entiteiten nooit hoger scoren dan intenties). Zie het voorbeeld hieronder:

<figure><img src="https://1621246471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_IHdvfaXCVi1CBgkrB-887967055%2Fuploads%2FYpFxuUCCj4949aMBbDaK%2FScreenshot%202026-10-27%20at%2012.41.05.png?alt=media&amp;token=714e1772-7b85-4956-881c-82b48dd582a5" alt=""><figcaption></figcaption></figure>

* Gebruik geen Google Search queries zoals “weer vandaag Brussel”. Herwerk deze korte zinnen naar een volzin: “Wat is het weer vandaag in Brussel”
* Maak je zinnen niet te lang
* Vermijd meerdere vragen in 1 zin en gebruik enkele vragen
  * Vb: “'Ik heb gisteren naar de website gekeken en ik vroeg me af of het mogelijk was om een sessie te boeken met de leraar van de vorige keer, omdat ik haar echt leuk vind, kan dat voor volgende week geregeld worden?”
  * Beter is: “ik wil graag een sessie boeken” en “kan ik een sessie boeken bij dezelfde leeraar?”
* Gebruik geen ruwe gebruikersinput om je chatbot te trainen. Kopieer dus niet zomaar alles wat je in gesprekken terug vindt om te gebruiken als trainingsdata. Je kan de gesprekken nakijken in de [Menselijke Overname](https://oswaldai.gitbook.io/docs/functionele-documentatie/overige-functionaliteiten/menselijke-overnames.md) interface (Opvolgen ▾ › Takeover) of alle [onbeantwoorde vragen](https://oswaldai.gitbook.io/docs/functionele-documentatie/overige-functionaliteiten/onbeantwoorde-berichten.md) in Opvolgen ▾ › Issues, waarbij je de vragen van de gebruikers kan terugvinden.
* Vooraleer je deze zinnen toevoegt bij je intenties moet je ervoor zorgen dat de zinnen werden ‘opgeruimd’:
  * Haal alle persoonlijke informatie weg (e-mails, namen, telefoonnummers, …)
  * Zorg dat lange teksten gedestilleerd worden tot enkele vragen

### Stap 5: Maak indien nodig op dit moment alvast een paar entiteiten aan.

Wanneer de chatbot een onderscheid moet kunnen maken tussen verschillende onderwerpen, objecten of specifieke woorden maak je daar best [entiteiten](https://oswaldai.gitbook.io/docs/functionele-documentatie/bouwen/entiteiten.md) voor aan. Een kort voorbeeld:

* Wat is het weer morgen in Rome?
* Wat is het weer vandaag in België?

De chatbot moet in dit voorbeeld het onderscheid kunnen maken tussen morgen en vandaag (“@tijdstip”) en Rome en België (“@plaats”).

| @label    | @waarde  | Synoniemen                     |
| --------- | -------- | ------------------------------ |
| @tijdstip | @morgen  | Volgende dag                   |
|           | @vandaag | Nu, op dit moment, momenteel   |
| @plaats   | @Rome    | Roma                           |
|           | @België  | Belgium, Belgique, BEL, Belgie |

Met het label houdt Oswald geen rekening, wel met de waarde en de synoniemen.

{% hint style="warning" %}
Gebruik waar mogelijk enkele woorden voor entiteiten en de synoniemen. Vermijd het gebruik van punten (.) want dit veroorzaakt technische problemen.
{% endhint %}

### Stap 6: Test je intenties in de trainingsinterface en kijk of de bot ze al goed kan herkennen. Pas aan waar nodig.

Geweldig! Je kan nu al je chatbot beginnen testen. Ga naar de [Train interface](https://oswaldai.gitbook.io/docs/functionele-documentatie/bouwen/train-interface.md) (Ontwikkelen ▾ › Trainen), typ een zin in het veld `Test een bericht` en druk op enter. Je zal zien wat de bot heeft herkend en welke intentie hij kiest. Indien je een andere intentie had verwacht, kan je dit corrigeren door bij `Modelvalidatie` de juiste intentie te selecteren en op `Valideren` te klikken. De zin die je net typte wordt dan toegevoegd als trainingszin aan de geselecteerde intentie.

<figure><img src="https://1621246471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_IHdvfaXCVi1CBgkrB-887967055%2Fuploads%2FYCP1O6CpLRFrccJh1fYe%2FScreenshot%202026-10-27%20at%2012.42.11.png?alt=media&amp;token=626a745b-c74d-45a6-bc66-b339de677645" alt=""><figcaption></figcaption></figure>

### Stap 7: Ontwerp je scenario's.

Wanneer je op dit moment tegen de bot probeert te praten, zal die waarschijnlijk een bericht weergeven zoals ‘Sorry, dat heb ik niet begrepen.’. Dit komt omdat je eerst de antwoorden moet ontwerpen die je chatbot kan selecteren aan de hand van de intenties. Ga naar de [scenario’s interface](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/inleiding.md) en maak een nieuw scenario aan met `Nieuw scenario`.

<figure><img src="https://1621246471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_IHdvfaXCVi1CBgkrB-887967055%2Fuploads%2F5ZRCVxCxz6jYWBPg9eqf%2FScreenshot%202026-10-27%20at%2012.42.43.png?alt=media&amp;token=b935a2c7-d947-427e-9749-c7883a747b16" alt=""><figcaption></figcaption></figure>

#### Scenario view

Wanneer je een nieuw scenario aanmaakt, kom je automatisch in de [scenario view](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/conversationele-bomen.md) terecht.

<figure><img src="https://1621246471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_IHdvfaXCVi1CBgkrB-887967055%2Fuploads%2FTJh4kIcJaaffiAqckjE7%2FScreenshot%202026-10-27%20at%2012.43.39.png?alt=media&amp;token=34322c30-3eb6-4035-8ced-2a3ee24645cb" alt=""><figcaption></figcaption></figure>

Hier krijg je een kort overzicht van de functionaliteiten:

* Titel (linksboven): je kan deze wijzigen door op de naam van je scenario te klikken.
* Scenariolijst: je keert terug naar de lijst van alle scenario’s via `Scenario's` in de menubalk.
* [Antwoordnode](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/conversationele-bomen.md): een node is een soort ‘container’ waarin je een antwoord van de bot formuleert.
* Taal: Hier selecteer je de taal van dit scenario (taalkeuze rechts in de menubalk). Wijzig de taal om de antwoorden in andere talen bij te werken.
* `⋯`-menu:
  * `Exporteren (JSON/CSV)`: Je kan een scenario exporteren naar een bestand. Je zou dit willen doen om bijvoorbeeld hetzelfde scenario ook in een andere chatbot te gebruiken. Dit kan handig zijn voor algemene scenario’s zoals "welkom", "contact", etc ...
  * `Scenario verwijderen`: Je kan dit scenario verwijderen.

<figure><img src="https://1621246471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_IHdvfaXCVi1CBgkrB-887967055%2Fuploads%2FgGm5XwtpCasrGmPK2o7j%2FScreenshot%202026-10-27%20at%2012.44.01.png?alt=media&amp;token=ce241634-1559-4503-a50c-d02aa9184e53" alt=""><figcaption></figcaption></figure>

* `Scenario opslaan`: Sla je scenario op.
* Open de test interface door op de chatbubbel van de testwidget te klikken. Je vindt hier ook je [bot brein](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/testen.md#het-brein-van-de-chatbot) terug door op een antwoord van de bot te klikken.
* Het veld `Vereiste toestand` (standaard `Altijd actief`) bevat de [Toestanden](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/toestanden.md).
* Je kan via het menu van een node antwoordnodes toevoegen.
  * `Tussenvoegen`: Er zal een node worden toegevoegd onder deze node.
  * `Aftakking toevoegen`: Je kan een nieuwe node ernaast toevoegen.
  * `Naar bladwijzer springen`: Spring naar een bookmark.
  * Naar mens: Je kan een menselijke overname instellen of suggereren via `Overname` in de geavanceerde instellingen van de node.

<figure><img src="https://1621246471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_IHdvfaXCVi1CBgkrB-887967055%2Fuploads%2FWIyljrnxxJlxD9curIGq%2FScreenshot%202026-10-27%20at%2012.44.24.png?alt=media&amp;token=7d6607ad-9ca6-4dfd-87b8-95d6490dbf7e" alt=""><figcaption></figcaption></figure>

#### Antwoordnodes ontwerpen

Klik op de antwoordnode om je antwoord te ontwerpen in het venster `Node bewerken`. Ook hier krijg je een kort overzicht:

<figure><img src="https://1621246471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_IHdvfaXCVi1CBgkrB-887967055%2Fuploads%2F0BfjiltnpxjWlgUd8bQ5%2FScreenshot%202026-10-27%20at%2012.44.49.png?alt=media&amp;token=3723be42-0035-454a-a95d-6c71c92cd970" alt=""><figcaption></figcaption></figure>

* [Intentie](https://oswaldai.gitbook.io/docs/functionele-documentatie/bouwen/trainen-van-de-nlp.md): Voeg de intentie toe onder `Triggers`. Je kan de bot enkel rekening laten houden met de zin of de context of beiden (`Bereik`: `Huidige zin`, `Contextgeschiedenis` of `Overal`). Raadpleeg de pagina [context](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/context.md) voor een voorbeeld.
* [Entiteiten](https://oswaldai.gitbook.io/docs/functionele-documentatie/bouwen/entiteiten.md): Selecteer indien van toepassing een entiteit. Je kan een entiteit toevoegen en aanduiden over welke specifieke waarde het gaat. Als je de `Specifieke waarde` leeg laat (`Elke waarde`), gaat de bot elke waarde die bij de entiteit label hoort selecteren. In ons voorbeeld van het weer in Rome kan je bijvoorbeeld de label “@plaats” selecteren. Dan maakt welke plaats niet uit, zolang de bot maar herkent dat er een plaats in de zin of context werd vermeld.

{% hint style="warning" %}
Indien je meerdere entiteiten toevoegt, moeten BEIDEN in de zin of context voorkomen vooraleer de bot deze antwoordnode zal kiezen. Hij kiest **niet** tussen 1 van de twee.
{% endhint %}

* [Tags](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/tags.md): Je kan tags toevoegen of verwijderen (`Geavanceerde instellingen` › `Sessie en context`). Deze kan je bekijken in de statistieken of gebruiken om te filteren in de Menselijke overname.
* Sla antwoord op in [variabele](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/variabelen.md) ( in `Geavanceerde instellingen`): Het is in Oswald mogelijk om een antwoord van de gebruiker op te slaan in een variabele. Raadpleeg de pagina [Variabelen](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/variabelen.md) voor een voorbeeld.
* Er bestaan 5 soorten [outputs ](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/antwoordnode.md#outputs)in een vast antwoord (tab `Berichten`):
  * Tekst
  * Links
  * Afbeeldingen
  * Filmpjes
  * Locaties
* Je hebt ook nog een tab generatieve antwoorden en code responses.&#x20;
* [Bladwijzer](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/bookmarks.md): Het is in Oswald mogelijk om van het einde van een scenario naar een andere node in hetzelfde scenario of in een ander scenario te springen.
* [Quickreplies](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/antwoordnode.md#snelle-antwoorden): Korte antwoorden die worden weergegeven in knoppen om je gebruikers op weg te helpen. Bestaat uit een tekst en een actie.
* Opslaan of sluiten.

Wanneer je een andere antwoordnode hebt die volgt op deze node (een [child node](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/conversationele-bomen.md)), krijg je nog een paar extra opties:

* [Antwoordprioriteit](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/antwoordprioriteit.md): Soms is het mogelijk dat er meerdere nodes getriggerd kunnen worden als antwoord op een bepaalde vraag. Je hebt drie mogelijkheden:
  * Kinderen eerst (`Standaard`)
  * Alleen kinderen&#x20;
  * Slimste match

Ontwerp je scenario boom op een logische wijze zodat het gesprek met je gebruiker kan vloeien en anticipeer op gerelateerde vragen.

#### Tips & tricks:

* Wil je wat variatie in je antwoorden? Je kan het ‘|’ teken gebruiken in je antwoorden. De bot zal dan willekeurig één van de zinnen selecteren. Zie de eerste antwoordnode in dit voorbeeld:
* Als chatbot developer moet je anticiperen op de vragen van de gebruiker. Soms stellen gebruikers algemene vragen, maar andere keren geven ze toch al wat specifieke informatie mee. Je kan in Oswald voor beide gevallen een scenario ontwerpen met een verticale structuur (zie hierboven).
* De eerste node zal geselecteerd worden wanneer de gebruiker een algemene vraag stelt, maar wanneer hij of zij al de specifieke entiteit meegeven, kan de bot meteen reageren met een specifieker antwoord.
* Indien je scenario’s ontwikkelt die je liever niet toegankelijk maakt voor de gebruiker, tenzij na een specifieke bookmark, kan je je scenario’s op de [toestand](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/toestanden.md) "locked" zetten op deze manier:

<figure><img src="https://1621246471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_IHdvfaXCVi1CBgkrB-887967055%2Fuploads%2FxVYvr5aYaaeebLKntzip%2FScreenshot%202026-10-27%20at%2012.46.26.png?alt=media&amp;token=1a1fe6b1-694a-4210-9344-5a29d5012eb2" alt=""><figcaption></figcaption></figure>

### Stap 8: Test je scenario’s in de test interface met het bot brein.

Wanneer je al je afzonderlijke scenario’s hebt gebouwd, is het belangrijk om ervoor te zorgen dat deze vloeien in een gesprek. Kijk dus hoe je verschillende scenario’s met elkaar interageren en dat de gebruiker altijd verder kan. Vermijd dus doodlopende scenario’s waar mogelijk en anticipeer op gerelateerde vragen die de gebruiker logischerwijze zal stellen na een bepaald antwoord.

Benut acties in je [quickreplies](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/antwoordnode.md#snelle-antwoorden), blokkeer scenario’s die je enkel toegankelijk wil maken aan de hand van een [bookmark](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/bookmarks.md) jump en gebruik bookmarks zoveel je wil (het is een super coole functionaliteit!).

Je kan de flow van je gesprek nakijken door te praten tegen de chatbot in de test omgeving. Klik op de chatbubbel van de testwidget (beschikbaar op elke pagina van je chatbot, behalve Takeover) en begin te praten tegen je bot.

<figure><img src="https://1621246471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_IHdvfaXCVi1CBgkrB-887967055%2Fuploads%2FWFGdDzF67cnxQmc9chtg%2FScreenshot%202026-10-27%20at%2012.47.05.png?alt=media&amp;token=a92f1ead-345a-4875-92fa-c83642288cf0" alt=""><figcaption></figcaption></figure>

In de testomgeving kan je nog enkele functionaliteiten vinden:

* Refresh: Reset de test interface en maak het gesprek leeg.
* **Opslaan als test**(in het bot brein): Wanneer je spreekt tegen je bot en een volledig scenario hebt doorlopen, kan je dit scenario opslaan als een ‘test’ door in het bot brein op `Opslaan als test` te klikken. Geef de ‘test’ een naam een sla op. Deze test verschijnt dan in de Tests interface (Opvolgen ▾ › Tests) en kan je op elk moment raadplegen om te testen of het scenario as is nog steeds werkt naar verwachting wanneer je verder aanpassingen uitvoert in de bot.

{% hint style="success" %}
Tests aanmaken zorgt ervoor dat je chatbotontwikkeling sneller en gemakkelijker verloopt. Gebruik deze functionaliteit dus zeker doorheen je ontwikkelingsproces.
{% endhint %}

* [Bot brein](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/testen.md#het-brein-van-de-chatbot): Je kan voor elk antwoord gaan kijken wat er zich op dat moment afspeelde in het bot brein door op het antwoord te klikken.

Naast je gesprek kan je het [bot brein](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/testen.md#het-brein-van-de-chatbot) raadplegen en op de voet volgen wat er zich afspeelt in het onderliggend geheugen van de bot.

Hier krijg je een klein overzicht wat je met het bot brein kan doen:

* [Intentie](https://oswaldai.gitbook.io/docs/functionele-documentatie/bouwen/trainen-van-de-nlp.md), [Toestand](https://oswaldai.gitbook.io/docs/functionele-documentatie/scenarios/toestanden.md) en [entiteiten](https://oswaldai.gitbook.io/docs/functionele-documentatie/bouwen/entiteiten.md) (`Resultaat`): Je kan zien welke zaken de bot heeft herkend.
* Regels (`Herkende regels`): Welke regels zijn er geactiveerd.
* Nieuwe context: Welke nieuwe zaken werden er aan de context toegevoegd.
* Vorige context: Welke zaken zaten er voor dit antwoord al in de context.
* Huidige tags: Welke tags werden er al herkend en toegevoegd.
* Intentie scores (met drempelwaarde) (`Zekerheid per intentie`): Je kan hier zien welke intenties en in welke mate ze werden herkend.
* Verwachte intentie: De intent die Oswald uiteindelijk heeft gekozen waaraan een antwoord hangt.
* Geactiveerde antwoorden: Hier zie je een lijst van de stappen die Oswald ondernam om op dit antwoord uit te komen.

{% hint style="info" %}
Wanneer er iets misloopt in je gesprek met de bot, raadpleeg dan altijd eerst het bot brein.
{% endhint %}

### Stap 9: Pas je integraties aan.

Je kan in de Instellingen, tabs `Widget` en `Integraties`, je Oswald widget ontwerpen of andere integraties toevoegen. Let hier wel op: als je de aanpassingen in je Oswald widget of andere integraties wil zien, moet je de bot opnieuw publiceren. Dit betekent dat alle aanpassingen in je integraties pas zichtbaar zijn nadat je ook de rest van de chatbot hebt gepubliceerd. Indien je liever enkele aanpassingen in de bot nog niet wil tonen aan de gebruiker, moet je hier wel op letten.

### Stap 10: Exporteer je chatbot en sla dit bestand op.

Het is altijd een goed idee om je chatbot te [exporteren](https://oswaldai.gitbook.io/docs/functionele-documentatie/instellingen/exporteren.md) en veilig op te slaan. Zo kan je altijd terugkeren naar een vorige versie. Sla regelmatig je chatbot op.

### Stap 11: Publiceer je chatbot.

[Publiceer](https://oswaldai.gitbook.io/docs/functionele-documentatie/instellingen/publiceren.md) je chatbot door in het trainingsstatus-menu rechts in de menubalk op `Publiceren` te klikken. Via `Widget testen` in hetzelfde menu kan je je chatbot in actie zien op een demopagina.

### Stap 12: Test je chatbot volledig.

Voor je de chatbot live zet, raden wij altijd aan om je chatbot goed te laten testen door verschillende partijen. Laat de bot vooral testen door personen die niets te maken hadden met de ontwikkeling van de bot en bekijk hoe zij ermee om gaan. Dit kan al heel waardevolle feedback zijn op je chatbot design, waarmee je al een paar aanpassingen kan doen voor je de bot publiek beschikbaar stelt. Wij raden aan minstens 5 personen de bot te laten testen. Gebruikers verwoorden soms jargon termen volledig anders en het is belangrijk om de juiste verwoording te achterhalen voor de bot live gaat.

Zorg daarnaast dat je alle feedback op 1 plek verzamelt. Zo kan je een overzicht behouden van alle verbeterpunten en zijn deze gemakkelijker te communiceren naar de juiste partij.

### **Stap 13: Zet je chatbot live.**

Indien je de Oswald widget integratie koos, kan je in de Instellingen, tab [`Widget`](https://oswaldai.gitbook.io/docs/functionele-documentatie/integraties/widget.md), het `Widgetscript` vinden. Plak dit in de HTML-code van je website en voila! Daar staat je chatbot klaar!

Bij andere integraties hoef je gewoon de instructies te volgen die worden weergegeven bij het selecteren van de integratie.

### Stap 14: Blijf je bot bijtrainen.

Hoe hard we ook proberen te anticiperen op gebruikersinput, de ervaring leert ons dat mensen zaken soms veel anders verwoorden en andere dingen verwachten van de chatbot. Het is dan aan jou de keuze hoe je hierop gaat inspelen.

Je kan je bot continu verbeteren door input van de gebruikers te analyseren in de [Menselijke overname](https://oswaldai.gitbook.io/docs/functionele-documentatie/overige-functionaliteiten/menselijke-overnames.md) interface (Opvolgen ▾ › Takeover), de [onbeantwoorde vragen](https://oswaldai.gitbook.io/docs/functionele-documentatie/overige-functionaliteiten/onbeantwoorde-berichten.md) (Opvolgen ▾ › Issues) of de [Train interface](https://oswaldai.gitbook.io/docs/functionele-documentatie/bouwen/train-interface.md). Daar kan je inzichten verzamelen over vragen waar de bot op dit moment nog niet kan antwoorden. Zorg dat je voor alle gebruikersinput de regels toepast in[ stap 4](https://oswaldai.gitbook.io/docs/functionele-documentatie/startersgids.md#stap-4-maak-al-minstens-2-intenties-aan-met-elk-minstens-4-trainingszinnen).

## Vragen?

Indien je toch nog problemen ondervindt met je (gepubliceerde) bot, kan je een ticket aanmaken in onze [servicedesk](https://raccoons-group.atlassian.net/servicedesk/customer/portal/4).

**Veel success! 👏**
