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

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

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 src="https://mintcdn.com/sleak/Iu3uNnJWw8e-16hu/images/returnless/return_status_cards.png?fit=max&auto=format&n=Iu3uNnJWw8e-16hu&q=85&s=a49df712dc32fd7b0cc0bf085be5f497" alt="Returnless statuskaart in de Sleak widget" width="6808" height="4612" data-path="images/returnless/return_status_cards.png" />
</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 src="https://mintcdn.com/sleak/e9jzwc3AphRy1sKl/images/returnless/returnless_groups.png?fit=max&auto=format&n=e9jzwc3AphRy1sKl&q=85&s=8db0a84dd92b9766cae984978a4718ea" alt="Returnless statusgroepen op de statuskaart" width="4640" height="2488" data-path="images/returnless/returnless_groups.png" />
</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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.