> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telli.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp Business

> WhatsApp-Templates über Agenten und Workflows in telli senden

Mit WhatsApp Business kannst du freigegebene WhatsApp-Templates über Agenten und Workflows senden. Nutze WhatsApp, wenn Kontakte Updates per WhatsApp erwarten, wenn Zustell- und Lesestatus wichtig sind oder wenn ein Template-basiertes Follow-up besser passt als eine SMS.

<Note>
  WhatsApp Business ist derzeit als Beta verfügbar. Die Integration, das Agent-Tool und die Workflow-Aktion sind nur sichtbar, wenn WhatsApp für deinen Account aktiviert ist.
</Note>

## Voraussetzungen

Du benötigst:

* Admin-Zugriff auf das Meta Business, zu dem das WhatsApp-Business-Konto gehört.
* Ein WhatsApp-Business-Konto und eine Telefonnummer, die für die offizielle WhatsApp Business Platform verwendet werden können.
* Die Berechtigung, während des Meta-Setups `whatsapp_business_management` und `whatsapp_business_messaging` zu gewähren.
* Mindestens ein in Meta freigegebenes WhatsApp-Template, bevor du WhatsApp-Nachrichten in telli konfigurierst.
* Einen Kontakt mit gültiger Telefonnummer.
* Die Einwilligung des Kontakts zur Kontaktaufnahme per WhatsApp.

## WhatsApp Business verbinden

Verbinde WhatsApp Business, bevor du WhatsApp-Nachrichten über Agenten und Workflows verwendest. telli nutzt Meta Embedded Signup, um dein WhatsApp-Business-Konto zu verbinden, die ausgewählte Telefonnummer zu registrieren und freigegebene Templates aus Meta zu laden.

<Steps>
  <Step title="WhatsApp-Einstellungen öffnen">
    Gehe in telli zu **Settings** > **Integrations** > **WhatsApp Business**.
  </Step>

  <Step title="Mit Facebook fortfahren">
    Klicke auf **Continue with Facebook** und melde dich mit einem Meta-Account an, der das WhatsApp-Business-Konto administrieren kann.
  </Step>

  <Step title="Business und Telefonnummer auswählen">
    Wähle im Meta-Setup-Dialog das Meta Business, das WhatsApp-Business-Konto und die Telefonnummer aus, die telli verwenden soll.
  </Step>

  <Step title="Zu telli zurückkehren">
    Lass den telli-Tab geöffnet, während die Einrichtung abgeschlossen wird. telli speichert die Verbindung und registriert die ausgewählte Telefonnummer.
  </Step>

  <Step title="Aktive Telefonnummer prüfen">
    Die WhatsApp-Business-Integrationsseite zeigt verbundene Telefonnummern und ihren Status. Die Telefonnummer muss **Active** sein, bevor Agenten oder Workflows WhatsApp-Nachrichten senden können.
  </Step>
</Steps>

## Zwei-Schritt-Verifizierung deaktivieren

Wenn Meta meldet, dass für die ausgewählte Telefonnummer die Zwei-Schritt-Verifizierung aktiviert ist, zeigt telli eine Warnung mit einem Link zum WhatsApp Manager an.

<Steps>
  <Step title="WhatsApp Manager öffnen">
    Klicke in der Warnung in telli auf **Open Manager**.
  </Step>

  <Step title="Zwei-Schritt-Verifizierung deaktivieren">
    Deaktiviere im WhatsApp Manager die Zwei-Schritt-Verifizierung für die ausgewählte Telefonnummer.
  </Step>

  <Step title="Registrierung erneut versuchen">
    Kehre zu telli zurück und klicke auf **Retry registration**. Verwende denselben Setup-Ablauf, statt eine neue Verbindung zu starten.
  </Step>
</Steps>

## Weitere Telefonnummer hinzufügen

Nachdem die erste Telefonnummer verbunden ist, klicke auf der WhatsApp-Business-Integrationsseite auf **Add phone number** und wiederhole Embedded Signup. telli listet alle verbundenen WhatsApp-Telefonnummern auf der Detailseite der Integration.

## Templates verwalten

WhatsApp-Templates werden in Meta verwaltet. In den Dialogen für WhatsApp-Tools und Workflow-Aktionen zeigt telli den Link **Manage templates**, wenn der verbundene Meta-Account verfügbar ist.

Nachdem ein Template in Meta freigegeben wurde, wähle es in einem Agent-Tool oder einer Workflow-Aktion aus, wähle die Sprache, prüfe die Vorschau und ordne mögliche Template-Felder Daten aus telli zu.

## WhatsApp aus einem Agenten senden

Verwende ein WhatsApp-Tool im Agenten, wenn der Agent während eines laufenden Anrufs ein konfiguriertes Template senden soll, zum Beispiel eine Terminerinnerung, Bestätigung oder einen Follow-up-Link.

<Steps>
  <Step title="Agenten öffnen">
    Öffne den Agenten, den du bearbeiten möchtest, und gehe im Builder-Seitenbereich zum Bereich für Tools.
  </Step>

  <Step title="WhatsApp-Tool hinzufügen">
    Klicke unter **WhatsApp** auf **Add WhatsApp tool**.
  </Step>

  <Step title="Label hinzufügen">
    Gib der Nachricht ein Label, zum Beispiel `appointment_reminder` oder `booking_link`. Labels müssen mit einem Buchstaben oder Unterstrich beginnen und dürfen Buchstaben, Zahlen und Unterstriche enthalten.
  </Step>

  <Step title="Absender auswählen">
    Wähle die aktive WhatsApp-Business-Telefonnummer aus, von der die Nachricht gesendet werden soll.
  </Step>

  <Step title="Template auswählen">
    Wähle ein freigegebenes Meta-Template und die Sprache aus. Wenn das Template Felder enthält, prüfe die Vorschau und ordne jedes Feld einem Kontaktwert oder einem festen Wert zu.
  </Step>

  <Step title="Tool im Prompt verwenden">
    Füge die WhatsApp-Tool-Referenz in den Prompt ein, zum Beispiel `@sendWhatsApp:appointment_reminder`, und beschreibe, wann der Agent sie senden soll.
  </Step>
</Steps>

Der Agent kann nur die WhatsApp-Templates senden, die du konfigurierst. Dadurch bleiben ausgehende Nachrichten vorhersehbar und entsprechen der Template-Freigabe in Meta.

## WhatsApp aus einem Workflow senden

Verwende die Workflow-Aktion **Send WhatsApp**, wenn telli einem Kontakt automatisch eine Nachricht senden soll.

<Steps>
  <Step title="Workflow erstellen oder öffnen">
    Gehe zu **Workflows** und erstelle einen Workflow oder öffne einen vorhandenen Entwurf.
  </Step>

  <Step title="Trigger auswählen">
    Wähle das Ereignis aus, das den Workflow starten soll. WhatsApp eignet sich besonders gut nach **Anruf beendet**- und kontaktbasierten Triggern.
  </Step>

  <Step title="Send WhatsApp hinzufügen">
    Füge nach dem Trigger oder nach einer Bedingung einen Aktionsblock **Send WhatsApp** hinzu.
  </Step>

  <Step title="Absender auswählen">
    Wähle die aktive WhatsApp-Business-Telefonnummer aus, von der die Nachricht gesendet werden soll.
  </Step>

  <Step title="Template auswählen und Felder zuordnen">
    Wähle ein freigegebenes Template und die Sprache aus, prüfe die Vorschau und ordne Template-Felder anschließend Workflow-Daten oder festen Werten zu.
  </Step>

  <Step title="Veröffentlichen und testen">
    Veröffentliche den Workflow und führe ihn manuell mit einem aktuellen Anruf oder Kontakt aus, bevor du automatische Versandvorgänge nutzt.
  </Step>
</Steps>

Siehe [Workflows](../platform/workflows) für den vollständigen Ablauf zum Veröffentlichen und Überwachen von Workflow-Ausführungen.

## WhatsApp-Aktivität prüfen

WhatsApp-Konversationen erscheinen in **Conversations** neben Anrufen und SMS, wenn WhatsApp für deinen Account aktiviert ist. Öffne eine Konversation, um den Nachrichtenverlauf und den Zustellstatus zu sehen.

WhatsApp-Aktivität erscheint außerdem in der Kontakt-Zeitleiste, damit du Follow-ups neben Anrufen und geplanten Aktivitäten des Kontakts prüfen kannst.

Diese Zustellstatus sind möglich:

| Status      | Bedeutung                                                                |
| :---------- | :----------------------------------------------------------------------- |
| `queued`    | telli hat die Nachricht an Meta übergeben und sie wartet auf den Versand |
| `sent`      | Meta hat die Nachricht akzeptiert und gesendet                           |
| `delivered` | WhatsApp hat die Zustellung an den Empfänger gemeldet                    |
| `read`      | Der Empfänger hat die Nachricht gelesen                                  |
| `failed`    | Der Versand ist vor der Zustellung fehlgeschlagen                        |

Eingehende Antworten von bekannten Telefonnummern werden der passenden WhatsApp-Konversation hinzugefügt. Für Antworten von unbekannten Nummern erstellt telli einen neuen Kontakt aus der Absendernummer.

## Einschränkungen

* Geschäftlich initiierte WhatsApp-Nachrichten verwenden freigegebene Meta-Templates.
* Freitext-Nachrichten sind in Workflows oder Agent-Tools nicht verfügbar.
* WhatsApp-Versand benötigt eine aktive WhatsApp-Business-Telefonnummer in telli.
* Templates müssen in Meta verwaltet und freigegeben werden, bevor sie in telli ausgewählt werden können.
* WhatsApp-Calling-Templates und dynamische WhatsApp-Flow-Templates werden nicht unterstützt.
* Für die WhatsApp-Nutzung können zusätzliche Gebühren anfallen.

## WhatsApp entfernen

Du kannst einzelne WhatsApp-Telefonnummern auf der Integrationsseite entfernen. Wenn du die letzte aktive Telefonnummer entfernst, ist der WhatsApp-Versand nicht verfügbar, bis eine weitere Telefonnummer verbunden ist.