> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Interactieve berichten

## Overzicht

In plaats van de gebruiker te vragen een antwoord te typen, kan je agent WhatsApp-**interactieve berichten** versturen: maximaal drie tikbare antwoordknoppen of een lijst met maximaal tien opties. De tikactie van de gebruiker komt terug als het volgende bericht en de agent ziet precies welke optie is gekozen.

Interactieve berichten werken alleen in actieve WhatsApp-berichtengesprekken. De agent verstuurt ze via twee integratietools:

* **Interactieve knoppen verzenden** — maximaal drie antwoordknoppen, voor kleine reeksen keuzes.
* **Interactieve lijst verzenden** — een tikbare lijst met opties, gegroepeerd in secties, voor meer dan drie keuzes.

Bron: [Meta's handleiding voor interactieve WhatsApp-berichten](https://developers.facebook.com/docs/whatsapp/guides/interactive-messages/).

## De tools inschakelen

#### Voeg de WhatsApp-integratie toe

Importeer je WhatsApp-bedrijfsaccount ([instructies](/docs/nl/eleven-agents/whatsapp)) en ga vervolgens naar
de [pagina Integraties](https://elevenlabs.io/app/agents/integrations), klik op de knop **\_Integratie
toevoegen \_**, selecteer WhatsApp en verbind je account.

#### Voeg de tools toe

Ga naar de [pagina Tools](https://elevenlabs.io/app/agents/tools), klik op de knop **\_Integratietool
toevoegen \_**, selecteer de WhatsApp-integratie en voeg de tools **\_ Interactieve knoppen verzenden \_** en
***Interactieve lijst verzenden*** toe.

> **Warning**
>
> Als je meer dan één WhatsApp-account hebt geïmporteerd, heeft elk account een eigen WhatsApp-integratie.
> Zorg dat je de tools toevoegt vanuit de integratie die is verbonden met het account dat je agent gebruikt —
> tools die zijn toegevoegd vanuit de integratie van een ander account werken niet voor de
> gesprekken van deze agent.

#### Koppel de tools aan je agent

Voeg de tools toe aan je agentconfiguratie. De tools sturen altijd een bericht naar de gebruiker van het actieve
gesprek — de agent kiest de inhoud, nooit de ontvanger.

## Interactieve knoppen verzenden

**Interactieve knoppen verzenden** toont één tot drie keuzes in het huidige WhatsApp-berichtengesprek.

| Parameter     | Vereist | Beschrijving                                                         |
| ------------- | ------- | -------------------------------------------------------------------- |
| `body_text`   | Ja      | Bericht dat boven de knoppen wordt getoond. Max. 1024 tekens.        |
| `buttons`     | Ja      | Eén tot drie knoppen, in weergavevolgorde. Titels moeten uniek zijn. |
| `footer_text` | Nee     | Kleine tekst onder de knoppen. Max. 60 tekens.                       |

Elke knop heeft:

| Veld    | Vereist | Beschrijving                                                                        |
| ------- | ------- | ----------------------------------------------------------------------------------- |
| `id`    | Ja      | ID die wordt teruggestuurd wanneer de gebruiker op deze knop tikt. Max. 256 tekens. |
| `title` | Ja      | Knoplabel. Max. 20 tekens.                                                          |

## Een interactieve lijst verzenden

**Interactieve lijst verzenden** toont opties die in secties zijn gegroepeerd in het huidige WhatsApp-berichtengesprek. De gebruiker opent de lijst en selecteert een rij.

| Parameter     | Vereist | Beschrijving                                                                                       |
| ------------- | ------- | -------------------------------------------------------------------------------------------------- |
| `body_text`   | Ja      | Bericht dat boven de lijst wordt getoond. Max. 4096 tekens.                                        |
| `button_text` | Ja      | Label van de knop die de lijst opent. Max. 20 tekens.                                              |
| `sections`    | Ja      | Eén tot 10 groepen met opties. Een lijst kan in totaal maximaal 10 rijen in alle secties bevatten. |
| `header_text` | Nee     | Kop die boven de berichttekst wordt getoond. Max. 60 tekens.                                       |
| `footer_text` | Nee     | Kleine tekst onder de lijst. Max. 60 tekens.                                                       |

Elke sectie heeft:

| Veld    | Vereist | Beschrijving                      |
| ------- | ------- | --------------------------------- |
| `title` | Ja      | Sectiekop. Max. 24 tekens.        |
| `rows`  | Ja      | Eén tot 10 opties in deze sectie. |

Elke rij heeft:

| Veld          | Vereist | Beschrijving                                                                     |
| ------------- | ------- | -------------------------------------------------------------------------------- |
| `id`          | Ja      | ID die wordt teruggestuurd wanneer de gebruiker deze rij kiest. Max. 200 tekens. |
| `title`       | Ja      | Rijlabel. Max. 24 tekens.                                                        |
| `description` | Nee     | Secundaire tekst onder het rijlabel. Max. 72 tekens.                             |

Als de agent inhoud produceert die een limiet overschrijdt, mislukt de toolaanroep en krijgt de agent te horen waarom, zodat hij het opnieuw kan proberen met kortere inhoud.

## De agent prompten

Vertel de agent in de systeemprompt wanneer hij keuzes moet aanbieden. Bijvoorbeeld:

```text
When you need the user to pick from a fixed set of options (appointment slots,
product variants, yes/no confirmations), use the Send Interactive Buttons tool
for up to 3 options or the Send Interactive List tool for more. Keep option
titles short. Do not use interactive messages for open-ended questions.
```

### Optioneel: voeg een procedure toe om het toolgebruik van de agent te sturen

De agent de tools geven is de helft van het werk — een [procedure](/docs/nl/eleven-agents/customization/procedures) vertelt hem hoe hij ze goed gebruikt.

> **Note**
>
> De onderstaande procedure is een template, geen kant-en-klare oplossing. Maak deze na het kopiëren eigen: pas de
> trigger aan je flows aan, behoud alleen de tools die je agent daadwerkelijk heeft en herschrijf de voorbeelden en
> regels voor opties zodat ze bij je use case passen.

#### Kopieer de voorbeeldprocedure

```markdown
---
name: Offer choices with interactive messages
trigger: The user must pick from a fixed set of known options in a WhatsApp message conversation, such as appointment slots, product variants, or order confirmations.
---

Offer the options as an interactive message instead of asking the user
to type an answer.

1. Check which interactive tools you have. Prefer Send Interactive
   Buttons for 2–3 options and Send Interactive List for 4–10. If only
   one of the two is available, use it for any option count that fits its
   limits; if no interactive tool fits, ask the question in plain text.
   Never present more than 10 options; narrow them down with a question
   first.
2. Write a body_text that asks one clear question. Do not stack multiple
   questions into one interactive message.
3. Give every option a stable, machine-readable id (for example
   slot_2026-08-20_10am) and a short human title — 20 characters for
   buttons, 24 for list rows.
4. For lists, group related rows into titled sections, and add a
   description to a row only when its title alone is ambiguous.
5. Send the message with the tool, then wait for the user's reply. Do not
   send a second interactive message before the user responds to the first.
6. Treat the reply as the user's choice. Confirm it back in one short line
   and continue the flow.

Rules:

- Never use interactive messages for open-ended questions.
- When the fixed options may not cover everyone, include a final option
  such as "Something else" and follow up with a free-text question.
- If the tool call fails because content exceeds a limit, shorten titles
  and descriptions and retry once.
- If the user types an answer instead of tapping, accept it — do not
  re-send the options.
```

## Beperkingen

* Interactieve berichten kunnen alleen worden verstuurd in **bericht**engesprekken — niet tijdens WhatsApp-spraakoproepen en niet op andere kanalen.
* WhatsApp Flows (interactieve formulieren) worden niet ondersteund. Als een gebruiker reageert met een Flow-antwoord, wordt dit niet aan de agent doorgegeven.
* Interactieve berichten zijn sessieberichten: ze kunnen alleen binnen een actief gesprek worden verstuurd, niet als eerste uitgaande contact. Gebruik [berichttemplates](/docs/nl/eleven-agents/whatsapp/outbound) om gesprekken te starten.