Twilio - User Set Up

Twilio is a pre-pay program (pay-as-you-go) used by Prime Clinical clients to facilitate text messaging, Patient Portal, and telemedicine. Twilio set up must be completed before these features may be used.

2. Offices must have a web domain name and renew their subscription for the domain name before its' expiration date. A domain name is required when setting up Twilio. See this document, section II - Set Up a URL, Port, and Telephone Number in Twilio, step 4.

3. Offices must have a current basic SSL certificate for IIS with 2048-bit encryption for the specified web domain name. An SSL certificate is required when setting up Twilio. See this document, section II - Set Up a URL, Port, and Telephone Number in Twilio, step 4.

Note: Offices who make changes to their external IP address should notify PCS support as the IP address will need to be updated in their Twilio account.

I - Open a Twilio Account

II - Set Up a URL, Port, and Telephone Number in Twilio

III - Enter Your Twilio API Credentials into Intellect

IV - Enter Your Clinic Phone Number into Twilio

V - Automate the Task

VI - Configure Twilio for Video Chat

I - Open a Twilio Account

Note: Because Twilio's website changes periodically, screen shots in this documentation may vary from Twilio's actual screens. For help with Twilio's screens, please contact Twilio directly.

3.1 Fill out the screen, entering your name, email address, and other fields as required.

3.2 Press the [Start your free trial] button to save your information and create a trial version Twilio account.

4. Once a trial version Twilio account has been set up, the account must be upgraded to a fully functioning account before it can be set up in Intellect.

4.1 If your account has not been upgraded, when you sign into your Twilio account an upgrade option displays on the top menu bar. For example:

4.2 To upgrade your account, click on [Upgrade Project] and fill in your account billing information as indicated on the Twilio screen.

Note: After completing steps 1 - 4.2 above, additional set up is required. To have Prime Clinical complete the remaining set up, contact support at 626-449-1705, or email support@primeclinical.com. Please include your name, client ID, contact information, Twilio log-in ID, and Twilio password.

II - Set Up a URL, Port, and Telephone Number in Twilio

1. If you are not currently in Twilio, log-in to the Twilio program. Your Twilio Dashboard will open.

2. On your Twilio Dashboard, scroll to the # Phone Numbers section and click on Manage Numbers:

3. Verify the Number and Voice URL options are selected (see blue arrows below):

4. Request a URL by typing YOUR clinic's internet address and webserver port in the Voice URL field (see red arrow above).

4.2 Replace domainname with YOUR clinic's domain that the SSL certificate is on. Replace port# with the SSL port (the default port is 8080). The recommended port is 8080, but if that port is already being used for another purpose, another port can be used as long as it is an open port through the firewall.

For example, Prime Clinical would enter https://primeclinical.net:8080/app_confirm.

5. Click on the [Buy a Number] option (see green arrow in step 3) to display the Buy a Number screen:

5.1 Verify that United States is selected as the Country, and the ☐ SMS box is checked (see blue arrows above).

5.2 The Number/Location field (see red arrow above) allows you to choose a phone number specific to your city or area. For example, select Number from the drop-down menu and then enter a specific area code, or select Location and enter a particular city; i.e., Pasadena, CA.

5.3 Click on the red [Search] button to generate a list of phone numbers from which to choose.

5.4 Click on the

button to the right of the phone number you wish to purchase. Once purchased, enter this phone number in the <Twilio Phone No.> field on Intellect's Utility --►Tools --►Configuration screen.

Note: Clinics who make changes to their external IP address should notify PCS support as their IP address will need to be updated in their Twilio account.

6.1 Log-in to Twilio, if you are not already logged-in. On your Twilio Dashboard, scroll to the # Phone Numbers section and click on Manage Numbers (see screen save in step 2) to open the Phone Numbers screen.

6.2 On the Phone Numbers screen, verify that your purchased Twilio number (see blue arrow below) and the URL you requested in step 4 display (see red arrow below):

6.3 Click on your purchased Twilio number to display the details of your number and URL set up.

6.3.1 In the Messaging section, verify that YOUR URL is set up as HTTP GET. The sample below (see red arrow) shows Prime Clinical's URL where YOUR URL should display. If the URL for your office does NOT display here, return to step 4.

III - Enter Your Twilio API Credentials into Intellect

The Account SID and Auth Token API credentials generated by Twilio during set up for YOUR account need to be entered into Intellect.

3.1 Copy the ACCOUNT SID information (see red arrow above) and paste/type it into the <Twilio Account SID> field on the Utility --►Tools --►Configuration screen. Note: The number shown above is a sample only - it is not a valid ACCOUNT SID number.

3.2 Copy the AUTH TOKEN information (see green arrow above) and paste/type it into the <Twilio Auth Token> field on the Utility --►Tools --►Configuration screen.
Note: You must copy the actual token. To see the actual token, click on the

symbol and then copy the token.

3.3 Remain in Twilio and go to section IV - Enter Your Clinic Phone Number into Twilio.

IV - Enter Your Clinic Phone Number into Twilio

1. If you are not currently in Twilio, log-in to the Twilio program. Your Twilio Dashboard will open.

2. On your Twilio Dashboard, scroll to the # Phone Numbers section and click on Verified Caller Ids:

3. When the Verified Caller IDs screen opens, click on the round red button with the white plus sign

to open the Verify a Phone Number screen:

4. In the field marked with a green arrow above, enter the same clinic phone number that is in the <Phone> field on Intellect's Utility --►Setup --►Clinic screen (this is the number that patients see as the caller ID).

4.1 After entering the phone number, Twilio calls the number. Pick up the phone when it rings and enter the code displayed on the screen. For example:

This is only an example. The verification code shown above is not a valid number.

Note: The above steps need to be completed for each clinic with different phone numbers that want to use Twilio. This must be done or calls will not be completed. If you change your phone number, these steps need to be done for the new number.

4.3 Save your changes, exit Twilio, and go to section V - Automate the Task.

V - Automate the Task

Once sections I - IV of this document have been completed, contact Prime Clinical to open a reference asking to have the task automated, and to verify that your hardware is set up correctly.

VI - Configure Twilio for Video Chat

• Complete Sections I - V of this document before continuing with Section VI.

• Go to Schedule --►Appointment --►Full Day --►Special Features --►Telemedicine and complete Section I - System Requirements.

1. If you are not currently in Twilio, log-in to the Twilio program. Your Twilio Dashboard will open.

4. In the FRIENDLY NAME field, type pcs as the key name and press the [Create API Key] button:

This is only an example. The SID and SECRET codes shown above are not valid.

5. Copy the SID displayed on the pcstestkey screen (see sample above) and paste it into Intellect's Utility --►Tools --►Configuration <Twilio API Key> field.

6. Copy the SECRET displayed on the pcstestkey screen and paste it into Intellect's Utility --►Tools --►Configuration <Twilio API Secret> field.

IMPORTANT: This secret is ONLY shown ONCE. Make note of it and store it in a safe place.

9. In Twilio, go to Settings --►General, scroll to the bottom of the page, and click the 'Enabled' radio button in the SSL Certificate Validation section:

11. When you have completed these steps, contact Prime Clinical to set up a test chat to make sure everything is operating properly.