Ausgehende Nachrichten & Vorlagen

Überblick

Ein Agent kann frei formulierte WhatsApp-Nachrichten nur innerhalb einer aktiven Unterhaltung senden. Um einen Nutzer zuerst zu erreichen — für Benachrichtigungen, erneute Kontaktaufnahme oder geplante Anrufe — senden Sie eine von Meta genehmigte Nachrichtenvorlage. Auf dieser Seite erfahren Sie, wie Sie Vorlagen erstellen, ausgehende Nachrichten und Anrufe senden und dies im großen Umfang durchführen.

Vorlagen im WhatsApp Manager erstellen

Vorlagen werden im WhatsApp Manager erstellt und genehmigt, nicht in ElevenLabs.

Beim Erstellen einer Vorlage:

• Wählen Sie eine Kategorie: Utility für Transaktionsnachrichten, Marketing für Werbenachrichten oder Authentication für Bestätigungscodes. Meta berechnet Preise und begrenzt die Rate für jede Kategorie unterschiedlich — siehe WhatsApp-Preise.
• Wählen Sie ein Parameterformat: positionell ({{1}}, {{2}}) oder benannt ({{customer_name}}). Benannte Parameter erfordern für jeden gesendeten Wert einen parameter_name.
• Reichen Sie die Vorlage zur Genehmigung ein. Die Genehmigung dauert meist Minuten bis Stunden. Eine ausstehende oder abgelehnte Vorlage kann nicht gesendet werden — die API akzeptiert die Anfrage, aber Meta stellt die Nachricht nie zu.

Ausgehende Nachricht senden

Das Senden einer Vorlagennachricht startet eine neue Unterhaltung. Der Agent bleibt still, bis der Nutzer antwortet — die Vorlage selbst ist die erste Nachricht, und es starten keine Unterhaltungstimer, bevor der Nutzer antwortet.

Dashboard

Python

TypeScript

cURL

Öffnen Sie die WhatsApp-Seite, wählen Sie Ihr Konto aus und klicken Sie auf Outbound -> Message. Wählen Sie einen Agenten, geben Sie eine WhatsApp-Nutzer-ID an und wählen Sie die Nachrichtenvorlage sowie ihre Parameter:

Das vollständige Anfrageschema finden Sie in der API-Referenz.

Vorlagenparameter

template_params ist eine Liste von Komponenten-Objekten, eines für jede Vorlagenkomponente mit Parametern:

• {"type": "body", "parameters": [...]} für Platzhalter im Nachrichtentext
• {"type": "header", "parameters": [...]} für einen parametrisierten Header (Text, Bild, Dokument oder Standort)
• {"type": "button", "sub_type": ..., "index": ..., "parameters": [...]} für Schaltflächenparameter

Jeder Eintrag in parameters ist ein Wertobjekt wie {"type": "text", "text": "Daniele"}. Fügen Sie bei Vorlagen mit benannten Parametern für jeden Wert parameter_name ein. Das Weglassen des Komponenten-Wrappers — wenn Sie beispielsweise {"type": "text", ...} direkt in template_params übergeben — wird abgelehnt.

Format der Empfängernummer

whatsapp_user_id darf nur Ziffern enthalten: die Ländervorwahl gefolgt von der Nummer, ohne +, Leerzeichen oder Bindestriche. Beispiel: 14155552671, nicht +1 (415) 555-2671.

Dynamische Variablen, Branches und Umgebungen

Mit dem Feld conversation_initiation_client_data können Sie dynamische Variablen für die Unterhaltung festlegen und sie an einen bestimmten Agent-Branch und eine Umgebung binden:

{
  "dynamic_variables": { "customer_name": "Daniele" },
  "branch_id": "agtbrch_8721kwarbs83e233mg1fzkaf9pg0",
  "environment": "staging"
}

Diese Einstellungen bleiben für die Unterhaltung bestehen: Wenn der Nutzer antwortet, setzt der Agent die Unterhaltung im angeforderten Branch und in der angeforderten Umgebung fort. Branch und Umgebung werden zuerst validiert — falls eines davon nicht existiert, schlägt die Anfrage mit einem Fehler fehl und es wird keine Nachricht gesendet.

Über dieses Anfragefeld erhalten ausgehende Unterhaltungen dynamische Variablen; eingehende Unterhaltungen erhalten sie stattdessen über einen Webhook zur Gesprächsinitialisierung — siehe Initialisierungskontext.

Nach dem Senden

Eine erfolgreiche Anfrage gibt eine conversation_id zurück und die Unterhaltung erscheint in Ihrem Verlauf, mit der gerenderten Vorlage als erster Nachricht. Der Agent wird erst ausgeführt, wenn der Nutzer antwortet. Durch das Senden der Vorlage starten weder der Timer für die maximale Dauer noch der Inaktivitätstimer; beide beginnen, sobald die Unterhaltung fortgesetzt wird. Eine 200-Antwort bedeutet, dass ElevenLabs die Anfrage akzeptiert hat — Meta kann die Zustellung danach dennoch ablehnen. Wenn die Nachricht nie ankommt, lesen Sie Fehlerbehebung.

Ausgehenden Anruf planen

Ausgehende WhatsApp-Anrufe erfordern die Zustimmung des Nutzers — siehe Nutzerberechtigungen für Anrufe. Erstellen Sie im WhatsApp Manager eine Nachrichtenvorlage mit einer Komponente für eine Anrufberechtigungsanfrage. Wenn Sie einen Anruf planen, prüft ElevenLabs den Berechtigungsstatus:

• Berechtigung bereits erteilt: Der Anruf wird sofort aufgebaut.
• Berechtigung noch nicht angefragt: Die Vorlage für die Berechtigungsanfrage wird gesendet und der Anruf wird aufgebaut, sobald der Nutzer zustimmt.
• Berechtigung abgelehnt: Die Unterhaltung wird mit dem Grund User declined the call permission request. als fehlgeschlagen erfasst.

Dashboard

Python

TypeScript

cURL

Öffnen Sie die WhatsApp-Seite, wählen Sie Ihr Konto aus und klicken Sie auf Outbound -> Call. Wählen Sie einen Agenten, geben Sie eine WhatsApp-Nutzer-ID an und wählen Sie die Vorlage für die Anrufberechtigungsanfrage:

Das vollständige Anfrageschema finden Sie in der API-Referenz. Wie bei ausgehenden Nachrichten legt conversation_initiation_client_data dynamische Variablen fest und bindet die Unterhaltung an einen Branch und eine Umgebung. Ein unbekannter Branch oder eine unbekannte Umgebung wird abgelehnt, bevor der Anruf geplant wird.

Kampagnen und Stapelverarbeitung

Um viele Nutzer anzurufen, verwenden Sie Stapelanrufe mit whatsapp_params: Geben Sie die Telefonnummer-ID und die Vorlage für die Anrufberechtigungsanfrage einmal an sowie eine whatsapp_user_id pro Empfänger.

Es gibt noch keinen nativen Batch-Endpunkt für ausgehende Nachrichten. Rufen Sie für Vorlagenkampagnen den Endpunkt für ausgehende Nachrichten einmal pro Empfänger auf und halten Sie die Messaging-Limits von Meta für Ihre Nummer ein — siehe Messaging-Limits.