SMS-Dokumentation

SMS senden

Endpunkt: 

Parameter:

Beispiel:

Eine nicht gesendete SMS erneut senden

Dieser API-Endpunkt dient dazu, eine nicht gesendete SMS erneut zu senden (nur wenn die Nachricht einen Fehlerstatus aufweist).

Endpunkt:

Parameter: 

Beispiel: 

Protokoll der von der API gesendeten SMS

Dieser API-Endpunkt wird verwendet, um das Protokoll der über die API gesendeten SMS-Nachrichten abzurufen.

Endpunkt: 

Parameter:

Beispiel:

Liste der vom Mobiltelefon gesendeten SMS

Dieser API-Endpunkt dient dazu, SMS-Nachrichten aufzulisten, die von Ihrem Mobilgerät gesendet und mit Ihrem SMSMobileAPI-Konto synchronisiert wurden.

Wichtig: Diese Funktion ist ab Android-Version verfügbar. 4.1.20.

Wichtig: Diese Funktion ist Standardmäßig nicht aktiviert in der Android-App.

Datenschutz: Alle synchronisierten Informationen werden anonymisiert, vertraulich behandelt und sicher verarbeitet.

Verlaufslimit: Diese API gibt immer Daten vom letzten 7 Tage nur.

Notiz: Wenn Sie SMS über den Standard-API-Endpunkt senden https://api.smsmobileapi.com/sendsms/Diese SMS können auch in dieser Liste erscheinen, da sie physisch von Ihrem Mobilgerät gesendet werden.

Endpunkt:

Parameter: 

Zurückgegebene Felder: 

Beispiel: 

Beispiel mit Filtern:

Beispiel mit vordefiniertem Zeitraum:

Empfangene SMS

Dieser API-Endpunkt dient zum Abrufen von auf dem Smartphone empfangenen SMS-Nachrichten. 

Endpunkt:

Parameter: 

Beispiel:

Empfangene SMS-Nachrichten als gelesen markieren

Dieser API-Endpunkt dient dazu, eine empfangene SMS als gelesen zu markieren. Nur API-Status.
Dies ändert nichts am Lesestatus des Smartphones.  

Endpunkt:

Parameter: 

Beispiel:

SMS-Alias aktualisieren

Dieser API-Endpunkt dient dazu, den Alias einer empfangenen SMS anhand ihrer GUID zu aktualisieren.

Notiz: Der alias Der Parameter kann leer sein. In diesem Fall wird der Alias gelöscht.

Endpunkt:

Parameter: 

Beispiel: 

Beispiel zum Löschen des Alias:

SMS löschen

Dieser API-Endpunkt dient zum Löschen von SMS-Nachrichten aus dem Serverprotokoll der SMS Mobile API.

Endpunkt: 

Parameter:

Beispiel:

Hinweis: Gelöschte SMS sind nur solche, die in den Serverprotokollen gespeichert sind. SMS auf dem Gerät werden nicht gelöscht.

SMS-Konversationen auflisten

Dieser API-Endpunkt dient dazu, SMS-Konversationen aufzulisten, die mit Ihrem Konto verknüpft sind.

Jede Konversation ist nach Telefonnummer gruppiert und enthält die zugehörigen eingehenden und ausgehenden SMS-Nachrichten.

Notiz: Der Ausgangspunkt des Gesprächs wird definiert durch origineConversation Parameter:

• received: Konversationen werden zuerst anhand empfangener SMS erkannt in logsmsreceive
• sent: Konversationen werden zuerst anhand der gesendeten SMS erkannt in logsmssent

Notiz: Wenn numero Wird kein Wert angegeben, gibt die API nur die letzten Konversationen zurück. Standardmäßig werden die letzten Konversationen zurückgegeben. 20 Die Gespräche werden erwidert.

Notiz: Für ausgehende SMS, wenn timearea_of_message ist verfügbar (Beispiel: UTC+02Das angezeigte Datum wird automatisch anhand dieses Werts umgerechnet. Dieses umgerechnete Datum wird auch zum Sortieren verwendet.

Notiz: Wenn resume=1Es werden nur die neuesten Nachrichten jedes Gesprächs angezeigt. resume_line_how um festzulegen, wie viele der neuesten Nachrichten einbezogen werden sollen.

Endpunkt:

Parameter: 

Verhaltensdetails: 

Beispiel 1 – Liste der letzten Konversationen aus empfangenen SMS: 

Beispiel 2 – Liste der letzten Konversationen aus gesendeten SMS:

Beispiel 3 – Filtern einer bestimmten Telefonnummer:

Beispiel 4 – Filtern nach Datumsbereich:

Beispiel 5 – Fortsetzungsmodus mit den letzten 3 Nachrichten pro Konversation:

Beispiel für eine erfolgreiche Antwort: 

{ "success": true, "origineConversation": "received", "resume": 0, "resume_line_how": null, "conversations": [ { "phone_number": "+10470000001", "contact_alias": "John Doe", "messages": [ { "direction": "incoming", "message_id": "msg_1001", "date": "2026-03-13 08:45:12", "timestamp_utc": "2026-03-13T08:45:12Z", "message": "Hallo, ich hätte gerne weitere Informationen.", "status": "received", "mobile_sid": "device_sid_1" }, { "direction": "outgoing", "message_id": "msg_1002", "date": "2026-03-13 10:46:03", "timestamp_utc": "2026-03-13T08:46:03Z", "message": "Natürlich, was möchten Sie wissen?", "status": "gesendet", "mobile_sid": "device_sid_2" } ] } ] }

Antwortfelder:

Fehlerbeispiel:

{ "success": false, "error": "Fehlender erforderlicher Parameter: apikey" }

Anmerkungen:

Gateway – Liste der verbundenen Mobilgeräte

Liste der mit Ihrem Gerät verbundenen Mobilgeräte auf SMS-Gateway.

Endpunkt:

Parameter:

Beispiel:

Gateway – Aktualisieren eines mobilen Labels

Aktualisiere die Bezeichnung (nom_reference) eines verbundenen Mobilgeräts.

Endpunkt:

Parameter:

Beispiel:

Wichtig: Ein Etikett ist erforderlich, kann aber leer sein. (label=).

Gateway – Ein verbundenes Mobilgerät löschen

Entfernen Sie ein verbundenes Mobilgerät von Ihrem Gateway (löscht alle Verlaufszeilen für diese SID).

Endpunkt:

Parameter:

Beispiel:

Webhook – SMS empfangen

Dieses Webhook-System sendet bei jedem SMS-Empfang eine POST-Anfrage an die konfigurierte URL. Das System stellt Echtzeit-Updates sicher, indem es die SMS-Details an die angegebene Webhook-URL sendet.

So konfigurieren Sie den Webhook im Dashboard

Befolgen Sie diese Schritte, um Ihre Webhook-URL im Dashboard einzurichten:

1. Melden Sie sich bei Ihrem Konto an auf der Dashboard der SMS Mobile API.
2. Navigieren Sie zum Webhook-Einstellungen Abschnitt.
3. Geben Sie Ihre Webhook-URL ein (z. B. https://example.com/webhook-endpoint).
4. Klicken Sie auf das Webhook speichern Taste. 
5. Nach dem Speichern beginnt das System, SMS-Details an die konfigurierte URL zu senden.

Webhook-Nutzlast

Wenn eine SMS empfangen wird, sendet das System die folgende JSON-Nutzlast an Ihre Webhook-URL:

{ "date": "2025-01-20", "hour": "10:15:00", "time_received": "2025-01-20 10:14:50", "message": "Hallo, dies ist ein Test.", "number": "+123456789", "guid": "abcde12345" }

Nutzlastfelder:

• Datum: Datum, an dem die SMS hinzugefügt wurde (JJJJ-MM-TT).
• Stunde: Stunde, wann die SMS hinzugefügt wurde (HH:mm:ss).
• Empfangszeit: Uhrzeit des SMS-Empfangs.
• Nachricht: Inhalt der SMS. 
• Nummer: Telefonnummer des Absenders.
• Anleitung: Eindeutige Kennung der SMS.

Beispiel für einen Webhook-Endpunkt

Ihr Server sollte bereit sein, eingehende POST-Anfragen zu verarbeiten. Unten finden Sie ein Beispiel-PHP-Skript zur Verarbeitung der Webhook-Nutzlast:

Testen des Webhooks

Verwenden Sie zum Testen Ihrer Webhook-Konfiguration Tools wie:

• Webhook.site
• AnfrageBin

Fehlerbehebung

• Stellen Sie sicher, dass die Webhook-URL korrekt und öffentlich zugänglich ist.
• Überprüfen Sie, ob Ihr Server bei erfolgreichen Anfragen den HTTP-Statuscode 200 zurückgibt.
• Überprüfen Sie Ihre Serverprotokolle auf Fehler bei der Verarbeitung der Nutzlast.

Erweiterte SMS

Authentifizierung

Die SMSMobile-API unterstützt zwei Authentifizierungsmethoden: die Verwendung eines einfachen API-Schlüssels oder des OAuth2-Protokolls mit einer Client-ID und einem Client-Geheimnis.

1. API-Schlüsselauthentifizierung

 Diese Methode erfordert einen API-Schlüssel, der als Parameter in eine GET- oder POST-Anfrage eingefügt werden kann.

2. OAuth2-Authentifizierung

OAuth2 bietet eine sicherere Authentifizierungsmethode.
Verwenden Sie eine Client-ID und ein Client-Geheimnis, um ein Zugriffstoken zu erhalten, und fügen Sie es dann in die folgende ein: Genehmigung Kopfzeile.

Die Client-ID und das Client-Geheimnis sind in Ihrem Dashboard verfügbar.
Laden Sie jetzt die mobile App herunter oder Greifen Sie auf Ihr Dashboard zu.

Abrufen eines Zugriffstokens

Verwenden des Zugriffstokens:

Welche Methode sollten Sie verwenden?

- Verwenden API-Schlüsselauthentifizierung für schnelle und unkomplizierte Integrationen.

- Verwenden OAuth2-Authentifizierung für mehr Sicherheit und Skalierbarkeit.