# Telefon (SMS)

Konfigurieren Sie das Gateway, das Einmalcodes per SMS oder Sprachanruf zustellt (das integrierte Gateway, Twilio oder ein benutzerdefiniertes HTTP-Gateway).

Requires: customSmsGateway

> **Plan-Hinweis:** Ein benutzerdefiniertes SMS-Gateway ist ab dem Essential-Plan verfügbar. Siehe [Plans & add-ons](https://dts-identity.com/de/docs/getting-started/plans-and-addons.md). Auf niedrigeren Stufen versendet die Plattform Einmalcodes über ihr integriertes Gateway.

Die Plattform stellt Einmalcodes per SMS für die telefonbasierte [Multi-Faktor-Authentifizierung](https://dts-identity.com/de/docs/security/multi-factor-authentication.md) und die Verifizierung von Telefonnummern zu. Ein integriertes Gateway funktioniert sofort; ab dem Essential-Plan können Sie diese Nachrichten über Ihren eigenen Anbieter leiten.

[Image: Der Reiter „Telefon" in den Branding-Einstellungen]

## Gateway wählen

1. Öffnen Sie in der Admin Console **Branding → Phone**.
2. Wählen Sie einen Anbieter:
   - **Built-in gateway**: der Standarddienst. Keine Konfiguration erforderlich.
   - **Twilio**: senden Sie über Ihr Twilio-Konto.
   - **Custom gateway**: senden Sie über eine beliebige HTTP-SMS-API.
3. Konfigurieren Sie die Felder für Ihre Wahl (unten) und wählen Sie **Save changes**.

## Twilio

Geben Sie Ihre Twilio-**Account SID** und Ihr **Auth Token** an und wählen Sie dann, wie Nachrichten gesendet werden:

- **Absender**: entweder eine **From number** oder eine **Messaging Service SID**. Ein Messaging Service gilt für Textnachrichten; Sprachanrufe verwenden immer eine From number.
- **Zustellmethoden**: stellen Sie den Code als **Textnachricht (SMS)**, als **Sprachanruf** oder beides zu.

## Benutzerdefiniertes Gateway

Richten Sie die Plattform auf eine beliebige HTTP-SMS-API aus:

- **Gateway URL** und **HTTP-Methode** (GET oder POST).
- Für POST ein **Body-Format** (JSON, formularkodiert oder raw) und eine **Request-Body**-Vorlage. Für raw Bodies können Sie den **Content-Type** setzen.
- **Benutzerdefinierte Header**: ein `Name: value` pro Zeile, nützlich für einen `Authorization`-Header.
- **Benutzername**, **Passwort** und ein **Auth Token** für Gateways, die sie erfordern.

Die URL, der Request-Body und die Header unterstützen Platzhalter, die beim Senden ersetzt werden, darunter die Empfängernummer und der Nachrichtentext, zum Beispiel `https://api.example.com/send?to={{to}}&text={{message}}` oder ein Header wie `Authorization: Bearer {{authToken}}`.

## Geheime Felder

Sensible Werte wie das Twilio Auth Token und das Passwort sowie das Auth Token des benutzerdefinierten Gateways werden sicher gespeichert und nie vorausgefüllt. **Lassen Sie ein geheimes Feld leer, um seinen aktuellen Wert zu behalten**; geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten.

## Nachrichteninhalt

Der Text der Code-Nachricht stammt aus dem integrierten, übersetzten Wortlaut der Plattform; er wird nicht auf dieser Seite bearbeitet. Der Body wird durch die lokalisierten Sprachtexte der Instanz gesteuert, sodass die Nachrichtensprache dem Gebietsschema des Benutzers (oder der Instanz) folgt statt einem Editor pro Vorlage.

## Missbrauchsschutz

Ausgehende SMS werden pro Benutzer ratenbegrenzt, sodass ein einzelnes Konto keine unbegrenzte Anzahl von Nachrichten auslösen kann. Das schützt Sie vor versehentlichen Schleifen und vorsätzlichem Missbrauch, der andernfalls die Zustellkosten in die Höhe treiben würde.

## Fehlerbehebung

- **Codes kommen nicht an**: bestätigen Sie, dass die Gateway-Anmeldedaten korrekt sind, und speichern Sie erneut, testen Sie den Ablauf dann erneut. Denken Sie daran, dass geheime Felder nach dem Speichern absichtlich leer sind; das bedeutet nicht, dass der Wert gelöscht wurde.
- **Twilio-Sprache, aber keine Nummer**: eine Messaging Service SID deckt nur SMS ab; fügen Sie eine From number hinzu, um die Sprachzustellung zu aktivieren.
- **Benutzerdefiniertes Gateway gibt einen Fehler zurück**: prüfen Sie, ob URL, HTTP-Methode, Body-Format und Platzhalter dem entsprechen, was Ihr Anbieter erwartet.
