Introduction

Telnyx is a communication network that interconnects with local carriers for global communications. Telnyx can be used for voice, messaging, API, and networking solutions. The APIs are designed for fast integration that enables messaging capabilities. 

You can use the Vtiger CRM + Telnyx integration to send SMS messages from all your SMS-enabled Vtiger modules directly to your contacts via the Telnyx delivery network.
 

Depending on your location, you can send SMS messages using a local number or your business name using an alphanumeric sender ID.  For example, MT-AADHAR123 is an alphanumeric sender ID.

 

• Cut your messaging costs by leveraging a private network with no access fees. 
• Allow customers to message you via local, national, or toll-free numbers (depending on location)

Key Terminology

Integrating Telnyx with Vtiger CRM

You must have an active Telnyx account to integrate with Vtiger CRM. 

Follow these steps to integrate Telnyx with VTiger CRM:

• Enable your Telnyx account with VTiger CRM
• Configure Telnyx account with VTiger CRM
• Install Telnyx

Step 1: Enable your Telnyx account with Vtiger CRM

1. Log in to your Telnyx account.  If you do not have a Telnyx account, create it from here.

2. Go to Numbers.
3. Click My Numbers. A Numbers/My Numbers window opens.

4. Click Search and Buy Numbers.

5. Select a Search Type, Region, and Number Features.
6. Click Search Numbers.

7. Click an SMS-enabled number ( Look for the SMS available message above the message icon)

8. Click Add to Cart.

9. Click Place Order.

10. Go back to My Numbers.
11. Select the number you have purchased.
12. Set the Connection or App as Forward only.

13. Select Create a Messaging Profile. A Create Messaging Profile window opens.

14. Enter a Profile name.
15. Click Create Profile.

16. Select Account Settings.

17. Select Keys and Credentials:
    1. Click API keys 
    2. Copy the API key to the Notepad.

Step 2: Configure your Telnyx account in Vtiger CRM

Follow the steps below to configure your Telnyx account:

1. Log in to CRM.

2. Click User Profile.
3. Go to Settings. 

4. In the Settings page, type SMS in the search field and select SMS Provider Configuration.

5. Click the +New Configuration. A New Configuration window opens.

6. Enter or select the following information:
   1. Provider: Search for Telnyxsms from the Provider drop-down.
   2. Active: Select Yes as Active status. 
   3. From: Add the number bought from Telnyx in the From field.
   4. Authorization: Paste the API key along with the prefix Bearer in the Authorization field.
   5. Callback URL: The Callback URL is auto-filled.
   6. Click Save.

Step 3: Install Telnyx app

You can install the Telnyx app only if you are an Admin user.

Follow these steps to install the Telnyx app:

1. Log in to the CRM.

2. Click the User Profile.
3. Click Settings.

4. Look for Add-ons under Extensions.

5. Type Telenyx SMS Integration in the Add-on Search field.
6. Click Install.

A success message will be displayed. Once the Telnyx app is installed, you will find it on the Settings page.

Using Telnyx From Vtiger CRM

Sending an SMS using Telnyx from Vtiger CRM

Follow the steps to send an SMS using Telnyx:

1. Log in to the CRM.

 

3. Go to Essentials.
4. Click Contacts. The Contact List View opens.

5. Click on a Contact you wish to send SMS.

6. Click More.
7. Select SMS. The Send SMS window opens.

8. Enter or select the following information:
   1. Select Phone Number: Choose the phone number from the Select Phone Number drop-down.
   2. Select SMS Gateway: Choose the SMS provider from the drop-down.
   3. Message text box: Type your message in the Message text box.
   4. Click Send.

Deactivating the Telnyx SMS app from Vtiger CRM

Follow the steps to deactivate The Telnyx SMS app from Vtiger CRM:

1. Log in to the CRM.

2. Click the User Profile.
3. Click Settings.

4. Click Add-ons under Extensions.

5. Type Telnyx in the search field.
6. Select Telnyx SMS Integration with Vtiger CRM.

7. Click Uninstall.

8. Click Yes to confirm.

Limitations

• Vtiger does not support incoming messages for Telnyx. You can only send messages.