# SMS-APIs (SyBox)

Wo: Einstellungen > Messaging > SMS-APIs

Wozu das dient: SMS-Anbieter als Backup-Kanal hinzufügen. Weisen Sie einem Gateway ein Land zu, wird es für Kontakte aus diesem Land bevorzugt genutzt.

Wer Zugriff hat: Benutzer mit der Berechtigung „SMS-Gateways verwalten“.

### So fügen Sie ein SMS-Gateway hinzu

1. Klicken Sie auf „SMS-API hinzufügen“.
   ![Settings, SMS APIs: a connected SMS gateway and the "Add SMS API" button](https://www.sybox.io/res/sybox/help/de/add-an-sms-gateway-1.webp?v=4c1863b9)
2. Anbieter: Wählen Sie MessageBird, SMS Misr, Texto oder Twilio. Das Formular zeigt nur die für diesen Anbieter benötigten Felder.
   ![The new SMS gateway window: the provider first, then the country, keys and sender](https://www.sybox.io/res/sybox/help/de/add-an-sms-gateway-2.webp?v=40043f56)
3. Anzeigename: Ein Name für Ihre eigene Übersicht.
4. Land: Ein zweistelliger Ländercode, zum Beispiel EG. Leer lassen, um das Gateway für alle Länder zu nutzen.
5. Angeben der Zugangsdaten des Anbieters:
   - MessageBird: Absender-ID (der Name oder die Nummer, die der Empfänger sieht) und API-Schlüssel.
   - SMS Misr: Absender-ID, Benutzername, Passwort und Sender-Token. Das Sender-Token ist der Wert, den SMS Misr für Ihre Absender-ID ausgibt.
   - Texto: Nur der API-Schlüssel.
   - Twilio: Absender-ID (Ihre From-Nummer oder der Messaging Service), Account SID und Auth-Token.
6. Aktiv: Eingeschaltet lassen, um das Gateway zu nutzen.
7. Klicken Sie auf Speichern. Fehlt ein Pflichtfeld, erscheint „Unvollständige Daten“.

### So senden Sie eine Test-SMS

1. Klicken Sie auf der Karte des Gateways auf „Test-SMS senden“ (das Senden-Symbol).
   ![To send a test SMS: "Send test SMS" marked on the screen in SyBox](https://www.sybox.io/res/sybox/help/de/send-a-test-sms-1.webp?v=069bc085)
2. Geben Sie eine Telefonnummer im internationalen Format ein, zum Beispiel +2126…, und passen Sie die Nachricht nach Wunsch an.
3. Klicken Sie auf Speichern. Sie sehen „Test-SMS gesendet.“ Falls der Anbieter die SMS ablehnt, wird der Fehler angezeigt.

Weitere Aktionen

- Bearbeiten: Beliebige Felder anpassen. Lassen Sie Passwort- oder Schlüsselfelder leer, um den aktuellen Wert beizubehalten.
- Aktivieren / Deaktivieren: Das Gateway ein- oder ausschalten.
- Löschen: „Dieses SMS-Gateway dauerhaft löschen?“
- Steht auf einer Karte „Fehlendes Token“, ist kein Schlüssel gespeichert. Bearbeiten Sie die Karte und tragen Sie den Schlüssel ein.

Source: https://www.sybox.io/de/help/sms-apis
