> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sleak.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 src="https://mintcdn.com/sleak/2zUtwoPt5u-BSpEu/images/returnless/returnless_dashboard_addintegration.png?fit=max&auto=format&n=2zUtwoPt5u-BSpEu&q=85&s=34b87bfb061c3d0ec8d356b6a69a7423" alt="Nieuwe integratie toevoegen in Returnless" width="2674" height="1529" data-path="images/returnless/returnless_dashboard_addintegration.png" />
    </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 src="https://mintcdn.com/sleak/2zUtwoPt5u-BSpEu/images/returnless/sleak_dashboard_confirm_returnless.png?fit=max&auto=format&n=2zUtwoPt5u-BSpEu&q=85&s=e9e4fb500caf674922ba45051b606c4e" alt="Returnless statuskaart in de Sleak widget" width="2674" height="1529" data-path="images/returnless/sleak_dashboard_confirm_returnless.png" />
    </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 instellingen

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

<Frame caption="Let op - Met de aanstaande release (Q3 '26) van het nieuwe dashboard 2.0 zal dit veranderen.">
  <img src="https://mintcdn.com/sleak/2zUtwoPt5u-BSpEu/images/returnless/sleak_dashboard_returnless_action_settings.png?fit=max&auto=format&n=2zUtwoPt5u-BSpEu&q=85&s=3cbd29459bf17f30b622fac06da106e6" alt="Returnless actie instellingen in het Sleak dashboard" width="2674" height="1529" data-path="images/returnless/sleak_dashboard_returnless_action_settings.png" />
</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

Als emailvalidatie is ingeschakeld, vraagt de agent de klant altijd om het emailadres waarmee de bestelling is geplaatst - voordat de retourstatus wordt opgehaald. Het opgeven van een email is dan vereist en moet daarnaast ook 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. Je kunt emailvalidatie aan- of uitzetten in de actie instellingen.

***

## 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 bij ingeschakelde emailvalidatie ook 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.

### 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 src="https://mintcdn.com/sleak/2zUtwoPt5u-BSpEu/images/returnless/return_status_cards.png?fit=max&auto=format&n=2zUtwoPt5u-BSpEu&q=85&s=fc7833ead8e1ac145c0a0e5fdf731524" alt="Returnless statuskaart in de Sleak widget" width="6808" height="4612" data-path="images/returnless/return_status_cards.png" />
</Frame>

| Status           | Beschrijving                            |
| ---------------- | --------------------------------------- |
| **Aangekondigd** | Retour is aangemeld, nog niet verzonden |
| **Verstuurd**    | Pakket is onderweg naar de webshop      |
| **Ontvangen**    | Pakket is aangekomen in het magazijn    |
| **Goedgekeurd**  | Retour is verwerkt en goedgekeurd       |
| **Betaald**      | Terugbetaling is uitgevoerd             |

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 tehoeven zoeken door het order- of retournummer automatisch door te geven aan de agent via de **custom fields** feature. 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>

***

## 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>
