Integration - SMS
The SMS module lets you setup SMS gateway over the internet. The SMS module will be used by all SMS sending operation on Kiwire such as SMS campaign and as well as SMS login function. Using SMS module, you can provide option for user to use OTP as password. OTP is to complete the SMS sign up as well as a new OTP code for every login.
* NOTE : Depending on your configuration of password security setting at Configurations -> Settings, if it is set to high, all OTP code generated is alphanumeric and if set to low all the OTP code will be numeric only.
How SMS module work:
User performs signup, Kiwire will determine if the login snippet is sms to verify the account creation or SMS content send to user will be the user credential.
Kiwire will create a SMS message with the message composition under SMS setting.
SMS gateway will send the SMS to user’s mobile number.
User will key in the SMS code to login.
The field and its function description is listed below.
Twillio Cloud SMS Gateway
Twillio is one of the world most popular cloud SMS provider. The Twillio cloud SMS option let you configure Twillio as your cloud SMS gateway.
The field and its function description is listed below.
Synchroweb SMS Gateway
The Synchroweb tab is for configuration of Synchroweb cloud SMS gateway.
The field and its function description is listed below.
Generic SMS Gateway Provider
Due to the complexity and availability of other numerous cloud or internet SMS gateway around the world, the generic SMS tab let you adapt and use most of internet SMS gateway available as your SMS gateway. A common SMS protocol around all SMS gateway provider is the support of “Post” and “Get” SMS sending API. By configuring the Generic tab to suit your SMS provider you are able to utilize our open interface. Please saved the Generic tab first in order to be able to select the generic provider from the drop down of SMS gateway provider.
The field and its function description is listed below.
Example
In this example we assume our SMS provider is call acme SMS gateway, and the http get method to trigger SMS sending is “http://gateway.acmesms.com/sendsms.jsp?accountno=[accountno]&password=[password given]&mobileno[phoneno]&msg=[sms text]” where the account no given is “myaccount”, password is “pass123” . the setup for the acme gateway will be as follow, Kiwire will append the replace the message and mobile no as per tag and generate the full URL and send the actual SMS.
Prefix
Prefix module will let you to create a telephone prefix number for each country. On the prefix listing module, you may search for specific prefix by using the search field.
The field and its function description is listed below.
Add Prefix
Click on “Add Prefix” button to create a new prefix number for a country and populate the required fields. Fill in the field to complete the process. The field and its function description is listed below.
How it works?
Mode : Send OTP to complete registration
Click on Configuration > Template > General from the navigation.
Create a new template for SMS verification code. Eg. Hi {{username}}, your verification code is {{password}}.
Click on Login Engine > Page Maker from the navigation.
Click on “Create Page” button to create a new page.
Drag SMS Sign Up snippet from the snippet selection box on the right.
Click on “Save” button and make the page as a default page.
Click on Login Engine > Sign Up Page from the navigation.
On Public Signup tab, enable the “Enable Public Self Sign Up” function and “Verification required” function.
For “Username” function, select Username from the options.
Select None for “Verification Page Template” function so it will display the default verification page. You can choose your own customize verification page. Make sure you create the customize verification page in page maker. (The input name should be “code”. Eg. <input name=”code” type=”password” placeholder=”Verification Code”>)
Select the profile that created in Account > Profile for “Link with Profile” function. Then, set the validity days. Eg. 30 days.
For “Additional Fields” function, you can select the fields for sign up page. Make sure you create the fields in Data Fields tab before select them for “Additional Fields” function. Then, click on “Save” button.
Click on Integration > SMS from the navigation.
On Twilio tab, setup your Twilio account details.
On Prefix tab, click on “Add Prefix” button to add telephone prefix number for the country that you want to send the SMS.
On Basic tab, enable the “Enabled” function and select Twilio for “Cloud SMS Operator” function.
For the “Mode” function, select Send OTP to complete registration option.
For the “SMS Content Template” function, select the template that you created in Configuration > Template > General for SMS verification code.
Select the profile that created in Account > Profile for “Link with Profile” function. Then, set the validity days. Eg. 30 days.
Enable the “Prefix Phone No With +Sign” function and click on “Save” button.
Mode : Send OTP every login
Click on Configuration > Template > General from the navigation.
Create a new template for SMS OTP code. Eg. Hi {{username}}, your OTP code is {{password}}.
Click on Login Engine > Page Maker from the navigation.
Click on “Create Page” button to create a new page for OTP code.
Drag Login snippet from the snippet selection box on the right. Click on the snippet’s HTML editor, remove the Username input field and change the placeholder for the Password input field to “OTP Code”. Then, click on “Save” button. (* NOTE : The input name should be “password”. Eg. <input name=”password” type=”password” placeholder=”OTP Code”>)
Click on Integration > SMS from the navigation.
On Basic tab, select Send OTP every login option for the “Mode” function.
For the “SMS Content Template” function, select the template that you created in Configuration > Template > General for SMS OTP code.
For the “OTP Page Template” function, select the page that you created in Login Engine > Page Maker for SMS OTP code.
Then, click on the “Save” button.
* NOTE : Other setup that made in “Mode : Send OTP to complete registration” will be the same. No changes required unless if you want.
Mode : Send user password one registered
Click on Configuration > Template > General from the navigation.
Create a new template for username and password. Eg. Your account details. Username : {{username}} & Password : {{password}}
Click on Login Engine > Page Maker from the navigation.
Click on “Create Page” button to create a new page.
Drag SMS Sign Up snippet from the snippet selection box on the right.
Click on the snippet’s HTML editor and remove the Password input field.
Click on “Save” button and make the page as a default page.
Then, click on “Create Page” button again to create a login page.
Drag Login snippet from the snippet selection box on the right and click on “Save” button.
Click on Login Engine > Sign Up Page from the navigation.
On Public Signup tab, select the Follow Journey if Possible option for the “Once Registered” function.
Click on Integration > SMS from the navigation.
On Basic tab, select Send user password one registered option for the “Mode” function.
For the “SMS Content Template” function, select the template that you created in Configuration > Template > General for username and password.
Then, select “None” for the “OTP Page Template” function and click on “Save” button.
Click on Login Engine > Login Journey from the navigation.
On Login Journey tab, click on “Create New Journey” button to create a new journey.
Fill in the fields and drag Sign Up page and Login Page from the available pages selection box.
Then, click on the “Save” button.
* NOTE : Other setup that made in “Mode : Send OTP to complete registration” and “Mode : Send user password one registered” will be the same. No changes required unless if you want.