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.
⏱ ca. 10 Min · Recht „Einstellungen verwalten“ (Admin) · Free & Paid · Stand: Version 1.1.26
Senden und empfangen. Ausgehend — einzeln aus dem Posteingang und als Kampagne — und eingehend: Trägst du die Empfangs-Adresse bei deinem Anbieter ein, landen Antworten im Posteingang und „STOP“ meldet automatisch ab (siehe Antworten empfangen & STOP).
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.
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.
Die Empfangs-Adresse ist geheim — nicht weitergeben. „Neue Adresse erzeugen“ macht die alte ungültig; dann trägst du die neue beim Anbieter ein. Bei STOP schickt The-Y keine Bestätigungs-SMS, und Zustellberichte für SMS gibt es nicht.
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)
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.
