Postman v2 Guide
Go to Postman v2
  • Postman v2 API Docs
    • 🤖About Postman v2
      • Postman v2 SLOs
    • Postman v2 SMS API user documentation
    • 📶Service Status
    • ⏰Postman Guide latest updates
    • 🏋️Important dates
    • 🛒Useful Links
  • Postman v2 general user guide (MoP)
    • 🔐Logging into Postman v2
    • 📢Create Campaign
      • Message Preview
      • Language tab
      • Message content
      • Character count
    • 🪵Message Logs
    • Deleting campaigns
  • Postman v2 Admin Portal, for UI Users (MOP)
    • 📤Sending messages via the Admin Portal
  • Postman v2 Admin Portal for API users (MOP)
    • ⚙️Campaign Settings
    • 🖥️Sending Messages via Postman API
  • 🪪Sending SMSes using NRIC
  • Postman v2 admin portal, for UI users (Internal)
    • Internal SMS
    • Information for new Twilio users
    • Summary of Costs
    • How do I onboard Postman v2 Internal SMS
      • 1. Sender ID Registration
      • 2. Sign up for a Twilio account
      • 3. Set up your Twilio account
      • 4. Fill your Twilio credentials on Postman
        • What if I need to buy a phone number?
      • 5. Send a Test Message
  • General notes for API users
    • 🗒️Overview
    • Authentication
    • API Errors
    • Message Delivery Errors
    • Pagination
    • Rate Limits
  • Endpoints for API users
    • 📞Endpoints for API users
    • The message object
    • Single Send
    • Single Send - Retry
    • Retrieve Message
    • Batch Send
    • Batch Send - Retry
    • Retrieve Batch
    • Retrieve Campaign Message
  • SFTP
    • 📂SFTP Integration
    • 🗝️Generating SSH Keys
    • Connecting to the SFTP server
    • Sending messages via SFTP
    • Checking whether sending via SFTP is successful
  • Load Test
    • Load Test Booking Requirement
  • FAQ
    • ❓Postman v2 FAQ
      • General Q&A
      • Sending emails to users (Legacy Postman)
      • Access related inquiries
      • Platform access related inquiries
      • User Access
      • API keys generation and IP Address whitelisting
      • Delivery Report
      • Messaging
      • Message Statuses
      • Integration and configuration related inquiries
      • Delivery rate
      • File types
      • SFTP and other integration methods
    • 💻Postman v2 API FAQ
      • API keys generation
      • Campaign related inquiries
      • API related inquiries
      • IP Address related inquiries
    • 🗃️SFTP and Other integration methods
  • Legal
    • Terms & Condition
    • Privacy Policy
  • Call App
    • Terms & Condition
    • Privacy Policy
Powered by GitBook
On this page
  • Single recipient
  • Formatting a single message
  • Multiple recipients
  • Formatting messages to multiple recipients
  • Postman Test Site: limitations
Export as PDF
  1. Postman v2 Admin Portal, for UI Users (MOP)

Sending messages via the Admin Portal

How do I use the admin portal (Postman UI) to send out messages?

PreviousDeleting campaignsNextCampaign Settings

Last updated 7 months ago

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

Single recipient

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.

All message parameters needs to be filled before you can send out the message.

Formatting a single 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.

Multiple recipients

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

  1. Download campaign .csv template

  2. Edit the .csv template and save it as a .csv file

  3. 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.

Recipient

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:

  1. Overloading the queue at the telco provider

  2. Leading to failed delivery attempts, which generate error messages

  3. Failed delivery attempts are still being charged

  4. These numbers are actually real numbers that are owned by MOPs

List of "fake" numbers:

  1. 6590000000

  2. 6599999999

  3. 6588888888

Language

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.

Formatting messages to multiple recipients

You may start entering fields into each message parameter in your csv file.

Formatting in Excel

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

Formatting in text editor

Text Editor: Commas, line breaks, quotation marks

When formatting your messages in a text editor,

  1. Ensure that all parameters are separated by commas

  1. 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

  2. Should your message content contain line breaks, please add the line breaks in your parameters within quotations, see image "Example csv in text editor".

  1. 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 Test Site: limitations

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.

Message language option is only available if the campaign admin has selected multiple languages during the . If no languages have been added, the default language will be English and you will not be able to select other languages.

The header row will require to match the created, such as containing lowercase letters, numbers and _.

We have our dedicated load test environment if you wish to conduct load test using these numbers. Book your time slot for load test . 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 for more information.

📤
here
here
recipient
language
Populate the required fields
Step 1 and 3: Postman admin portal
Step 2: Edit .csv file - the header row will be automatically populated based on the message parameters input in the message template
Unable to upload file as csv was wrongly formatted
Example csv in text editor
Message with line breaks
Quotation marks and commas within message
campaign creation process
variables