General

Prerequisites

Sign up for a Plivo Account

When you sign up with Plivo, you will start with a free trial account to experiment with and learn about our services. This free trial account comes with free credits. If you wish to continue with our service, you can add more credits and purchase a number by clicking here. Add a number and credits to your account to start testing the full range of our voice and SMS service features.

Sign up here to get your free Plivo account today.

Follow these steps to successfully sign up for a free trial account:

1. Sign up with your work email address
2. Check your inbox for an activation email from Plivo. Click on the link in the email to activate your account.
3. Enter your mobile number to complete the phone verification step.

Create a Bitrix24 account

You can signup/login to your Bitrix24 account from here.

Install Plivo Application on your Bitrix24 Account 

Once logged in, you can refer to the below GIF/instructions to install the Plivo app on your Bitrix24 account. 

• Search for Plivo on the Applications page. 
• Install Plivo by clicking on the Install button. 

Implementation

Once installed, you will be redirected to the Plivo Application page. please enter your Plivo Auth ID, Auth Token details, and Sender ID details. Save the details and click on the “Test SMS” button to validate the integration. 

Please Note that Sender ID refers to the Source Number. You can rent a Plivo US/Canada number from here if the destination number is a US/Canada number.   

Test and Validate

Once you are done with the implementation, you can test the setup from the “Test SMS” page. You can trigger a test SMS by entering the Destination Number and Message Content. 

Note: 

• You can trigger bulk SMS [to multiple recipients] by simply providing a list of destination numbers separated with the delimiter ‘<’. (e.g. 14156667777<14157778888<14158889999).
• Bitrix24/Plivo integration currently only supports Outbound SMS.

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, log in to your account -> Navigate to Voice/ SMS -> Logs -> Filter the logs as per your requirement by clicking on the "Filter Logs" for SMS logs and "Filter" for voice logs -> from the dropdown list select either "Select MDRs/CDRs on this page or " Select all MDRs/CDRs" and click on "Export".

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