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.

De tools inschakelen

Interactieve knoppen verzenden

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

Elke knop heeft:

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.

Elke sectie heeft:

Elke rij heeft:

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:

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 vertelt hem hoe hij ze goed gebruikt.

---
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 berichtengesprekken — 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 om gesprekken te starten.