Your AI Connector Docs

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 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. 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 – laden Sie sie von der Website oder den GitHub-Releases 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.
  • 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 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.

Nur Cloud-Server-Modus. Das Verbindungsfenster funktioniert mit dem Cloud-Server-Modus der App. Ein Telefon, das auf den lokalen Servermodus eingestellt ist oder mit einem anderen Server (einem privaten oder Drittanbieter-Relay) verbunden ist, kann nicht verbunden werden: Die Geräte-ID, das Registrierungstoken oder die Anmeldedaten dieses Servers werden als ungültiger Benutzername oder ungültiges Passwort abgelehnt. Schalten Sie das Telefon in den Cloud-Server-Modus und verwenden Sie den Benutzernamen und das Passwort vom Startbildschirm der App.


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 auch eine Twilio-SMS-Nummer verbunden haben, trennen Sie das Android-Gateway, um diese wieder über Twilio zu senden. Eine Ausnahme in beiden Fällen: SMS-Broadcast-Nachrichten 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. Kein Telefon, keine Nachrichten. Halten Sie es geladen, mit WLAN oder Daten verbunden und schließen Sie es von der Akku-Optimierung aus.
  • Nur geringes Volumen. Mobilfunkanbieter markieren und drosseln Telefone, die plötzlich viele Nachrichten versenden. Dieser Kanal ist für Konversationen und Eins-zu-eins-Antworten gedacht – nicht für Massensendungen.
  • SMS-Massensendungen werden auf diesem Kanal nicht unterstützt. Der Versand von Massen-SMS erfordert eine verbundene Twilio-Nummer; die Plattform weist Sie darauf hin, wenn Sie versuchen, eine solche ohne Twilio zu starten. Führen Sie Massensendungen über Twilio durch und nutzen Sie das Android-Gateway für konversationelle Antworten.
  • Nur Text. Eingehende MMS-Nachrichten, einschließlich RCS-Chat-Nachrichten, die das Telefon als MMS empfängt, kommen mit ihrem Text an, aber Fotos, Videos oder Dateien darin werden nicht übertragen. Das Senden von MMS (Medien) wird auf diesem Kanal nicht unterstützt.
  • Es gelten die Limits des Mobilfunkanbieters. Das SMS-Guthaben Ihres Mobilfunktarifs, Fair-Use-Obergrenzen und eventuelle Gebühren pro Nachricht sind Angelegenheiten zwischen Ihnen und Ihrem Mobilfunkanbieter.
  • Die Zustellungsbestätigung hängt von Ihrem Mobilfunkanbieter ab. Einige Anbieter melden die Zustellung zuverlässig, andere nicht. Ein „Gesendet“-Status bedeutet, dass das Telefon die Nachricht verschickt hat.
  • Konto- / Nummernrisiko. Die Verwendung einer persönlichen Nummer für automatisiertes geschäftliches Texten kann gegen die Bedingungen Ihres Mobilfunkanbieters verstoßen und bei Missbrauch dazu führen, dass die Nummer gedrosselt oder gesperrt wird. Nutzen Sie sie verantwortungsbewusst, holen Sie die Zustimmung ein und fügen Sie Anweisungen zum Abbestellen 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 anhand des Startbildschirms der Gateway-App – diese werden neu generiert, wenn Sie die App neu installieren oder zurücksetzen.
  • Bestätigen Sie, dass das Telefon über eine Internetverbindung verfügt und der Cloud-Server-Modus in der App aktiviert ist.
  • Verwenden Sie den Benutzernamen und das Passwort vom Startbildschirm der App, nicht eine Geräte-ID, ein Registrierungstoken oder Anmeldedaten für einen anderen Server.

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.