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

# 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](https://developers.facebook.com/docs/whatsapp/guides/interactive-messages/).

## Tools aktivieren

#### WhatsApp-Integration hinzufügen

Importieren Sie Ihr WhatsApp-Business-Konto ([Anleitung](/docs/de/eleven-agents/whatsapp)) und gehen Sie dann zur
[Integrationsseite](https://elevenlabs.io/app/agents/integrations). Klicken Sie auf **\_Integration
hinzufügen \_**, wählen Sie WhatsApp aus und verbinden Sie Ihr Konto.

#### Tools hinzufügen

Gehen Sie zur [Tools-Seite](https://elevenlabs.io/app/agents/tools), klicken Sie auf **\_Integrationstool
hinzufügen \_**, wählen Sie die WhatsApp-Integration aus und fügen Sie die Tools **\_ Interaktive Schaltflächen senden \_** und
***Interaktive Liste senden*** hinzu.

> **Warning**
>
> Wenn Sie mehr als ein WhatsApp-Konto importiert haben, besitzt jedes eine eigene WhatsApp-Integration.
> Stellen Sie sicher, dass Sie die Tools aus der Integration hinzufügen, die mit dem Konto verbunden ist, das Ihr Agent verwendet —
> Tools aus der Integration eines anderen Kontos funktionieren nicht für die
> Unterhaltungen dieses Agenten.

#### Tools an Ihren Agenten anhängen

Fügen Sie die Tools in Ihrer Agentenkonfiguration hinzu. Die Tools senden immer Nachrichten an den Nutzer der aktiven
Unterhaltung — der Agent wählt den Inhalt, niemals den Empfänger.

## Interaktive Schaltflächen senden

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

| Parameter     | Erforderlich | Beschreibung                                                                   |
| ------------- | ------------ | ------------------------------------------------------------------------------ |
| `body_text`   | Ja           | Nachricht über den Schaltflächen. Maximal 1024 Zeichen.                        |
| `buttons`     | Ja           | Ein bis drei Schaltflächen in Anzeigereihenfolge. Titel müssen eindeutig sein. |
| `footer_text` | Nein         | Kleingedrucktes unter den Schaltflächen. Maximal 60 Zeichen.                   |

Jede Schaltfläche enthält:

| Feld    | Erforderlich | Beschreibung                                                                                       |
| ------- | ------------ | -------------------------------------------------------------------------------------------------- |
| `id`    | Ja           | Kennung, die zurückgemeldet wird, wenn der Nutzer diese Schaltfläche antippt. Maximal 256 Zeichen. |
| `title` | Ja           | Beschriftung der Schaltfläche. Maximal 20 Zeichen.                                                 |

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

| Parameter     | Erforderlich | Beschreibung                                                                                           |
| ------------- | ------------ | ------------------------------------------------------------------------------------------------------ |
| `body_text`   | Ja           | Nachricht über der Liste. Maximal 4096 Zeichen.                                                        |
| `button_text` | Ja           | Beschriftung der Schaltfläche zum Öffnen der Liste. Maximal 20 Zeichen.                                |
| `sections`    | Ja           | Eine bis 10 Optionsgruppen. Eine Liste kann insgesamt bis zu 10 Zeilen über alle Abschnitte enthalten. |
| `header_text` | Nein         | Überschrift über dem Nachrichtentext. Maximal 60 Zeichen.                                              |
| `footer_text` | Nein         | Kleingedrucktes unter der Liste. Maximal 60 Zeichen.                                                   |

Jeder Abschnitt enthält:

| Feld    | Erforderlich | Beschreibung                               |
| ------- | ------------ | ------------------------------------------ |
| `title` | Ja           | Abschnittsüberschrift. Maximal 24 Zeichen. |
| `rows`  | Ja           | Eine bis 10 Optionen in diesem Abschnitt.  |

Jede Zeile enthält:

| Feld          | Erforderlich | Beschreibung                                                                                 |
| ------------- | ------------ | -------------------------------------------------------------------------------------------- |
| `id`          | Ja           | Kennung, die zurückgemeldet wird, wenn der Nutzer diese Zeile auswählt. Maximal 200 Zeichen. |
| `title`       | Ja           | Zeilenbeschriftung. Maximal 24 Zeichen.                                                      |
| `description` | Nein         | Sekundärtext unter der Zeilenbeschriftung. Maximal 72 Zeichen.                               |

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:

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

### 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](/docs/de/eleven-agents/customization/procedures) erklärt ihm, wie er sie gut einsetzt.

> **Note**
>
> Die folgende Prozedur ist eine Vorlage, keine sofort einsetzbare Lösung. Passen Sie sie nach dem Kopieren an: Richten Sie den
> Auslöser an Ihren Abläufen aus, behalten Sie nur die Tools, die Ihr Agent tatsächlich hat, und überarbeiten Sie die Optionen,
> Beispiele und Regeln für Ihren Anwendungsfall.

#### Beispielprozedur kopieren

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

## Einschränkungen

* Interaktive Nachrichten können nur in **Nachrichten**unterhaltungen 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](/docs/de/eleven-agents/whatsapp/outbound), um Unterhaltungen zu starten.