Skip to main content

General

  • Bitrix24 Integration

    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. 

    image2.gif

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

    image1.gif

    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.
  • How to enable SMS/MMS through TollFree numbers?

    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.

  • How do I add a line break in my SMS or MMS message?

    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
  • What countries do you support for SMS?

    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. 

     

  • What is the difference between promotional and transactional SMS messages?

     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. 

  • How to Export Message Detail Records (MDR) and Call Detail Records (CDR)

    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