Interaktive Nachrichten

Überblick

Statt den Nutzer um eine getippte Antwort zu bitten, kann Ihr Agent interaktive WhatsApp-Nachrichten senden: bis zu drei antippbare Antwortschaltflächen oder eine Liste mit bis zu zehn Optionen. Das Antippen des Nutzers wird als seine nächste Nachricht zurückgesendet, und der Agent erkennt genau, welche Option ausgewählt wurde.

Interaktive Nachrichten funktionieren nur in aktiven WhatsApp-Nachrichtenunterhaltungen. Der Agent sendet sie über zwei Integrationstools:

• Interaktive Schaltflächen senden — bis zu drei Antwortschaltflächen für kleine Auswahlmengen.
• Interaktive Liste senden — eine antippbare, in Abschnitte gegliederte Optionsliste für mehr als drei Auswahlmöglichkeiten.

Quelle: Metas Leitfaden zu interaktiven WhatsApp-Nachrichten.

Tools aktivieren

Interaktive Schaltflächen senden

Interaktive Schaltflächen senden zeigt in der aktuellen WhatsApp-Nachrichtenunterhaltung ein bis drei Auswahlmöglichkeiten an.

Jede Schaltfläche enthält:

Interaktive Liste senden

Interaktive Liste senden zeigt Optionen, gruppiert in Abschnitte, in der aktuellen WhatsApp-Nachrichtenunterhaltung an. Der Nutzer öffnet die Liste und wählt eine Zeile aus.

Jeder Abschnitt enthält:

Jede Zeile enthält:

Wenn der Agent Inhalte über einem Limit erzeugt, schlägt der Tool-Aufruf fehl. Der Agent erfährt den Grund und kann es mit kürzeren Inhalten erneut versuchen.

Den Agenten prompten

Teilen Sie dem Agenten im System-Prompt mit, wann er Auswahlmöglichkeiten anbieten soll. Zum Beispiel:

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.

Optional: Eine Prozedur hinzufügen, um die Tool-Nutzung des Agenten zu steuern

Dem Agenten die Tools zu geben, ist nur die halbe Arbeit — eine Prozedur erklärt ihm, wie er sie gut einsetzt.

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

Einschränkungen

• Interaktive Nachrichten können nur in Nachrichtenunterhaltungen gesendet werden — nicht während WhatsApp-Sprachanrufen und nicht auf anderen Kanälen.
• WhatsApp Flows (interaktive Formulare) werden nicht unterstützt. Wenn ein Nutzer mit einer Flow-Antwort reagiert, wird diese nicht an den Agenten weitergegeben.
• Interaktive Nachrichten sind Sitzungsnachrichten: Sie können nur innerhalb einer aktiven Unterhaltung gesendet werden, nicht als erster ausgehender Kontakt. Nutzen Sie Nachrichtenvorlagen, um Unterhaltungen zu starten.