(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start': new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0], j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.data-privacy-src= 'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f); })(window,document,'script','dataLayer','GTM-TT9ZP96');

Knowledge Base

SMS Data Collection Postback

The SMS Data Collection postback API notifies you that a customer has replied to your data collection questions via SMS. To receive SMS Data Collection postback, you need to configure the callback settings of your SMS Data Collection flows created on the Skycore platform. Once SMS Data Collection postback is enabled, you will start receiving postbacks for replies to your data collection flows.

The SMS Data Collection callback settings consist of the callback URL, callback method, and the additional personal variables to be passed to the callback.

  • The callback URL is used to determine where the collected data is sent to. You can also add dynamic merge tags to the callback URL.
  • The callback method can be set to HTTP POST, HTTP GET, or JSON POST to receive all of the answers in the data collection set.
  • The additional personal variables can be configured and will be passed to the callback URL along with the collected data when the flow is completed.

Merge Tag Data

Dynamic Merge tags can be used in the Callback URL. It follows the format {$variable}. These tags will be replaced with the answers collected for the data collection questions if the merge tag matches the variable where the answer is stored. For example, if you have data collection questions setup like the following:

Q1. What is your First name? – Response or answer to this question is stored in a variable “$firstname”

Q2. What is your Last name? – Response or answer to this question is stored in a variable “$lastname” 

And your callback URL is set up in the following format using the dynamic merge tags:

https://mycallbackurl/callback?first={$firstname}&last={$lastname}

Then the tags {$firstname} and {$lastname} will be replaced with answers stored in the variables $firstname and $lastname respectively.

Callback Methods

1. HTTP POST (Key/Value Pair)

Data Collection Via SMS (MO) 
POST {Callback URL} HTTP/1.1
Content-Type: application/x-www-form-urlencoded
 
phone=10000000000&sender=00000firstname=John&lastname=Appleseed

2. HTTP GET (Query String)

Data Collection Via SMS (MO) 
GET {Callback URL} HTTP/1.1
Content-Type: application/x-www-form-urlencoded
 
phone=10000000000&sender=00000&firstname=John&lastname=Appleseed

 3. JSON POST (Raw JSON)

Data Collection Via SMS (MO)
POST {Callback URI} HTTP/1.1
Content-Type: application/json
 
{"phone":"10000000000","sender":"00000","firstname":"John","lastname":"Appleseed"}
Go to Top