The-Y verschickt SMS über deinen eigenen SMS-Anbieter („Bring your own credentials") — ohne Aufschlag, du zahlst deinen Anbieter direkt. In dieser Anleitung hinterlegst du die API-Zugangsdaten und schickst eine Test-SMS.
⏱ ca. 5 Min · Recht: settings.manage (Admin) · Free & Paid
Aktuell nur Versand (ausgehend). Eingehende SMS als Tickets zu empfangen ist geplant (braucht einen Inbound-Webhook je Anbieter) und steht auf dem Feature-Board. Der ausgehende Versand — einzeln aus dem Posteingang und als Marketing-Kampagne — funktioniert vollständig.
Einstellungen → Kanäle — hier fügst du das SMS-Konto hinzu.
Bevor du startest — was du brauchst
Ein Konto bei einem SMS-Anbieter mit REST-API. The-Y ist auf das gängige SMStools-Format ausgelegt (Header X-Client-Id / X-Client-Secret); die API-Basis-URL ist frei einstellbar, sodass auch kompatible Anbieter passen.
Vom Anbieter: Client-ID und Client-Secret (API-Zugangsdaten) sowie die API-Basis-URL.
Einen Absender (Sender-ID) — je nach Land/Anbieter eine Kurzwahl, ein Name oder eine Nummer (muss beim Anbieter freigeschaltet sein).
Schritt für Schritt
Kanäle öffnen.Einstellungen → Kanäle; bei mehreren Marken oben die passende Marke wählen.
SMS-Konto hinzufügen. Bei „Postfächer & Nummern" auf „＋ Hinzufügen" → Typ SMS. Das Einrichten-Panel öffnet sich.
Zugangsdaten eintragen.
API-Basis-URL deines Anbieters (z. B. https://api.dein-anbieter.tld)
Client-ID und Client-Secret — werden verschlüsselt gespeichert (AES-256)
Absender (Sender-ID)
Test-SMS senden. Klicke „Test-SMS senden" und gib eine Zielnummer ein (z. B. dein eigenes Handy). The-Y ruft die Anbieter-API live auf; eine Fehlermeldung (z. B. 401 Invalid Credentials) kommt direkt vom Anbieter — siehe Fehlerbehebung.
Speichern & aktiv schalten. Das SMS-Konto ist nun aktiv und steht in „Neuer Chat" und im Marketing als Kanal zur Verfügung.
SMS versenden
Einzeln: Im Posteingang über „＋ Neuer Chat" einen Kontakt wählen, Kanal SMS, Nachricht schreiben, senden. (Consent wird respektiert — abgemeldete Kontakte erscheinen nicht.)
Als Kampagne: Unter Marketing eine Kampagne mit Kanal SMS anlegen (Segment, Platzhalter wie {vorname}). Siehe die Marketing-Anleitung.
Consent (Einwilligung)
Im Kunden-Panel jedes Kontakts stellst du je Kanal ein, ob SMS erlaubt sind. „Neuer Chat" und Marketing schließen für SMS abgemeldete Kontakte automatisch aus — wichtig für rechtskonformen Versand.
Fehlerbehebung
401 Invalid Credentials
Client-ID oder Client-Secret stimmen nicht, oder die API-Basis-URL ist falsch. Prüfe die Werte im Anbieter-Dashboard und trage sie erneut ein. Die Fehlermeldung stammt 1:1 vom Anbieter — das bedeutet, die Verbindung selbst steht.
„Absender nicht erlaubt" / SMS kommt nicht an
Viele Länder/Anbieter verlangen einen registrierten Absender (Sender-ID). Lass deinen Absender beim Anbieter freischalten oder nutze eine erlaubte Nummer/Kurzwahl. Prüfe außerdem dein Anbieter-Guthaben.
Mein Anbieter ist nicht SMStools
Ist die API des Anbieters mit dem SMStools-Schema kompatibel (Header X-Client-Id/X-Client-Secret, JSON-Endpunkt), passt du einfach die API-Basis-URL an. Andernfalls schreib uns unter office@the-y.at — weitere Anbieter-Adapter sind möglich.
