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

# WhatsApp-Vorlagen zur Authentifizierung per Passcode

> So senden WhatsApp-Authentifizierungsvorlagen Passcodes: fester Text, Code kopieren, One-Tap und Zero-Tap, Time-to-live und Versand aus Flowella.

Eine Authentifizierungsvorlage sendet einen Einmal-Passcode für die Anmeldung, die Kontowiederherstellung oder die Bestätigung einer Transaktion. Sie ist die einzige Kategorie, die einen Passcode enthalten darf, und die strengste: Meta legt den Text fest, Sie fügen nur den Code und optional eine Sicherheits- und eine Ablaufzeile hinzu, und die Nachricht enthält eine Schaltfläche, die den Code kopiert oder einfügt.

> [!NOTE]
>
> **In Flowella.** Teilweise unterstützt. Flowella kann Authentifizierungsvorlagen über die [Flowella API](https://knowledge.flowella.io/de/hubspot/workflows/authentication-otp.md) senden, mit einem eigenen Code für jeden Empfänger. Der Editor von Flowella kann keine Passcode-Schaltflächen hinzufügen. Erstellen Sie die Vorlage daher im WhatsApp Manager. Ein HubSpot-Workflow kann keine Passcodes senden.

## Was die Nachricht enthält

| Teil | Inhalt | Können Sie ihn ändern |
| - | - | - |
| Text | Metas vorgegebener Text: der Code, gefolgt von „is your verification code", übersetzt in die Sprache der Vorlage | Nur den Code |
| Sicherheitszeile | „For your security, do not share this code." | Ein oder aus |
| Ablaufzeile | „This code expires in N minutes", von 1 bis 90 Minuten | Ein oder aus, und die Anzahl der Minuten |
| Schaltfläche | Code kopieren, One-Tap-Autofill oder Zero-Tap | Den Typ, und bei One-Tap die App-Details |

Authentifizierungsvorlagen dürfen keine Links, Medien oder Emojis enthalten, und jede Variable ist auf 15 Zeichen begrenzt. Verwenden Sie im Code nur Ziffern und Buchstaben.

## Schaltflächentypen

| Typ | So funktioniert es | Funktioniert auf |
| - | - | - |
| **Code kopieren** | Die Person tippt auf die Schaltfläche, WhatsApp kopiert den Code und sie fügt ihn in Ihre App oder Website ein | Jedem Telefon, ohne Aufwand für Sie |
| **One-Tap-Autofill** | Die Person tippt auf die Schaltfläche und WhatsApp übergibt den Code direkt an Ihre Android-App | Android, mit Änderungen an Ihrer App |
| **Zero-Tap** | WhatsApp übergibt den Code ohne Tippen an Ihre Android-App | Android, mit Änderungen an Ihrer App und akzeptierten Zero-Tap-Bedingungen von Meta |

Ab iOS 26 schlägt iOS den Code aus der Benachrichtigung als Tastaturvorschlag vor, bei jeder Authentifizierungsvorlage und ohne Aufwand für Sie. Ältere iOS-Versionen füllen nichts automatisch aus. Code kopieren ist daher die sichere Wahl, wenn Sie keine native Android-App entwickeln.

> [!WARNING]
>
> Wenn Ihre Android-App den One-Tap- oder Zero-Tap-Handshake mit `PendingIntent` startet, wechseln Sie vor dem 31. Januar 2027 zum OTP Android SDK von Meta. An diesem Tag stellt Meta die `PendingIntent`-Methode ein.

## Verknüpfte Geräte

WhatsApp stellt Authentifizierungsnachrichten nur auf dem Haupttelefon der Person zu. Auf verknüpften Geräten wie WhatsApp Web oder einem Tablet ist die Nachricht ausgeblendet, und die Person wird gebeten, ihr Telefon zu prüfen. Sie können das nicht abschalten.

## Time-to-live

| | Wert |
| - | - |
| Standard von Meta | 10 Minuten. Vorlagen, die vor dem 23. Oktober 2024 erstellt wurden, haben standardmäßig 30 Tage. |
| Einstellbarer Bereich | 30 Sekunden bis 15 Minuten |

Setzen Sie die Time-to-live nicht länger als die Gültigkeit Ihres Codes, damit niemand einen bereits abgelaufenen Code erhält. Flowella hat keine Einstellung für die Time-to-live. Wenn Sie einen eigenen Wert brauchen, legen Sie ihn für die Vorlage im WhatsApp Manager fest.

## Preis

Authentifizierungsnachrichten werden pro zugestellter Nachricht berechnet, mit [Volumenstufen](https://knowledge.flowella.io/de/whatsapp/pricing/whatsapp-pricing.md#volume-tiers-for-utility-and-authentication). In einigen Märkten berechnet Meta einen höheren Tarif **authentication-international**, wenn ein berechtigtes Unternehmen Codes an Nummern in diesem Markt sendet. Siehe [WhatsApp-Preise](https://knowledge.flowella.io/de/whatsapp/pricing/whatsapp-pricing.md).

## Eine Vorlage im WhatsApp Manager erstellen

**1. Eine Vorlage beginnen**

Klicken Sie im [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/message_templates) auf **Create template** und wählen Sie **Authentication**. Sie können auch mit einer Authentifizierungsvorlage aus der Bibliothek von Meta beginnen.

**2. Die Optionen wählen**

Wählen Sie den Schaltflächentyp und schalten Sie bei Bedarf die Sicherheitszeile und die Ablaufzeile ein. Für One-Tap oder Zero-Tap fügen Sie den Paketnamen und den Signatur-Hash Ihrer Android-App hinzu.

**3. Einreichen**

Wählen Sie die Sprachen und reichen Sie die Vorlage ein. Meta schreibt den Text selbst, daher geht die Prüfung meist schnell.

Die Vorlage erscheint danach auf der Seite **Templates** in Flowella und kann über die API gesendet werden.

## Passcodes aus Flowella senden

Ihre App erzeugt den Code, speichert ihn mit einem Ablaufzeitpunkt und ruft `POST /v1/templates/send` mit dem Code als Textvariable und dem Wert der Schaltfläche auf. Flowella lehnt einen Code mit mehr als 15 Zeichen ab, bevor er Meta erreicht. Eine vollständige Anleitung mit Regeln für erneutes Senden und Sperren finden Sie unter [Einmal-Passcodes senden](https://knowledge.flowella.io/de/hubspot/workflows/authentication-otp.md).

## Bewährte Vorgehensweisen

* **Bestätigen Sie zuerst die Nummer.** Stellen Sie sicher, dass die WhatsApp-Nummer der Person gehört, bevor Sie einen Code an sie senden.
* **Sagen Sie den Personen, dass der Code per WhatsApp kommt**, besonders wenn Sie auch SMS oder E-Mail anbieten.
* **Zeigen Sie, dass Sie ihn erhalten haben.** Wenn die Person den Code einfügt oder Ihre App ihn empfängt, bestätigen Sie das auf dem Bildschirm.
* **Senden Sie keine Codes in Marketing- oder Utility-Vorlagen.** Meta lehnt Vorlagen, die Passcodes in der falschen Kategorie enthalten, ab dem ersten Tag des folgenden Monats ab. Siehe [Vorlagenkategorien](https://knowledge.flowella.io/de/whatsapp/templates/template-categories.md#when-meta-changes-a-category-after-approval).

## Verwandt

> [card] [Einmal-Passcodes senden](https://knowledge.flowella.io/de/hubspot/workflows/authentication-otp.md)
>
> Die Anleitung für die Flowella API.

> [card] [Vorlagenbibliothek](https://knowledge.flowella.io/de/whatsapp/templates/template-library.md)
>
> Fertige Vorlagen von Meta.

> [card] [Grundlagen zu Vorlagen](https://knowledge.flowella.io/de/whatsapp/templates/template-fundamentals.md)
>
> Namen, Sprachen, Status und Limits.

> [card] [WhatsApp-Preise](https://knowledge.flowella.io/de/whatsapp/pricing/whatsapp-pricing.md)
>
> Authentifizierungstarife und der internationale Tarif.

Abgeglichen mit der Dokumentation von Meta am 18. November 2026: [Authentication templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates), [Template categorization](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-categorization) und [Time-to-live](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/time-to-live).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.