SMS einrichten (eigener Anbieter)
The-Y verschickt und empfängt 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, schickst eine Test-SMS und richtest den Empfang von Antworten ein.
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)
- API-Basis-URL deines Anbieters (z. B.
- 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.
Antworten empfangen & STOP
- Empfangs-Adresse erzeugen. Im Einrichten-Panel des SMS-Kontos im Bereich „Eingehende SMS & STOP“ auf „Empfangs-Adresse erzeugen“ klicken.
- Beim Anbieter eintragen. Adresse kopieren und bei deinem SMS-Anbieter als Webhook für eingehende Nachrichten eintragen — meist unter Einstellungen → Webhooks → eingehende Nachrichten.
- Fertig. Antworten deiner Kunden landen im Posteingang. Schreibt jemand „STOP“, „STOPP“, „ABMELDEN“ oder „UNSUBSCRIBE“, ist er für SMS abgemeldet (mit Vermerk im Gespräch); „START“ oder „ANMELDEN“ meldet wieder an.
SMS versenden
- Einzeln: Im Posteingang über „＋ Neuer Chat" einen Kontakt wählen, Kanal SMS, Nachricht schreiben, senden. (Consent wird respektiert — abgemeldete Kontakte erscheinen nicht.) Die Nummer wird mit deiner Ländervorwahl gespeichert (aus „0664 …“ wird „+43 664 …“), und vor dem Senden siehst du, an welche Nummer es geht. Gibt es mit der Nummer schon ein offenes Gespräch, schreibst du dort weiter.
- Als Kampagne: Unter Marketing eine Kampagne mit Kanal SMS anlegen (Segment, Platzhalter wie
{vorname}). Siehe die Marketing-Anleitung.
Consent (Einwilligung)
Auf der Kontaktseite siehst du je Kanal, ob eine Einwilligung vorliegt — mit Datum und Quelle. SMS-Kampagnen gehen nur an Kontakte mit ausdrücklicher Einwilligung; „Neuer Chat" und Marketing schließen für SMS abgemeldete Kontakte automatisch aus. Mehr dazu: Einwilligung, STOP & Abmeldung.
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.
Antworten kommen nicht im Posteingang an
Prüfe, ob die Empfangs-Adresse beim Anbieter als Webhook für eingehende Nachrichten eingetragen ist (nicht für Zustellberichte) und ob du nach „Neue Adresse erzeugen“ die neue Adresse eingetragen hast. Das SMS-Konto muss aktiv sein.
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.