Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

What is the SMS Notification Service?

This notification service has been specifically introduced for customers using the SMS Invite service for Hosted Web. This is a push notification service and will notify customers (on a configured URL) - when the status of an SMS reaches a final state in greenID. This allows customers to take necessary steps in their workflow - for example, sending the SMS again if the SMS failed to be delivered to the individual attempting verification.

How does it work?

Once a phone number has been successfully submitted to greenID for sending an SMS,  greenID will send an API response to the customer which will contain a 'submitted' status (among other output fields). This service enables customers to receive a notification to a specific URL once we are informed by our SMS provider of the final delivery status of the SMS i.e. Delivered, Undelivered or Failed. Below is the explanation of the SMS statuses:

Status 

Explanation

Delivered

SMS Service Provider has received confirmation of message delivery from the upstream carrier, and, where available, the destination handset.

Undelivered

SMS Service Provider received a delivery receipt indicating that the message was not delivered. This can happen for several reasons including carrier content filtering and the availability of the destination handset.

Failed

The message could not be sent.  

When a notification is sent to the customer's URL, it will contain:

  • verificationID

  • SMS Status

  • SMS ID

How can this be setup?

The notification URL is set as a property for a client organisation and can only be configured or changed by GBG staff. Please contact your account representative for more information.

Include Page
greenID include
greenID include

On This Page

Table of Contents
minLevel1
maxLevel7
Include Page
greenID Hosted Web A-Z
greenID Hosted Web A-Z