Home  >   Articles   >  Vtiger Integration with Plivo
Articles in this section

Vtiger Integration with Plivo

Learn how to use the Plivo integration in Vtiger CRM to call your contacts.
A
Abdul Sameer
24 Oct, 2024 - Updated 27 days ago
Table of Contents

Introduction

Is your office crowded with the latest phones, faxes, mobiles, etc.?
Are you finding it difficult to communicate with your customers using multiple devices?
What if your laptop or desktop had a single app that could connect you to a customer with a single click?

Well, there is - the Phone Calls module in Vtiger CRM!

With the Phone Calls module, you can connect with your contacts by simply placing a call directly from your laptop or desktop by clicking the phone call icon.

So, how does Vtiger CRM’s feature work? Let us see.

 

With the Phone Calls module installed, you can:

  • Place calls directly from your desktop or laptop. 
  • Integrate services such as Live Chat, email, call logging, purchase history, feedback surveying, support tickets, and many more. 

You can also use different telephony gateways! With the Phone Calls module, you can connect to other hosted telephony services such as Twilio, ViciDial, Knowlarity, Exotel, and Asterisk ver. 1.4 and 1.6 (without Vtiger Connector) and Asterisk ver. 1.8 - 11 (with Vtiger Connector).

Benefits of the Phone Calls feature

  • Integrated telephony (web-based) comes at a cheaper cost both in terms of hardware and handling, as calls are routed through your internet.
  • Control and coordinate your communication with a single platform. No more worries about trying to work with too many devices and losing out on a contact. 
  • Call from anywhere and anytime. You or your employees can work from the office or home or even when they are on the road. You can log in at different times and not worry about changes in weather or social conditions.
  • Provides more lines of communication and enables handling a large number of calls.
  • Switch between multiple applications and devices to see data, which makes a phone call much more efficient. 

Also, you can set up two types of gateways with Plivo:

  • Normal gateway - To set this up, you must configure an extension phone number in the agent’s preferences. When you call a client, it connects to the extension number first. Agents must receive the call on the extension number to connect with the client.
  • Client gateway - Outgoing calls directly connect to the clients when you use client gateways. You can set up client gateways only with Twilio and Plivo. 

Other Telephony Gateways in Vtiger CRM

Vtiger CRM’s integrated telephony helps to connect with the following:
  • Asterisk
  • Knowlarity
  • Telzio
  • Twilio
  • ViciDial
  • Exotel

Feature Availability

 
One Pilot One Growth One Professional One Enterprise
Feature Availability
Plivo
To know more about feature limits, click here.

Installing Phone Calls

To use the Phone Calls module, you must first install it from the Extension Store. You can access the Extension Store if you are an Admin user. 

Follow these steps to install Phone Calls:

  1. Log in to your CRM account.
  2. Click the User Menu on the top right corner of the screen.
  3. Click Settings. 
 
  1. Look for the Extensions section.
  2. Select Extension Store.
 
  1. Search for Phone Calls using the search bar.
  2. Click Install.

 

After you install the module, you can see it under Main Menu > Essentials > Conversations.

 

After you install the module, you can see it under Main Menu > Essentials > Conversations.

Configuring Plivo 

You can configure Plivo and other gateways only if you are an Admin user. Let us look at the procedure of setting up Plivo as a normal and client gateway.

Note: Log in to your Plivo account and keep both Vtiger and Plivo tabs open to set up the gateway.

Normal gateway

Let us first see how Plivo works as a normal gateway.

  • CRM admins must subscribe to the Plivo service and get their Plivo Number.
  • Individual sales or support representatives must set up their Plivo Extension Number in their CRM preferences. 
  • Incoming calls - When a customer calls on the Plivo Number, the call is routed to all the sales or support representatives. One of the members can attend the call.
  • Outgoing calls - When a sales or support representative calls a customer, the call is first routed to the member’s own extension number. The sales/support must receive the call on the extension number, after which the call connects to the customer. 

Follow these steps to set up Plivo as a normal gateway:

Perform these steps in Vtiger CRM.

  1. Log in to your CRM account.
  2. Click the User Menu on the top right corner of the screen.
  3. Click Settings.
 
  1. Look for the Extensions section.
  2. Select Phone Configuration.
 
  1. Click +Add Gateway.
 
  1. Select Plivo from the Gateway drop-down.
  2. Select Active from the Gateway Status drop-down. This activates the gateway for incoming and outgoing calls.
  3. Set the gateway as default by selecting Yes from the Default Gateway drop-down. This step is optional.


Keep both Plivo and the CRM tabs open.

  1. Log in to your Plivo account.
  2. Click Voice. 
  3. Click Overview.
  4. Copy the Auth ID and Auth Token from the Account and paste it in under Auth ID and Auth Token in the CRM.
 
 
  1. Go to Voice. 
  2. Click Applications. 
  3. Click XML. 
  4. Click Add New Application.
 
  1. Enter the application name. For example, Vtiger CRM.
 
  1. Copy Callback URL from the CRM.
 
  1. Paste it under the following in Plivo:
    1. Primary Answer URL.
    2. Hangup URL.
    3. Fallback Answer URL.
  2. Click Create Application.
 
  1. Go to Phone Numbers (# icon) from the Plivo sidebar.
  2. Click on Your Plivo number.
  3. Copy your Plivo number and paste it under Your Caller ID in the CRM. Remove all special characters from the number while you paste it.
 
 
  1. Go to Plivo, and select the application you created in Step 18 from the PHLO Name drop-down.
  2. Click Update Number.


Go back to the CRM tab.

  1. Choose the following for incoming calls:
    1. Welcome Message Type - This is an audio message that is played while a client is calling you. You can choose:
      • Message - Type the message, which is transcribed into an audio message.
      • URL - The audio on the URL is played as the audio message.
    2. Closed Message Type - This is an audio message that is played when a client calls you during your non-business hours and you are unavailable to receive calls. You can choose
      • Message - Type the message, which is transcribed into an audio message.
      • URL - The audio on the URL is played as the audio message.
    3. Busy Message Type - This is an audio message that is played when a client calls you during your business hours, but you cannot receive calls
      • Message - Type the message, which is transcribed into an audio message.
      • URL - The audio on the URL is played as the audio message.
    4. No Answer Timeout (sec) - The period after which a client’s incoming call must be disconnected before you receive it. For example, 60 seconds.
    5. Language for IVR messages - The language in which the Welcome Message must play.
    6. Business Hour Name - Select the agent’s business hours.
    7. Voicemail Email ID - When clients leave a voicemail message, it is sent to the email address you specify here.
    8. Voicemail Transcription - Choose None if you do not want a voicemail transcript. Choose Auto or Hybrid if you need a transcript. To learn about their difference, click here.
 
  1. Wait Music URL - The music that must play when a client’s call is being connected.
  2. Recording - Choose Yes if you need a recording of the call. Otherwise, choose No.
  3. Ticket/Case Title - Enter the case title. Vtiger CRM does not consider this value. There are options on the incoming call pop-up to create a case or deal.
  4. Opportunity - Enter the deal name. Vtiger CRM does not consider this value.  There are options on the incoming call pop-up to create a case or deal.
  5. Ring Incoming calls from an unknown number-
    • A mandatory field where you configure users who will be alerted by a ring.
    • You can configure all users and groups for an unknown number.
  6. Ring Incoming calls from a known number- 
    • You can configure all users, assigned users, and groups for a known number.
  7. Country- The outgoing call will have the country code of the countries chosen from the drop-down menu.
    • When you choose a country, the calls populate that country's phone code. For example, if you select India, +91 is taken to generate the calls.
    • If you keep the field blank, calls can be triggered with all other providers, and the codes will auto-populate.
    • If you select “ALL”, the CRM allows all types of country codes to do a call.
    • If you configure the same country in multiple gateway fields, the CRM displays all the providers configured with the same country code. You can choose any of the gateways to generate a call.
  1. Click Save.


Configure the extension number in the CRM. Keep both the Plivo and CRM tabs open.

  1. Click the User Menu on the top right corner of the screen.
  2. Click My Preferences.
 
  1. Click the Edit icon.
 
  1. Scroll down to Phone Preferences.
  2. Enter the extension number in the Plivo Extension field. Prefix the country code to the number and remove the + sign. For example, 919998877766. 
 
  1. Click Save.

Client gateway

Follow these steps to set up Plivo as a client gateway:

  • Perform Steps 1 to 9 mentioned in the Normal Gateway setup.
  • Keep both Plivo and the CRM tabs open.
  1. Click Voice on the sidebar.
  2. Click  Endpoints.
  3. Click Add New Endpoint.
 
  1. Enter a username, password, and alias name.
 
  1. Select XML Application from the Application Type drop-down. 
  2. Select the application you created (in Step 18) from the Application drop-down.
  3. Click Create Endpoint.
 
  1. Go to Phone Numbers (# icon) from the Plivo sidebar.
  2. Click on your Plivo number.
  3. Copy your Plivo number and paste it under Your Caller ID in the CRM. Remove all special characters from the number while you paste it.
 
  1. Go to Plivo, and select the application you created in Step 18 from the Plivo Application drop-down.
  2. Click Update Number.
 
  • Perform Steps 27 and 28 mentioned in the Normal Gateway setup.
  • Configure the Plivo extension in your preferences. Keep both the Plivo and CRM tabs open.
  1. Click the User Menu on the top right corner of the screen.
  2. Click My Preferences.
 
  1. Click the Edit icon.
 
  1. Scroll down to Phone Preferences.
 
  1. Go to Plivo and open the endpoint you created in Step 24 in the normal gateway.
  2. Copy the SIP URL from the endpoint, and paste it into the Plivo Extension field in the CRM preferences.
  3. Enter the same password you created in Step 21 in the Plivo Auth field in the CRM.
  4. Click Save.
 
 
Tips
  • When you set up a client (Twilio or Plivo only) gateway, you can see a Dialer shortcut on top of your CRM screen. You can directly dial a number and call from the shortcut. 
  • After you finish configuring, you must share your Plivo number with your customers for them to contact you.
  • Admin users can restrict other users from making or receiving calls through Profiles.

Phone Calls Features

The Phone Calls module provides the features below.

Incoming Call Pop-up

Vtiger CRM users are notified about incoming calls in the form of pop-up messages. 

So how does this feature work? Incoming calls are matched with the lead, contact, or organization records in the CRM by matching caller numbers with numbers in the CRM. 

  • If a matching number exists, then the lead/contact/organization's name is displayed in the pop-up.
  • If a matching number does not exist, you are prompted to enter the caller's email ID in the pop-up to create a new contact record.
 

And if you have multiple users manning your phone calls, say a customer care team, the incoming call pop-up is shown to all the users who have configured the extension number in their preferences

When a user answers a call, the pop-up disappears for other users.

 

So, how is this incoming call pop-up helpful to you? Well, from the pop-up, you can:

  • Search/Create a contact if there is no matching contact for an incoming call.
  • Create a deal or a case from the incoming call pop-up.
  • Transfer calls to other agents or reps.
  • Add call notes.
 

Also, you can view recent call logs in related touchpoints of the contact’s record.

Click-to-Call for Outgoing Calls

This feature is available for all outgoing calls. You can directly call your contacts from the contact or organization record by adding their phone numbers to the record.  

 

Follow these steps to place a call from a record:

  1. Log in to your CRM account.
  2. Click the Main Menu
 
  1. Go to Essentials.
  2. Select Contacts.
 
  1. Hower on any required contact in the Listview and click on the phone icon on the available options.
 
  1. Choose a gateway (if multiple are configured and active)


The call is connected automatically. The outgoing call pop-up has a dialer icon that can be used for IVR messages. 
 

Note: You can also call your contacts from the following screens:

  • Contacts’ List View
  • Contact Summary View
  • Actions
  • Related organization record
  • Related deal record
 

Call Notes

You can add notes while on a call or after the call to follow up with customers. These notes are available in the phone call records. You can also access these notes for reference whenever you call the customer again.

Customer Sentiments

After a call is completed, you can rate the customer’s experience of talking with you using one of the five sentiments: Very Negative, Negative, Neutral, Positive, and Very Positive. Recording sentiments helps you improve customer experiences in the future.

 

To learn more about customer sentiments, click here.

Call Recording

You can automatically record all incoming calls to ensure you don't miss out on the important points you discussed with your contact. You can listen to these calls later to make notes or to review what you have discussed.

Transfer Calls

Do you have a team of sales reps or customer reps handling calls in your business? Then the Transfer Call feature is perfect for you. If some of your sales reps or customer reps are busy, they can transfer the call to other agents from the incoming call pop-up with just a click. This facility is available for Plivo and Twilio users.

 

For example, if Chris is busy on a call with a customer and receives another, he can immediately transfer the second call to James, another sales representative.

 

Follow these steps to transfer a call:

  1. Log in to your CRM account.
  2. Receive the call from the incoming call pop-up.
  3. Click the Transfer icon shown on the top right of the pop-up.
 
  1. Select the agent to whom you want to transfer the call.
 
  1. Add transfer call notes, if any.
  2. Click Transfer call.

Setting up Voicemails

Are all your sales reps busy? Don’t miss a customer's call - set up a voicemail!

You can have your customers leave a message if all support representatives are busy or away from work. The voice will be recorded and sent to the owner’s primary email address, which you must specify during the setup.

Also, did you know that you can create a transcript of your voicemail messages?

 

Simply enable the Transcript field under Phone Calls. You can also send the transcript of the call to your customer. This transcript is emailed to the owner’s primary email address.
 

Note: Transcripts might not always provide an accurate representation of the audio. Transcription is available only in Plivo and Twilio.

Link Phone Calls to Business Hours

What if a customer calls when you are having an extensively busy day? Or is your business closed for the holidays or if it is your day off? Not to worry, you can now link your phone calls to your business hours by setting up a voicemail. Just record your message, and it will be played out. Customers will have the option of leaving you a message upon the completion of your voicemail.

For example: 

  • If a customer calls and all the agents are busy, a 'busy' message is played out. 
  • If a customer calls on non-working hours or a holiday, an 'away' message configured with the phone calls is played out.
​​​​​​​Note
  • The Voicemail, Transcript, and Business Hours features are available only in Plivo and Twilio.
  • You can record Interactive Voice Response (IVR) messages in any of the languages supported in Plivo and Twilio integrations.
  

Phone Call Logs

The log of the calls (incoming and outgoing) are listed under Main Menu > Essentials > Phone Calls. You can view the following details on this screen:

  • Call status, customer number, which agent or rep handled the call (mentioned in Handled By and Assigned To fields), call duration, etc.
  • Details for each call can be seen when you open the call record, such as -
    • Links to the voice recording
    • Call notes
    • Call transfer details
    • Call directions, etc.
 

You can create a list of all your phone calls, such as missed calls, completed calls, etc., from the List View. 

To learn how to create a list, click here.


Phone Call Status Values

Call status values to define the status of the calls being handled. You can see the following call statuses in the CRM.

  • Ringing: For inbound calls, before the call is routed.
  • In-progress: For inbound calls, after an agent or a rep picks up the call. For outbound calls, when a rep initiates a call.
  • Completed: For inbound and outbound calls, after a call is completed.
  • Voicemail: For inbound calls, if a call went to voicemail.
  • Hang-up: For inbound calls, if a customer hangs up the call before it is routed to a rep.
  • No-answer: For an outbound call, when it is not answered and there is no voicemail.


​​​​​​​PHLO Support

In Plivo, the Plivo High-Level Object or PHLO console allows admins to set up IVR call flow. The list of agents is configured in Plivo. Based on the options chosen by the caller, Plivo sends a callback to Vtiger with the details. Vtiger then creates phone call records.

Follow these steps to configure PHLO in Plivo:

  1. Log in to your Plivo account.
  2. Go to PHLO from the left menu or go to https://console.plivo.com/phlo/list/.
  3. Click Create new PHLO to create a PHLO application.
  4. Select Phone System IVR and click Create Application.
  5. Design the complete flow with all the messages - Welcome messages, busy messages, etc., in the Plivo console. CRM configuration will not be used in this application.
  6. Add all the SIP numbers under <> for calling setup.
  7. Add Custom Headers and Event Callbacks for Answer, Completed, Hangup, and Record under <>. 
    • Copy the callback URL from Vtiger’s  Phone Calls configuration.
  8. Select the PHLO Name and choose PHLO under Application Type in your Active Numbers.
  9. Click Update Number.
 

For more help, reach out to [email protected]

 

Was this article helpful?
0  out of  0  found this helpful.
Comments 0
Be the first to comment
© Copyright 2023 Vtiger. All rights reserved.