Skip to contentSkip to navigationSkip to topbar
Twilio Docs
On this page

Voice in Twilio Flex

Flex offers basic functionality for inbound and outbound calling capabilities by default. You can augment existing calls using the Programmable Voice API. Programmable Voice can also be used, alongside other tools like Studio, to set up custom call flows.

Additionally, the Flex UI offers you the ability to customize existing behaviors for inbound and outbound calls using the Actions Framework and Notifications Framework.

Track Voice Usage

track-voice-usage page anchor

You can pull calls in your Flex account by using the Usage Records API and passing pstnconnectivity as the Category parameter. This will show your Programmable Voice usage over the PSTN (aka, the actual telephone network.)

Get PSTN UsageLink to code sample: Get PSTN Usage
1
// Download the helper library from https://www.twilio.com/docs/node/install

2
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";

3


4
// Find your Account SID and Auth Token at twilio.com/console

5
// and set the environment variables. See http://twil.io/secure

6
const accountSid = process.env.TWILIO_ACCOUNT_SID;

7
const authToken = process.env.TWILIO_AUTH_TOKEN;

8
const client = twilio(accountSid, authToken);

9


10
async function listUsageRecord() {

11
  const records = await client.usage.records.list({

12
    category: "pstnconnectivity",

13
    limit: 20,

14
  });

15


16
  records.forEach((r) => console.log(r.accountSid));

17
}

18


19
listUsageRecord();

Response

1
{

2
  "end": 0,

3
  "first_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Usage/Records.json?Category=calleridlookups&StartDate=2008-01-02&EndDate=2008-01-02&PageSize=1&Page=0",

4
  "next_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Usage/Records.json?Category=calleridlookups&StartDate=2008-01-02&EndDate=2008-01-02&PageSize=1&Page=1&PageToken=APMQ%3D%3D",

5
  "page": 0,

6
  "page_size": 1,

7
  "previous_page_uri": null,

8
  "start": 0,

9
  "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Usage/Records.json?Category=calleridlookups&StartDate=2008-01-02&EndDate=2008-01-02&PageSize=1&Page=0",

10
  "usage_records": [

11
    {

12
      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",

13
      "api_version": "2010-04-01",

14
      "as_of": "2019-06-24T22:32:49+00:00",

15
      "category": "calleridlookups",

16
      "count": null,

17
      "count_unit": "",

18
      "description": "Caller Name Lookups",

19
      "end_date": "2008-01-02",

20
      "price": "2192.84855",

21
      "price_unit": "usd",

22
      "start_date": "2008-01-02",

23
      "subresource_uris": {

24
        "all_time": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Usage/Records/AllTime.json?Category=calleridlookups",

25
        "daily": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Usage/Records/Daily.json?Category=calleridlookups",

26
        "last_month": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Usage/Records/LastMonth.json?Category=calleridlookups",

27
        "monthly": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Usage/Records/Monthly.json?Category=calleridlookups",

28
        "this_month": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Usage/Records/ThisMonth.json?Category=calleridlookups",

29
        "today": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Usage/Records/Today.json?Category=calleridlookups",

30
        "yearly": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Usage/Records/Yearly.json?Category=calleridlookups",

31
        "yesterday": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Usage/Records/Yesterday.json?Category=calleridlookups"

32
      },

33
      "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Usage/Records.json?Category=calleridlookups&StartDate=2008-01-02&EndDate=2008-01-02",

34
      "usage": "2192.84855",

35
      "usage_unit": "usd"

36
    }

37
  ]

38
}

End User Guides

end-user-guides page anchor

Receiving a call is one of the basic interactions with the Flex UI. Other workflows, like making an outbound call or transferring a call, are more complex. The following end user guides explain how these interactions work in the Flex UI in more detail.

Next Steps

next-steps page anchor