# CLAUDE
Source: https://docs.sleak.chat/CLAUDE



# Mintlify documentation

## Working relationship

* You can push back on ideas-this can lead to better documentation. Cite sources and explain your reasoning when you do so
* ALWAYS ask for clarification rather than making assumptions
* NEVER lie, guess, or make up anything

## Project context

* Format: MDX files with YAML frontmatter
* Config: docs.json for navigation, theme, settings
* Components: Mintlify components

## Content strategy

* Document just enough for user success - not too much, not too little
* Prioritize accuracy and usability
* Make content evergreen when possible
* Search for existing content before adding anything new. Avoid duplication unless it is done for a strategic reason
* Check existing patterns for consistency
* Start by making the smallest reasonable changes

## docs.json

* Refer to the [docs.json schema](https://mintlify.com/docs.json) when building the docs.json file and site navigation

## Frontmatter requirements for pages

* title: Clear, descriptive page title
* description: Concise summary for SEO/navigation

## Writing standards

* Second-person voice ("you")
* Prerequisites at start of procedural content
* Test all code examples before publishing
* Match style and formatting of existing pages
* Include both basic and advanced use cases
* Language tags on all code blocks
* Alt text on all images
* Relative paths for internal links

## Git workflow

* NEVER use --no-verify when committing
* Ask how to handle uncommitted changes before starting
* Create a new branch when no clear branch exists for changes
* Commit frequently throughout development
* NEVER skip or disable pre-commit hooks

## Do not

* Skip frontmatter on any MDX file
* Use absolute URLs for internal links
* Include untested code examples
* Make assumptions - always ask for clarification


# Custom tool
Source: https://docs.sleak.chat/agent/acties/custom-tool

Leer hoe je een custom tool configureert voor real-time data

Met een custom tool kan de agent real-time informatie ophalen uit externe software systemen. Op basis van specifieke variabelen kan de agent relevante data opvragen en met AI een antwoord formuleren op de vraag van de bezoeker.

<Info>
  **Deze feature is onderdeel van het Grow pakket**
</Info>

## Voorbeelden

| Toepassing | Omschrijving |
| - | - |
| Support ticket aanmaken | Laat de agent automatisch een ticket aanmaken in je helpdesk op basis van het gesprek |
| Weer informatie ophalen | Haal real-time weerdata op voor een locatie die de bezoeker opgeeft |
| Data ophalen uit CMS | Vraag actuele content of productinformatie op uit je eigen systeem |
| Retour status opvragen | Laat bezoekers de status van hun retour opzoeken via een ordernummer |

## Hoe werkt het?

Een custom tool is het beste te vergelijken met een tool die de agent kan gebruiken. Net als bij andere databronnen, bepaalt de tool beschrijving wanneer de agent de API moet raadplegen.

<Info>
  **Variabelen zijn vereist**

  De agent moet eerst specifieke variabelen verzamelen voordat de agent een custom tool kan gebruiken. Bijvoorbeeld: "Je kunt deze tool pas raadplegen als er een ordernummer EN een e-mailadres zijn doorgegeven."
</Info>

**Voorbeeld tool beschrijving:**

```
Gebruik deze tool om de status van een bestelling op te vragen.
Je kunt deze tool pas raadplegen als er een ordernummer EN een e-mailadres zijn doorgegeven.
Vraag eerst naar deze gegevens voordat je de tool gebruikt.
```

## Best practices

1. **Wees duidelijk over vereiste variabelen**: Vermeld expliciet welke gegevens de agent moet verzamelen voordat de API wordt aangeroepen
2. **Test de koppeling**: Controleer of de API correct reageert met de verwachte data
3. **Beveilig credentials**: Bewaar API keys en secrets veilig
4. **Rate limiting**: Houd rekening met API limieten van de externe service

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# Formulier
Source: https://docs.sleak.chat/agent/acties/formulier

Toon een formulier in de chat op het juiste moment

Met een formulier actie kun je een formulier bouwen dat de agent op het juiste moment in de chat toont. De tool beschrijving bepaalt wanneer de agent het formulier inzet.

## Veldtypen

| Type | Omschrijving |
| - | - |
| E-mail | E-mailadres invoer met validatie |
| Telefoon | Telefoonnummer invoer |
| Tekst | Korte tekst, één regel |
| Meerdere regels | Langere tekst, zoals een bericht of omschrijving |
| Meerkeuze | Laat de bezoeker kiezen uit vaste opties |
| Bestand | Bestandsupload |

<Info>
  **Deze feature is onderdeel van het Grow pakket**
</Info>

## Tool beschrijving

De tool beschrijving bepaalt wanneer de agent het formulier toont. Gebruik dit om het formulier alleen in te zetten in relevante situaties.

## Webhook

Het formulier kan worden gekoppeld aan een webhook. Zodra een bezoeker het formulier verstuurt, worden de ingevulde gegevens naar de ingestelde URL gestuurd.

Dit maakt het mogelijk om inzendingen automatisch te verwerken in externe systemen, zoals:

* Een ticket aanmaken in je helpdesk (bijv. Freshdesk, Zendesk)
* Een lead opslaan in je CRM (bijv. HubSpot, Pipedrive)
* Een notificatie sturen naar Slack of e-mail
* Een flow starten in een automatiseringstool zoals Make of n8n

## Bevestigingsbericht

Het bericht dat de bezoeker ziet na het versturen van het formulier is aanpasbaar.

**Voorbeeld:**

```
Toon dit formulier wanneer een bezoeker een klacht wil indienen of contact wil opnemen met de klantenservice.
Vraag niet opnieuw naar gegevens die al in het gesprek zijn gegeven.
```

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# Human handoff
Source: https://docs.sleak.chat/agent/acties/human-handoff

Leer hoe je de handoff naar een menselijke medewerker configureert

Met human handoff kunnen bezoekers worden doorverbonden naar een menselijke medewerker wanneer de agent er niet goed uitkomt of de bezoeker expliciet om hulp vraagt. Dit gebeurt via een handoff-knop in de widget.

## Configuratie

Je configureert human handoff in de agent instellingen onder **Instellingen > Human handoff**.

## Hoe werkt het?

Wanneer een vraag buiten scope valt, het gesprek vastloopt of de bezoeker gefrustreerd raakt / om hulp vraagt, kan de agent een **handoff-knop** tonen. Als de bezoeker deze knop gebruikt en het formulier invult, wordt het gesprek overgenomen via de inbox.

### Kern prompt richtlijnen

Je agent moet geconfigureerd worden met de volgende richtlijnen in de basis prompt:

```
Je beantwoordt alleen vragen over het bedrijf en haar diensten.
Als een vraag buiten deze scope valt, of het gesprek vastloopt, reageer je met een kort aanbod om een menselijke medewerker in te schakelen via de handoff-knop.

Belangrijke regels:
- Gebruik de human handoff tool alleen nadat de bezoeker expliciet heeft bevestigd dat hij/zij een medewerker wil spreken
- Je zult dus nooit zelf een antwoord op een vraag bedenken als deze niet in de aangeleverde informatie staat
- Stuur alleen URL's uit de aangeleverde informatie - verzin nooit eigen links
- Houd antwoorden kort: maximaal 6 zinnen
- Als er geen link in de informatie staat, laat deze dan weg
```

## Proces voor de bezoeker

1. **Gesprek loopt vast / bezoeker vraagt om hulp** – bijvoorbeeld omdat de vraag buiten scope valt of de bot meerdere keren geen goed antwoord geeft
2. **Agent toont een handoff-knop** waarmee de bezoeker kan aangeven een medewerker te willen spreken
3. **Bezoeker gebruikt de knop en vult het formulier in** – je kunt hier o.a. naam, e‑mail en telefoonnummer laten verzamelen
4. **Handoff wordt geactiveerd** – de AI wordt (tijdelijk) uitgeschakeld en het gesprek komt in de inbox terecht zodat een medewerker het kan overnemen

## Proces voor de medewerker

### 1. Notificatie ontvangen

Je ontvangt een notificatie dat er een gesprek aandacht nodig heeft.

### 2. Gesprek overnemen

Bevestig dat je het live gesprek overneemt.

### 3. Gesprek voeren

Voer het gesprek met de bezoeker. De AI is nu uitgeschakeld.

### 4. Gesprek afsluiten

Wanneer je het gesprek verlaat, wordt de AI weer geactiveerd.

## E-mail notificaties

Wanneer een medewerker reageert, ontvangt het bedrijf een e-mail notificatie om de conversatie te kunnen blijven volgen.

De bezoeker kan ook via e-mail blijven communiceren, wat de continuïteit van het gesprek waarborgt.

## Best practices

1. **Duidelijke scope**: Definieer helder wat de agent wel en niet kan beantwoorden
2. **Snelle respons**: Zorg dat er altijd iemand beschikbaar is om overgenomen gesprekken te behandelen
3. **Consistente tone**: Zorg dat menselijke medewerkers dezelfde tone aanhouden als de agent
4. **Follow-up**: Gebruik e-mail notificaties om geen gesprekken te missen

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# Order status koppeling
Source: https://docs.sleak.chat/agent/acties/orderstatus

Laat de agent automatisch order statussen opzoeken via een native koppeling

Met een order status koppeling kan de agent real-time bestel- en verzendstatus ophalen uit je webshop of fulfilment systeem. De agent vraagt automatisch de benodigde gegevens op bij de bezoeker voordat de koppeling wordt gebruikt.

<Frame>
  <img alt="Beschikbare order status koppelingen" />
</Frame>

Nadat de agent een bestelling opzoekt, worden de orderdetails in een overzichtelijke weergave getoond. Zo ziet de bezoeker direct dat de agent daadwerkelijk een order heeft opgezocht - en ontstaat er extra vertrouwen en zekerheid dat er geen sprake is van AI-hallucinatie.

<Info>
  **Deze feature is onderdeel van het Grow pakket**
</Info>

## Beschikbare koppelingen

<CardGroup>
  <Card title="Shopify">Order status</Card>
  <Card title="WooCommerce">Order status</Card>
  <Card title="Lightspeed">Order status</Card>
  <Card title="Magento">Order status</Card>
  <Card title="Shopware">Order status</Card>
  <Card title="Sendcloud">Shipment status</Card>
  <Card title="Myparcel">Shipment status</Card>
  <Card title="Picqer">Fulfilment status</Card>
  <Card title="GoedGepickt">Fulfilment status</Card>
  <Card title="Monta">Fulfilment status</Card>
</CardGroup>

<Info>
  **Mis je jouw integratie?** Geen zorgen - praktisch elk systeem kan ook gemakkelijk ge-integreerd worden via de [Custom tool](/agent/acties/custom-tool).
</Info>

## Configuratie

<Accordion title="Shopify">
  **Vereiste gegevens:**

  * Base URL (bijv. `https://your-store.myshopify.com`)
  * Access Token
</Accordion>

<Accordion title="WooCommerce">
  **Vereiste gegevens:**

  * Base URL
  * Consumer Key
  * Consumer Secret
</Accordion>

<Accordion title="Lightspeed">
  **Vereiste gegevens:**

  * API Key
  * API Secret
</Accordion>

<Accordion title="Magento">
  **Vereiste gegevens:**

  * Base URL
  * Access Token
</Accordion>

<Accordion title="Shopware">
  **Vereiste gegevens:**

  * Base URL
  * Access Key ID
  * Secret Access Key
</Accordion>

<Accordion title="Sendcloud">
  **Vereiste gegevens:**

  * Public Key
  * Secret Key
</Accordion>

<Accordion title="Myparcel">
  **Vereiste gegevens:**

  * API Token
</Accordion>

<Accordion title="Picqer">
  **Vereiste gegevens:**

  * Base URL
  * API Key

  <Warning>
    **Geen last-mile status bij Picqer**

    Picqer is een WMS (magazijnsysteem) en ontvangt geen last-mile statusupdates van de vervoerder. Picqer weet of een bestelling in behandeling is of verzonden is, maar niet of het pakket onderweg of al bezorgd is.

    Daarom toont de orderstatus-kaart bij Picqer geen tijdlijn en geen geschatte leverdatum. De kaart linkt naar de Picqer-statuspagina van de bestelling. Heeft de vervoerder een track & trace-link aangemaakt, dan staat die op die pagina en krijgt de agent die link ook mee.

    Niet elke bestelling heeft een track & trace-link, bijvoorbeeld bij ophalen in de winkel of verzending via bol.com.
  </Warning>
</Accordion>

<Accordion title="GoedGepickt">
  **Vereiste gegevens:**

  * API Key
</Accordion>

<Accordion title="Monta">
  **Vereiste gegevens:**

  * Username
  * Password
</Accordion>

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# Productaanbevelingen
Source: https://docs.sleak.chat/agent/acties/productaanbevelingen

Toon een productcarrousel in de chat op basis van het gesprek

Met productaanbevelingen toont de agent een interactieve productcarrousel direct in de chat.

<Frame>
  <img alt="Productaanbevelingen in de chat" />
</Frame>

De agent bepaalt op basis van het gesprek welke producten relevant zijn en presenteert deze visueel aan de bezoeker.

**Voorbeeld:** een bezoeker zoekt naar "iets leuks voor de zomer" - de agent toont automatisch passende producten uit je assortiment.

<Info>
  **Deze feature is onderdeel van het Scale pakket**
</Info>

## Vereisten

Productaanbevelingen werken samen met een [XML feed](/agent/databronnen/xml-feed). De producten die worden aanbevolen komen uit de gekoppelde XML feed.

## Multimodaliteit

Productaanbevelingen werken ook in combinatie met afbeeldingen. Als een bezoeker een foto stuurt - bijvoorbeeld van een outfit - begrijpt de agent de visuele context en kan hij bijpassende producten aanbevelen.

**Voorbeeld:** een bezoeker stuurt een foto van een wit zomers jurkje en vraagt "heb je hier leuke schoenen bij?" De agent herschrijft de vraag op basis van de afbeelding en zoekt naar passende producten in de XML feed.

<Info>
  Schakel **File uploading** in via [agent instellingen → Extra opties](https://dashboard.sleak.chat/agent-instellingen?tab=inbox) om afbeeldingen te ondersteunen.
</Info>

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# Agent kennis
Source: https://docs.sleak.chat/agent/agent-kennis

Leer hoe je jouw Sleak agent van de juiste kennis voorziet

<Check>
  **Documentatie in progressie**

  De documentatie is nog niet volledig. Heb je vragen of suggesties? Neem dan contact op via [support@sleak.chat](mailto:support@sleak.chat) of +31850608199.
</Check>

## First things first:

<Info>
  **ChatGPT weet (bijna) niets over jouw bedrijf**

  Het taalmodel achter ChatGPT heeft enkel algemene kennis. Zonder de juiste informatie kan het niets vertellen over jouw bedrijf. Via Sleak voer je het model van de benodigde informatie.
</Info>

<Info>
  **ChatGPT (en dus Sleak) kan niet zelf op het internet zoeken**

  Het model kan niet zelfstandig informatie van het internet halen. Het werkt uitsluitend met de context die het aangeboden krijgt.
</Info>

Er zijn twee manieren waarop we ChatGPT van informatie voorzien:

**1. Consistente informatie via de basis prompt**

Standaard voeden we ChatGPT met de basis prompt. Dit is een brok tekst waar de gespreksgeschiedenis en fundamentele instructies in staan. Deze informatie is altijd beschikbaar voor de agent.

<Frame>
  <img alt="Zonder extra databronnen" />
</Frame>

**2. Dynamische informatie via databronnen en acties**

Daarnaast kun je extra databronnen en acties toevoegen. Op basis van de vraag van de bezoeker selecteert Sleak specifiek relevante informatie uit deze bronnen en voegt deze toe aan de context.

<Frame>
  <img alt="Met extra databronnen" />
</Frame>

De agent krijgt dan een combinatie van:

* De gespreksgeschiedenis
* De [basis prompt](/agent/basis-prompt)
* Specifiek geselecteerde informatie uit [extra databronnen](/agent/extra-data)

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# Basis prompt
Source: https://docs.sleak.chat/agent/basis-prompt

Leer hoe je een effectieve basis prompt schrijft voor je agent

Bij het aanmaken van een nieuwe agent wordt automatisch een template basis prompt gegenereerd. Deze bestaat uit een identiteit en instructies, die je allebei naar eigen wens kunt aanpassen.

## Tips voor een goede basis prompt

<Info>
  **Doe alsof je tegen een mens praat**

  Gebruik geen formele instructies, maar schrijf alsof je tegen een persoon praat. Gebruik "je" in plaats van "de agent" of "het systeem". Bijvoorbeeld: "Je bent een vriendelijke klantenservice medewerker die klanten helpt met hun vragen over producten."
</Info>

<Info>
  **Wees concreet**

  Vervang vage instructies door concrete richtlijnen. In plaats van "Houd antwoorden kort", schrijf je "Geef antwoorden van maximaal 3 zinnen, tenzij de vraag om meer uitleg vraagt."
</Info>

<Info>
  **Verwoord hetzelfde op verschillende manieren**

  Een enkele vermelding van een instructie kan worden gemist tussen alle andere richtlijnen. Herhaal belangrijke instructies op verschillende manieren om ze te benadrukken.
</Info>

<Info>
  **Gebruik alleen relevante informatie**

  Vermijd overbodige informatie in de basis prompt. Meer informatie betekent meer ruis, wat de agent kan afleiden van de belangrijkste taken. Houd de focus scherp.
</Info>

<Info>
  **Test & optimaliseer**

  Wat werkt voor het ene bedrijf werkt niet per se voor het andere. Experimenteer met verschillende formuleringen en benaderingen om te ontdekken wat het beste werkt voor jouw specifieke situatie.
</Info>

<Warning>
  **Let op bij het gebruik van extra databronnen**

  Als je extra databronnen gebruikt, zorg er dan voor dat de basis prompt alleen informatie bevat die de agent *altijd* nodig heeft. Vermijd overlap tussen de basis prompt en extra databronnen om redundantie te voorkomen.
</Warning>

## Voorbeeld basis prompt

Hieronder zie je een voorbeeld van de basis prompt van onze agent Sophie:

<Frame>
  <img alt="Basis prompt van agent Sophie" />
</Frame>

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# CSV bestand
Source: https://docs.sleak.chat/agent/databronnen/csv

Leer hoe je CSV bestanden gebruikt als databron voor je agent

<Info>
  **Deze feature is onderdeel van het Grow pakket**
</Info>

Met een CSV upload kun je gestructureerde data beschikbaar maken voor je agent. De agent kan het CSV bestand bevragen als een database om specifieke informatie op te zoeken.

## Hoe werkt het?

De agent ziet het CSV bestand als een tool die het kan gebruiken om informatie op te halen. Bij elke vraag die relevant lijkt, kan de agent het bestand raadplegen.

**Tool beschrijving voorbeeld:**

```
Raadpleeg deze tool voor alle vragen die te maken hebben met producten, het assortiment of ons aanbod.
```

Deze beschrijving vertelt de agent wanneer het deze databron moet gebruiken.

<Warning>
  **Zorg voor een 'schoon' bestand**

  Zorg ervoor dat je CSV bestand goed gestructureerd is:

  * Gebruik duidelijke kolomnamen
  * Vermijd lege rijen of cellen
  * Gebruik consistente formatting
  * Test het bestand voordat je het uploadt
</Warning>

## Geschikt voor

CSV uploads zijn ideaal voor:

* **Productcatalogi** met specificaties, prijzen en voorraad
* **Prijslijsten** met actuele prijsinformatie
* **Contactgegevens** van filialen of dealers
* **Specificaties** van diensten of producten

## Best practices

1. **Duidelijke kolom headers**: Gebruik beschrijvende namen zoals "product\_naam", "prijs", "voorraad"
2. **Consistente data**: Zorg dat elke rij dezelfde structuur heeft
3. **Actuele informatie**: Update het CSV bestand regelmatig
4. **Niet te groot**: Houd het bestand overzichtelijk (max enkele duizenden rijen)

**Zie ook:**

* [Kennisbank configureren](/agent/extra-data/kennisbank) voor ongestructureerde informatie
* [API aansluiten](/agent/extra-data/api) voor real-time data

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# Kennisbank
Source: https://docs.sleak.chat/agent/databronnen/kennisbank

Leer hoe je een effectieve kennisbank opzet voor je agent

Een kennisbank bestaat uit artikelen waarin je informatie over jouw bedrijf, producten of diensten beschrijft. De agent doorzoekt deze artikelen om relevante antwoorden te vinden.

<Warning>
  **Nieuw onderwerp? Nieuw artikel.**

  Maak voor elk onderwerp een apart artikel. Dit helpt de agent om de juiste informatie te vinden en voorkomt verwarring.
</Warning>

<Check>
  **Denk als Google**

  Schrijf kennisbank artikelen zoals je webpagina's optimaliseert voor Google. Elk artikel moet zich focussen op één specifiek onderwerp en relevante zoekwoorden bevatten.
</Check>

## Tips voor effectieve kennisbank artikelen

<Info>
  **Verweven instructies in artikelen**

  Je kunt instructies voor de agent direct in de artikelen verwerken. Bijvoorbeeld: "Verwijzing naar de volledige spelregels staan op [www.voorbeeld.nl/spelregels](http://www.voorbeeld.nl/spelregels) - verwijs hier altijd naar bij vragen over spelregels."
</Info>

<Info>
  **Meer informatie is meer ruis**

  Vermijd overbodige informatie. Elk extra detail kan de agent afleiden van wat echt belangrijk is. Houd artikelen gefocust en to the point.
</Info>

<Info>
  **Verwoord hetzelfde op verschillende manieren**

  Gebruik variatie in formulering en herhaal belangrijke concepten op verschillende manieren. Dit vergroot de kans dat de agent de juiste informatie vindt.
</Info>

<Info>
  **Herhaal keywords voor context**

  Vermeld het hoofdonderwerp van een artikel meerdere keren in verschillende contexten. Dit helpt de agent begrijpen waar het artikel over gaat en wanneer het relevant is.
</Info>

## Voorbeelden van goede kennisbank artikelen

* **Retourbeleid**: "Binnen 14 dagen retourneren zonder opgave van reden. Stuur een email naar [retour@bedrijf.nl](mailto:retour@bedrijf.nl) met je ordernummer..."
* **Verzendkosten**: "Gratis verzending vanaf €50. Bij bestellingen onder €50 bedragen de verzendkosten €4,95..."
* **Openingstijden**: "Onze klantenservice is bereikbaar van maandag t/m vrijdag van 9:00 tot 17:00 uur..."

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# Website scrape
Source: https://docs.sleak.chat/agent/databronnen/website-scrape

Gebruik je eigen website als databron voor je agents

Met een website scrape indexeert Sleak automatisch de inhoud van je website. De agent kan deze inhoud doorzoeken om vragen te beantwoorden op basis van jouw actuele webpagina's.

**Geschikt voor:**

* Productpagina's en diensten
* Blogartikelen en nieuws
* Helppagina's en FAQ's
* Alle andere publiek toegankelijke pagina's

Bij het aanmaken van een website databron geef je een URL op. Sleak indexeert de pagina's op die URL en slaat de inhoud op zodat de agent er gebruik van kan maken.

Er zijn twee manieren om pagina's te ontdekken:

* **Sitemap** - Sleak leest de sitemap van je website. Dit is de aanbevolen optie.
* **Crawl** - Sleak volgt links op je website om pagina's te ontdekken.

<Tip>
  **Gebruik bij voorkeur een sitemap**
</Tip>

## Automatische verversing

Je kunt **automatische verversing** instellen voor website scrape databronnen. Sleak herindexeert de website dan automatisch elke dag, zodat de agent altijd werkt met actuele informatie.

#### Hoe het werkt

Automatische verversing vindt dagelijks plaats tussen 01:00 en 02:00 . Zo is de agent altijd op de hoogte van de laatste wijzigingen op je website.

<Info>
  Automatische XML feed verversing is onderdeel van de **automatische verversing add-on**
</Info>

#### Auto-discovery van nieuwe pagina's

Bij elke verversing controleert Sleak of er nieuwe pagina's zijn toegevoegd aan de sitemap. Nieuwe pagina's worden automatisch geïndexeerd - je hoeft de databron niet opnieuw in te stellen.

#### verversingsfrequentie

Als jouw sitemap een `<lastmod>` tag bevat, herkent Sleak welke pagina's zijn gewijzigd sinds de vorige scrape. Hierdoor worden alleen de aangepaste pagina's opnieuw geindexeerd - wat de verversing aanzienlijk efficiënter maakt. Hierdoor is dagelijkse verversing alleen ondersteund voor sitemaps die gebruikmaken van de `<lastmod>` tag. Voor andere scrapes is de verversingsfrequentie 7 dagen, en vindt er alleen op zondagnacht verversing plaats.

<Warning>
  Let op - dagelijkse verversing wordt alleen ondersteund voor sitemaps die de `<lastmod>` tag bevatten. Voor alle andere website scrapes is de verversingsfrequentie 7 dagen.
</Warning>

Veel CMS-systemen zoals WordPress, Webflow en Shopify voegen de `<lastmod>` tag automatisch toe. Weet je niet zeker of jouw sitemap deze tag bevat? Vraag het na bij je webbouwer of bekijk de sitemap via `jouwwebsite.nl/sitemap.xml`.

<Tip>
  Het toevoegen van `<lastmod>` aan je sitemap is ook goed voor SEO - zoekmachines en AI modellen als ChatGPT en Claude weten zo beter wanneer pagina's opnieuw ge-indexeerd moeten worden.
</Tip>

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# XML feed
Source: https://docs.sleak.chat/agent/databronnen/xml-feed

Synchroniseer productdata en andere gestructureerde data via een XML feed

Met een XML feed kun je gestructureerde data zoals productcatalogi direct beschikbaar maken voor de agent. Dit is de meest efficiënte manier om productdata toe te voegen - ook grote feeds worden ondersteund.

**Geschikt voor:**

* Productcatalogi met specificaties, prijzen en voorraad
* Andere gestructureerde XML feeds

<Info>
  **Deze feature is onderdeel van het Grow pakket**
</Info>

## Hoe het werkt

Je geeft een URL op naar een XML feed. Sleak verwerkt de feed en maakt de inhoud doorzoekbaar voor de agent.

#### Automatische paginacontext

Gebruikt een bezoeker de chat op een productpagina waarvoor een XML feed bestaat? Dan wordt de data van dat product automatisch als context meegegeven aan de agent - zonder dat hij er apart naar hoeft te zoeken. Dit is een aanvulling op het semantisch zoeken.

## Automatische verversing

Met automatische verversing wordt de XML feed dagelijks automatisch verwerkt. Zo blijft voorraad, prijzen en andere productdata altijd actueel. Hierdoor is de agent ook altijd op de hoogte van de laatste wijzigingen in je feed.

<Info>
  Automatische XML feed verversing is onderdeel van de **automatische verversing add-on**
</Info>

## Feed aanmaken

De meeste gebruikers maken een speciale feed aan via een feed manager zoals [Channable](https://www.channable.com) of [DataFeedWatch](https://www.datafeedwatch.com). Zo bevat de feed alleen de data die voor de agent relevant is bij het beantwoorden van vragen - en geen onnodige ruis.

<Tip>
  Houd de feed zo compact mogelijk. Hoe minder onnodige velden, hoe beter de agent de juiste informatie vindt.
</Tip>

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# Exact Match Search
Source: https://docs.sleak.chat/agent/exact-match-search

Zoek direct naar specifieke producten op basis van SKU, EAN of product-ID via je XML feed

<Info>
  **Beta functie** - Exact Match Search is momenteel in beta. De actie kan alleen door het Sleak-team worden geactiveerd voor je agent. Neem contact met ons op om het in te schakelen.
</Info>

## Het probleem

AI search in Sleak werkt met **semantisch zoeken** - dit werkt in de meeste gevallen uitstekend, maar is minder geschikt voor exacte waarden zoals een **SKU, EAN-code of product-ID**. De AI zoekt namelijk op betekenis, niet op exacte overeenkomst.

Bij **grote productcatalogussen** leidt dit ertoe dat het juiste product lastig te vinden is. Bijvoorbeeld: een klant vraagt naar een specifieke schroevendraaier, maar er worden 12 schroevendraaiers van een net ander type of maat gevonden.

## De oplossing

Exact Match Search is een AI-actie waarmee de agent gestructureerd kan zoeken naar productwaarden in je XML feed. In plaats van semantisch zoeken, zoekt de agent direct naar een exacte match op basis van een specifieke waarde zoals:

| Zoekparameter | Voorbeeld |
| - | - |
| SKU | `PRO-MAT-HARVEST` |
| Product-ID | `YMNPMEB-427` |
| EAN-code | `840104831519` |

Het beschikbaar stellen van meer dan 1 zoekparameter is ook ondersteund.

<Frame>
  <img alt="Exact Match Search in de widget" />
</Frame>

<br />

<Info>
  Exact Match Search werkt in combinatie met een bestaande **XML feed databron**. Er wordt gezocht obv. gestructureerde data uit de XML feed, verwerkt in het contextvenster voor AI search.
</Info>

## Hoe het werkt in de widget

Wanneer een bezoeker in de widget een specifieke productcode noemt, herkent de agent automatisch dat er een exacte zoekopdracht nodig is. De agent gebruikt vervolgens de Exact Match Search actie om direct het juiste product op te halen.

In het voorbeeld hierboven vraagt de bezoeker naar EAN-code `840104831519`. De agent herkent dit als een productidentificatie, zoekt exact op deze waarde in de XML feed en retourneert direct het juiste product - de Manduka PRO Mat in kleur Harvest - inclusief alle beschikbare data uit de productfeed, in dit voorbeeld de voorraadstatus.

<Tip>
  **Laat de agent vragen terugstellen**<br />

  <p>
    De agent weet dat zij toegang heeft tot de product search tool, ook wanneer de bezoeker niet direct een van de vooraf ingestelde waarden (id, sku, etc.) vermeld in een vraag.
  </p>

  <p>
    Je kunt de agent zo prompten dat deze, wanneer een bezoeker bijvoorbeeld slechts een producttitel of beschrijving benoemt, terugvraagt of er ook een artikelnummer vermeld kan worden zodat het product opgezocht kan worden.
  </p>
</Tip>

## Hoe het werkt in de inbox

In de inbox kun je als medewerker de Exact Match Search actie in werking zien. Je ziet welke tool de agent heeft aangeroepen (bijv. "Direct search gebruikt") en welke waarde is gebruikt bij het zoeken.

<Frame>
  <img alt="Exact Match Search in de inbox" />
</Frame>

Door op de actie-log te klikken kun je in detail zien welke context er is opgehaald via de Exact Match Search. Hier zie je precies welke productdata uit de XML feed is gevonden en aan de agent is meegegeven.

<Frame>
  <img alt="Detail weergave van opgehaalde context via Exact Match Search" />
</Frame>

## Configuratie

### Activatie

Exact Match Search is nog in beta - de agent actie kan tijdens de beta **nog niet** zelf worden toegevoegd via de agent-bouwer. De actie wordt door het Sleak-team geactiveerd voor je agent. Neem hiervoor contact met ons op.

### Tool beschrijving aanpassen

Na activatie kun je de **tool beschrijving** aanpassen in de agent-bouwer. Hiermee bepaal je:

* **Wanneer** de agent de tool inzet (bijv. alleen bij EAN-codes, of ook bij productnamen)
* **Welke zoekparameters** er worden gebruikt (bijv. zoeken op SKU, EAN, product-ID, of een combinatie)

<Frame>
  <img alt="Exact Match Search actie in de agent-bouwer" />
</Frame>

### Prompt editor

Via de **prompt editor** (basis prompt) kun je nog meer controle uitoefenen over het gedrag van de agent omtrent het tool calling:

* **Tool calling** - bepaal wanneer en hoe vaak de agent de Exact Match Search actie mag gebruiken
* **Antwoordgedrag** - stel in hoe de agent gevonden resultaten interpreteert en hiermee omgaat (bv. altijd voorraadstatus vermelden, of alleen als de bezoeker ernaar vraagt)
* **Fallback gedrag** - definieer wat er gebeurt als er geen exact match wordt gevonden

## Vereisten

* Een actieve **XML feed databron** gekoppeld aan je agent
* Activatie van de Exact Match Search actie door het Sleak-team
* Een actief abonnement op het ['Grow' plan](https://sleak.chat/tarieven)

<br />

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# Hoe werken databronnen?
Source: https://docs.sleak.chat/agent/extra-data

Leer hoe je extra databronnen toevoegt aan je agent

Extra databronnen stellen je in staat om je agent in staat om specifieke op te zoeken op basis van de vraag van de bezoeker. Er zijn verschillende soorten databronnen:

<Tabs>
  <Tab title="Kennisbank">
    ## Kennisbank

    Een kennisbank bestaat uit artikelen met informatie over jouw bedrijf, producten of diensten. De agent kan deze artikelen doorzoeken om relevante informatie te vinden.

    **Geschikt voor:**

    * Veelgestelde vragen (FAQ)
    * Productinformatie
    * Bedrijfsrichtlijnen
    * Procedures en instructies

    Lees meer over [hoe je een kennisbank configureert](/agent/extra-data/kennisbank).
  </Tab>

  <Tab title="CSV bestand">
    ## CSV bestand

    Upload een CSV bestand met gestructureerde data. De agent kan dit bestand bevragen als een database.

    **Geschikt voor:**

    * Productcatalogi met specificaties
    * Prijslijsten
    * Voorraadgegevens
    * Klantgegevens

    Lees meer over [hoe je een CSV bestand uploadt](/agent/extra-data/csv).
  </Tab>

  <Tab title="API connectie">
    ## API connectie

    Koppel een API om real-time data op te halen uit externe systemen.

    **Geschikt voor:**

    * Live voorraadgegevens
    * Actuele prijzen
    * Orderstatussen
    * Tracking informatie

    Lees meer over [hoe je een API aansluit](/agent/extra-data/api).
  </Tab>

  <Tab title="Website scrape">
    ## Website scrape

    Laat Sleak automatisch de inhoud van je website indexeren. De agent kan deze inhoud doorzoeken om vragen te beantwoorden op basis van jouw actuele webpagina's.

    **Geschikt voor:**

    * Productpagina's en diensten
    * Blogartikelen en nieuws
    * Helppagina's en FAQ's

    Lees meer over [hoe je een website scrape instelt](/agent/extra-data/website-scrape).
  </Tab>
</Tabs>

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# Start een conversatie
Source: https://docs.sleak.chat/api/create-conversation

POST /api/conversation
Creëert een nieuwe chatconversatie met de opgegeven chatbot

Dit endpoint begint een nieuwe conversatie met een specifieke chatbot. Je ontvangt een `conversation_id` terug die je kunt gebruiken om berichten te versturen.


# API Overzicht
Source: https://docs.sleak.chat/api/overview

De Sleak.chat API biedt directe toegang tot onze infrastructuur voor het bouwen van betrouwbare AI agents

<Info>
  **n8n community node beschikbaar**

  Voor low-code integraties kun je gebruik maken van onze [n8n community node](https://docs.sleak.chat/integraties/n8n-integratie). Dit maakt het eenvoudig om Sleak te integreren in je automatiseringsworkflows.
</Info>

## Authenticatie

De Sleak API gebruikt Bearer token authenticatie. Voeg je API key toe aan de Authorization header:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

Je kunt je API key vinden in het dashboard onder **Instellingen > API**.

## Base URL

```
https://api.v1.sleak.chat
```

## Endpoints

De API biedt de volgende endpoints:

<Card title="POST /api/conversation" icon="comments" href="/api/create-conversation">
  Start een nieuwe conversatie met een chatbot
</Card>

<Card title="POST /api/message" icon="message" href="/api/send-message">
  Verstuur een bericht binnen een bestaande conversatie
</Card>

## Rate Limiting

De API hanteert rate limiting om overbelasting te voorkomen. Rate limit informatie wordt teruggegeven in de response headers:

* `X-RateLimit-Limit`: Maximaal aantal requests per minuut
* `X-RateLimit-Remaining`: Aantal resterende requests
* `X-RateLimit-Reset`: Unix timestamp wanneer de rate limit reset

Bij het overschrijden van de rate limit ontvang je een `429 Too Many Requests` response.

## Error Handling

Alle errors worden geretourneerd in het volgende format:

```json theme={null}
{
  "error": {
    "code": "error_code",
    "message": "Foutbeschrijving",
    "details": {}
  }
}
```

**HTTP Status Codes:**

* `200`: Succesvol verwerkt
* `400`: Ongeldige aanvraag
* `401`: Niet geautoriseerd
* `403`: Geen toegang tot deze resource
* `404`: Resource niet gevonden
* `429`: Rate limit overschreden
* `500`: Interne server fout

## Code Voorbeelden

### cURL

```bash theme={null}
# Start een conversatie
curl -X POST https://api.v1.sleak.chat/api/conversation \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chatbot_id": "chatbot_123", "visitor_id": "visitor_456"}'

# Verstuur een bericht
curl -X POST https://api.v1.sleak.chat/api/message \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conversation_id": "conv_789", "message": "Hallo!"}'
```

### Python

```python theme={null}
import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.v1.sleak.chat"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# Start conversatie
response = requests.post(
    f"{BASE_URL}/api/conversation",
    headers=headers,
    json={"chatbot_id": "chatbot_123", "visitor_id": "visitor_456"}
)
conversation_id = response.json()["conversation_id"]

# Verstuur bericht
response = requests.post(
    f"{BASE_URL}/api/message",
    headers=headers,
    json={"conversation_id": conversation_id, "message": "Hallo!"}
)
messages = response.json()
```

### JavaScript (Node.js)

```javascript theme={null}
const axios = require('axios');

const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://api.v1.sleak.chat';

const headers = {
  'Authorization': `Bearer ${API_KEY}`,
  'Content-Type': 'application/json'
};

// Start conversatie
const conversation = await axios.post(
  `${BASE_URL}/api/conversation`,
  { chatbot_id: 'chatbot_123', visitor_id: 'visitor_456' },
  { headers }
);

const conversationId = conversation.data.conversation_id;

// Verstuur bericht
const response = await axios.post(
  `${BASE_URL}/api/message`,
  { conversation_id: conversationId, message: 'Hallo!' },
  { headers }
);
```

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# Verstuur een bericht
Source: https://docs.sleak.chat/api/send-message

POST /api/message
Verstuurt een bericht naar een bestaande conversatie en ontvangt een AI-gegenereerd antwoord

Dit endpoint verstuurt een bericht naar een bestaande conversatie en retourneert het antwoord van de AI-chatbot.

<Info>
  **Metadata in responses**

  Het antwoord bevat optionele metadata zoals gebruikte databronnen en tools. Dit helpt bij debugging en het begrijpen van hoe de chatbot tot het antwoord kwam.
</Info>


# Cookies en CMP
Source: https://docs.sleak.chat/installatie/cookies

Welke cookies de Sleak widget plaatst en hoe je ze configureert in je Consent Management Platform (CMP)

De Sleak widget gebruikt twee functionele cookies om chatgeschiedenis aan een bezoeker te koppelen. Zonder deze cookies start de chat na elke paginalading een nieuw gesprek.

| Cookie | Doel |
| - | - |
| `sleakVisitorId_{chatbotId}` | Unieke bezoeker-ID om gesprekken te koppelen |
| `sleakChatId_{chatbotId}` | Unieke chat-ID om het actieve gesprek te hervatten |

<Info>
  Vervang `{chatbotId}` door het ID van jouw agent. Je vindt dit in het [Sleak dashboard](https://dashboard.sleak.chat/integraties?tab=installatie) in het installatie-script van je agent.
</Info>

## Cookies toevoegen aan je CMP

Gebruik je een Consent Management Platform (CMP) zoals Cookiebot, CookieYes, Complianz of OneTrust? Voeg dan beide cookies toe en categoriseer ze als **Functioneel** (ook wel "Strikt noodzakelijk" of "Necessary" genoemd).

<Warning>
  De cookies **moeten** als functioneel worden gecategoriseerd, niet als "Analytisch" of "Marketing". Functionele cookies vereisen geen consent en worden daardoor niet verwijderd bij het laden van de
  pagina.
</Warning>

De stappen zijn voor elke CMP vergelijkbaar. Raadpleeg de documentatie van je CMP-provider voor specifieke instructies.

## Cookie specificaties

Gebruik onderstaande gegevens voor je CMP of cookieverklaring.

### sleakVisitorId

| Eigenschap | Waarde |
| - | - |
| **Naam** | `sleakVisitorId_{chatbotId}` |
| **Provider** | Sleak |
| **Categorie** | Functioneel (strikt noodzakelijk) |
| **Doel** | Behoudt een persistente bezoeker-ID zodat chatgeschiedenis behouden blijft tussen sessies |
| **Verzamelde data** | Willekeurige unieke ID - geen berichtinhoud, geen persoonsgegevens |
| **Vervaltijd** | 12 maanden |
| **Opslagtype** | Cookie |
| **Rechtsgrondslag** | Niet onderworpen aan consent (gerechtvaardigd belang) |
| **Doorgifte buiten EU** | Nee |

### sleakChatId

| Eigenschap | Waarde |
| - | - |
| **Naam** | `sleakChatId_{chatbotId}` |
| **Provider** | Sleak |
| **Categorie** | Functioneel (strikt noodzakelijk) |
| **Doel** | Behoudt een persistente chat-ID zodat het actieve gesprek hervat kan worden |
| **Verzamelde data** | Willekeurige unieke ID - geen berichtinhoud, geen persoonsgegevens |
| **Vervaltijd** | 12 maanden |
| **Opslagtype** | Cookie |
| **Rechtsgrondslag** | Niet onderworpen aan consent (gerechtvaardigd belang) |
| **Doorgifte buiten EU** | Nee |

## Veelgestelde vragen

<AccordionGroup>
  <Accordion title="Kan ik de cookies ook onder 'Toestemming' / 'Consent' plaatsen?">
    Dat raden we sterk af. Als de cookies onder consent vallen, worden ze pas geplaatst nadat een bezoeker de cookie-banner accepteert. Tot die tijd werkt de chatgeschiedenis niet. Omdat deze cookies
    geen persoonsgegevens bevatten en puur functioneel zijn, mogen ze zonder consent geplaatst worden.
  </Accordion>

  <Accordion title="Werkt de chat voor nieuwe bezoekers die de cookie-banner nog niet hebben gezien?">
    Ja - mits de cookies als **Functioneel** zijn gecategoriseerd. Functionele cookies worden direct geplaatst, ongeacht de consent-status van de bezoeker.
  </Accordion>
</AccordionGroup>

<Tip>
  Verdwijnt de chatgeschiedenis na het herladen van de pagina? Volg dan de [troubleshooting gids](/troubleshooting/cookies).
</Tip>


# Custom chat veld
Source: https://docs.sleak.chat/installatie/custom-chat-input

Koppel je eigen input/formulier aan de widget en verstuur berichten direct naar de chat

Met deze feature kun je je eigen formulier op de website koppelen aan de Sleak chat widget. Zodra een bezoeker het formulier verstuurt, wordt het ingevulde bericht direct naar de chat gestuurd en opent de chat widget automatisch.

### Implementatie

Je hoeft alleen het attribuut `slk-prefill-form` toe te voegen aan je bestaande `<form>`-element. Het veld waarvan de waarde naar de chat gestuurd wordt, moet het `slk-prefill-message` attribuut hebben.

### **Voorbeeld**

Stel, je hebt het volgende formulier op je website:

```html theme={null}
<form style="display: flex; flex-direction: column; gap: 1em; align-items: center;">
  <label for="testMessage">Stel je vraag:</label>
  <input type="text" name="my-input" required />
  <button type="submit">Stuur naar Sleak</button>
</form>
```

→ Aan het form element van je formulier voeg je het `slk-prefill-form` attribuut toe

→ En aan het input element waar de tekst in getyped wordt, voeg je het `slk-prefill-message` attribuut toe. Voeg daarnaast ook het `required` attribuut toe om te voorkomen dat er lege berichten verstuurd kunnen worden.

```html theme={null}
<form slk-prefill-form style="display: flex; flex-direction: column; gap: 1em; align-items: center;">
  <label for="testMessage">Stel je vraag:</label>
  <input type="text" name="my-input" slk-prefill-message required />
  <button type="submit">Stuur naar Sleak</button>
</form>
```

Je kan het formulier verder volledig stylen naar wens.

Het is ook mogelijk om meerdere formulieren op 1 pagina te gebruiken.

### Wat gebeurt er na het verzenden?

1. Het bericht wordt direct in de Sleak widget gestuurd, en er wordt een chat gestart.
2. Het formulier wordt ge-reset
3. De chat widget opent automatisch, zodat de bezoeker direct verder kan chatten.
4. Bestaat er al een chat? Dan wordt er een nieuw bericht aan de bestaande chat toegevoegd.

***

<Note>
  **Hulp nodig?**

  Mocht er iets niet lukken of onduidelijk zijn? Neem gerust contact op met het team van Sleak, zodat we je verder kunnen helpen!
</Note>


# Custom Fields
Source: https://docs.sleak.chat/installatie/custom-fields

Geef contextinformatie door aan je agent via custom fields voor gepersonaliseerde gesprekken

<Info>
  **Technische implementatie**

  Implementatie van deze feature vereist basis-kennis in web development. Laat dit bij voorkeur over aan een ontwikkelaar. Hulp nodig? [Neem contact op](mailto:support@sleak.chat) met ons support team.
</Info>

Met custom fields kun je automatisch context over de bezoeker doorgeven aan je Sleak agent. Denk aan naam, e-mailadres, ordernummer, of andere relevante informatie die je al hebt.

De custom field data wordt **beschikbaar voor de AI agents in chats**, is daarnaast ook **zichtbaar in de chat inbox** en ten slotte beschikbaar via de **Sleak API en webhooks**.

## Voordelen van custom fields

* **Meer context**: Agent heeft toegang tot relevante info, wat de gesprekskwaliteit bevordert
* **Personalisatie**: Gesprekken starten met "Hoi \[naam]" in plaats van generieke begroetingen
* **Minder storend voor gebruiker**: Agent kan direct helpen zonder eerst gegevens te vragen
* **Integraties**: Gebruik gegevens voor acties zoals orderstatus opzoeken

***

## Implementatie

Custom fields kun je configureren via je [Sleak dashboard](https://dashboard.sleak.chat/integraties?tab=custom-fields). De implementatie kan op twee manieren:

| Methode | Beschrijving | Voordelen | Nadelen |
| - | - | - | - |
| **Omgeving met login** | Haal gegevens op uit de sessie of account van de ingelogde klant | Meest betrouwbaar, vaak ook meer data beschikbaar | Vereist ingelogde gebruikers |
| **Cookie-gebaseerd** | Sla gegevens op in cookies na bijvoorbeeld een aankoop | Werkt voor alle bezoekers, eenvoudige implementatie | Werkt niet op meerdere apparaten |

Waar de data ook vandaan komt - Custom fields verstuur je via JavaScript nadat de Sleak widget is geladen:

```javascript wrap theme={null}
window.addEventListener('sleakCustomFieldsHandlerInitialized', function (event) {
  console.log(event);
  
  // Voorbeeld data - vervang met echte data uit je applicatie
  const userData = {
    naam: 'John Doe',
    email: 'john@mymail.com',
    telefoonnummer: '0031612341234',
    ordernummer: 'ORD-29485'
  };

  // Verstuur de custom fields naar Sleak
  window.sleakPushCustomFields(userData);
});
```

<Warning>
  Vervang de voorbeelddata met echte data uit je applicatie. Gebruik dynamische data in plaats van statische waardes.
</Warning>

***

## Voorbeelden van implementatie scenario's

### Scenario 1: Ingelogde gebruikers

Voor websites waar gebruikers inloggen:

```javascript wrap theme={null}
window.addEventListener('sleakCustomFieldsHandlerInitialized', function (event) {
  // Haal gebruikersdata op uit je sessie/API
  const currentUser = getCurrentUser(); // Je eigen functie
  
  if (currentUser) {
    window.sleakPushCustomFields({
      naam: currentUser.fullName,
      email: currentUser.email,
      klant_id: currentUser.id,
      membership_level: currentUser.membershipLevel
    });
  }
});
```

### Scenario 2: E-commerce met order context

Voor webshops waar bezoekers een specifieke order bekijken:

```javascript wrap theme={null}
window.addEventListener('sleakCustomFieldsHandlerInitialized', function (event) {
  // Haal ordernummer op uit URL of DOM
  const orderNumber = getOrderFromUrl(); // Je eigen functie
  const customerEmail = getEmailFromOrder(orderNumber); // Je eigen functie
  
  if (orderNumber) {
    window.sleakPushCustomFields({
      ordernummer: orderNumber,
      email: customerEmail,
      order_status: 'in_behandeling'
    });
  }
});
```

### Scenario 3: Delayed data loading

Wanneer de benodigde data pas later beschikbaar is:

```javascript wrap theme={null}
// Custom fields handler
let customFieldsReady = false;

window.addEventListener('sleakCustomFieldsHandlerInitialized', function (event) {
  customFieldsReady = true;
  sendCustomFieldsIfReady();
});

// Je eigen data loading
window.addEventListener('userDataLoaded', function (event) {
  sendCustomFieldsIfReady();
});

function sendCustomFieldsIfReady() {
  if (customFieldsReady && window.userDataAvailable) {
    window.sleakPushCustomFields(window.currentUserData);
  }
}
```

***

## Testen en debuggen

### Test in development

Je kunt de custom fields functionaliteit testen door het event handmatig te triggeren:

```javascript wrap theme={null}
// Test de custom fields handler
window.dispatchEvent(new CustomEvent('sleakCustomFieldsHandlerInitialized'));
```

### Debug tips

* Open de browser console om te zien of events correct gefired worden
* Controleer of `window.sleakPushCustomFields` beschikbaar is
* Verifieer in je Sleak dashboard of de custom fields aankomen

***

## Veelgestelde vragen

<AccordionGroup>
  <Accordion title="Wanneer worden custom fields verstuurd?">
    Custom fields worden verstuurd zodra `sleakPushCustomFields()` wordt aangeroepen. Dit kan voor, tijdens, of na het starten van een gesprek.
  </Accordion>

  <Accordion title="Kan ik custom fields updaten tijdens een gesprek?">
    Ja, je kunt `sleakPushCustomFields()` meerdere keren aanroepen om de context bij te werken tijdens het gesprek.
  </Accordion>

  <Accordion title="Welke datatypen worden ondersteund?">
    String, Number, en Boolean waardes worden ondersteund. Complexere objecten worden automatisch geconverteerd naar strings.
  </Accordion>

  <Accordion title="Zijn custom fields zichtbaar voor de bezoeker?">
    Nee, custom fields zijn alleen zichtbaar voor de agent en in je Sleak dashboard. De bezoeker ziet deze informatie niet.
  </Accordion>
</AccordionGroup>


# Custom open button
Source: https://docs.sleak.chat/installatie/custom-open-button

Koppel je eigen knop aan de Sleak chat widget en stel een standaard bericht in

### Open je Sleak widgets met een knop op je eigen website

Met deze feature kun je je eigen knop op de website koppelen aan de Sleak chat widget. Zodra een bezoeker op deze knop drukt, wordt de widget geopend. Daarbij is het ook mogelijk om een standaard bericht in te stellen die automatisch wordt gestuurd als er op de knop wordt gedrukt.

### Hoe koppel ik mijn eigen button aan Sleak?

Je hoeft alleen het attribuut `slk-custom-button` toe te voegen aan je bestaande `<button>`-element. Om een standaard bericht in te stellen die automatisch wordt gestuurd hoef je alleen maar het attribuut `slk-message-trigger` toe te voegen aan je bestaande `<button>`-element.

### **Voorbeeld**

Stel, je hebt de volgende knop op je website:

```html theme={null}
<button type="button">Neem contact op</button>
```

→ Aan het button element voeg je het `slk-custom-button` attribuut toe.

```html theme={null}
<button type="button" slk-custom-button>Neem contact op</button>
```

→ Voor het standaard bericht voeg je het `slk-message-trigger` attribuut toe met het gewenste bericht tussen "".

```html theme={null}
<button type="button" slk-message-trigger="Ik heb een vraag">Neem contact op</button>
```

Je kan de knop verder volledig stylen naar wens.

Het is ook mogelijk om meerdere knoppen op 1 pagina te gebruiken.

***

<Note>
  **Hulp nodig?**

  Mocht er iets niet lukken of onduidelijk zijn? Neem gerust contact op met het team van Sleak, zodat we je verder kunnen helpen!
</Note>


# Google Tag Manager events
Source: https://docs.sleak.chat/installatie/google-tag-manager

Track conversies en events van je Sleak chat widget via Google Tag Manager voor analytische- en/of advertentieplatforms

<Info>
  **Technische implementatie**

  Implementatie van deze feature vereist basis-kennis in marketing analytics. Laat dit bij voorkeur over aan een ontwikkelaar. Hulp nodig? [Neem contact op](mailto:support@sleak.chat) met ons support team.
</Info>

Met Google Tag Manager kun je events van je Sleak chat widget doorsturen naar Google Analytics 4, Google Ads, Facebook Pixel, en andere platforms. Dit geeft je inzicht in hoe bezoekers interacteren met je AI-agent.

## Beschikbare events

Sleak stuurt automatisch de volgende events naar de DataLayer. Je kunt deze events activeren via je [Sleak dashboard](https://dashboard.sleak.chat/integraties?tab=gtm):

| Event | Beschrijving |
| - | - |
| `sleakChatInitiated` | Nieuwe chats |
| `sleakSentContactDetails` | Contactgegevens achtergelaten in chat |
| `sleakHumanHandoffActivated` | Human handoff geactiveerd |

***

## Google Analytics 4 setup

De meest gebruikelijke setup is analytics in GA4.

### Stap 1: Events configureren in GTM

Maak voor elk Sleak event een nieuwe tag aan in Google Tag Manager:

<Steps>
  <Step title="Maak een trigger">
    * **Trigger Type**: Custom Event
    * **Event Name**: `sleakChatInitiated` (of andere event naam)
    * **Trigger Name**: "Sleak - Chat Initiated"
  </Step>

  <Step title="Maak een GA4 Event tag">
    * **Tag Type**: Google Analytics: GA4 Event
    * **Configuration Tag**: Je GA4 configuratie tag
    * **Event Name**: `chat_initiated` (GA4 event naam)
    * **Event Parameters**: (optioneel)
  </Step>
</Steps>

***

## Conversie tracking voorbeelden

Wil je ook conversies attribueren in advertentieplatformen? In dit geval kun je de Google Tag Manager setup uitbreiden door meerdere tags toe te voegen aan de triggers.

### Google Ads conversies

Voor Google Ads kun je specifieke events als conversies markeren:

```javascript wrap theme={null}
// Voorbeeld: Lead captured als Google Ads conversie
gtag('event', 'conversion', {
  'send_to': 'AW-XXXXXXXXX/AbC-D_efG-h12_34-567',
  'value': 1.0,
  'currency': 'EUR',
  'event_callback': function() {
    console.log('Google Ads conversie geregistreerd');
  }
});
```

### Facebook Pixel events

Track chat interacties als Facebook events:

```html wrap theme={null}
<script>
  fbq('track', 'Lead', {
    content_category: 'chat_interaction',
    content_name: 'sleakSentContactDetails',
    value: 1,
    currency: 'EUR'
  });
</script>
```

***

## Debug en testing

### GTM Preview mode

1. Open Google Tag Manager
2. Klik op **Preview**
3. Navigeer naar je website
4. Test chat interacties en controleer of events correct worden getriggerd

### Google Analytics 4 debug

Gebruik de GA4 DebugView om real-time events te bekijken:

1. Ga naar **Admin → DebugView** in GA4
2. Open je website met `?debug_mode=1` parameter
3. Voer chat acties uit en controleer of events verschijnen


# In-line embed
Source: https://docs.sleak.chat/installatie/inline-embed

Embed de Sleak chat widget direct in je website met aangepaste afmetingen

Met de in-line embed optie kun je de Sleak chat widget direct in je website integreren met aangepaste afmetingen. Dit is ideaal wanneer je de widget op een specifieke locatie wilt plaatsen zonder dat deze als overlay wordt weergegeven.

### Hoe gebruik ik de in-line embed?

Gebruik de `placement="fullwidth"` parameter in combinatie met een container div om de widget in-line te embedden. Je kunt de afmetingen volledig aanpassen naar je wensen.

### **Voorbeeld - Elementor**

Voor Elementor kun je de volgende code gebruiken met vaste afmetingen (`px` waarden zijn aanpasbaar naar wens):

```html theme={null}
<!-- sleak.chat sleakbot embed snippet -->
<div style="height: 800px; width: 1000px; min-height: 800px; min-width: 1000px;">
<script id="sleakbot" src="https://cdn.sleak.chat/fetchsleakbot.js" chatbot-id="jouw-chatbot-id" placement="fullwidth"></script>
</div>
```

**Belangrijke parameters:**

* `placement="fullwidth"` - Zorgt ervoor dat de widget de volledige breedte van de container gebruikt
* `chatbot-id="jouw-chatbot-id"` - Vervang dit door je eigen chatbot ID uit het Sleak dashboard
* Container div styling - Pas `height`, `width`, `min-height` en `min-width` aan naar je gewenste afmetingen

***

### **Responsive afmetingen**

Voor een meer responsieve aanpak kun je ook percentages of andere CSS units gebruiken:

```html theme={null}
<div style="height: 600px; width: 100%; min-height: 400px;">
<script id="sleakbot" src="https://cdn.sleak.chat/fetchsleakbot.js" chatbot-id="jouw-chatbot-id" placement="fullwidth"></script>
</div>
```

***

<Note>
  **Hulp nodig?**

  Mocht er iets niet lukken of onduidelijk zijn? Neem gerust contact op met het team van Sleak, zodat we je verder kunnen helpen!
</Note>


# Basis installatie
Source: https://docs.sleak.chat/installatie/website-installatie

Installeer de Sleak chat widget op je website via het standaard installatie-script of met Google Tag Manager

De Sleak chat widget kun je op twee manieren installeren op je website:

<Tabs>
  <Tab title="Directe installatie">
    Voor de meeste websites is directe installatie de snelste methode.

    <Steps>
      <Step title="Kopieer de installatiecode">
        Ga naar je Sleak dashboard en navigeer naar **Instellingen → Integratie**. Kopieer de gegenereerde script code.

        ```html wrap theme={null}
        <!-- sleak.chat sleakbot embed snippet -->
        <script id="sleakbot" src="https://cdn.sleak.chat/fetchsleakbot.js" chatbot-id="<jouw-agent-id>"></script>
        ```
      </Step>

      <Step title="Plaats de code op je website">
        Voeg de script code toe net voor de sluitende `</body>` tag van je HTML pagina's.

        <Tip>
          Voor WordPress, Shopify, of andere CMS-systemen kun je de code meestal via de thema-editor of een plugin toevoegen.
        </Tip>
      </Step>

      <Step title="Test de installatie">
        Open je website en controleer of de chat widget zichtbaar is. Je kunt een testgesprek starten om te verifiëren dat alles werkt.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Google Tag Manager">
    Voor websites die al Google Tag Manager gebruiken.

    <Steps>
      <Step title="Maak een nieuwe tag aan">
        Ga naar je Google Tag Manager container en klik op **Tags → New**.
      </Step>

      <Step title="Configureer de tag">
        * **Tag Type**: Custom HTML
        * **Tag Name**: "Sleak Chat Widget"
        * **HTML**: Plak de onderstaande code
        * **Triggering**: All Pages (of een specifieke trigger naar keuze)

        ```html wrap theme={null}
        <script>
         var sleakGtmScript = document.createElement('script');
         sleakGtmScript.id = 'sleakbot';
         sleakGtmScript.src = 'https://cdn.sleak.chat/fetchsleakbot.js';
         sleakGtmScript.setAttribute('chatbot-id', '<jouw-agent-id>');
         document.body.appendChild(sleakGtmScript);
        </script>
        ```
      </Step>

      <Step title="Publiceer de tag">
        Preview eerst de tag om te testen, en publiceer vervolgens je GTM container.
      </Step>
    </Steps>

    <Tip>
      Met GTM kun je eenvoudig de chat widget conditioneel laden op specifieke pagina's of bijvoorbeeld voor bepaalde gebruikersgroepen.
    </Tip>
  </Tab>
</Tabs>


# Channable Integratie
Source: https://docs.sleak.chat/integraties/channable-integratie

Koppel je Channable productfeed aan Sleak en stel deze beschikbaar als context voor je AI agents

[Channable](https://www.channable.com) is een feed management platform waarmee je je productdata beheert en exporteert naar verschillende kanalen. Sleak is beschikbaar als kant-en-klaar kanaal in Channable, zodat je je productfeed met een paar klikken kunt koppelen.

<Info>
  **Hulp nodig?**

  Mocht er iets niet lukken of onduidelijk zijn? Neem gerust contact op met het team van Sleak, zodat we je verder kunnen helpen!
</Info>

## Channel aanmaken in Channable

Volg deze stappen om de Sleak feed aan te maken in je Channable account.

<Steps>
  <Step title="Ga naar Channels">
    Open je project in Channable en ga in het linkermenu naar **Channels**. Klik vervolgens op **Create channel**.

    <Frame>
      <img alt="Create channel in Channable" />
    </Frame>
  </Step>

  <Step title="Zoek de Sleak.chat channel">
    Zoek in de zoekbalk naar **sleak**. De **Sleak.chat** channel verschijnt direct in de resultaten.

    <Frame>
      <img alt="Zoek naar Sleak.chat" />
    </Frame>
  </Step>

  <Step title="Selecteer Sleak.chat">
    Je vindt Sleak.chat ook terug onder de categorie **Comparison websites**. Selecteer de Sleak.chat channel en doorloop de verdere configuratie in Channable.

    <Frame>
      <img alt="Sleak.chat onder Comparison websites" />
    </Frame>
  </Step>
</Steps>

## Feed toevoegen in Sleak

Zodra de channel in Channable is aangemaakt, krijg je een feed-URL. Voeg deze in Sleak toe als [XML productfeed](/agent/databronnen/xml-feed).

Vanaf dat moment werkt de feed verder precies als een normale productfeed: Sleak verwerkt de feed, maakt de inhoud doorzoekbaar voor de agent en houdt de data actueel via [automatische verversing](/agent/databronnen/xml-feed).

## Automatisch relevante context

De Sleak.chat channel in Channable is zo opgezet dat alle data in Channable die relevant is als context voor de AI agents automatisch wordt blootgesteld in de feed. Je hoeft dus niet handmatig velden te selecteren of te mappen - de relevante productdata komt automatisch mee.

## Geschikt voor productaanbevelingen

Deze feed is ook geschikt voor [productaanbevelingen](/agent/acties/productaanbevelingen): het in-chat tonen van interactieve productcarrousels. De agent bepaalt op basis van het gesprek welke producten uit de feed relevant zijn en presenteert deze visueel aan de bezoeker.

<Frame>
  <img alt="Productaanbevelingen in de chat" />
</Frame>

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# N8N Integratie
Source: https://docs.sleak.chat/integraties/n8n-integratie

Gebruik de Sleak.chat community node in n8n voor low-code AI agent workflows

De Sleak.chat n8n-node is beschikbaar als community node in n8n.

<Info>
  **Hulp nodig?**

  Mocht er iets niet lukken of onduidelijk zijn? Neem gerust contact op met het team van Sleak, zodat we je verder kunnen helpen!
</Info>

## Overzicht

Wij weten als geen ander welke uitdagingen komen kijken bij het bouwen van hoogwaardige agents die presteren in productie en op schaal.

Met onze n8n node kun je daarom nu gebruik maken van de betrouwbare data-verwerking en agent-infrastructuur van het Sleak.chat-platform...

Maar dan met volledige flexibiliteit - zodat je onze bewezen agents direct in je eigen workflow kunt inzetten.

De node maakt interactie met de Sleak.chat completions API mogelijk. Je kan nieuwe conversations aanmaken, en messages te versturen naar deze conversations.

<Frame>
  <img alt="Sleak n8n node overzicht" />
</Frame>

***

## Installation

1. Open je n8n-instance
2. Ga naar **Settings > Community Nodes**
3. Klik op **Install**
4. Voer `n8n-nodes-sleakchat` in

<Frame>
  <img alt="Community node installatie" />
</Frame>

5. Klik op **Install**
6. Je node wordt nu ge-installeerd!

<Frame>
  <img alt="De ge-installeerde node" />
</Frame>

## Gebruikmaken van de node

Na installatie, kan je de node in het canvas slepen in je workflows.

## Authentication

Om te authenticaten met Sleak heb je een API key nodig. Die kun je aanmaken in je [Sleak workspace](https://dashboard.sleak.chat/instellingen?tab=api), als je account admin permissions heeft in de workspace.

<Frame>
  <img alt="Maak een API key aan in je workspace" />
</Frame>

Zodra je je key hebt aangemaakt in je Sleak workspace, stel je je credentials in binnen n8n:

* Ga naar Credentials \[in de credentials-sectie of in je Node op het canvas]
* Klik op 'Create new credential'
* Voer je API-gegevens in
* Sla de credentials op

## Beschikbare methoden

### 1. Send Message

Deze resource stelt je in staat om een bericht te sturen naar een bestaande conversation.

<Frame>
  <img alt="Send Message methode" />
</Frame>

**Parameters:**

* **`Conversation ID`** (uuid): Het ID van de conversation waar je een bericht naartoe wil sturen
* **`Message`** (string): De message inhoud die je wil sturen

```json theme={null}
{
  "conversation_id": "your-conversation-id",
  "message": "Hello, how can you help me today?"
}
```

<Warning>
  **Sidenotes**

  * Het is vereist om eerst een conversation te maken voordat je messages kunt sturen. Gebruik het `conversation_id` dat teruggegeven wordt door de **Create conversation** method
  * Je kunt alleen berichten sturen naar conversations die via n8n/api zijn aangemaakt
</Warning>

### 2. Create Conversation

Deze method stelt je in staat om een nieuwe conversation aan te maken.

<Frame>
  <img alt="Create Conversation methode" />
</Frame>

**Parameters:**

* **`Chatbot ID`** (string): De ID van de agent waar je een conversation mee wil starten
* **`Name`** (string): Een naam voor de nieuwe conversation *\[optioneel]*

```json theme={null}
{
  "chatbot_id": "your-chatbot-id",
  "name": "New Support Conversation"
}
```

<Warning>
  **Sidenotes**

  * Je kunt alleen berichten sturen naar agents die bij jouw organisatie horen.
  * Je kunt optioneel een herkenbare naam meegeven aan je conversation, zodat je deze later makkelijk terugvindt in je Sleak-inbox.
</Warning>

## Typisch gebruik

Voor het sturen van berichten naar nieuwe conversations gebruik je doorgaans het `conversation_id` dat eerder is teruggegeven via Create conversation in je workflow.

<Frame>
  <img alt="Voorbeeld voor nieuwe conversations" />
</Frame>

Voor bestaande conversations is het gebruikelijk om het `conversation_id` bij aanmaak op te slaan in een extern systeem - zoals een CRM of database. Bij nieuwe events in de toekomst kun je deze waarde gebruiken om de juiste conversation te koppelen en het antwoord te verwerken zoals gewenst voor jouw use case.

<Frame>
  <img alt="Voorbeeld voor bestaande conversations" />
</Frame>

***

<Note>
  **Hulp nodig?**

  Mocht er iets niet lukken of onduidelijk zijn? Neem gerust contact op met het team van Sleak, zodat we je verder kunnen helpen!
</Note>


# Returnless integratie
Source: https://docs.sleak.chat/integraties/returnless-integratie

Koppel Returnless aan Sleak zodat klanten hun retouren gemakkelijk via chat kunnen volgen

Met de Returnless-integratie geef je je agent directe toegang tot retourdata van je klanten. De volgende acties zijn beschikbaar:

| Actie | Beschrijving |
| - | - |
| **Retour status ophalen** | De agent haalt de actuele retourstatus op - of het pakket onderweg is, ontvangen is, en of de terugbetaling al is verwerkt. |
| **Retour aanmaken** *(roadmap)* | Laat klanten retouraanvragen aanmaken via chat. (Let op - Deze actie is nu nog niet beschikbaar maar wordt wordt later toegevoegd. |

<Info>
  **Hulp nodig?**

  Kom je er niet uit of heb je vragen? Neem contact op met het Sleak-team, we helpen je verder.
</Info>

***

## Installatie

<Steps>
  <Step title="Ga naar e-commerce integraties in Returnless">
    Navigeer in Returnless naar **E-commerce-integratie toevoegen** en klik op [Nieuwe integratie toevoegen](https://panel.returnless.com/settings/integrations/platform/create).
  </Step>

  <Step title="Voeg de Sleak.chat integratie toe">
    Zoek naar **Sleak.chat** in de lijst en selecteer de integratie.

    <Frame>
      <img alt="Nieuwe integratie toevoegen in Returnless" />
    </Frame>
  </Step>

  <Step title="Verifieer de integratie">
    Klik op **Integratie verifiëren**. Returnless stuurt je door naar Sleak om de koppeling te bevestigen - er is geen handmatige configuratie nodig.
  </Step>

  <Step title="Bevestig in Sleak">
    Bevetig de integratie in Sleak om de integratie actief te maken. Sleak maakt automatisch een **Returnless refund status** actie aan die je agents vanaf dat moment kunnen gebruiken.

    <Frame>
      <img alt="Returnless statuskaart in de Sleak widget" />
    </Frame>
  </Step>
</Steps>

<Tip>
  De actie is standaard gekoppeld aan de agent die actief was tijdens de installatie. Je kunt hem daarna eenvoudig delen met andere agents via de instellingen.
</Tip>

***

## Actie configuratie

Na installatie vind je de Returnless actie terug in je agent onder **Acties**. Hier kun je het gedrag van de agent bijsturen.

<Frame>
  <img alt="Returnless actie instellingen in het Sleak dashboard" />
</Frame>

### Tool prompt

De tool prompt is de prompt die bepaalt wanneer en hoe de agent de Returnless actie inzet. Je kunt dit aanpassen om het gedrag te fine-tunen - bijvoorbeeld om de tool alleen te gebruiken bij expliciete retourvragen.

### Variabelen

De agent verwacht minimaal één van de volgende waarden van de klant:

| Variabele | Beschrijving |
| - | - |
| `return_number` | Het retourreferentienummer - begint altijd met `RE-` |
| `order_number` | Het originele ordernummer - begint altijd met `ORD` |

Beide zijn optioneel; de agent vraagt automatisch door als geen van beide beschikbaar is.

Je kunt de beschrijvingen van deze variabelen ook aanpassen in de actie instellingen. De agent ziet deze teksten mee - gebruik ze om extra instructies achter te laten, bijvoorbeeld hoe de agent moet doorvragen of welk formaat je verwacht.

### Emailvalidatie

Voordat de retourstatus wordt opgehaald, vraagt de agent de klant altijd om het emailadres waarmee de bestelling is geplaatst. Het opgeven van een email is vereist en moet overeenkomen met het daadwerkelijke emailadres van de retouraanvraag.

Dit is een privacy- en beveiligingsmaatregel: we controleren hiermee of de retouraanvraag daadwerkelijk van deze gebruiker is.

***

## De actie in actie

Zodra de actie is gekoppeld aan je agent, kunnen klanten in de widget vragen stellen over hun retour. De agent herkent retourgerelateerde vragen en zet de Returnless actie in om de status op te halen.

Typisch verloop in de widget:

1. De klant vraagt bijvoorbeeld naar de status van een retour of terugbetaling
2. De agent vraagt om een retournummer of ordernummer, en het emailadres van de bestelling
3. De agent haalt de retourstatus op via Returnless
4. De agent antwoordt in de chat en toont een **statuskaart**  in de widget

De klant hoeft de widget niet te verlaten: alle relevante informatie staat direct in de chat. Via de link op de statuskaart kan de klant ook doorklikken naar de persoonlijke retourpagina in Returnless.

### Wat ziet de agent?

Zodra een retour is gevonden, haalt de agent automatisch de volgende informatie op:

* **Retourstatus** - de huidige status van de retouraanvraag
* **Retourartikelen** - welke producten zijn teruggestuurd en waarom
* **Zending** - of het pakket onderweg is, ontvangen, en via welke vervoerder
* **Terugbetaling** - of de refund al is verwerkt en via welke betaalmethode

De agent heeft alles in één keer beschikbaar, zodat vervolgvragen direct beantwoord kunnen worden zonder een extra opzoekactie.

### Statuskaart message type in de widget

Zodra de agent de retourstatus heeft opgehaald, toont de widget automatisch een **statuskaart** met een visueel overzicht van de voortgang.

Hierdoor kan de eindgebruiker direct gemakkelijk zien wat de status is, en daarnaast ook fact-checken dat het klopt door op de card te klikken en naar het Returnless return portal te navigeren.

<Frame>
  <img alt="Returnless statuskaart in de Sleak widget" />
</Frame>

Returnless retourstatussen worden gegroepeerd in verschillende stappen op de progressiebalk in de statuskaart. Elke `return_state` krijgt een eigen label dat de klant op de kaart ziet.

| Groep | Label op de statuskaart | `return_state` (Returnless) |
| - | - | - |
| **Aangemeld** | Retour aangemeld | `return-announced` |
| | Retouraanvraag in behandeling | `request-pending` |
| | Retouraanvraag goedgekeurd | `request-approved` |
| | Annulering in behandeling | `withdrawal-request-pending` |
| **Onderweg** | Retour verzonden | `return-shipped` |
| **Ontvangen** | Retour wordt verwerkt | `return-processing` |
| **Afgerond** | Retour afgerond | `return-resolved` |
| **Afgekeurd** | Retour afgekeurd | `request-rejected` |
| **Aanmelding niet afgerond** | Aanmelding niet afgerond | `return-prevented` |
| | Aanmelding niet afgerond | `return-preventing` |

<Frame>
  <img alt="Returnless statusgroepen op de statuskaart" />
</Frame>

De statuskaart toont daarnaast:

| Veld | Beschrijving |
| - | - |
| Return number | Retourreferentienummer |
| Order number | Origineel ordernummer |
| Shipping carrier | Gebruikte verzenddienst |
| Email | Emailadres van de retouraanvraag |
| Verzonden op | Datum waarop het pakket is verzonden |
| Link naar return portal pagina | Directe link naar de persoonlijke statuspagina in Returnless |

***

<Tip>
  **Vul order- of retournummer automatisch in via custom fields**

  Je kunt klanten de moeite besparen om hun gegevens zelf op te hoeven zoeken door het order- of retournummer automatisch door te geven aan de agent via [custom fields](/installatie/custom-fields). Dit kan in de praktijk op twee manieren:

  * **Omgeving met login** - haal het ordernummer op uit de sessie of account van de ingelogde klant en stel het in als custom field bij het laden van de chat.
  * **Cookies** - sla het order- of retournummer op in een cookie (plaatsen in browser van eindgebruiker bijvoorbeeld na een aankoop) en lees die cookie uit om het custom field in te stellen.

  De agent beschikt dan direct over de benodigde gegevens zonder dat de klant iets hoeft op te zoeken of in te typen.
</Tip>

***

### Limitaties

* De retourstatuskaarten zijn momenteel alleen zichtbaar in de widget, nog niet in de Sleak inbox. Dit komt bij de aankomende (Q3 '26) release van het nieuwe Dashboard 2.0. Uiteraard zie je in de inbox wel al het antwoord van de agent met alle belangrijke informatie.

***

## Veelgestelde vragen

<AccordionGroup>
  <Accordion title="Werkt de integratie met meerdere webshops?">
    Ja. Je koppelt één Returnless organisatie die je vervolgens kunt delen met alle agents. Meerdere webshops onder één Returnless account zijn direct beschikbaar. Voor verschillende Returnless organisaties kun je apart meerdere integraties installeren.
  </Accordion>

  <Accordion title="Wat als een retour niet gevonden wordt?">
    De agent meldt dit aan de klant en vraagt of de opgegeven gegevens kloppen. Ook de statuskaart wordt getoond met daarin een melding dat er geen retour is gevonden.
  </Accordion>
</AccordionGroup>


# WhatsApp Integratie - beta
Source: https://docs.sleak.chat/integraties/whatsapp-integratie

Leer hoe je de WhatsApp integratie (beta) met Sleak instelt en gebruikt

<Info>
  **Beta Functie**

  De WhatsApp integratie is momenteel in beta. Naar verwachting vindt de publieke release plaats in Q3 2026. Heb je vragen of feedback? Neem contact op via [support@sleak.chat](mailto:support@sleak.chat).
</Info>

## Wat is de WhatsApp Integratie?

De WhatsApp integratie maakt het mogelijk om WhatsApp als kanaal in te zetten voor je agents in Sleak. Je gebruikers kunnen zo direct via WhatsApp met je agents communiceren.

<Frame>
  <img alt="WhatsApp integratie" />
</Frame>

## Hoe werkt het?

De integratie werkt via een koppeling tussen WhatsApp en Sleak:

1. **Inkomende berichten**: Wanneer iemand een bericht stuurt naar je WhatsApp nummer, wordt dit automatisch doorgestuurd naar je Sleak agent
2. **AI reacties**: Je Sleak agent verwerkt het bericht en genereert een antwoord
3. **Uitgaande berichten**: Het antwoord wordt automatisch teruggestuurd naar de eindgebruiker via WhatsApp
4. **Beheer**: Chats zijn in de beta fase te beheren via WhatsApp Web. Met de publieke release komt er tevens ondersteuning voor de Sleak inbox

<Check>De integratie ondersteunt zowel tekstberichten als afbeeldingen.</Check>

<Info>
  **Alleen nieuwe gesprekken**

  De AI workflow pikt alleen gesprekken op die zijn gestart nadat de integratie is ingeschakeld. Bestaande WhatsApp-gesprekken die al actief waren vóór de koppeling worden niet opgepakt. Zo voorkom je dat de agent ongewenst reageert op oude chats.
</Info>

## Onboarding Proces

<Steps>
  <Step title="Account Aanmaken">
    Ga naar [whatsapp.sleak.chat](https://whatsapp.sleak.chat) en log in met je bestaande Sleak account. Je gebruikt dezelfde inloggegevens als voor je Sleak dashboard.
  </Step>

  <Step title="WhatsApp Account Verbinden">
    Na het inloggen is er een mogelijkheid om WhatsApp verbindingen aan te maken.

    Klik op 'koppelen' om een QR code te genereren waar je je WhatsApp account mee kan koppelen.

    <Frame>
      <img alt="WhatsApp integratie" />
    </Frame>
  </Step>

  <Step title="QR Code Scannen">
    1. Klik in de popup op "Generate QR Code" voor het kanaal dat je wilt verbinden
    2. Open WhatsApp op je telefoon
    3. Ga naar **Instellingen** > **Gekoppelde apparaten** > **Apparaat koppelen**
    4. Scan de QR code die je ziet op het scherm

    <Frame>
      <img alt="WhatsApp integratie" />
    </Frame>

    <Check>
      **WhatsApp business mobiele app en web app blijven ondersteund**

      Je kunt ook de WhatsApp business app en Web app blijven gebruiken om je whatsapp berichten te beheren zoals je al gewend bent.
    </Check>
  </Step>

  <Step title="Agent Koppelen">
    Selecteer in de dropdown welke Sleak agent je wilt gebruiken voor dit WhatsApp kanaal. Je kunt elk van je bestaande agents gebruiken. Let op: Een agent koppelen is vereist - zonder gekoppelde agent kunnen berichten niet worden verwerkt.
  </Step>
</Steps>

<Warning>
  **Prompt Aanpassingen**

  Agents in Sleak zijn standaard geoptimaliseerd voor web chat. Voor WhatsApp kan het nodig zijn om je prompt licht aan te passen, omdat WhatsApp chats doorgaans net anders van aard zijn.

  We bevelen je aan om een nieuwe agent aan te maken. Neem de tijd om goed te testen, en pas waar nodig de prompting aan in het Sleak dashboard.
</Warning>

### Instellingen

In het dashboard kun je verschillende instellingen beheren:

* **Agent Selectie**: Kies welke agent je wilt gebruiken voor elk WhatsApp kanaal
* **Verbindingsstatus**: Bekijk of je WhatsApp account verbonden is
* **QR Code Beheer**: Genereer nieuwe QR codes wanneer nodig

***

# Functies

## Agent uitschakelen voor individuele gesprekken

Je kunt chats uitschakelen door een bericht te sturen vanuit de WhatsApp web app. Wanneer je handmatig een bericht stuurt via WhatsApp Web, wordt het gesprek automatisch gesloten en worden er geen nieuwe berichten meer gegenereerd of verstuurd.

### Agent weer inschakelen

Mocht het voorkomen dat je een uitgeschakelde agent weer in wil schakelen, bijvoorbeeld voor een test chat, kan dit door in WhatsApp web `/agent` te sturen in de chat.

```txt command om agent te her-activeren theme={null}
/agent
```

## Human handoff via WhatsApp

De human handoff tool wordt ondersteund door de WhatsApp integratie, maar je moet een specifieke configuratie gebruiken

### configuratie

* **Tool beschrijving**: gebruik hier een aangepaste prompt voor WhatsApp.

  ```txt voorbeeld prompt template wrap theme={null}
  BELANGRIJK: Gebruik deze tool nooit direct. Vraag ALTIJD om bevestiging - anders kun je de tool niet gebruiken.

  Als de tool gebruikt is - bevestig je dit weer aan de gebruiker en zeg je dat het gemiddeld 1 uur duurt voordat er een medewerker in de chat komt.
  ```

* **Afhandeling instelling**: deze instelling is niet van toepassing op de WhatsApp integratie

* **Bevestigings bericht**: gebruik een kort, direct bericht.

  ```txt voorbeeld bevestigings bericht theme={null}
  “Een medewerker komt je helpen - houd je WhatsApp in de gaten!”
  ```

* **Verzamel aanvullende gegevens**: zet deze optie uit voor WhatsApp handoff

<Frame>
  <img alt="WhatsApp integratie" />
</Frame>

### Handoff gebruik

Wanneer een eindgebruiker een human handoff aanvraagt, ontvangt het e-mailadres dat aan de agent is gekoppeld automatisch een e-mail. In deze mail staat een directe link naar WhatsApp Web waarmee je het betreffende gesprek direct kunt openen — zonder te hoeven zoeken.

<Check>Je hoeft zelf niets in te stellen. De e-mail wordt automatisch verstuurd zodra de agent een handoff activeert.</Check>

## Afbeeldingen verwerken

De integratie ondersteunt het versturen en ontvangen van afbeeldingen. Klanten kunnen afbeeldingen sturen naar je WhatsApp nummer, en deze worden automatisch doorgestuurd naar je Sleak agent voor verwerking.

***

# Tips

* Test je agent eerst met een paar testberichten voordat je live gaat
* Overweeg je prompt aan te passen voor WhatsApp (kortere, directere antwoorden werken vaak beter)
* Gebruik de WhatsApp web app om berichten te monitoren en indien nodig handmatig in te grijpen
* Houd er rekening mee dat WhatsApp berichten real-time zijn - zorg dat je agent snel en accuraat reageert

<br />

<br />

# Beperkingen

### Geen inbox ondersteuning

De WhatsApp integratie wordt in de beta fase nog niet ondersteund in de Sleak inbox. Ondersteuning is echter wel al in ontwikkeling en wordt beschikbaar bij de publieke release. Momenteel kun je WhatsApp chats beheren via WhatsApp Web.

### Agent actions

Voor onderstaande agent actions is er (nog) geen ondersteuning:

* **Custom forms** – aangepaste formulieren worden niet ondersteund
* **Productaanbevelingen** – productaanbevelingen zijn niet beschikbaar

Alle databronnen werken gewoon zoals je gewend bent in de widgets en dashboards.

<br />

<br />

<Info>Let op - de WhatsApp integratie zal na de publieke release onderdeel worden van het Scale pakket</Info>

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# Sleak.chat AI chat agent
Source: https://docs.sleak.chat/introduction

Welkom bij de documentatie van Sleak.chat - de AI chat agent bouwer voor jouw website of webshop

<Check>
  **Documentatie in progressie**

  De documentatie is nog niet volledig. Heb je vragen of suggesties? Neem dan contact op via [support@sleak.chat](mailto:support@sleak.chat) of +31850608199.
</Check>

Welkom bij de Sleak.chat documentatie. Hier vind je alles wat je nodig hebt om jouw AI agent in te richten, te koppelen en te optimaliseren.

<CardGroup>
  <Card title="Agent inrichten" icon="robot" href="/agent/agent-kennis">
    Leer hoe je jouw agent van de juiste kennis voorziet
  </Card>

  <Card title="Extra databronnen" icon="database" href="/agent/extra-data">
    Koppel kennisbanken, CSV-bestanden of een API aan je agent
  </Card>

  <Card title="API Referentie" icon="code" href="/api/overview">
    Integreer Sleak direct in je eigen applicatie via de REST API
  </Card>

  <Card title="n8n Integratie" icon="diagram-project" href="/integraties/n8n-integratie">
    Bouw low-code workflows met de Sleak community node voor n8n
  </Card>
</CardGroup>

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# Blocking tijdens scrapen
Source: https://docs.sleak.chat/troubleshooting/blocking-scraping

Oplossing voor foutmeldingen tijdens het scrapen van je website

Er zijn **twee veelvoorkomende oorzaken** waarom het scrapen van je website kan falen. Beide hebben te maken met beveiligingsmaatregelen op je website die scraping blokkeren.

***

## Oorzaak 1: Server beveiliging blokkeert scraping

Het komt voor dat **foutmeldingen verschijnen tijdens het scrapen van je website**. Dit kan gebeuren omdat je server automatisch onbekende bots blokkeert als beveiligingsmaatregel.

**Wat gebeurt er precies?**

* Je server detecteert scraping activiteit als potentieel verdachte traffic
* De ingebouwde beveiliging blokkeert automatisch toegang
* Hierdoor kunnen niet alle pagina's succesvol gescraped worden

### Oplossing: Server header toevoegen

<Steps>
  <Step title="Voeg header toe">
    Voeg de volgende header toe op je server:

    ```
    sleak.chat scrape
    ```

    Dit zorgt ervoor dat je server Sleak herkent als vertrouwde bot en toegang verleent.
  </Step>

  <Step title="Opnieuw scrapen">
    Selecteer alle URLs met foutmeldingen in je databron en klik rechtsbovenin op 'meer opties' -> 'Opnieuw scrapen'.
  </Step>

  <Step title="Verificatie">
    Het scraping proces zal nu zonder blokkering verlopen.
  </Step>
</Steps>

<Info>
  **Weet je niet hoe je een header moet toevoegen?**

  Neem contact op met je webouwer of hostingprovider. Zij kunnen je helpen met het toevoegen van de `sleak.chat scrape` header aan je server configuratie.
</Info>

***

## Oorzaak 2: Cloudflare blokkeert scraping

### Foutmeldingen bij het toevoegen van sitemaps of productfeeds

Sommige websites gebruiken **Cloudflare** om verkeer te beveiligen. In dat geval kan het voorkomen dat onze scraper wordt geblokkeerd en dat sitemaps of productfeeds niet (opnieuw) kunnen worden ingelezen.

Gelukkig is dit eenvoudig op te lossen door onze user agent toe te staan in Cloudflare.

### Oplossing: User agent toestaan in Cloudflare

<Steps>
  <Step title="Ga naar Cloudflare instellingen">
    Ga in Cloudflare naar **Security → WAF → Firewall Rules**
  </Step>

  <Step title="Maak nieuwe regel aan">
    Maak een nieuwe regel aan met de volgende expressie:

    ```
    (http.user_agent contains "sleak.chat scrape")
    ```
  </Step>

  <Step title="Stel actie in">
    **Actie:** Allow
  </Step>

  <Step title="Test de oplossing">
    Probeer de sitemap of productfeed opnieuw toe te voegen
  </Step>
</Steps>

**Resultaat**: Cloudflare staat verzoeken toe die onze scraper-user-agent bevatten.

***

<Note>
  **Hulp nodig?**

  Mocht er iets niet lukken of onduidelijk zijn? Neem gerust contact op met het team van Sleak, zodat we je verder kunnen helpen!
</Note>


# Browser notificaties niet zichtbaar
Source: https://docs.sleak.chat/troubleshooting/browser-notificaties

Stappenplan voor wanneer browser push-notificaties niet binnenkomen op je computer of laptop

Browser notificaties geven je een melding in de inbox bij urgente gebeurtenissen, zoals een bezoeker die menselijke hulp nodig heeft. Zo kun je direct schakelen en snel reageren, ook als je net niet naar Sleak aan het kijken bent.

## Het probleem

Je verwacht een melding van Sleak in je browser, maar de melding komt niet binnen. Dit kan gebeuren op een vaste computer of laptop.

Browser notificaties zijn afhankelijk van drie plekken tegelijk:

1. Browser notificaties moeten aanstaan in Sleak
2. De browser moet notificaties mogen tonen
3. Het apparaat zelf moet notificaties toestaan

Als één van deze drie plekken notificaties blokkeert, zie je geen melding.

<Info>
  Gebruik dit artikel op het apparaat waarop de notificaties niet werken. Notificaties kunnen per apparaat, browser en browserprofiel anders ingesteld zijn.
</Info>

## Wanneer je een melding krijgt

Browser notificaties komen alleen binnen wanneer er hulp van een menselijke medewerker nodig is. Concreet bij:

* **Human handoff**: de agent draagt het gesprek over aan een medewerker
* **Reactie in livechat**: een bezoeker reageert in een livechat-gesprek

Je krijgt dus **geen** melding bij elke nieuwe chat. Pas op het moment dat er een medewerker nodig is, stuurt Sleak een browsermelding.

<Warning>
  Krijg je geen melding bij een nieuwe chat? Dat klopt en is geen storing. Meldingen zijn bedoeld voor de momenten waarop iemand moet meekijken of reageren.
</Warning>

Daarnaast verschijnt een browsermelding alleen wanneer het Sleak-tabblad **niet** je actieve tabblad is. Heb je Sleak op de voorgrond open en kijk je er actief naar? Dan zie je de chat direct in de inbox binnenkomen en krijg je geen losse pop-up. Dat is normaal gedrag.

<Warning>
  Browser meldingen worden niet afgeleverd als het inbox tabblad open staat. Het werkt alleen als er een inbox tabblad openstaat op de achtergrond.
</Warning>

Zo'n melding verschijnt als een systeemmelding van je **apparaat** zelf, bijvoorbeeld rechtsboven of rechtsonder in je scherm. Het is dus geen melding binnen de Sleak-pagina, maar een notificatie van je besturingssysteem, gestuurd via je browser.

<Frame>
  <img alt="Voorbeeld van een browsermelding van Sleak rechtsboven in het scherm" />
</Frame>

## Stap 1: zet Browser notificaties aan in Sleak

Controleer eerst of browser notificaties in Sleak zelf aanstaan. Zonder deze instelling stuurt Sleak geen browsermeldingen naar je apparaat.

1. Open [dashboard.sleak.chat/instellingen?tab=notificaties](https://dashboard.sleak.chat/instellingen?tab=notificaties)
2. Ga naar **Instellingen**
3. Klik op **Notificaties**
4. Zet **Browser notificaties** aan
5. Herlaad Sleak
6. Test opnieuw

<Frame>
  <img alt="Sleak notificatie-instellingen met Browser notificaties ingeschakeld" />
</Frame>

Nadat je **Browser notificaties** aanzet, vraagt je browser zelf om toestemming om meldingen te mogen sturen. Klik in dit venster op **Toestaan**. Zonder deze toestemming kan Sleak geen browsermeldingen tonen.

<Info>
  Zie je geen toestemmingsvenster verschijnen? Dan heb je de toestemming mogelijk eerder al gegeven of geweigerd. Je kunt dit altijd aanpassen via de site-instellingen van je browser. Volg hiervoor de stappen verderop bij jouw systeem of browser.
</Info>

<Info>
  **Audio meldingen** is een aparte instelling. Die gaat over geluid bij nieuwe chats en berichten. Voor browser push-notificaties moet vooral **Browser notificaties** aanstaan.
</Info>

## Probeer dit eerst

Doe deze stappen voordat je de instellingen induikt:

1. Controleer of **Browser notificaties** aanstaat in Sleak
2. Open Sleak in de browser waarin je normaal werkt
3. Log uit en log opnieuw in
4. Herlaad de pagina
5. Controleer of je niet in een privévenster of incognitovenster werkt
6. Controleer of het geluid of de focusmodus van je apparaat niet op stil staat
7. Stuur of vraag een testmelding

Werkt het daarna nog niet? Loop dan eerst de browserstappen door en daarna de instellingen van je apparaat.

## Stap 2: sta notificaties toe in je browser

De browser bepaalt of een website meldingen mag tonen. Deze instelling staat los van je apparaat: toestemming in Chrome geldt bijvoorbeeld niet automatisch voor Edge, Safari of Firefox. Kies hieronder je browser.

### Chrome of Edge

1. Open Sleak in Chrome of Edge
2. Klik links van de URL op het slotje of instellingen-icoon
3. Klik op **Site-instellingen**
4. Zoek **Meldingen** of **Notificaties**
5. Zet deze op **Toestaan**
6. Herlaad Sleak en test opnieuw

In het overzicht met meldingsinstellingen van je browser controleer je twee dingen. Bij **Standaardgedrag** moet **Sites kunnen vragen of ze je meldingen mogen sturen** aanstaan. En onder **Toestemming om meldingen te sturen** moet dashboard.sleak.chat in de lijst staan.

<Frame>
  <img alt="Chrome meldingsinstellingen met dashboard.sleak.chat toegestaan" />
</Frame>

<Info>
  Andere browsers zoals Edge, Firefox en Safari hebben vergelijkbare meldingsinstellingen, alleen met andere namen en op een iets andere plek.
</Info>

### Safari

1. Open Safari
2. Klik linksboven op **Safari**
3. Open **Instellingen**
4. Ga naar **Websites**
5. Klik op **Meldingen**
6. Zoek Sleak of de website waarop je Sleak gebruikt
7. Zet deze op **Sta toe**
8. Test opnieuw

### Firefox

1. Open Sleak in Firefox
2. Klik links van de URL op het slotje
3. Controleer of notificaties zijn toegestaan
4. Open anders **Instellingen**
5. Ga naar **Privacy & Beveiliging**
6. Zoek **Toestemmingen**
7. Klik naast **Meldingen** op **Instellingen**
8. Zoek Sleak of de website waarop je Sleak gebruikt
9. Zet deze op **Toestaan**
10. Herlaad Sleak en test opnieuw

<Info>
  Gebruik je in Chrome of Edge meerdere profielen, bijvoorbeeld een werk- en privéprofiel? Notificaties worden per profiel opgeslagen. Controleer rechtsboven of je in het juiste profiel werkt.
</Info>

## Stap 3: controleer de instellingen van je apparaat

Staat de toestemming in je browser goed, maar zie je nog steeds niets? Dan blokkeert je apparaat de meldingen waarschijnlijk. Kies hieronder je besturingssysteem.

### Windows

1. Open **Instellingen** op Windows
2. Ga naar **Systeem**
3. Ga naar **Meldingen**
4. Controleer of **Meldingen** aan staat
5. Zoek je browser, bijvoorbeeld **Google Chrome** of **Microsoft Edge**, en zet notificaties daarvoor aan
6. Controleer of **Niet storen** uit staat en er geen focus- of concentratiesessie actief is
7. Test opnieuw

### MacOS / MacBook

1. Open **Systeeminstellingen**
2. Ga naar **Meldingen**
3. Zoek je browser, bijvoorbeeld **Google Chrome**, **Microsoft Edge** of **Safari**
4. Zet **Sta meldingen toe** aan
5. Controleer of meldingen ook op het toegangsscherm of in het berichtencentrum mogen verschijnen
6. Ga naar **Focus** en controleer of **Niet storen** of een andere focusmodus uit staat
7. Test opnieuw

### Ander besturingssysteem

Staat jouw systeem hier niet bij, bijvoorbeeld Linux of ChromeOS op een Chromebook? De aanpak is hetzelfde:

1. Open de instellingen van je besturingssysteem
2. Zoek het onderdeel **Meldingen** of **Notificaties**
3. Controleer of meldingen in het algemeen aan staan
4. Zoek je browser in de lijst en zet meldingen voor die browser aan
5. Controleer of er geen **Niet storen**- of focusmodus actief is
6. Test opnieuw

<Info>
  De namen en plek van deze instellingen verschillen per systeem, maar het principe is altijd hetzelfde: meldingen aan voor je browser en geen Niet storen actief.
</Info>

### Zakelijke of beheerde computer

Sommige zakelijke computers hebben instellingen die door een IT-partij worden beheerd.

1. Open je browser
2. Open **Instellingen**
3. Kijk of je ergens **Beheerd door je organisatie** ziet staan

Staat dit erbij? Dan kan het zijn dat notificaties door de IT-beheerder zijn geblokkeerd. Neem dan contact op met je IT-partij en vraag of browser notificaties voor Sleak toegestaan mogen worden.

## Als het nog steeds niet werkt

Loop deze extra checklist door:

<AccordionGroup>
  <Accordion title="Gebruik je een privévenster of incognitovenster?">
    Browser notificaties werken vaak niet goed of niet blijvend in privévensters. Open Sleak in een normaal browservenster en zet notificaties daar opnieuw aan.
  </Accordion>

  <Accordion title="Gebruik je de juiste browser?">
    Controleer of je Sleak opent in dezelfde browser waarin je notificaties hebt toegestaan. Toestemming in Chrome geldt bijvoorbeeld niet automatisch voor Edge, Safari of Firefox.
  </Accordion>

  <Accordion title="Gebruik je het juiste profiel?">
    Chrome en Edge kunnen meerdere profielen hebben. Notificaties worden per profiel opgeslagen. Controleer rechtsboven in de browser of je in het juiste profiel werkt.
  </Accordion>

  <Accordion title="Heb je de website misschien eerder geblokkeerd?">
    Als je eerder op "Blokkeren" hebt geklikt, moet je dit handmatig aanpassen via de site-instellingen van je browser. Klik links van de URL op het slotje of instellingen-icoon en zet notificaties op **Toestaan**.
  </Accordion>

  <Accordion title="Staat Niet storen, Focus of Concentratie aan?">
    Windows en macOS kunnen meldingen tijdelijk stilhouden. Zet Niet storen of Focus tijdelijk uit en test opnieuw.
  </Accordion>

  <Accordion title="Worden meldingen wel ontvangen, maar zonder geluid?">
    Controleer het volume, stille modus, Focus, meldingsgeluid en de notificatie-instellingen van je browser. Soms verschijnt de melding wel in het berichtencentrum, maar zonder geluid.
  </Accordion>

  <Accordion title="Gebruik je een zakelijke computer?">
    Op zakelijke computers kan een IT-beheerder notificaties, browserrechten of achtergrondprocessen blokkeren. Controleer of je browser "Beheerd door je organisatie" toont en vraag je IT-partij om browser notificaties toe te staan.
  </Accordion>

  <Accordion title="Gebruik je een VPN, antivirus of streng bedrijfsnetwerk?">
    Sommige bedrijfsnetwerken, VPN's of beveiligingsprogramma's blokkeren browsermeldingen of achtergrondverkeer. Test indien mogelijk tijdelijk op een ander netwerk, bijvoorbeeld een mobiele hotspot.
  </Accordion>

  <Accordion title="Heb je de browser lang niet gebruikt?">
    Sommige browsers kunnen oude of weinig gebruikte notificatierechten intrekken. Open Sleak opnieuw, sta notificaties opnieuw toe en test daarna nog een keer.
  </Accordion>

  <Accordion title="Heb je meerdere tabbladen met Sleak open?">
    Sluit dubbele tabbladen, open Sleak opnieuw in één tabblad en test opnieuw. Meerdere sessies of oude tabbladen kunnen verwarrend zijn bij het testen.
  </Accordion>

  <Accordion title="Werkt het op een ander apparaat wel?">
    Test dezelfde account op een ander apparaat of in een andere browser. Werkt het daar wel, dan zit het probleem waarschijnlijk in de instellingen van het eerste apparaat.
  </Accordion>

  <Accordion title="Krijg je geen pop-up terwijl je Sleak actief open hebt?">
    Dat is normaal. Een browsermelding verschijnt alleen wanneer het Sleak-tabblad niet je actieve tabblad is. Kijk je actief naar Sleak, dan zie je de chat direct in de inbox in plaats van een pop-up. Test door Sleak open te laten in de browser, maar naar een ander tabblad of programma te wisselen, en vraag dan een testmelding.
  </Accordion>
</AccordionGroup>

## Stuur deze gegevens naar support

Kom je er niet uit? Stuur dan deze gegevens naar support. Daarmee kunnen we sneller zien waar het misgaat.

1. Welk apparaat gebruik je? Bijvoorbeeld Windows computer, Windows laptop, MacBook of iMac
2. Welke browser gebruik je? Bijvoorbeeld Chrome, Edge, Safari of Firefox
3. Werkt het op een ander apparaat wel?
4. Staat **Browser notificaties** aan in Sleak?
5. Heb je notificaties toegestaan in de browser?
6. Heb je notificaties toegestaan in de instellingen van je apparaat?
7. Staat Niet storen of Focus uit?
8. Gebruik je een zakelijke computer die door IT wordt beheerd?
9. Zie je een melding in het berichtencentrum, maar niet als pop-up?
10. Vanaf welke pagina of website verwacht je de notificatie?
11. Voeg indien mogelijk een screenshot toe van de notificatie-instellingen

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# Chats worden niet bewaard na herladen
Source: https://docs.sleak.chat/troubleshooting/cookies

Troubleshooting gids wanneer chatgeschiedenis verdwijnt door een conflict met je Consent Management Platform (CMP)

## Het probleem

Na het herladen van een pagina is de chatgeschiedenis verdwenen. De bezoeker start telkens een nieuw gesprek in plaats van verder te gaan waar hij/zij gebleven was.

Dit wordt bijna altijd veroorzaakt doordat je **Consent Management Platform (CMP)** - zoals Cookiebot, CookieYes, Complianz of OneTrust - de Sleak cookies verwijdert of blokkeert voordat de bezoeker consent geeft.

## De oorzaak

Sleak gebruikt de cookies `sleakVisitorId_{chatbotId}` en `sleakChatId_{chatbotId}` om chatgeschiedenis aan een bezoeker te koppelen. Als je CMP deze cookies niet herkent, worden ze bij het laden van de pagina verwijderd. Het gevolg: de chat kan de bezoeker niet meer identificeren en start opnieuw.

## Oplossing

Voeg beide cookies toe aan je CMP en categoriseer ze als **Functioneel**. Alle specificaties die je hiervoor nodig hebt vind je op de pagina [Cookies en CMP](/installatie/cookies).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ik heb de cookies toegevoegd maar het werkt nog steeds niet">
    Controleer of de cookies daadwerkelijk als **Functioneel** of **Strikt noodzakelijk** zijn gecategoriseerd in je CMP - niet als "Niet geclassificeerd", "Analytisch" of "Marketing". Cookies buiten
    de functionele categorie worden pas geplaatst na consent.
  </Accordion>

  <Accordion title="Hoe controleer ik of de cookies worden verwijderd?">
    1. Open je website in Chrome of Firefox
    2. Open DevTools (`F12` of `Cmd + Option + I`)
    3. Ga naar het tabblad **Application** → **Cookies**
    4. Zoek naar `sleakVisitorId_` en `sleakChatId_`
    5. Herlaad de pagina - als de cookies verdwijnen na het herladen, blokkeert je CMP ze
  </Accordion>

  <Accordion title="Mijn CMP staat niet in deze lijst - wat nu?">
    De stappen zijn voor elke CMP vergelijkbaar: voeg de twee cookies toe en stel de categorie in op **Functioneel**. Raadpleeg de documentatie van je CMP-provider voor specifieke instructies.
  </Accordion>
</AccordionGroup>

***

<CardGroup>
  <Card title="Email Support" icon="envelope" href="mailto:support@sleak.chat">
    [support@sleak.chat](mailto:support@sleak.chat)
  </Card>

  <Card title="Bel ons" icon="phone" href="tel:+31850608199">
    +31 85 060 8199
  </Card>
</CardGroup>


# Foutmeldingen bij het toevoegen van sitemap of productfeed
Source: https://docs.sleak.chat/troubleshooting/sitemap-productfeed-fout

Oplossing voor foutmeldingen bij het toevoegen van sitemaps of productfeeds door Cloudflare Bot Fight Mode

Sommige websites gebruiken **Cloudflare** om verkeer te beveiligen. In dat geval kan het voorkomen dat onze systemen worden geblokkeerd waardoor sitemaps of productfeeds niet (opnieuw) kunnen worden ingelezen.

Gelukkig is dit in de meeste gevallen eenvoudig op te lossen door 'Bot Fight Mode' uit te schakelen.

## Oplossing: Disable Bot Fight Mode

<Steps>
  <Step title="Ga naar op Cloudflare">
    Log in op de Cloudflare en selecteer het juiste account en domein.
  </Step>

  <Step title="Ga naar Security instellingen">
    Ga naar **Security → Bots**.
  </Step>

  <Step title="Schakel Bot Fight Mode uit">
    Schakel **Bot Fight Mode** uit.
  </Step>

  <Step title="Test de oplossing">
    Probeer de sitemap of productfeed opnieuw toe te voegen.
  </Step>
</Steps>

<Info>
  Officiële documentatie van Cloudflare over Bot Fight Mode vind je [hier](https://developers.cloudflare.com/bots/get-started/free/).
</Info>

<Frame>
  <img alt="Cloudflare Bot Fight Mode uitschakelen" />
</Frame>

***

<Note>
  **Hulp nodig?**

  Mocht er iets niet lukken of onduidelijk zijn? Neem gerust contact op met het team van Sleak, zodat we je verder kunnen helpen!
</Note>