SMS-Zustellbericht-Zuordnung

Diese Anleitung zeigt Ihnen, wie die SMS-Zustellbericht-Zuordnung in der Ozeki SMS Gateway funktioniert. Zustellberichte sind SMS-Nachrichten, die vom Mobilfunknetz zurückgesendet werden, wenn Ihre ursprünglich gesendete Nachricht das Empfängerhandy erreicht. Wenn Sie eine SMS-Nachricht senden, gibt das Netzwerk eine Submit-Reference-ID zurück, und später, wenn die SMS an das Empfängerhandy zugestellt wird, erhalten Sie einen Zustellbericht mit dem Zustelldatum und derselben Submit-Reference-ID. In dieser GUI sehen Sie, wie die Submit-Reference-ID protokolliert wird, und Sie werden sehen, wie Sie den Zuordnungsalgorithmus für Zustellberichte der Ozeki SMS Gateway nachverfolgen können.

SMS-Zustellbericht-Zuordnung in einem Video erklärt

Im folgenden Video sehen Sie, wie die Zustellbericht-Zuordnung funktioniert. Zuerst wird die Protokollierung für die Zustellberichte aktiviert. Dann wird eine SMS über eine SMPP-Verbindung gesendet. Sie können im Video die zurückgegebene Submit-Reference-ID sehen. Diese ID wird vom Mobilfunknetzbetreiber zurückgegeben. Anschließend sehen Sie den Eintrag im Zustellberichtsregister.

Der zweite Teil des Videos zeigt, was passiert, wenn der Zustellbericht im System eintrifft. Ein Zustellbericht kommt immer zu einem späteren Zeitpunkt. Sie können den eingehenden Zustellbericht im Ereignisprotokoll der SMPP-Verbindung sehen. Beachten Sie, dass die Submit-Reference-ID für diesen Zustellbericht mit der zuvor gespeicherten Submit-Reference-ID übereinstimmt. Sobald der Zustellbericht eintrifft, können Sie die Zuordnungsereignisse im Protokoll der Zustellbericht-Zuordnungsengine sehen.

Video 1 - Wie die Zustellbericht-Zuordnung funktioniert (Video-Tutorial)

SMS-Zustellbericht-Zuordnung im Detail erklärt

Um nachverfolgen zu können, was passiert, müssen Sie die Protokollierung im Menü Bearbeiten/Einstellungen/Zustellberichte aktivieren. Stellen Sie sicher, dass die "Dateibasierte" Zustellbericht-Zuordnungsengine ausgewählt ist und das Kontrollkästchen "Zustellbericht-Zuordnungsereignisse protokollieren" aktiviert ist. (Abbildung 1)

Server-Einstellungen öffnen
Abbildung 1 - Server-Einstellungen öffnen

Im Formular der Server-Einstellungen finden Sie eine Liste von Konfigurationen. Wählen Sie den Eintrag "Zustellberichte" aus der Liste aus. (Abbildung 2)

Zustellbericht-Zuordnungsereignisprotokoll aktivieren
Abbildung 2 - Zustellbericht-Zuordnungsereignisprotokoll aktivieren

Sobald die Protokollierungsfunktion der Zustellbericht-Zuordnungsengine aktiviert ist, senden Sie eine Test-SMS. Nachdem die SMS gesendet wurde, sehen Sie die entsprechende Submit-Reference-ID im Ereignisprotokoll der Mobilfunknetzverbindung. In unserem Fall ist dies 2127518572. (Abbildung 3)

Submit-Reference-ID der gesendeten Nachricht
Abbildung 3 - Submit-Reference-ID der gesendeten Nachricht

Öffnen Sie als nächstes das Zustellberichtsprotokoll. Sie finden das Protokoll, wenn Sie im Menü "Ansicht" auf "Submit-References" klicken (Abbildung 4).

Zustellberichtsprotokoll öffnen
Abbildung 4 - Zustellberichtsprotokoll öffnen

In diesem Protokoll sehen Sie den Eintrag: "Submit reference added: 2127518572". Dieser Eintrag ist wichtig, weil nachdem dieser Eintrag im System registriert wurde, Zustellberichte, die mit dieser ID eingehen, der entsprechenden SMS zugeordnet werden können. Wir benötigen diesen Zuordnungsmechanismus, damit wir den Status der entsprechenden SMS auf "zugestellt" setzen können. (Abbildung 5)

Submit-Reference-ID im Zustellberichtsprotokoll
Abbildung 5 - Submit-Reference-ID im Zustellberichtsprotokoll

Im letzten Teil überprüfen Sie den eingehenden Zustellbericht. Wenn Sie sich das Protokoll der Mobilfunknetzverbindung ansehen, werden Sie eine Zeile sehen, die mit den Worten "Delivery report from..." beginnt. In dieser Zeile sehen Sie die ursprüngliche Submit-Reference-ID und den Zeitstempel der Zustellung. (Abbildung 6)

Submit-Reference-ID des Zustellberichts
Abbildung 6 - Submit-Reference-ID des Zustellberichts

Nachdem der Zustellbericht empfangen wurde, gehen Sie zum Protokoll der Zustellbericht-Engine im Menü "Ansicht"/"Submit-References" und werfen Sie einen Blick auf das Zuordnungsereignis. (Abbildung 7)

Zustellbericht-Zuordnungsereignis im Zustellberichtsprotokoll
Abbildung 7 - Zustellbericht-Zuordnungsereignis im Zustellberichtsprotokoll

FAQs

Warum werden meine Zustellberichte verworfen?

Bei der Verwaltung eines SMS-Gateways ist es entscheidend, dass Zustellberichte die gesendeten Nachrichten korrekt widerspiegeln. Manchmal können jedoch Berichte auftauchen, denen keine entsprechende Nachricht in Ihrem System zugeordnet ist. Hier eine Übersicht möglicher Ursachen:

1. Referenz-ID-Fehlabgleich:

  • Die SMSC könnte im Zustellbericht eine andere Referenz-ID zurückgeben als im Übermittlungsbericht. Selbst eine minimale Abweichung kann dazu führen, dass die Ozeki-Software den Bericht nicht der ursprünglichen Nachricht zuordnen kann.
  • Lösung: Überprüfen Sie das Ereignisprotokoll des Dienstleisters in Ozeki, um die ursprüngliche Nachricht zu finden und deren Referenz-ID zu verifizieren.

2. Nicht eindeutige Referenz-IDs:

  • Einige Dienstleister vergeben möglicherweise dieselbe Referenz-ID für mehrere Nachrichten. Dies führt zu Konflikten bei der Registrierung der Nachrichten in der Ozeki-Referenztabelle. Folglich werden Zustellberichte für die zweite Nachricht (mit der doppelten ID) verworfen.
  • Lösung: Dieses Problem liegt beim Dienstleister. Kontaktieren Sie ihn, um die Vergabepraxis der Referenz-IDs zu überprüfen.

3. Nachrichtenalter überschreitet Speicherlimit:

  • Die Ozeki-Software speichert Referenz-IDs für einen festgelegten Zeitraum (normalerweise eine Woche). Zustellberichte für ältere Nachrichten werden aufgrund von Datenbankgrößenbeschränkungen verworfen.
  • Lösung: Dies ist eine Systemkonfiguration, um Funktionalität und Speicherbedarf auszugleichen. Eine Verlängerung des Speicherzeitraums für Referenz-IDs ist möglicherweise nicht ideal, daher sollten alternative Lösungen wie die Archivierung älterer Nachrichten in Betracht gezogen werden.

4. Vorzeitiges Löschen der Nachricht:

  • Wenn die ursprüngliche Nachricht aus dem "Gesendet"-Ordner gelöscht wird oder automatische Löschung aktiviert ist, kann die Nachricht fehlen, wenn der Zustellbericht eintrifft.
  • Lösung: Überprüfen Sie Ihre Lösch-Einstellungen. Vermeiden Sie das Löschen gesendeter Nachrichten vor Erhalt des Zustellberichts, insbesondere bei kritischen Kommunikationen.
Durch das Verständnis dieser möglichen Ursachen können Sie nicht zugeordnete Zustellberichte in Ihrem Ozeki-SMS-Gateway effektiv beheben und eine genaue Nachrichtenverfolgung sicherstellen.

Was kann ich in der GUI des Zustellberichtsregisters sehen?

Diese Tabelle dient als Repository für ausstehende Nachrichten. Dabei handelt es sich um Nachrichten, die zur Zustellung übermittelt wurden, für die jedoch noch keine Zustellbestätigung (Bericht) eingegangen ist. Die Nachricht bleibt in dieser Tabelle gelistet, bis ein Zustellbericht vorliegt. Wenn innerhalb eines vordefinierten Zeitraums (typischerweise eine Woche) keine Bestätigung eintrifft, wird die Nachricht aus der Tabelle entfernt. Dieser Prozess gewährleistet eine effiziente Verwaltung der Nachrichtendaten und verhindert die Ansammlung veralteter Einträge.

More information