Komponenten einer Confirmation

• Confirmation ID: Die Confirmation ID entspricht der eindeutigen Nummer, mit der die Confirmation beim Start im System angelegt wird.

• Date initialized: Datum, an dem eine Confirmation gestartet wurde.

• Time initialized: Uhrzeit, zu der eine Confirmation gestartet wurde.

• Template mit Template ID: Eine Confirmation basiert immer auf einer durch diese eindeutige Nummer identifizierbaren Vorlage, in der die Texte, Parameter und sonstige Einstellungen für den Bestätigungsprozess sowie der zu verwendende Messaging Account definiert werden. Im Einzelnen werden beim Start einer Confirmation folgende Elemente aus dem Template übernommen:

  • Messaging Account mit der Source Phone Number: Der Messaging Account, der im Rahmen des Bestätigungsprozesses für das Senden und Empfangen von Nachrichten verwendet wird, wird aus dem Template übernommen. Damit ergibt sich auch die Quell-Telefonnummer (Source Phone Number), von der aus die jeweiligen SMS an den Smartphone-Nutzer gesendet und über die diese empfangen werden.
  • Introduction Message: Sind für den Introduction Text im Template Parameter hinterlegt, werden diese im Rahmen der initialen SMS einer Confirmation an den Smartphone-Nutzer individuell gefüllt. Diese erste initiale Nachricht an den Smartphone-Nutzer wird auch als Introduction Message bezeichnet.
  • Expected Message: Beim Starten der Confirmation werden die Parameter im Confirmation Text aus dem jeweiligen Template individuell ersetzt, um die Expected Message zu definieren.
  • Try Again Message: Sofern eine Try Again Message im Rahmen eines Templates konfiguriert ist, wird, wenn der Empfänger der Introduction Message eines Bestätigungsprozesses mit einer Nachricht antwortet, die von der Expected Message abweicht, diese Try Again Message als SMS an den Smartphone-Nutzer gesendet.
  • Resolved Message: Sofern im relevanten Template eine Resolved Message konfiguriert ist, wird diese verschickt, sobald im Rahmen der Confirmation die Expected Message vom Smartphone-Nutzer empfangen wurde.
  • Failure Message: Sofern im relevanten Template eine Failure Message konfiguriert ist, wird diese bei Beendigung des Bestätigungsprozesses verschickt, wenn im Rahmen der Confirmation die Expected Message nicht vom Smartphone-Nutzer empfangen wurde und die Confirmation nicht durch einen neuen Bestätigungsprozess mit der gleichen Zielrufnummer beendet wurde (Status „Overwritten“).
  • Confirmation Expiration (min): Die zeitliche Angabe, wie viele Minuten der Bestätigungsprozess aktiv ist, bevor er automatisch mit dem Status „Timeout“ beendet wird, wird auch aus dem jeweiligen Template übernommen.
  • Callback URL: Nach jedem beendeten Bestätigungsprozess wird der finale Confirmation-Status sowie eine Übersicht über sämtliche Statusmeldungen zu der jeweiligen Confirmation an einen https-Endpunkt (die Callback URL) gesendet. Standardmäßig wird im Rahmen einer Confirmation die im Template hinterlegte Callback URL verwendet. Beim Starten einer Confirmation kann eine davon abweichende Callback URL angegeben werden.

• Target Phone Number. Die Target Phone Number entspricht der Rufnummer des Smartphone-Nutzers, von dem eine Bestätigung eingeholt werden soll. Diese wird beim Starten der Confirmation angegeben und mit dieser Zielrufnummer kommt es im Rahmen des Bestätigungsprozesses zum Nachrichtenaustausch.

• Confirmation Status und Message Status: Verlaufsvarianten von Confirmations lassen sich über Statusmeldungen zur Confirmation selbst (Confirmation Status) sowie durch Statusmeldungen in Hinblick auf den Versand einzelner Nachrichten (Message Status) zum jeweiligen Bestätigungsprozess nachvollziehen. Bei Beendigung einer Confirmation wird abhängig vom Verlauf des Bestätigungsprozesses ein finaler Confirmation Status gesetzt.
  Siehe: Verlaufsvarianten von Confirmations

• Sent Messages: Für jede Confirmation werden die im Zuge des Bestätigungsprozesses an die Target Phone Number versendeten SMS-Nachrichten dokumentiert.

• Received Messages: Für jede Confirmation werden die im Zuge des Bestätigungsprozesses von der Source Phone Number seitens der Target Phone Number der Confirmation empfangenen SMS-Nachrichten dokumentiert.