Skip to main content

General

  • Bitrix24 Integration

    Sign up for a free Plivo account, and register for or log in to a Bitrix24 account. Then search for Plivo in the Bitrix24 Marketplace, and install Plivo by clicking on the Install button.

    image2.gif

    You'll then be redirected to the Plivo Application page. Enter your Plivo Auth ID, Auth Token, and sender ID details. Save the details, then 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 if the destination number is a US/Canada number.   

    Test and validate

    Once you're done with the implementation, you can test the setup from the Test SMS page. You can trigger a test SMS message by entering a destination number and message content. 

    Note: 

    • You can trigger bulk SMS messages to multiple recipients by providing a list of destination numbers separated with the delimiter "<" (e.g. 14156667777<14157778888<14158889999).
    • Bitrix24/Plivo integration supports only outbound SMS.
  • How can I enable SMS and MMS through toll-free numbers?

    By default, toll-free numbers are not whitelisted for your account. To get your account and use case whitelisted so you can send SMS and MMS messages through your toll-free number, enter your details in the Plivo Toll-Free Questionnaire form, then open a ticket with Plivo support using the email address you used to fill in the form.

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

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

    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 message:

    Here is my first line
    Here is my second line

    In your own applications, you can use similar syntax, updating several <variables> and strings:

    • Line 1 — your Auth ID
    • Line 2 — your Auth ID and Auth Token
    • Line 3 — a valid sender/from number
    • Line 4 — a valid destination number
    • Line 5 — the desired message text
  • What countries do you support for SMS?

    We support inbound SMS in the following countries:

    Australia
    Austria
    Belgium
    Canada
    France
    Netherlands
    Sweden
    United Kingdom
    United States

    We support outbound SMS in more than 200 countries.

  • What's the difference between promotional and transactional SMS messages?

    A promotional SMS message is sent with the objective of promoting a product or service. These are sales and marketing messages which may or may not be solicited by the recipient.

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

    • Messages sent for two-factor authentication or one-time passwords
    • Notifications regarding a product or service used by a customer, such as an appointment reminder
  • How to Export Message Detail Records (MDR) and Call Detail Records (CDR)

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

     To find your MDRs and CDRs, log in to your account. Navigate to SMS or Voice, then Logs. Filter the logs by clicking on Filter Logs for SMS logs or Filter for voice logs. From the dropdown list select either "Select MDRs/CDRs on this page" or " Select all MDRs/CDRs," then click Export.

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

    The information included in your CDR or MDR export includes: 

    For a 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

     

    Call Detail Records (CDRs) and Message Detail Records (MDRs) are retained in our transactional databases for 90 days.