# WhatsApp-Authentifizierungstemplates

Ein Authentifizierungstemplate übermittelt einen Einmal-Bestätigungscode. Meta gibt den Wortlaut vor, wenn Sie das Template erstellen. Beim Senden übergeben Sie den Code als Body-Parameter.

## Bevor Sie senden

Entscheiden Sie, ob Sie ein von Bird verwaltetes Template nutzen oder ein eigenes Template auf Ihrem Business-Account erstellen möchten.

Für den Versand der vorgefertigten Katalogtemplates von Bird, `bird_otp` und `bird_otp_authifly`, ist keine eigene Verifizierung nötig. Diese Templates liegen auf den eigenen WhatsApp Business Accounts von Bird, und der verwaltete Versandpfad prüft den Verifizierungsstatus Ihres Unternehmens nicht.

Wenn der verbundene Business-Account `not_verified` meldet, verweigert Bird das Erstellen oder Duplizieren von Authentifizierungstemplates mit `412` [`E15043`](/docs/api/errors/E15043) `WhatsAppTemplateBusinessNotVerified`. Prüfen Sie den verbundenen Account und seinen zuletzt synchronisierten Status. Siehe [WhatsApp-Business-Verifizierung](/docs/knowledge-base/whatsapp/business-verification) für den Verifizierungsprozess und die Statusbehandlung.

Das Erstellen und Bearbeiten von Utility- und Marketing-Templates ist von dieser Sperre nicht betroffen; Sie können diese unabhängig von Ihrem Verifizierungsstatus weiterhin anlegen und bearbeiten.

Erstellen Sie Templates im Dashboard, mit der [`bird` CLI](/docs/cli) oder über den [MCP-Server](/docs/ai/mcp-server). Siehe [WhatsApp-Templates erstellen](/docs/guides/whatsapp/authoring-templates) für den vollständigen Ablauf.

## Einen Bestätigungscode senden

`POST /v1/whatsapp/messages` mit einem `template`-Objekt, das einen Katalog-Slug benennt:

**TypeScript**

```typescript
const msg = await bird.whatsapp.send({
  to: "+14155550100",
  template: {
    slug: "bird_otp",
    language: "en",
    components: [{ type: "body", parameters: [{ type: "text", text: "481920" }] }],
  },
});
console.log(msg.id, msg.status);
```

Examples: [TypeScript](/de-de/dokumentation/guides/whatsapp/templates/authentication.ts.md) · [Python](/de-de/dokumentation/guides/whatsapp/templates/authentication.py.md) · [Go](/de-de/dokumentation/guides/whatsapp/templates/authentication.go.md) · [PHP](/de-de/dokumentation/guides/whatsapp/templates/authentication.php.md) · [CLI](/de-de/dokumentation/guides/whatsapp/templates/authentication.cli.md) · [MCP](/de-de/dokumentation/guides/whatsapp/templates/authentication.mcp.md) · [cURL](/de-de/dokumentation/guides/whatsapp/templates/authentication.curl.md)

Vier Regeln gelten speziell für diese Kategorie:

- **Lassen Sie `from` weg.** Ein von Bird verwaltetes Template wählt seinen Absender selbst, anhand von Kategorie und Region. Das Setzen von `from` gibt `422` [`E15018`](/docs/api/errors/E15018) `WhatsAppSenderNotAllowed` zurück. Das ist das Gegenteil eines Freitextversands, der `from` erfordert; wichtig zu wissen, wenn Sie von den Seiten zu interaktiven Nachrichten kommen.
- **`to` muss eine E.164-Telefonnummer sein.** Ein Authentifizierungstemplate kann nicht an eine unternehmensspezifische Benutzer-ID gesendet werden; das ergibt `422` [`E15014`](/docs/api/errors/E15014) `WhatsAppRecipientNotSupportedForTemplate`.
- **Der Body akzeptiert genau einen positionellen Parameter: den Code.** Null Parameter oder ein benannter Parameter gibt `422` [`E15003`](/docs/api/errors/E15003) `WhatsAppTemplateParameterMismatch` zurück. Authentifizierung ist die einzige Kategorie, die Meta positionell schreibt; jede andere Kategorie benennt ihre Parameter.
- **Kein Kundenservice-Fenster erforderlich.** Template-Versendungen sind nicht an ein Fenster gebunden; genau deshalb gibt es Bestätigungscode-Templates: Sie müssen jemanden erreichen können, der Ihnen noch nie geschrieben hat.

Lesen Sie die verfügbaren Sprachen für `bird_otp` oder `bird_otp_authifly` aus dem Template-Katalog aus. Wenn die angeforderte Sprache nicht verfügbar ist, schlägt der Versand fehl, anstatt eine andere Sprache einzusetzen.

## Die Code-kopieren-Schaltfläche

Meta schreibt den Body eines Authentifizierungstemplates selbst als Vorlage mit einem einzelnen Code-Platzhalter. Sie liefern daher Flags statt Text. Die Button-Komponente ist beim Versand optional: Wenn Sie keinen angeben, fügt Bird ihn für Sie hinzu, mit demselben Code wie im Body. Sie können ihn auch selbst angeben:

```json
{ "type": "button", "parameters": [{ "type": "text", "text": "481920" }] }
```

In beiden Fällen erreicht genau ein Button WhatsApp, und zwar die Code-kopieren-Schaltfläche: Antippen kopiert den Code in die Zwischenablage. Bird unterstützt nur `copy_code`; die beiden anderen Button-Verhaltensweisen, die Meta für Authentifizierungstemplates dokumentiert, One-Tap und Zero-Tap Autofill, sind auf Bird derzeit nicht verfügbar.

Das Erstellen eines Template-Buttons folgt derselben Struktur: ein `otp`-Button, und das Template akzeptiert keinen anderen Button-Typ. Sie geben `add_security_recommendation` (ein Boolean, der im Body angezeigt wird) und `code_expiration_minutes` (1 bis 90, im Footer angezeigt) an, statt Text zu schreiben.

## Was Meta in einem Authentifizierungstemplate erlaubt

Meta legt die Struktur eines Authentifizierungstemplates fest und prüft dessen Inhalt: keine URLs, Medien oder Emojis irgendwo im Template und ein Limit von 15 Zeichen für den Code-Parameter. Die Kategorie ändert auch, wie WhatsApp die Nachricht zustellt: Sie wird nur an das primäre Gerät des Empfängers gesendet. Siehe [Template-Richtlinien](/docs/knowledge-base/whatsapp/template-guidelines) für die vorgegebene Struktur, Zeichenlimits und den Prüfungsprozess im Detail.

## Kosten

Kategorie und Ziel bestimmen den Preis. Unter [WhatsApp-Authentication-International-Tarife](/docs/knowledge-base/whatsapp/authentication-international-rates) erfahren Sie, wie der Versand in ein anderes Land als Ihren primären Standort den Preis ändern kann, und unter [Kosten und Abrechnung](/docs/guides/whatsapp/sending-whatsapp#cost-and-billing), wann ein Versand berechnet wird. Die Tarifwerte finden Sie unter [WhatsApp-Preise](/products/whatsapp/pricing).

## Worauf Sie achten sollten

- **Die vorgefertigten Templates von Bird werden in den folgenden neun Ländern nicht zugestellt.** `bird_otp` und `bird_otp_authifly` senden über die eigenen WhatsApp Business Accounts von Bird, und diese Konten übermitteln keine Authentifizierungsnachrichten nach Ägypten, Indien, Indonesien, Malaysia, Nigeria, Pakistan, Saudi-Arabien, Südafrika oder in die Vereinigten Arabischen Emirate. Ein solcher Versand wird mit `422` [`E15063`](/docs/api/errors/E15063) `WhatsAppDestinationRestricted` abgelehnt, bevor etwas berechnet wird. Ein Template, das Sie auf Ihrem eigenen Konto erstellt haben und von Ihrer eigenen Nummer senden, erreicht diese Länder normal. [Verify](/docs/guides/verify/countries#where-whatsapp-cannot-carry-a-passcode) erreicht sie ebenfalls, indem es den Bestätigungscode selbstständig auf einen anderen Kanal verschiebt.
- **Ein Versand mit eigenem Template erfordert `from`, und dieser muss auf demselben WhatsApp Business Account liegen wie das Template.** Ein Absender auf einem anderen Konto wird mit `422` [`E15023`](/docs/api/errors/E15023) `WhatsAppSenderWABAMismatch` abgelehnt, bevor etwas berechnet wird.
- **Nur eine Sprache, deren Version genehmigt und live ist, kann gesendet werden.** Eine Sprache im Status Entwurf, Ausstehend, Abgelehnt oder Pausiert kann es nicht.
- **Meta kann ein Template von sich aus umkategorisieren.** Es gibt kein Opt-out, und die Preis- und Zustellregeln der Kategorie verschieben sich mit.
- **Die Kategorie des Templates und die Kategorie seiner Sprache können voneinander abweichen.** Siehe [WhatsApp-Templates](/docs/guides/whatsapp/templates#listing-templates-from-the-api) dazu, wie der Versandpfad dies auflöst.
- **Ein eingelesenes Authentifizierungstemplate kann nicht dupliziert werden.** Bird kann den von WhatsApp generierten Text nicht in die Einstellungen zurücklesen, aus denen ein neues Template erstellt wird; das ergibt `422` [`E15024`](/docs/api/errors/E15024) `WhatsAppTemplateContentNotDuplicable`. Erstellen Sie stattdessen ein neues Template mit eigener Sicherheitsempfehlung und Code-Ablaufzeit.

## Nächste Schritte

- [WhatsApp-Templates](/docs/guides/whatsapp/templates): Katalog durchsuchen und der gemeinsame Vertrag für den Versand per Template
- [Utility-Templates](/docs/guides/whatsapp/templates/utility): Bestellaktualisierungen, Terminerinnerungen und Kontobenachrichtigungen
- [WhatsApp-Unternehmensverifizierung](/docs/knowledge-base/whatsapp/business-verification): wie die Verifizierung funktioniert und was sie sonst noch freischaltet

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/products/whatsapp) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)