Twilio Phone

Twilio Phone is a gh-element that allows you to connect your application to the Twilio account. Thanks to this, you can make calls, send messages directly from the application.

Functional Characteristic

The feature of this element in integration with the Twilio service. This allows user to pull up all the necessary data and immediately call the appropriate contacts. Thus, you can collect all the necessary information about the client in one place and see their data during the call.

This element also allows to forward the call to a mobile device if no one picks up the phone in the application. If no one answers the phone, a voice message will be automatically sent to the calling customer.

One more function of this gh-element is chatting. It gives you caller a space for exchange of messages with the client.

Twilio Phone Panel

The main part of using a Twilio phone is its panel. This is the workspace of the current element, where many useful functions are located.

First of all, there are the selected phone number is displayed in the upper part of the element. Above it you can see the buttons with the names of the fields from which the numbers are taken. They allows to switch between phone numbers.

Below are three tabs:

• Numpad - allows you to enter, correct and erase the phone number.
• Call history - allows you to view all calls made to a specific number.
• Messages - allows to exchange messages with the selected contact.

To switch between these tabs, use the buttons at the bottom of the panel.

Value Format

This element have no value.

Element Options

The Twilio Phone element can look like a very complex element because of its options. It has three blocks of settings, each of which contains different settings.

Field, Authentication, and Additional Settings

The first block of settings is divided into three parts. The Field Settings contains three settings, two of which are standard. Authentication is used to connect the element to your Twilio account. Additional settings are optional but very useful.

Multiple Value

This is a switch that lets you control how many numbers your Twilio phone can display. If it is enabled, several numbers will be displayed, otherwise only one phone number will be displayed.

Account Sid

As you already understood, you need to have a Twilio account to use this gh element. And the first thing that you have to enter is your 34 digit account SID. It is used with Auth Token to authenticate API requests.

Auth Token

The second thing for Twilio credentials is Auth Token. Used with Account Sid to successfully send a request. Read more about it here.

App Sid

This is the TwiML App SID that allows Twilio to make outgoing to your application. More precisely, this is the SID of your application to which you want calls to be received. To get this SID you have to create TwiML App in your Twilio account.

SIP Domain

The purpose of this function is to save a SIP domain for forwarding calls to your phone number. As you may have gathered, Twilio phone also supports calls via the SIP network. So, in addition to the main functions, you can configure call forwarding to the phone using SIP account.

Voice Mail URL

Twilio phone gives you the ability to use voicemail. The current URL is a link to the audio file that will be used if the person does not reach either the computer or the phone through the SIP domain.

Phone Numbers

The second group of settings configures the source of the phone numbers.

Application

This is the application that contains all needed phone numbers.

Fields

This is the Phone element that contains the required phone number. You can select several fields at once. Then they will be displayed in the default interpretation type pop-up window and you will be able to make calls to all these numbers in Twilio Phone.

View Name

This is the view of the item where the Twilio phone is located. When you receive an incoming call, after accepting it, this view will open.

An incoming call can only be received when the application with the Twilio Phone is open.

Edit

This is a column with two settings to edit and delete the option.

Callers

The last group of settings allows you to enter the data of callers.

User ID

This is the function that allows you to select the user which will be a caller.

Caller ID

In this setting, you can enter a Twilio phone number that will be associated with the selected user. The caller will receive all messages, including voice messages, to this mail.

Client Mail

Here you can enter an email that will be associated with the current caller. On this mail caller will get all messages and voice mails.

Element Style

The Twilio Phone style can be customized using the common style settings. And its appearance can be changed using the types of its interpretations.

Data Model

The current gh-element has quite big data model:

{
    "data_model": {
        "account_sid": "83rhefhjfwkkk",
        "app_sid": "aksjoiuo82b",
        "auth_token": "iusdoinshiodsa22",
        "callers": [{
            "caller_id": "456574745",
            "client_mail": "dgdfg@gmail.com",
            "user_id": "1547"
        }],
        "fields_with_phones": [{
            "app_id": "29862",
            "field_id": "697437,699277",
            "view_id": "1575865"
        }],
        "interpretation": [],
        "multiple_value": 0,
        "regular_expression": "\\.*$",
        "sip_domain": "sdhkui&89a7ihween",
        "voice_mail_url": "dsfssdg@gmail.com"
    }
}

Filtration

This element cannot be filtered out.

Interpretation

The current element has only a few types of interpretation.

Default

The default interpretation of the Twilio Phone is a button that opens the pop-up list with all available phone numbers.

Twilio phone Panel

This is the interpretation that the Twilio phone panel displays.