📤Sending messages via the Admin Portal
How do I use the admin portal (Postman UI) to send out messages?
Last updated
How do I use the admin portal (Postman UI) to send out messages?
Last updated
To start sending out messages, select the campaign that you wish to use. This will take you to the campaign dashboard page. You may choose to send to a single recipient or multiple recipients
Upon selecting single recipient, a pop-up will prompt you to key in your recipient's details.
Recipient's phone number
Message language*
Message parameters
Once the details have been filled in, click send to send out your message.
Message language option is only available if the campaign admin has selected multiple languages during the campaign creation process. If no languages have been added, the default language will be English and you will not be able to select other languages.
All message parameters needs to be filled before you can send out the message.
You may start entering fields into your message parameters.
Should there be a need to add commas or quotation marks in your message parameters, you may enter them in your message parameters.
Upon selecting multiple recipients, you will be prompted to upload a .csv file containing
message parameters
All message parameters need to be filled before you can send out your messages.
We highly recommend the following steps when formatting your .csv file to send out messages
Download campaign .csv template
Edit the .csv template and save it as a .csv file
Upload your .csv file
In the multiple recipients sending format, any errors in the CSV file rows will result in failure to upload your file. You will need to fix the error(s) before all messages in the batch before you are able to successfully upload your file.
The header row will require to match the variables created, such as containing lowercase letters, numbers and _.
This contains mobile phone number of the recipient, prefixed by the country code but without the leading +. For example, when sending to a Singapore phone number, the value of recipient will be 6599999999.
eg. 6591234567 is a recipient string for a Singapore (65) phone number (91234567)
Do not use "fake" numbers when sending SMS messages, even for testing purposes.
Reasons why this practice is avoided:
Overloading the queue at the telco provider
Leading to failed delivery attempts, which generate error messages
Failed delivery attempts are still being charged
These numbers are actually real numbers that are owned by MOPs
List of "fake" numbers:
6590000000
6599999999
6588888888
We have our dedicated load test environment if you wish to conduct load test using these numbers. Book your time slot for load test here. Please avoid sending messages to numbers that are not owned by you or your agency. Your agency PIC and CIO will also be informed. Click here for more information.
This column will need to be filled, even if there is only one available language that can be selected.
eg. If English is the only language you can choose in your message creation, you will need to fill every single entry with English.
You may start entering fields into each message parameter in your csv file.
Excel: Commas and quotation marks
Should there be a need to add commas or quotation marks in your message parameters, you may enter them in each cell within your excel file.
Excel: Line Breaks
Should there be a need for line breaks, you may add them in a single cell
Text Editor: Commas, line breaks, quotation marks
When formatting your messages in a text editor,
Ensure that all parameters are separated by commas
Should your content contain more than just letters, please encase them in quotations, see example above
Parameter containing more than just letters - highlighted in blue
Should your message content contain line breaks, please add the line breaks in your parameters within quotations, see image "Example csv in text editor".
Should your content contain quotation, encase the entire quote, including the quotation marks, within a set of quotations, see image "Example csv in text editor".
quote - highlighted in yellow
quotations used to encase quote - highlighted in pink
These steps will ensure that messages sent out can contain commas and quotation marks.
Postman's test site is meant for agency users to test out the platform. As such, you should test out the site like how you would send out messages to MOPs in a real scenario, where each number will only receive a single message.
If you send test messages with exact same content to the same person multiple times in 1 sitting in the same campaign:
eg. "Hi your appointment is on 1 Jan 2024" was sent to Tom 10 times within 1 batch send,
The telcos' automatic spam filter may be triggered . This means the message may not be delivered to Tom's phone at all, even though it will pass Postman’s send filters and status is reflected as delivered. See screenshot below on how the batch .csv is formatted in this failed example.
