Telnyx

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const callControlApplication = await client.callControlApplications.retrieve('id');

console.log(callControlApplication.data);

{
  "data": {
    "active": false,
    "anchorsite_override": "Latency",
    "application_name": "call-router",
    "created_at": "2018-02-02T22:25:27.521Z",
    "dtmf_type": "Inband",
    "first_command_timeout": true,
    "first_command_timeout_secs": 10,
    "id": "1293384261075731499",
    "inbound": {
      "channel_limit": 10,
      "shaken_stir_enabled": true,
      "sip_subdomain": "example",
      "sip_subdomain_receive_settings": "only_my_connections"
    },
    "outbound": {
      "channel_limit": 10,
      "outbound_voice_profile_id": "1293384261075731499"
    },
    "record_type": "call_control_application",
    "updated_at": "2018-02-02T22:25:27.521Z",
    "webhook_api_version": "1",
    "webhook_event_failover_url": "https://failover.example.com",
    "webhook_event_url": "https://example.com",
    "webhook_timeout_secs": 25,
    "call_cost_in_webhooks": false,
    "redact_dtmf_debug_logging": true
  }
}

GET

call_control_applications

{id}

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const callControlApplication = await client.callControlApplications.retrieve('id');

console.log(callControlApplication.data);

{
  "data": {
    "active": false,
    "anchorsite_override": "Latency",
    "application_name": "call-router",
    "created_at": "2018-02-02T22:25:27.521Z",
    "dtmf_type": "Inband",
    "first_command_timeout": true,
    "first_command_timeout_secs": 10,
    "id": "1293384261075731499",
    "inbound": {
      "channel_limit": 10,
      "shaken_stir_enabled": true,
      "sip_subdomain": "example",
      "sip_subdomain_receive_settings": "only_my_connections"
    },
    "outbound": {
      "channel_limit": 10,
      "outbound_voice_profile_id": "1293384261075731499"
    },
    "record_type": "call_control_application",
    "updated_at": "2018-02-02T22:25:27.521Z",
    "webhook_api_version": "1",
    "webhook_event_failover_url": "https://failover.example.com",
    "webhook_event_url": "https://example.com",
    "webhook_timeout_secs": 25,
    "call_cost_in_webhooks": false,
    "redact_dtmf_debug_logging": true
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string<int64>

required

Identifies the resource.

Example:

"1293384261075731499"

Response

Successful response with details about a call control application.

data

Call Control Application · object

Show child attributes

data.active

boolean

default:true

Specifies whether the connection can be used.

data.anchorsite_override

enum<string>

default:Latency

Latency directs Telnyx to route media through the site with the lowest round-trip time to the user's connection. Telnyx calculates this time using ICMP ping messages. This can be disabled by specifying a site to handle all media.

Available options:

Latency,

Chicago, IL,

Ashburn, VA,

San Jose, CA,

London, UK,

Chennai, IN,

Amsterdam, Netherlands,

Toronto, Canada,

Sydney, Australia

Example:

"Amsterdam, Netherlands"

data.application_name

string

A user-assigned name to help manage the application.

Example:

"call-router"

data.created_at

string

ISO 8601 formatted date of when the resource was created

Example:

"2018-02-02T22:25:27.521Z"

data.dtmf_type

enum<string>

default:RFC 2833

Sets the type of DTMF digits sent from Telnyx to this Connection. Note that DTMF digits sent to Telnyx will be accepted in all formats.

Available options:

RFC 2833,

Inband,

SIP INFO

Example:

"Inband"

data.first_command_timeout

boolean

default:false

Specifies whether calls to phone numbers associated with this connection should hangup after timing out.

Example:

true

data.first_command_timeout_secs

integer

default:30

Specifies how many seconds to wait before timing out a dial command.

Example:

10

data.tags

string[]

Tags assigned to the Call Control Application.

data.id

string<int64>

Example:

"1293384261075731499"

data.inbound

Call Control Application Inbound · object

Show child attributes

data.inbound.channel_limit

integer

When set, this will limit the total number of inbound calls to phone numbers associated with this connection.

Example:

10

data.inbound.shaken_stir_enabled

boolean

default:false

When enabled Telnyx will include Shaken/Stir data in the Webhook for new inbound calls.

Example:

false

data.inbound.sip_subdomain

string

Specifies a subdomain that can be used to receive Inbound calls to a Connection, in the same way a phone number is used, from a SIP endpoint. Example: the subdomain "example.sip.telnyx.com" can be called from any SIP endpoint by using the SIP URI "sip:@example.sip.telnyx.com" where the user part can be any alphanumeric value. Please note TLS encrypted calls are not allowed for subdomain calls.

Example:

"example"

data.inbound.sip_subdomain_receive_settings

enum<string>

default:from_anyone

This option can be enabled to receive calls from: "Anyone" (any SIP endpoint in the public Internet) or "Only my connections" (any connection assigned to the same Telnyx user).

Available options:

only_my_connections,

from_anyone

Example:

"only_my_connections"

data.outbound

Call Control Application Outbound · object

Show child attributes

data.outbound.channel_limit

integer

When set, this will limit the total number of outbound calls to phone numbers associated with this connection.

Example:

10

data.outbound.outbound_voice_profile_id

string<int64>

Identifies the associated outbound voice profile.

Example:

"1293384261075731499"

data.record_type

enum<string>

default:call_control_application

Available options:

call_control_application

data.updated_at

string

ISO 8601 formatted date of when the resource was last updated

Example:

"2018-02-02T22:25:27.521Z"

data.webhook_api_version

enum<string>

default:1

Determines which webhook format will be used, Telnyx API v1 or v2.

Available options:

1,

2

Example:

"1"

data.webhook_event_failover_url

string<url> | null

default:""

The failover URL where webhooks related to this connection will be sent if sending to the primary URL fails. Must include a scheme, such as https.

Example:

"https://failover.example.com"

data.webhook_event_url

string<url>

The URL where webhooks related to this connection will be sent. Must include a scheme, such as https.

Example:

"https://example.com"

data.webhook_timeout_secs

integer | null

Required range: 0 <= x <= 30

Example:

25

data.call_cost_in_webhooks

boolean

default:false

Specifies if call cost webhooks should be sent for this Call Control Application.

data.redact_dtmf_debug_logging

boolean

default:false

When enabled, DTMF digits entered by users will be redacted in debug logs to protect PII data entered through IVR interactions.

Example:

true

Example:

{
  "active": false,
  "anchorsite_override": "Latency",
  "application_name": "call-router",
  "created_at": "2018-02-02T22:25:27.521Z",
  "dtmf_type": "Inband",
  "first_command_timeout": true,
  "first_command_timeout_secs": 10,
  "id": "1293384261075731499",
  "inbound": {
    "channel_limit": 10,
    "shaken_stir_enabled": true,
    "sip_subdomain": "example",
    "sip_subdomain_receive_settings": "only_my_connections"
  },
  "outbound": {
    "channel_limit": 10,
    "outbound_voice_profile_id": "1293384261075731499"
  },
  "record_type": "call_control_application",
  "updated_at": "2018-02-02T22:25:27.521Z",
  "webhook_api_version": "1",
  "webhook_event_failover_url": "https://failover.example.com",
  "webhook_event_url": "https://example.com",
  "webhook_timeout_secs": 25,
  "call_cost_in_webhooks": false,
  "redact_dtmf_debug_logging": true
}

Create a call control application Delete a call control application

⌘I

AI

Real-Time Communications

WebRTC

Messaging

Identity

Storage & Data

Account & Billing

Other Products

SETI

OAuth

Retrieve a call control application

Authorizations

Path Parameters

Response