MSG91 Destination
MSG91 provides SMS marketing/transactional automation for businesses. With Segment you can send SMS with a single call.
This destination is maintained by MSG91. For any issues with the destination, contact the MSG91 Support team.
This document is about a feature in beta
This means the feature is actively being developed, and some functionality may change before it becomes generally available.
- From your Segment UI's Destinations page click on "Add Destination".
- Search for "MSG91" in the Catalog, select it, and choose which of your sources to connect the destination to.
- Enter the "API Key" into your Segment Settings UI which you can find from your MSG91 dashboard in the API page using the 'API' option in the sidebar. It's recommended that you create a brand new API key for the Segment destination.
If you're not familiar with the Segment Specs, take a look to understand what the Identify method does. An example call would look like:
1{2"messageId": "test-message-7krupg",3"timestamp": "2019-04-16T06:33:14.682Z",4"type": "identify",5"email": "test@example.org",6"traits": {7"phone": "phone number to send SMS on",8"firstName": "Firstname of SMS receiver",9"message": "Thank you for singup, this is test SMS",10"senderID": "Ex. flipKT, MSGIND, Vodaphn"11},12"userId": "test-user-0md4g"13}
Identify calls will be sent to MSG91 as an Send SMS event.
If you're not familiar with the Segment Specs, take a look to understand what the Page method does. Make sure you send the following Properties with page method to send SMS. An example call would look like:
1{2"type": "page",3"name": "Home",4"properties": {5"phone": "Phone number to send SMS",6"firstName": "John",7"message": "Thank you for singup, this is test SMS",8"senderID": "Ex. flipKT, MSGIND, Vodaph"9}10}11
Page calls will be sent to MSG91 as a Send SMS.
If you're not familiar with the Segment Specs, take a look to understand what the Screen method does. Make sure you send the following Properties with Screen method to send SMS. An example call would look like:
1{2"type": "screen",3"name": "Home",4"properties": {5"phone": "Phone number to send SMS",6"firstName": "John",7"message": "Thank you for singup, this is test SMS",8"senderID": "Ex. flipKT, MSGIND, Vodaph"9}10}
Screen calls will be sent to MSG91 as a Send SMS.
If you're not familiar with the Segment Specs, take a look to understand what the Track method does. Make sure you send the following Properties with track method to send SMS. An example call would look like:
1{2"type": "track",3"event": "Clicked Login Button",4"properties": {5"phone": "Phone number to send SMS",6"firstName": "John",7"message": "Thank you for singup, this is test SMS",8"senderID": "Ex. flipKT, MSGIND, Vodaph"9}10}
Track calls will be sent to MSG91 as a Send SMS event.
You can check MSG91's API doc to read more about APIs and also test and create API from there.
Make sure you send the following properties/ traits to send SMS.
1"properties": {2"phone": "Phone number to send SMS",3"firstName": "John",4"message": "Thank you for singup, this is test SMS",5"senderID": "Ex. flipKT, MSGIND, Vodaph"6},
| Property/ Trait | Type | Description |
|---|---|---|
phone | Number | Phone number with country code, on which you want to send SMS: 167554321, 918818888758 |
firstName | String | First name of SMS receiver |
message | String | SMS content you want to get delivered on mobile number. |
senderID | String | Identity which will display on mobile when SMS received. Also dependent upon country rule |
For more parameters, visit MSG91 API doc