Ablauf einer Confirmation

Starten einer Confirmation

Das Starten einer Confirmation erfolgt via Web-Oberfläche oder via REST-API.

Verlaufsvarianten

Die Statusmeldungen im Rahmen einer Confirmation geben Aufschluss über den Verlauf des Bestätigungsprozesses.

Bei den Statusmeldungen wird unterschieden zwischen Statusangaben, die sich auf den gesamten Bestätigungsprozess beziehen (Confirmation Status) und solchen, die nur in Bezug zu einzelnen Nachrichten im Verlauf einer Confirmation stehen (Message Status).

In ConfirmationCheck gibt es die folgenden Statusmeldungen:

• Confirmation Status „Initialize“: Die Anfrage für das Starten des Bestätigungsprozesses wurde vom Server erhalten.
• Confirmation Status „Pending“: Die initiale Nachricht wurde an die Zielrufnummer versendet.
• Message Status „IntroductionMessageDelivered“: Der genutzte Messaging Service hat bestätigt, dass die initiale Nachricht an die Zielrufnummer zugestellt wurde.
• Confirmation Status „Resolved“: Der Smartphone-Nutzer hat innerhalb der für die Confirmation vorgesehenen Zeit für die Confirmation Expiration (min) eine SMS-Nachricht übermittelt, die exakt der erwarteten Nachricht (Expected Message) entspricht.
• Message Status „ResolvedMessage“: Es wurde die im Template für die Confirmation konfigurierte Resolved Message an den Smartphone-Nutzer versandt.
• Message Status „ResolvedMessageDelivered“: Der genutzte Messaging Service hat bestätigt, dass die im Template für die Confirmation konfigurierte Resolved Message an die Zielrufnummer zugestellt wurde.
• Confirmation Status „Tryagain“: Es wurde die im Template für die Confirmation konfigurierte Try Again Message an den Smartphone-Nutzer versandt.
• Message Status „TryagainMessageDelivered“: Der genutzte Messaging Service hat bestätigt, dass die im Template für die Confirmation konfigurierte Try Again Message an die Zielrufnummer zugestellt wurde.
• Confirmation Status „IncorrectAnswer“: Ist im Template für die Confirmation keine Try Again Message konfiguriert, bedeutet diese Statusmeldung das Folgende: Der Smartphone-Nutzer hat innerhalb der für die Confirmation vorgesehenen Zeit für die Confirmation Expiration (min) über die Zielrufnummer an die Quellrufnummer eine Nachricht übermittelt, die nicht der erwarteten Nachricht (Expected Message) entspricht.
  Ist im Template für die Confirmation eine Try Again Message konfiguriert, bedeutet diese Statusmeldung, dass nach Versand der Try Again Message vom Smartphone-Nutzer innerhalb der für die Confirmation vorgesehenen Zeit für die Confirmation Expiration (min) über die Zielrufnummer an die Quellrufnummer eine Nachricht übermittelt wurde, die nicht der erwarteten Nachricht (Expected Message) entspricht.
• Confirmation Status „Aborted“: Der Bestätigungsprozess wurde manuell abgebrochen.
• Confirmation Status „Timeout“: Es wurde innerhalb der für die Confirmation vorgesehenen Zeit für die Confirmation Expiration (min) keiner der folgenden Confirmation Status erreicht: „Resolved“, „ResolvedIncorrectAnswer“, „Aborted“, „Overwritten“.
• Confirmation Status „Overwritten“: Es kann immer nur ein Bestätigungsprozess für eine Kombination aus Quell- und Zieltelefonnummer gleichzeitig aktiv sein. Sobald eine Confirmation gestartet wird, für deren Quell- und Zieltelefonnummer ein Bestätigungsprozess gerade aktiv ist, wird dieser bereits laufende Bestätigungsprozess mit dem Status „Overwritten“ abgebrochen.
• Message Status „FailureMessage“: Es wurde die im Template für die Confirmation konfigurierte Failure Message an den Smartphone-Nutzer versandt.
• Message Status „ResolvedMessageDelivered“: Der genutzte Messaging Service hat bestätigt, dass die im Template für die Confirmation konfigurierte Resolved Message an die Zielrufnummer zugestellt wurde.

Ergebnisse von Confirmations erhalten

Via API

Siehe API Reference

Via CSV-Export

In ConfirmationCheck können Confirmations mit Detailinformationen aus der Benutzeroberfläche als signiertes CSV exportiert werden. Der Export umfasst im Standard alle im System vorhandenen (also nicht gelöschten) Confirmations. Die zu exportierenden Confirmations können durch das Setzen von Filtern eingeschränkt werden.

Beim Export erhält man ein ZIP-Verzeichnis, das einen Ordner mit Dateien namens „confirmations.csv.signature“, publickey.pem“ und „confirmation.csv“ enthält.

Bei der Datei „confirmations.csv.signature“ handelt es sich um die Signatur, die sich mit der „publickey.pem“-Datei überprüfen lässt (Siehe FAQ: CSV auf Unversehrtheit prüfen).

In der Datei „confirmations.csv“ sind exportierte Confirmations mit Detailinformationen enthalten. Diese Datei kann beispielweise in Tabellenverarbeitungsprogrammen geöffnet und weiterverarbeitet werden.

Die folgende Tabelle zeigt den Aufbau der confirmations.csv-Datei:

Inhalt CSV	Beschreibung
Confirmation ID	Siehe: Komponenten einer Confirmation
Template ID	Siehe: Komponenten einer Confirmation
Source Phone Number	Siehe: Komponenten einer Confirmation
Target Phone Number	Siehe: Komponenten einer Confirmation
Date Initialized	Siehe: Komponenten einer Confirmation
Time Initialized	Siehe: Komponenten einer Confirmation
Export Status	Confirmation Status bei Export der CSV-Datei
Export Time	Datum und Uhrzeit bei Export der CSV-Datei
Callback URL	Siehe: Komponenten einer Confirmation
Introduction Parameters	Siehe: Komponenten einer Confirmation
Introduction Message	Siehe: Komponenten einer Confirmation
Confirmation Parameters	Siehe: Komponenten einer Confirmation
Expected Message	Siehe: Komponenten einer Confirmation
Try Again Message	Siehe: Komponenten einer Confirmation, nur in CSV sofern im Rahmen der Confirmation verschickt
Failure Message	Siehe: Komponenten einer Confirmation, nur in CSV sofern im Rahmen der Confirmation verschickt
Resolved Message	Siehe: Komponenten einer Confirmation, nur in CSV sofern im Rahmen der Confirmation verschickt
Received Message 1	Siehe: Komponenten einer Confirmation, nur in CSV sofern im Rahmen der Confirmation erhalten
Received Message 2	Siehe: Komponenten einer Confirmation, nur in CSV sofern im Rahmen der Confirmation erhalten
Received Message 3	Siehe: Komponenten einer Confirmation, nur in CSV sofern im Rahmen der Confirmation erhalten
JSON	Protokollierung der jeweiligen Confirmation im JSON-Format