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

# WhatsApp-Tools

## Überblick

Sie können Ihrem Agenten ein Tool geben, mit dem er Nachrichten über WhatsApp senden kann, auch während Unterhaltungen über einen anderen Kanal (z. B. Telefon).

Die WhatsApp-Integration bietet drei Tools:

* **Nachricht senden** — sendet eine Vorlagennachricht an jeden WhatsApp-Nutzer. Funktioniert über jeden Kanal, sodass ein Telefonagent dem Anrufer beispielsweise eine Bestätigung über WhatsApp senden kann. Auf dieser Seite wird dieses Tool behandelt.
* **Interaktive Schaltflächen senden** und **Interaktive Liste senden** — bieten dem Nutzer einer aktiven WhatsApp-Unterhaltung antippbare Auswahlmöglichkeiten. Diese funktionieren nur innerhalb von WhatsApp-Nachrichtenunterhaltungen — siehe [Interaktive Nachrichten](/docs/de/eleven-agents/whatsapp/interactive-messages).

## Einrichtung

#### Ihr Konto importieren

Folgen Sie den Anweisungen [hier](/docs/de/eleven-agents/whatsapp), um Ihr WhatsApp-Business-
Konto zu importieren.

#### Integration hinzufügen

Öffnen Sie die [Integrationsseite](https://elevenlabs.io/app/agents/integrations), klicken Sie auf **\_Add
integration \_**, wählen Sie WhatsApp aus und verbinden Sie Ihr Konto:

![WhatsApp-Integration](/docs/_fern-img/e560b1b2a4345bd2fbe9519f7146b87d195268955d2b2aa2c6221629d97e4384.webp)

#### Tool hinzufügen

Öffnen Sie die [Toolseite](https://elevenlabs.io/app/agents/tools), klicken Sie auf **\_Add integration
tool \_**, wählen Sie die WhatsApp-Integration und das Tool **\_ Send Message \_**:

![WhatsApp-Tool](/docs/_fern-img/e85dcc3a3e3581250604311c516e080fb7f61f100b98b4b55be5f6071866e888.webp)

## Tool verwenden

#### Nachrichtenvorlage erstellen

Öffnen Sie den [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/), öffnen Sie die
Seite ***Manage templates*** und erstellen Sie eine Nachrichtenvorlage:

![WhatsApp-Nachrichtenvorlage](/docs/_fern-img/e2d2c8bcab0b4c664261a57658627fd4368fc00e4768e4bd4c16264c59d07e16.webp)

> **Info**
>
> Das Tool unterstützt derzeit nur Parameter im Nachrichtentext.

#### Ihren Agenten konfigurieren

Öffnen Sie die Konfiguration Ihres Agenten und fügen Sie das Tool hinzu:

![Agentenkonfiguration: Tools](/docs/_fern-img/0e078a4206030111493387ec6c9bc2235106ac3cb763d4555dd1ae7307c6d46a.webp)

Teilen Sie dem Agenten im System-Prompt mit:

* wann er das Tool verwenden soll
* welchen Vorlagennamen und Sprachcode er verwenden soll
* welche Parameter er übergeben soll

![Agentenkonfiguration: Prompt](/docs/_fern-img/893aa34f7bd3e01a0cbb919f08f801398de318d46e1d8d1a6c72a945193f7de9.webp)

#### Testen

Testen Sie die Tool-Konfiguration:

![Testunterhaltung](/docs/_fern-img/47d48232a04cd47112d5637288c6225761f7f66f3016f5fc7d9cf38a34b3782d.webp)![Testnachricht empfangen](/docs/_fern-img/6b3809101caa5d38cf7ea761feb38f4ee316bfde4bef20e2e22eca6b14d0262f.webp)

## Parameter und Sprachcodes

Das Tool füllt nur die **Text**-Parameter der Vorlage aus — Vorlagen mit parametrisierten Headern oder Schaltflächen werden von diesem Tool nicht unterstützt. Der Empfänger ist eine WhatsApp-Nutzer-ID: nur Ziffern, mit Ländervorwahl und ohne `+` (z. B. `14155552671`) — länderspezifische Hinweise finden Sie in den [Regeln zum Format der Empfängernummer](/docs/de/eleven-agents/whatsapp/outbound#recipient-number-format).

Der Sprachcode der Vorlage muss mit der Sprache übereinstimmen, mit der die Vorlage im WhatsApp Manager erstellt wurde — siehe [unterstützte Sprachcodes](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/supported-languages/). Ein häufiger Fehler ist, `en` für eine Vorlage zu übergeben, die als `en_US` erstellt wurde (oder umgekehrt); Meta behandelt diese als unterschiedliche Vorlagen.

## Fehlerbehebung

* **Vorlage nicht gefunden**: Der Vorlagenname oder Sprachcode stimmt nicht genau mit dem WhatsApp Manager überein oder die Vorlage gehört zu einem anderen WhatsApp-Business-Konto als dem verbundenen.
* **Nachricht akzeptiert, aber nicht zugestellt**: Die Vorlage ist nicht genehmigt, ein Textparameter fehlt oder es gibt Zahlungsprobleme mit dem Konto — siehe [Fehlerbehebung und FAQ](/docs/de/eleven-agents/whatsapp/troubleshooting#message-accepted-but-not-delivered).
* **Der Agent übergibt falsche Parameter**: Geben Sie im System-Prompt die genauen Parameternamen und erwarteten Werte der Vorlage an und stellen Sie einen Beispielaufruf bereit.