Configure BYO SMS for Twilio

If you have an existing relationship with Twilio for SMS services, you can use the Bring Your Own (BYO) SMS feature to integrate your existing Twilio account into Genesys Cloud. You can then send and receive SMS messages with your customers using all the Genesys Cloud SMS capabilities.

For BYO SMS pricing, see Genesys Cloud fair use policy.

Provision SMS Numbers with Genesys Cloud inbound Webhook

Before you can add your Twilio SMS numbers to your BYO SMS Twilio integration, you must provision your SMS numbers to use the Genesys Cloud inbound Webhook.  To do so, you provision the appropriate Genesys Cloud Webhook URL for your region on each SMS number. For more information, see the Webhooks article in Twilio Docs.

Configuring Webhooks for 10DLC numbers

If you are using US 10DLC numbers, which have been registered, then you may discover that Twilio places those numbers in a Messaging Service. In this case, Genesys recommends that you select the Defer to sender’s webhook option in the webhook configuration for the Messaging Service and provision your SMS numbers to use the Genesys Cloud inbound Webhook.

Set up the BYO Twilio SMS integration

To set up the BYO Twilio SMS integration, perform these steps:

1. Click Admin.
2. Under Integrations, click Integrations.
3. Click Admin > Channels > Message > Platform Integrations.
4. Click Integrations.
5. Locate the Bring Your Own Twilio SMS Account Configuration tile.

5. Click Install. The Bring Your Own Twilio SMS Account Configuration screen appears.
6. (Optional) On the Details tab, customize the name of your integration and add notes.
   Note: Genesys recommends that you use the name and notes to identify the Twilio account you are using.
7. Click the Configuration tab.
8. Click the Credentials tab.
9. Click Configure. The Configure Credentials dialog box appears.
10. In the Account SID box, type the SID for your Twilio account. 
11. In the Authorized Token box, type the Authorized Token for your Twilio account.
    Note: Genesys Cloud encrypts your Twilio credentials and stores them in a secure environment. For more information, see How does Genesys Cloud handle credentials?.
12. Click OK.
13. Click Save.
14. Set the Status to Active.

Add your numbers to the SMS Number Inventory

After you set up your BYO Twilio SMS integration, you are ready to add your numbers to the SMS Number Inventory. You can only add one number at a time.

To add your SMS numbers, perform these steps:

1. Click Admin.
2. Under Message, click SMS Number Inventory.
3. Click Menu > Channels > Message > SMS Inventory.
4. When the SMS Number Inventory page appears, click Add numbers.
5. Click Import. The Import Number dialog appears.
6. From the Integration list, select the integration from which you want to import numbers.
7. From the Type list, select the type of number you are importing.
   • If you select Local, Mobile, or Toll-free:
     • In the Sender ID box, type a number using the E164 format.
   • If you select Shortcode:
     • From the Country list, select the country.
     • In the Sender ID box, type a number.
8. Click Next.
9. If you select Shortcode from the Type list, the Required interaction dialog appears and you must fill in the information on each of the three tabs.
   • On the Help tab:
     • In the Keywords box, enter the help keywords you want to use.
     • In the Message box, enter the message that you want to send to customers in response to a help request.
   • On the Opt-out tab:
     • In the Keywords box, enter the opt-out keywords you want to use.
     • In the Message box, enter the message that you want to send to customers in response to an opt-out request.
   • On the Re Opt-in tab:
     • In the Keywords box, enter the opt-in keywords you want to use.
     • In the Message box, enter the message that you want to send to customers in response to an opt-in request.
10. Click Confirm import. Genesys Cloud retrieves the SMS number data and then returns you to the SMS Number Inventory page. A toast appears at the top of the page telling you that the number import was successful.

For more information, see Manage your SMS long code number inventory.