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:

StatusberichtErklärungFinaler Status
DELIVEREDDie SMS wurde erfolgreich zugestellt.
NOTDELIVEREDDie SMS konnte nicht zugestellt werden. Bitte prüfen Sie ggf. die Empfängernummer.
BUFFEREDDie SMS wurde erfolgreich verschickt, wurde aber durch das SMSC zwischengespeichert, da der Empfänger nicht erreichbar ist.
TRANSMITTEDDie SMS wurde durch das SMSC verschickt und sollte demnächst ankommen.
ACCEPTEDDie SMS wurde durch das SMSC akzeptiert.
EXPIREDDie SMS wurde nicht vor Ablauf der Gültigkeitsperiode empfangen.
REJECTEDDie SMS wurde durch den Betreiber abgelehnt.
FAILEDEs ist ein Fehler beim Versand aufgetreten.

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"
  }
]