# Android-Telefon als SMS-Gateway (Beta) Verwenden Sie Ihr eigenes Android-Telefon als SMS-Sender. Anstatt ein Twilio-Konto zu verbinden, installieren Sie eine kleine Open-Source-App auf einem Android-Telefon, koppeln diese mit Ihrem Arbeitsbereich, und Ihre Textnachrichten werden über die eigene Nummer und den Mobilfunktarif des Telefons gesendet und empfangen. > **Beta-Kanal.** Das Android-SMS-Gateway ist jetzt für alle Nutzer mit einem Plan verfügbar, der ein Kanal-Kontingent beinhaltet. Da es sich jedoch noch um eine neue Funktion handelt, können gelegentlich noch Unstimmigkeiten auftreten. Bitte beachten Sie, dass sich das Verhalten und die Limits mit der Weiterentwicklung des Kanals ändern können. Sollte etwas nicht wie beschrieben funktionieren, informieren Sie bitte den Support. --- ## Warum Sie dies nutzen sollten Das Android-Gateway ist für **geringes Volumen und konversationelle SMS** konzipiert – für das Antworten auf Leads, KI-Konversationen und Eins-zu-eins-Textnachrichten. Es ist gut geeignet, wenn: - Sie weiterhin von Ihrer **bestehenden privaten oder geschäftlichen Nummer** aus texten möchten. - Twilio für Ihr Land oder Ihr Volumen **zu umfangreich oder zu teuer** ist. - Sie lieber das **bestehende SMS-Guthaben Ihres Mobilfunkanbieters** nutzen möchten, anstatt Gebühren pro Nachricht zu zahlen. - Sie den Papierkram für die **Registrierung beim Mobilfunkanbieter** (A2P 10DLC und Ähnliches), den Twilio erfordert, **vermeiden** möchten. Es ist **nicht** für Massen-SMS-Versand ausgelegt – siehe [Einschränkungen](#limitations) weiter unten. > **Bevorzugen Sie Twilio für Skalierbarkeit und Zuverlässigkeit.** Wenn Sie Nachrichten in großem Umfang versenden, garantierte Verfügbarkeit benötigen oder Massen-SMS-Kampagnen durchführen, verbinden Sie stattdessen eine Twilio-Nummer – siehe [SMS-Messaging](sms.md). Beide sind alternative SMS-Transportwege; Nachrichten, Kontakte, die KI und Ihr Posteingang funktionieren in beiden Fällen gleich. --- ## Voraussetzungen - **Ein Android-Telefon** mit einer aktiven SIM-Karte und einem SMS-Tarif (ein unbegrenzter oder großzügiger SMS-Tarif wird dringend empfohlen). - **Die kostenlose Open-Source-App „SMS Gateway for Android“** von [sms-gate.app](https://sms-gate.app) – laden Sie sie von der Website oder den [GitHub-Releases](https://github.com/capcom6/android-sms-gateway/releases/latest) herunter. Wir haben diese App nicht entwickelt – es handelt sich um ein Drittanbieterprojekt. - **Das Telefon muss eingeschaltet, online und uneingeschränkt bleiben** – siehe [Das Telefon zuverlässig halten](#keeping-the-phone-reliable). - **Ein kostenpflichtiger Tarif** – das Android-Gateway ist in Ihrem Kanal-Kontingent enthalten. Es gibt **keine Plattformgebühr pro Nachricht** und keine Twilio-Rechnung – Sie nutzen den Mobilfunktarif Ihres eigenen Telefons. Wenn die KI eine Antwort generiert, verbraucht diese Antwort weiterhin KI-Credits, genau wie bei jedem anderen Kanal. --- ## Einrichten der Gateway-App 1. Installieren Sie **SMS Gateway for Android** von [sms-gate.app](https://sms-gate.app) auf dem Telefon, dessen Nummer Sie verwenden möchten. 2. Öffnen Sie die App. 3. Aktivieren Sie den **Cloud Server**-Modus (die einfachste Option – er leitet über den gehosteten Server des Projekts weiter, sodass Ihr Telefon keine öffentliche Adresse benötigt). 4. Die App generiert einen **Benutzernamen** und ein **Passwort** auf dem Startbildschirm. Diese fügen Sie im nächsten Abschnitt in die Plattform ein. 5. (Empfohlen) Öffnen Sie in der App **Settings → Webhooks**. Ein Webhook ist eine automatische Benachrichtigung, die die App an die Plattform sendet, sobald etwas passiert – hier, sobald eine Nachricht eingeht. 6. Kopieren Sie den **Signing Key**. Das Einfügen in die Plattform fügt eine zusätzliche Signaturprüfung für eingehende Nachrichten hinzu. > **Lokaler Modus (fortgeschritten).** Wenn Sie bevorzugen, dass das Telefon direkt über Ihr eigenes Netzwerk mit der Plattform kommuniziert, anstatt über das Cloud-Relay, unterstützt die App auch den Modus „Local Server“. Sie müssen das Telefon unter einer erreichbaren HTTPS-Adresse verfügbar machen und diese Adresse beim Verbinden als Basis-URL eingeben. Der Cloud-Modus wird für fast alle Benutzer empfohlen. --- ## Verbinden des Telefons mit der Plattform 1. Klicken Sie in der linken Seitenleiste unten auf **Einstellungen**. 2. Klicken Sie in der linken Navigationsleiste der Einstellungen unter **Kanäle** auf **Kanäle**. 3. Suchen Sie die Karte **Android SMS Gateway** und klicken Sie auf **Verbinden**. 4. Geben Sie die **Telefonnummer** ein – die eigene Nummer des Telefons im internationalen Format (E.164), z. B. `+14155551234`. 5. Geben Sie den **Gateway-Benutzernamen** und das **Gateway-Passwort** vom Startbildschirm der Gateway-App ein. 6. Fügen Sie optional den **Webhook-Signaturschlüssel** (empfohlen) aus den Webhook-Einstellungen der App ein. 7. Klicken Sie auf **Verbinden**. Die Plattform validiert die Anmeldedaten, registriert die Nachrichten- und Zustellungs-Webhooks auf dem Gateway für Sie und ändert den Status auf **Verbunden**. Es ist kein Kopieren und Einfügen von Webhook-URLs in die App erforderlich – die Registrierung erfolgt automatisch. ### Status überprüfen Sobald die Verbindung hergestellt ist, ändert sich die Schaltfläche der Karte von **Verbinden** zu **Verwalten**. Klicken Sie darauf, um das Gateway-Panel erneut zu öffnen, wo Sie jederzeit **Status aktualisieren** finden. Es überprüft erneut, ob das Gateway erreichbar ist, und zeigt an, ob das Telefon aktuell **online** ist. Wenn sich das Telefon im Ruhemodus befindet oder offline ist, sehen Sie eine klare Offline-Anzeige, damit Sie wissen, dass keine Nachrichten gesendet werden, bis es wieder verbunden ist. ### Trennen der Verbindung Klicken Sie auf der Karte auf **Verwalten**, um das Gateway-Panel erneut zu öffnen, und klicken Sie dann auf **Trennen**. Die Plattform entfernt die Webhooks, die sie auf dem Gateway registriert hat, und löscht die Verbindung. Ihre SMS werden dann wieder über Twilio abgewickelt, falls Sie eine Twilio-SMS-Nummer verbunden haben, oder die SMS-Funktion wird deaktiviert, falls dies nicht der Fall ist. --- ## Wie Nachrichten fließen ### Eingehend 1. Jemand sendet eine SMS an Ihre Telefonnummer. 2. Die Gateway-App auf dem Telefon erkennt die SMS und benachrichtigt die Plattform. 3. Die Plattform erstellt einen Kontakt (falls neu), legt die Nachricht in Ihren Posteingang und – falls der entsprechende KI-Agent aktiv ist – antwortet darauf. ### Ausgehend 1. Sie oder die KI senden eine Antwort von der Plattform aus. 2. Die Plattform übergibt die Nachricht an Ihr Gateway. 3. Das Telefon sendet sie als normale SMS von Ihrer Nummer über Ihren Mobilfunkanbieter. 4. Sobald der Mobilfunkanbieter eine Rückmeldung gibt, ändert sich der Nachrichtenstatus auf **Gesendet** und dann auf **Zugestellt** (oder **Fehlgeschlagen**). > **Das Android-Gateway hat beim Senden Vorrang.** Solange es verbunden ist, werden Eins-zu-eins-Nachrichten und KI-Antworten über Ihr Telefon gesendet. Wenn Sie zusätzlich eine Twilio-SMS-Nummer verbunden haben, trennen Sie das Android-Gateway, um diese wieder über Twilio zu senden. Eine Ausnahme in beiden Fällen: **Kampagnen- und Broadcast-SMS-Blasts werden immer über Ihre Twilio-Nummer gesendet**, niemals über das Android-Telefon – Massenversand von einem privaten Mobiltelefon führt genau dazu, dass Nummern gesperrt werden, daher unterstützt die Plattform dies nicht. --- ## Einschränkungen Das Android-Gateway ist von einem physischen Telefon abhängig, das Sie kontrollieren, daher gibt es Einschränkungen, die Sie bei Twilio nicht haben. Überprüfen Sie diese, bevor Sie sich für wichtige Nachrichten darauf verlassen. - **Das Telefon muss eingeschaltet und online bleiben.** Ohne Telefon keine SMS. Halten Sie es geladen, mit WLAN oder mobilen Daten verbunden und schließen Sie es von der Akku-Optimierung aus. - **Nur geringes Volumen.** Mobilfunkanbieter markieren und drosseln Telefone, die plötzlich viele SMS versenden. Dieser Kanal ist für Konversationen und Eins-zu-eins-Antworten gedacht – **nicht für Massen-SMS-Kampagnen**. - **Massen-SMS-Versand wird über diesen Kanal nicht unterstützt.** Für den Versand von Massen-SMS ist eine verbundene Twilio-Nummer erforderlich; die Plattform weist Sie darauf hin, wenn Sie versuchen, eine Kampagne ohne Twilio zu starten. Führen Sie Massen-SMS über Twilio durch und nutzen Sie das Android-Gateway für konversationelle Antworten. - **Nur Text.** Das Senden und Empfangen von MMS (Medien) wird über diesen Kanal nicht unterstützt. - **Es gelten die Limits des Mobilfunkanbieters.** Das SMS-Guthaben Ihres Tarifs, Fair-Use-Grenzen und eventuelle Gebühren pro Nachricht sind Angelegenheiten zwischen Ihnen und Ihrem Mobilfunkanbieter. - **Die Zustellungsbestätigung hängt von Ihrem Anbieter ab.** Einige Anbieter melden die Zustellung zuverlässig, andere nicht. Ein Status "Gesendet" bedeutet, dass das Telefon die SMS abgeschickt hat. - **Konto- / Nummernrisiko.** Die Verwendung einer privaten Nummer für automatisierte geschäftliche SMS kann gegen die Nutzungsbedingungen Ihres Anbieters verstoßen und bei Missbrauch zur Drosselung oder Sperrung der Nummer führen. Nutzen Sie den Dienst verantwortungsbewusst, holen Sie Einwilligungen ein und fügen Sie Anweisungen zum Abmelden hinzu. --- ## Das Telefon zuverlässig halten Damit Nachrichten ohne Unterbrechung fließen: - **Deaktivieren Sie die Akku-Optimierung** für die SMS Gateway-App (Android-Einstellungen → Apps → SMS Gateway → Akku → Nicht eingeschränkt). Andernfalls könnte Android die App im Hintergrund beenden. - **Halten Sie den Bildschirm erreichbar / erlauben Sie der App, im Hintergrund zu laufen.** Ein dediziertes Telefon, das dauerhaft am Strom angeschlossen ist, ist ideal. - **Bleiben Sie in einem stabilen WLAN oder mobilen Netz.** Wenn das Telefon die Verbindung verliert, werden Nachrichten in die Warteschlange gestellt oder schlagen fehl, bis die Verbindung wiederhergestellt ist. - **Halten Sie die SIM-Karte aktiv und in gutem Zustand** bei Ihrem Mobilfunkanbieter. --- ## Fehlerbehebung ### "Gateway-Anmeldedaten konnten nicht validiert werden" - Überprüfen Sie den **Benutzernamen** und das **Passwort** erneut auf dem Startbildschirm der Gateway-App – diese werden neu generiert, wenn Sie die App neu installieren oder zurücksetzen. - Bestätigen Sie, dass das Telefon über Internet verfügt und der **Cloud Server**-Modus in der App eingeschaltet ist. ### Status zeigt offline / Nachrichten werden nicht gesendet - Öffnen Sie die App auf dem Telefon und bestätigen Sie, dass sie läuft und mit dem Cloud-Server verbunden ist. - Stellen Sie sicher, dass sich das Telefon nicht im Ruhemodus/Energiesparmodus befindet und dass die App von der Akku-Optimierung ausgeschlossen ist. - Tippen Sie auf der Karte auf **Status aktualisieren**, nachdem Sie das Telefon wieder online gebracht haben. ### Eingehende SMS werden nicht angezeigt - Bestätigen Sie, dass die Verbindung weiterhin als **Verbunden** angezeigt wird (tippen Sie auf **Status aktualisieren**). - Senden Sie von einem anderen Telefon aus eine Test-SMS an die Nummer des Telefons. - Stellen Sie sicher, dass die Standard-Nachrichten-App des Telefons den Absender nicht blockiert oder filtert. ### Eine SMS zeigt "Fehlgeschlagen" an - Der Mobilfunkanbieter hat die Nachricht abgelehnt – prüfen Sie, ob die Nummer des Empfängers gültig ist und im internationalen Format vorliegt. - Bestätigen Sie, dass Ihre SIM-Karte noch über ein SMS-Guthaben verfügt und die Nummer nicht gesperrt ist. - Sehr hohe Senderaten können eine Drosselung durch den Anbieter auslösen; reduzieren Sie das Tempo und halten Sie das Volumen niedrig. --- ## Benötigen Sie Hilfe? Das Android-SMS-Gateway befindet sich in der **Beta-Phase**. Wenn Sie auf ein Problem stoßen, das hier nicht behandelt wird, wenden Sie sich bitte an hi@youraiconnector.com mit: - Der Telefonnummer, die Sie verbunden haben (nicht das Passwort). - Ob die Gateway-App auf dem Telefon als online angezeigt wird. - Einer Beschreibung des Problems und wann es aufgetreten ist. Wir werden uns das so schnell wie möglich ansehen.