Antworten kommen auf der Mobilnummer an, die Ihr Kontakt bereits kennt.
SMSMobileAPI / API
Empfangene SMS API · Ihr Handy bleibt der Posteingang
Machen Sie jede auf Ihrem Handy empfangene SMS zu verwertbaren Anwendungsdaten.
Ihr Kontakt sendet eine normale SMS an Ihre bestehende Mobilnummer. Die Nachricht erreicht zuerst Ihr verbundenes Telefon; anschließend synchronisiert SMSMobileAPI die unterstützten Daten sicher, sodass Ihre Anwendung die Antwort abrufen, klassifizieren und verarbeiten kann.
Keine virtuelle Empfangsnummer ersetzt Ihr Telefon: Ihr Handy, Ihre SIM und Ihre bestehende Nummer bleiben im Zentrum des Austauschs.
AEin Kontakt sendet eine SMS
„Können Sie mich zurückrufen?“
+1 555 012 9841
Können Sie mich zurückrufen?
/getsms/200sms.received
number+15550129841
deviceVertriebs‑Handy
statusBereit
Ihre Software nutzt sie
Rufen Sie Absender, Nachricht, empfangendes Mobilgerät, Zeitstempel, GUID und optionales alias ab.
Zentralisieren Sie Antworten und behalten Sie dabei bei, welches angeschlossene Telefon jede SMS empfangen hat.
Die einfache Erklärung
Das API ersetzt Ihr Telefon nicht. Es macht die darauf empfangenen SMS nutzbar.
SMSMobileAPI legt eine sichere Software‑Schicht über ein echtes Mobil‑Postfach. So erhält Ihr CRM, Ihre Support‑Plattform oder Ihre interne Anwendung Zugriff auf die relevanten empfangenen Nachrichtendaten, ohne die von Ihren Kontakten genutzte Nummer zu ändern.
Ein Kontakt sendet eine SMS
Der Kontakt schreibt an die reale Nummer, die mit Ihrer SIM verknüpft ist.
Ihr Handy empfängt sie.
Das SMS gelangt über Ihren Mobilfunkanbieter auf das verbundene Telefon.
Die App synchronisiert sie.
Mit der erforderlichen Berechtigung und Hintergrundzugriff sendet die offizielle App die unterstützten Nachrichtendaten sicher an Ihr Konto.
Ihre Software nutzt sie
Rufen Sie sie mit dem REST API ab, empfangen Sie ein Webhook V2-Ereignis oder zeigen Sie sie in einer kompatiblen Integration an.
Eine Antwort, die Ihre Anwendung nutzen kann
Eine Anfrage liefert die Nachricht und den Kontext, der zur Verarbeitung benötigt wird.
Verwenden Sie GET /getsms/, um synchronisierte eingehende SMS aufzulisten. Filtern Sie nach empfangendem Mobilgerät, fordern Sie nur ungelesene Nachrichten an oder rufen Sie Nachrichten nach einem Unix‑Zeitstempel ab.
- number
- Der Absender im internationalen Format, sofern verfügbar.
- message
- Der vom verbundenen Mobilgerät synchronisierte SMS-Text.
- sIdentifiantPhone
- Das verbundene Mobilgerät, das die SMS empfangen hat.
- timestamp_unix
- Zeitstempel der Nachricht, geeignet zum Sortieren und für inkrementelle Synchronisation.
- guid
- Eine stabile Nachrichtenreferenz für Lesezustand und Folgeoperationen.
- alias
- Ein optionales Kontakt‑ oder Anwendungslabel.
{
"result": {
"error": "",
"sms": [{
"sIdentifiantPhone": "508b004b4aadacc4",
"timestamp_unix": 1774041814,
"message": "Can you call me back?",
"number": "+15550129841",
"guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122",
"alias": "Alex Morgan"
}]
}
}Wählen Sie das richtige Zustellungsmuster
Holen Sie Nachrichten per API ab — oder reagieren Sie sofort mit Webhook V2.
Beide Methoden verwenden dieselben Mobilfunkdaten des verbundenen Geräts. Wählen Sie je nach Funktionsweise Ihrer Anwendung oder kombinieren Sie sie für schnelle Reaktionen und zuverlässige Wiederherstellung.
Ihre Anwendung fordert Nachrichten an, sobald sie bereit ist.
- Erstellen Sie ein Postfach oder eine geplante Synchronisierung
- Nach Mobilgerät, Zeit oder ungelesenem Status filtern
- Nachrichten nach einer Unterbrechung wiederherstellen
SMSMobileAPI sendet ein sms.received-Ereignis an Ihr HTTPS-Ziel.
- Reagieren ohne Polling-Schleife
- Zuverlässige Zustellung und automatische Wiederholungsversuche nutzen
- Starten Sie einen Workflow, sobald das Ereignis verfügbar ist
Mehr als eine einfache Nachrichtenliste
Erstellen Sie einen vollständigen Workflow für empfangene SMS.
/getsms/Empfangene SMS auflisten
Verwenden Sie Filter nach Mobilgerät, Zeitstempel und Ungelesen-Status, um nur das abzurufen, was Ihre Anwendung benötigt.
/getsms/set-read/Als verarbeitet markieren
Aktualisieren Sie den SMSMobileAPI API-Lesestatus, nachdem Ihre Anwendung eine Nachricht verarbeitet hat.
/getsms/update/Ein alias anhängen
Einen Kontaktnamen oder eine Anwendungsbeschriftung mit einer empfangenen Nachricht verknüpfen.
/conversation/sms/list/Konversationen erstellen
Gruppieren Sie eingehende und ausgehende Nachrichten nach Telefonnummer für eine Support- oder CRM-Zeitleiste.
Das Markieren einer Nachricht als gelesen über die API ändert nicht den Lesestatus in der Nachrichtenanwendung des Telefons.
Was können Sie erstellen?
Von einer einzelnen Antwort bis zu einem kompletten Geschäftsprozess.
Erstellen Sie ein gemeinsames SMS-Postfach
Leiten Sie Antworten mehrerer autorisierter Telefone in eine gemeinsame Support-Ansicht, während das empfangende Mobilgerät erhalten bleibt.
Kontakt-Zeitleiste vervollständigen
Fügen Sie eingehende Antworten einem Kunden-Datensatz hinzu – neben ausgehenden SMS und zugehörigen Anrufaktivitäten.
Bestätigungen automatisch erkennen
Erkennen Sie Bestätigungen, Absagen oder Umbuchungswünsche und aktualisieren Sie den nächsten Schritt.
Wichtige Nachrichten eskalieren
Benachrichtigen Sie die richtige Person, rufen Sie ein API auf oder starten Sie eine Workflow Studio-Automatisierung, wenn die Bedingungen erfüllt sind.
Vom Start bis zur ersten API-Antwort
Empfangen Sie Ihr erstes SMS über die API in vier kontrollierten Schritten.
- 1
Mobilgerät installieren und koppeln
Installieren Sie die aktuelle offizielle SMSMobileAPI-App und verbinden Sie das kompatible Telefon mit Ihrem Konto.
- 2
Aktivieren Sie den Zugriff auf empfangene SMS
Autorisieren Sie in der Mobil‑App die Synchronisation empfangener SMS sowie die für Ihren Workflow notwendige Hintergrundausführung.
- 3
Senden Sie eine eindeutige Testnachricht
Senden Sie eine SMS von einer anderen Nummer an das verbundene Mobilgerät und überprüfen Sie sie im Log des empfangenen SMS-Dashboards.
- 4
Rufen Sie den Endpunkt sicher auf
Bewahren Sie den API-Schlüssel auf Ihrem Server auf, rufen Sie /getsms/ auf und speichern Sie die GUID, damit Ihre Anwendung doppelte Verarbeitung vermeiden kann.
FAQ zu empfangenen SMS in API
Fragen, die Entwickler und Betriebsteams zuerst stellen.
Empfängt die API das SMS anstelle meines Mobilgeräts?
Nein. Ihr kompatibles verbundenes Mobilgerät und die SIM empfangen das SMS zuerst. SMSMobileAPI synchronisiert anschließend die unterstützten Nachrichtendaten, damit Ihre Software sie abrufen kann.
Können mehrere Mobilgeräte dieselbe Anwendung versorgen?
Ja. Mehrere autorisierte Mobilgeräte können mit einem Konto verbunden werden, und die Kennung des empfangenden Geräts erlaubt Ihrer Anwendung, die Quelle jeder Nachricht beizubehalten.
Soll ich Polling oder Webhook V2 verwenden?
Verwenden Sie GET /getsms/, wenn Ihre Anwendung den Abrufplan steuert oder Wiederherstellung benötigt. Verwenden Sie das sms.received Webhook V2-Ereignis, wenn ein HTTPS-Ziel reagieren soll, sobald das Ereignis verfügbar ist. Viele Produktionssysteme kombinieren beide.
Wie vermeide ich, dieselbe Nachricht zweimal zu verarbeiten?
Speichern Sie die Nachrichten-GUID in Ihrer Anwendung und gestalten Sie die Verarbeitung idempotent. Nach erfolgreicher Verarbeitung können Sie außerdem den SMSMobileAPI API-Lesezustand aktualisieren.
Ändert das Markieren einer Nachricht als gelesen den Posteingang des Telefons?
Nein. Der Endpoint ändert den API-seitigen Lesezustand, der von SMSMobileAPI-Workflows verwendet wird; er markiert die Nachricht nicht als gelesen innerhalb der Messaging-App des Telefons.
Kann ich aus meiner Anwendung antworten?
Ja. Ihre Anwendung kann den SMS-Sende-Endpoint aufrufen, sodass ein ausgewähltes verbundenes Mobilgerät die Antwort über seine SIM und Mobilnummer sendet.
Sorgen Sie dafür, dass Ihre Software jede nützliche Antwort versteht, die auf Ihrem Mobilgerät eingeht.
Verbinden Sie ein Telefon, autorisieren Sie die received-SMS-Synchronisierung und testen Sie den vollständigen Ablauf, bevor Sie ihn auf Ihr CRM, Ihre Support-Plattform oder Ihre Automatisierung ausweiten.
