Statusberichte

Über Statusberichte können Sie die erfolgreiche Zustellung einer SMS und den jeweiligen Zeitpunkt nachvollziehen. Es bieten sich Ihnen grundsätzlich zwei Möglichkeiten: Die wesentlich effizientere und schnellere Methode ist ein Webhook direkt an Ihren Server. Sobald ein neuer Status vorhanden ist, wird automatisch Ihre gewünschte URL aufgerufen. Die alternative Methode ist es, über eine Anfrage an die API direkt den Status von SMS abzufragen. Sollte noch kein Status vorhanden sein, müssten Sie ggf. später erneut anfragen. Bitte verwenden Sie bestenfalls die Webhooks. Beide Varianten lassen sich auch kombinieren, zum Beispiel falls der Webhook fehlgeschlägt.

SMS Flowchart

Sie erhalten Aktualisierungen ausschließlich für Statusberichte, die nicht intern (Created, Queued, Processed) sind, sondern vom Netzbetreiber gesendet wurden:

Statusbericht	Erklärung	Finaler Status
`DELIVERED`	Die SMS wurde erfolgreich zugestellt.
`NOTDELIVERED`	Die SMS konnte nicht zugestellt werden. Bitte prüfen Sie ggf. die Empfängernummer.
`BUFFERED`	Die SMS wurde erfolgreich verschickt, wurde aber durch das SMSC zwischengespeichert, da der Empfänger nicht erreichbar ist.
`TRANSMITTED`	Die SMS wurde durch das SMSC verschickt und sollte demnächst ankommen.
`ACCEPTED`	Die SMS wurde durch das SMSC akzeptiert.
`EXPIRED`	Die SMS wurde nicht vor Ablauf der Gültigkeitsperiode empfangen.
`REJECTED`	Die SMS wurde durch den Betreiber abgelehnt.
`FAILED`	Es ist ein Fehler beim Versand aufgetreten.

Je nach Netzbetreiber können unterschiedliche Statusberichte gesendet werden. Die meisten Netzbetreiber senden nie einen BUFFERED Status. Technisch gesehen ist der DELIVEREDStatus zwar eine direkte Rückmeldung des Endgeräts, allerdings kommt bei einigen Zielnetzen vor, dass falsche Statusberichte zurückgesendet werden. Darauf haben wir leider keinen Einfluss.

Statusberichte per Webhook

Idealerweise sollten Sie Aktualisierungen zu einer SMS per Webhook abonnieren. Dies ist die beste und schnellste Methode, um die Statusberichte zu erhalten. Sollte das aus technischen Gründen nicht möglich sein, zum Beispiel weil Sie keinen öffentlich erreichbaren Server haben, können Sie die Statusberichte per API abfragen.

GET/api/statusVeraltet

Statusberichte abfragen

Fragen Sie den Status einer SMS ab. Diese Abfrage ist höchstens 30 Tage nach Versand einer SMS möglich. Bitte beachten Sie, dass diese API veraltet ist und bald abgeschaltet werden kann. Nutzen Sie stattdessen die Abfrage des Logbuchs mit der ID der Nachricht als Parameter.

Parameter

Name
msg_id
Type
string
Description
Die ID der SMS, deren Status Sie abfragen möchten. Mehrere IDs können jeweils durch ein Komma getrennt angegeben werden.

Anfrage

GET

/api/status

curl -G https://gateway.seven.io/api/analytics \
  -H "X-Api-Key: IHR_API_SCHLÜSSEL" \
  -H "Accept: application/json"
  -d "msg_id=77232007287,77232007195"

Antwort

[
  {
    "id": "77232007287",
    "status": "DELIVERED",
    "status_time": "2024-02-16 15:43:16.905"
  },
  {
    "id": "77232007195",
    "status": "DELIVERED",
    "status_time": "2024-02-16 15:42:19.989"
  }
]