General

By default, TollFree numbers are not whitelisted for your account. You need to connect with Plivo to get your account & use case whitelisted. Post this verification process, you will be able to send SMS/MMS through TollFree numbers. Listed below is the process to enable SMS/MMS in your TollFree numbers.

To enable SMS/MMS in your Tollfree number:

1. Fill the required details in this form: https://docs.google.com/forms/u/1/d/e/1FAIpQLSfVR8ajPSsZpcfADMH0yHXDbmPO0s8opx8_kE0DLNYU6Yi0kA/viewform

2. Raise a ticket to Plivo-Support referring to the email id used to fill the above form.

To include line breaks in your messages sent from Plivo, you may need to encode the line break \n in your code. Here’s an example of how this works:

Java

curl -X POST https://api.plivo.com/v1/Account/<auth_id>/Message/ \
  -u <auth_id>:<auth_token> -H 'Content-Type: application/json' \
  -d '{  "src" : "14845355114", 
  "dst" : "14845355111"  , 
  "text": "Here is my first line\nHere is my second line" 
}'

This example sends an outbound message from the sender (484) 535-5114 (+14845355114) to the recipient at (484) 535-5111 (+14845355111), and includes the following message:

Here is my first line
Here is my second line

• Line 1 update with your Auth ID
• Line 2 update with your Auth ID and Auth Token
• Line 3 update with a valid sender/from number
• Line 4 update with a valid destination number
• Line 5 update with the desired message text

Currently, we support inbound SMS in the following countries:

Australia
Austria
Belgium
Canada
France
Netherlands
Sweden
United Kingdom
United States

Note: phone numbers that can receive SMS messages are labeled “SMS-enabled”.

Outbound SMS:

For outbound SMS, we support more than 200 countries. Please check our pricing page to get country-level details. 

 Promotional SMS: this type of message is sent with the objective of promoting a product or service. These messages are sales and marketing SMS’s which may or may not be solicited by the recipient.

 Transactional SMS: this type of message is sent to your customers with the purpose of passing on information necessary for using your product or service. For example: 

a) SMS sent for two-factor authentication, one-time passwords, etc.

b) Notifications regarding a product or service used by an existing customer, such as an appointment reminder. 

Customers can generate the Message Detail Record (MDR) and Call Detail Record (CDR) reports directly from their Plivo Console. 

 To find your MDR and CDR, login to your account. Navigate to Voice/ SMS, Logs, Set the Date Range, and click on Export All.

Call Detail Records (CDRs) and Message Detail Records (MDRs) will be retained in our transactional databases for a period of 90 days. Click here for more info. 

If the logs are too large, exported logs will be emailed to your registered email address. If the logs are within the downloadable limit, the file will automatically be downloaded to your device. 

The information included in your CDR/MDR will include: 

For the downloaded file:

Message UUID

From

To    

To Country ISO2

Direction    

Message Time    

Status    

Error Code    

Error Reason    

Units    

Rate Per Unit (USD)    

Carrier Surcharge Per Unit (USD)    

Total Charge Per Unit (USD)    

Total Charge (USD)

For an emailed file:

Message UUID

From    

To    

Direction    

Time    

Status    

Units    

Amount    

Message Rate    

Message Charge