telnyx 6.48.0 → 6.49.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (84) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/client.d.mts +6 -0
  3. package/client.d.mts.map +1 -1
  4. package/client.d.ts +6 -0
  5. package/client.d.ts.map +1 -1
  6. package/client.js +6 -0
  7. package/client.js.map +1 -1
  8. package/client.mjs +6 -0
  9. package/client.mjs.map +1 -1
  10. package/package.json +1 -1
  11. package/resources/ai/assistants/assistants.d.mts +2 -2
  12. package/resources/ai/assistants/assistants.d.mts.map +1 -1
  13. package/resources/ai/assistants/assistants.d.ts +2 -2
  14. package/resources/ai/assistants/assistants.d.ts.map +1 -1
  15. package/resources/ai/assistants/assistants.js.map +1 -1
  16. package/resources/ai/assistants/assistants.mjs.map +1 -1
  17. package/resources/ai/assistants/canary-deploys.d.mts +246 -30
  18. package/resources/ai/assistants/canary-deploys.d.mts.map +1 -1
  19. package/resources/ai/assistants/canary-deploys.d.ts +246 -30
  20. package/resources/ai/assistants/canary-deploys.d.ts.map +1 -1
  21. package/resources/ai/assistants/canary-deploys.js +0 -10
  22. package/resources/ai/assistants/canary-deploys.js.map +1 -1
  23. package/resources/ai/assistants/canary-deploys.mjs +0 -10
  24. package/resources/ai/assistants/canary-deploys.mjs.map +1 -1
  25. package/resources/ai/assistants/index.d.mts +1 -1
  26. package/resources/ai/assistants/index.d.mts.map +1 -1
  27. package/resources/ai/assistants/index.d.ts +1 -1
  28. package/resources/ai/assistants/index.d.ts.map +1 -1
  29. package/resources/ai/assistants/index.js.map +1 -1
  30. package/resources/ai/assistants/index.mjs.map +1 -1
  31. package/resources/index.d.mts +1 -0
  32. package/resources/index.d.mts.map +1 -1
  33. package/resources/index.d.ts +1 -0
  34. package/resources/index.d.ts.map +1 -1
  35. package/resources/index.js +4 -2
  36. package/resources/index.js.map +1 -1
  37. package/resources/index.mjs +1 -0
  38. package/resources/index.mjs.map +1 -1
  39. package/resources/uac-connections/actions.d.mts +65 -0
  40. package/resources/uac-connections/actions.d.mts.map +1 -0
  41. package/resources/uac-connections/actions.d.ts +65 -0
  42. package/resources/uac-connections/actions.d.ts.map +1 -0
  43. package/resources/uac-connections/actions.js +29 -0
  44. package/resources/uac-connections/actions.js.map +1 -0
  45. package/resources/uac-connections/actions.mjs +25 -0
  46. package/resources/uac-connections/actions.mjs.map +1 -0
  47. package/resources/uac-connections/index.d.mts +3 -0
  48. package/resources/uac-connections/index.d.mts.map +1 -0
  49. package/resources/uac-connections/index.d.ts +3 -0
  50. package/resources/uac-connections/index.d.ts.map +1 -0
  51. package/resources/uac-connections/index.js +9 -0
  52. package/resources/uac-connections/index.js.map +1 -0
  53. package/resources/uac-connections/index.mjs +4 -0
  54. package/resources/uac-connections/index.mjs.map +1 -0
  55. package/resources/uac-connections/uac-connections.d.mts +2588 -0
  56. package/resources/uac-connections/uac-connections.d.mts.map +1 -0
  57. package/resources/uac-connections/uac-connections.d.ts +2588 -0
  58. package/resources/uac-connections/uac-connections.d.ts.map +1 -0
  59. package/resources/uac-connections/uac-connections.js +97 -0
  60. package/resources/uac-connections/uac-connections.js.map +1 -0
  61. package/resources/uac-connections/uac-connections.mjs +92 -0
  62. package/resources/uac-connections/uac-connections.mjs.map +1 -0
  63. package/resources/uac-connections.d.mts +2 -0
  64. package/resources/uac-connections.d.mts.map +1 -0
  65. package/resources/uac-connections.d.ts +2 -0
  66. package/resources/uac-connections.d.ts.map +1 -0
  67. package/resources/uac-connections.js +6 -0
  68. package/resources/uac-connections.js.map +1 -0
  69. package/resources/uac-connections.mjs +3 -0
  70. package/resources/uac-connections.mjs.map +1 -0
  71. package/src/client.ts +30 -0
  72. package/src/resources/ai/assistants/assistants.ts +0 -2
  73. package/src/resources/ai/assistants/canary-deploys.ts +280 -31
  74. package/src/resources/ai/assistants/index.ts +0 -1
  75. package/src/resources/index.ts +12 -0
  76. package/src/resources/uac-connections/actions.ts +83 -0
  77. package/src/resources/uac-connections/index.ts +15 -0
  78. package/src/resources/uac-connections/uac-connections.ts +3153 -0
  79. package/src/resources/uac-connections.ts +3 -0
  80. package/src/version.ts +1 -1
  81. package/version.d.mts +1 -1
  82. package/version.d.ts +1 -1
  83. package/version.js +1 -1
  84. package/version.mjs +1 -1
@@ -0,0 +1,2588 @@
1
+ import { APIResource } from "../../core/resource.mjs";
2
+ import * as FqdnsAPI from "../fqdns.mjs";
3
+ import * as Shared from "../shared.mjs";
4
+ import * as CredentialConnectionsAPI from "../credential-connections/credential-connections.mjs";
5
+ import * as ActionsAPI from "./actions.mjs";
6
+ import { ActionCheckRegistrationStatusResponse, Actions } from "./actions.mjs";
7
+ import { APIPromise } from "../../core/api-promise.mjs";
8
+ import { DefaultFlatPagination, type DefaultFlatPaginationParams, PagePromise } from "../../core/pagination.mjs";
9
+ import { RequestOptions } from "../../internal/request-options.mjs";
10
+ /**
11
+ * UAC connection operations
12
+ */
13
+ export declare class UacConnections extends APIResource {
14
+ actions: ActionsAPI.Actions;
15
+ /**
16
+ * Creates a UAC connection. A UAC (User Agent Client) Connection registers Telnyx
17
+ * to your PBX — the opposite of a standard SIP trunk, where the PBX registers to
18
+ * Telnyx. Use UAC when your PBX doesn’t support outbound SIP registration or you
19
+ * need Telnyx to maintain the registration.
20
+ *
21
+ * @example
22
+ * ```ts
23
+ * const uacConnection = await client.uacConnections.create({
24
+ * connection_name: 'my name',
25
+ * });
26
+ * ```
27
+ */
28
+ create(body: UacConnectionCreateParams, options?: RequestOptions): APIPromise<UacConnectionCreateResponse>;
29
+ /**
30
+ * Retrieves the details of an existing UAC connection.
31
+ *
32
+ * @example
33
+ * ```ts
34
+ * const uacConnection = await client.uacConnections.retrieve(
35
+ * 'id',
36
+ * );
37
+ * ```
38
+ */
39
+ retrieve(id: string, options?: RequestOptions): APIPromise<UacConnectionRetrieveResponse>;
40
+ /**
41
+ * Updates settings of an existing UAC connection.
42
+ *
43
+ * @example
44
+ * ```ts
45
+ * const uacConnection = await client.uacConnections.update(
46
+ * 'id',
47
+ * );
48
+ * ```
49
+ */
50
+ update(id: string, body: UacConnectionUpdateParams, options?: RequestOptions): APIPromise<UacConnectionUpdateResponse>;
51
+ /**
52
+ * Returns a list of your UAC connections. A UAC (User Agent Client) Connection
53
+ * registers Telnyx to your PBX — the opposite of a standard SIP trunk, where the
54
+ * PBX registers to Telnyx. Use UAC when your PBX doesn’t support outbound SIP
55
+ * registration or you need Telnyx to maintain the registration.
56
+ *
57
+ * @example
58
+ * ```ts
59
+ * // Automatically fetches more pages as needed.
60
+ * for await (const uacConnectionListResponse of client.uacConnections.list()) {
61
+ * // ...
62
+ * }
63
+ * ```
64
+ */
65
+ list(query?: UacConnectionListParams | null | undefined, options?: RequestOptions): PagePromise<UacConnectionListResponsesDefaultFlatPagination, UacConnectionListResponse>;
66
+ /**
67
+ * Deletes an existing UAC connection.
68
+ *
69
+ * @example
70
+ * ```ts
71
+ * const uacConnection = await client.uacConnections.delete(
72
+ * 'id',
73
+ * );
74
+ * ```
75
+ */
76
+ delete(id: string, options?: RequestOptions): APIPromise<UacConnectionDeleteResponse>;
77
+ }
78
+ export type UacConnectionListResponsesDefaultFlatPagination = DefaultFlatPagination<UacConnectionListResponse>;
79
+ export interface UacConnectionCreateResponse {
80
+ /**
81
+ * A UAC (User Agent Client) Connection registers Telnyx to your PBX — the opposite
82
+ * of a standard SIP trunk, where the PBX registers to Telnyx. Use UAC when your
83
+ * PBX doesn’t support outbound SIP registration or you need Telnyx to maintain the
84
+ * registration.
85
+ */
86
+ data?: UacConnectionCreateResponse.Data;
87
+ }
88
+ export declare namespace UacConnectionCreateResponse {
89
+ /**
90
+ * A UAC (User Agent Client) Connection registers Telnyx to your PBX — the opposite
91
+ * of a standard SIP trunk, where the PBX registers to Telnyx. Use UAC when your
92
+ * PBX doesn’t support outbound SIP registration or you need Telnyx to maintain the
93
+ * registration.
94
+ */
95
+ interface Data {
96
+ /**
97
+ * Identifies the type of resource.
98
+ */
99
+ id?: string;
100
+ /**
101
+ * Defaults to true
102
+ */
103
+ active?: boolean;
104
+ /**
105
+ * `Latency` directs Telnyx to route media through the site with the lowest
106
+ * round-trip time to the user's connection. Telnyx calculates this time using ICMP
107
+ * ping messages. This can be disabled by specifying a site to handle all media.
108
+ */
109
+ anchorsite_override?: CredentialConnectionsAPI.AnchorsiteOverride;
110
+ /**
111
+ * The uuid of the push credential for Android
112
+ */
113
+ android_push_credential_id?: string | null;
114
+ /**
115
+ * The authentication strategy used by this connection.
116
+ */
117
+ authentication?: 'uac-authentication';
118
+ /**
119
+ * Specifies if call cost webhooks should be sent for this connection.
120
+ */
121
+ call_cost_in_webhooks?: boolean;
122
+ connection_name?: string;
123
+ /**
124
+ * ISO-8601 formatted date indicating when the resource was created.
125
+ */
126
+ created_at?: string;
127
+ /**
128
+ * When enabled, Telnyx will generate comfort noise when you place the call on
129
+ * hold. If disabled, you will need to generate comfort noise or on hold music to
130
+ * avoid RTP timeout.
131
+ */
132
+ default_on_hold_comfort_noise_enabled?: boolean;
133
+ /**
134
+ * Sets the type of DTMF digits sent from Telnyx to this Connection. Note that DTMF
135
+ * digits sent to Telnyx will be accepted in all formats.
136
+ */
137
+ dtmf_type?: CredentialConnectionsAPI.DtmfType;
138
+ /**
139
+ * Encode the SIP contact header sent by Telnyx to avoid issues for NAT or ALG
140
+ * scenarios.
141
+ */
142
+ encode_contact_header_enabled?: boolean;
143
+ /**
144
+ * Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
145
+ * TLS.
146
+ */
147
+ encrypted_media?: CredentialConnectionsAPI.EncryptedMedia | null;
148
+ /**
149
+ * External SIP peer settings used by Telnyx when registering to your PBX and
150
+ * routing outbound calls.
151
+ */
152
+ external_uac_settings?: Data.ExternalUacSettings;
153
+ /**
154
+ * The Telnyx-managed FQDN generated for the UAC connection.
155
+ */
156
+ fqdn?: string;
157
+ /**
158
+ * The fixed outbound authentication mode used by UAC FQDN records.
159
+ */
160
+ fqdn_outbound_authentication?: 'credential-authentication';
161
+ /**
162
+ * FQDN records managed automatically by the UAC connection lifecycle.
163
+ */
164
+ fqdns?: Array<FqdnsAPI.Fqdn>;
165
+ inbound?: Data.Inbound;
166
+ /**
167
+ * Internal Telnyx-side settings for a UAC connection.
168
+ */
169
+ internal_uac_settings?: Data.InternalUacSettings;
170
+ /**
171
+ * The uuid of the push credential for Ios
172
+ */
173
+ ios_push_credential_id?: string | null;
174
+ /**
175
+ * Configuration options for Jitter Buffer. Enables Jitter Buffer for RTP streams
176
+ * of SIP Trunking calls. The feature is off unless enabled. You may define min and
177
+ * max values in msec for customized buffering behaviors. Larger values add latency
178
+ * but tolerate more jitter, while smaller values reduce latency but are more
179
+ * sensitive to jitter and reordering.
180
+ */
181
+ jitter_buffer?: Shared.ConnectionJitterBuffer;
182
+ /**
183
+ * Controls when noise suppression is applied to calls. When set to 'inbound',
184
+ * noise suppression is applied to incoming audio. When set to 'outbound', it's
185
+ * applied to outgoing audio. When set to 'both', it's applied in both directions.
186
+ * When set to 'disabled', noise suppression is turned off.
187
+ */
188
+ noise_suppression?: 'inbound' | 'outbound' | 'both' | 'disabled';
189
+ /**
190
+ * Configuration options for noise suppression. These settings are stored
191
+ * regardless of the noise_suppression value, but only take effect when
192
+ * noise_suppression is not 'disabled'. If you disable noise suppression and later
193
+ * re-enable it, the previously configured settings will be used.
194
+ */
195
+ noise_suppression_details?: Shared.ConnectionNoiseSuppressionDetails;
196
+ /**
197
+ * Enable on-net T38 if you prefer the sender and receiver negotiating T38 directly
198
+ * if both are on the Telnyx network. If this is disabled, Telnyx will be able to
199
+ * use T38 on just one leg of the call depending on each leg's settings.
200
+ */
201
+ onnet_t38_passthrough_enabled?: boolean;
202
+ outbound?: Data.Outbound;
203
+ /**
204
+ * The password to be used as part of the credentials. Must be 8 to 128 characters
205
+ * long.
206
+ */
207
+ password?: string;
208
+ /**
209
+ * Identifies the type of the resource.
210
+ */
211
+ record_type?: string;
212
+ /**
213
+ * The most recently known SIP registration status for this UAC connection.
214
+ */
215
+ registration_status?: string | null;
216
+ /**
217
+ * ISO 8601 formatted date indicating when the registration status was last
218
+ * updated.
219
+ */
220
+ registration_status_updated_at?: string | null;
221
+ rtcp_settings?: CredentialConnectionsAPI.ConnectionRtcpSettings;
222
+ /**
223
+ * This feature enables inbound SIP URI calls to your Credential Auth Connection.
224
+ * If enabled for all (unrestricted) then anyone who calls the SIP URI
225
+ * <your-username>@telnyx.com will be connected to your Connection. You can also
226
+ * choose to allow only calls that are originated on any Connections under your
227
+ * account (internal).
228
+ */
229
+ sip_uri_calling_preference?: 'disabled' | 'unrestricted' | 'internal';
230
+ /**
231
+ * Tags associated with the connection.
232
+ */
233
+ tags?: Array<string>;
234
+ /**
235
+ * ISO-8601 formatted date indicating when the resource was updated.
236
+ */
237
+ updated_at?: string;
238
+ /**
239
+ * The user name to be used as part of the credentials. Must be 4-32 characters
240
+ * long and alphanumeric values only (no spaces or special characters). At least
241
+ * one of the first 5 characters must be a letter.
242
+ */
243
+ user_name?: string;
244
+ /**
245
+ * Determines which webhook format will be used, Telnyx API v1 or v2.
246
+ */
247
+ webhook_api_version?: '1' | '2';
248
+ /**
249
+ * The failover URL where webhooks related to this connection will be sent if
250
+ * sending to the primary URL fails. Must include a scheme, such as 'https'.
251
+ */
252
+ webhook_event_failover_url?: string | null;
253
+ /**
254
+ * The URL where webhooks related to this connection will be sent. Must include a
255
+ * scheme, such as 'https'.
256
+ */
257
+ webhook_event_url?: string;
258
+ /**
259
+ * Specifies how many seconds to wait before timing out a webhook.
260
+ */
261
+ webhook_timeout_secs?: number | null;
262
+ }
263
+ namespace Data {
264
+ /**
265
+ * External SIP peer settings used by Telnyx when registering to your PBX and
266
+ * routing outbound calls.
267
+ */
268
+ interface ExternalUacSettings {
269
+ /**
270
+ * The authentication username used in SIP digest authentication. If not set, the
271
+ * Username value will be used.
272
+ */
273
+ auth_username?: string | null;
274
+ /**
275
+ * The registration interval, in seconds, indicating how often the system refreshes
276
+ * the SIP registration with the external SIP peer.
277
+ */
278
+ expiration_sec?: number | null;
279
+ /**
280
+ * The user portion of the SIP From header used in outbound requests. This controls
281
+ * the caller identity presented to the external SIP peer.
282
+ */
283
+ from_user?: string | null;
284
+ /**
285
+ * An optional SIP proxy used to route outbound requests before reaching the
286
+ * external SIP peer.
287
+ */
288
+ outbound_proxy?: string | null;
289
+ /**
290
+ * The SIP password used for digest authentication with the external SIP peer.
291
+ */
292
+ password?: string;
293
+ /**
294
+ * The SIP proxy address of the external SIP peer used for registrations and
295
+ * outbound call routing.
296
+ */
297
+ proxy?: string;
298
+ /**
299
+ * The transport protocol used for SIP signaling when communicating with the
300
+ * external SIP peer. One of UDP, TLS, or TCP.
301
+ */
302
+ transport?: 'UDP' | 'TLS' | 'TCP' | null;
303
+ /**
304
+ * The SIP username used to authenticate with the external SIP peer for
305
+ * registrations and outbound calls. Must start with a letter or number and contain
306
+ * only letters, numbers, hyphens, and underscores.
307
+ */
308
+ username?: string;
309
+ }
310
+ interface Inbound {
311
+ /**
312
+ * This setting allows you to set the format with which the caller's number (ANI)
313
+ * is sent for inbound phone calls.
314
+ */
315
+ ani_number_format?: '+E.164' | 'E.164' | '+E.164-national' | 'E.164-national';
316
+ /**
317
+ * When set, this will limit the total number of inbound calls to phone numbers
318
+ * associated with this connection.
319
+ */
320
+ channel_limit?: number;
321
+ /**
322
+ * Defines the list of codecs that Telnyx will send for inbound calls to a specific
323
+ * number on your portal account, in priority order. This only works when the
324
+ * Connection the number is assigned to uses Media Handling mode: default. OPUS and
325
+ * H.264 codecs are available only when using TCP or TLS transport for SIP.
326
+ */
327
+ codecs?: Array<string>;
328
+ /**
329
+ * Default routing method to be used when a number is associated with the
330
+ * connection. Must be one of the routing method types or left blank, other values
331
+ * are not allowed.
332
+ */
333
+ default_routing_method?: 'sequential' | 'round-robin';
334
+ dnis_number_format?: '+e164' | 'e164' | 'national' | 'sip_username';
335
+ /**
336
+ * Generate ringback tone through 183 session progress message with early media.
337
+ */
338
+ generate_ringback_tone?: boolean;
339
+ /**
340
+ * When set, inbound phone calls will receive ISUP parameters via SIP headers.
341
+ * (Only when available and only when using TCP or TLS transport.)
342
+ */
343
+ isup_headers_enabled?: boolean;
344
+ /**
345
+ * Enable PRACK messages as defined in RFC3262.
346
+ */
347
+ prack_enabled?: boolean;
348
+ /**
349
+ * When enabled the SIP Connection will receive the Identity header with
350
+ * Shaken/Stir data in the SIP INVITE message of inbound calls, even when using UDP
351
+ * transport.
352
+ */
353
+ shaken_stir_enabled?: boolean;
354
+ /**
355
+ * When enabled, allows multiple devices to ring simultaneously on incoming calls.
356
+ */
357
+ simultaneous_ringing?: 'disabled' | 'enabled';
358
+ /**
359
+ * Defaults to true.
360
+ */
361
+ sip_compact_headers_enabled?: boolean;
362
+ /**
363
+ * The Telnyx-generated SIP subdomain for this UAC connection.
364
+ */
365
+ sip_subdomain?: string;
366
+ /**
367
+ * Controls which SIP URI callers may reach this connection.
368
+ */
369
+ sip_subdomain_receive_settings?: 'only_my_connections' | 'from_anyone';
370
+ /**
371
+ * Time(sec) before aborting if connection is not made.
372
+ */
373
+ timeout_1xx_secs?: number;
374
+ /**
375
+ * Time(sec) before aborting if call is unanswered (min: 1, max: 600).
376
+ */
377
+ timeout_2xx_secs?: number;
378
+ }
379
+ /**
380
+ * Internal Telnyx-side settings for a UAC connection.
381
+ */
382
+ interface InternalUacSettings {
383
+ /**
384
+ * The SIP URI that Telnyx will call when handling an inbound request from the
385
+ * external peer. Do not include a `sip:` prefix. The value must be in the format
386
+ * `userinfo@[subdomain.]sip.telnyx.com` or
387
+ * `userinfo@[subdomain.]sipdev.telnyx.com`; the userinfo portion may contain only
388
+ * letters, digits, hyphens, and underscores.
389
+ */
390
+ destination_uri?: string;
391
+ }
392
+ interface Outbound {
393
+ /**
394
+ * Set a phone number as the ani_override value to override caller id number on
395
+ * outbound calls.
396
+ */
397
+ ani_override?: string;
398
+ /**
399
+ * Specifies when we apply your ani_override setting. Only applies when
400
+ * ani_override is not blank.
401
+ */
402
+ ani_override_type?: 'always' | 'normal' | 'emergency';
403
+ /**
404
+ * Forces all SIP calls originated on this connection to be "parked" instead of
405
+ * "bridged" to the destination specified on the URI. Parked calls will return
406
+ * ringback to the caller and will await for a Call Control command to define which
407
+ * action will be taken next.
408
+ */
409
+ call_parking_enabled?: boolean | null;
410
+ /**
411
+ * When set, this will limit the total number of outbound calls to phone numbers
412
+ * associated with this connection.
413
+ */
414
+ channel_limit?: number;
415
+ /**
416
+ * Generate ringback tone through 183 session progress message with early media.
417
+ */
418
+ generate_ringback_tone?: boolean;
419
+ /**
420
+ * When set, ringback will not wait for indication before sending ringback tone to
421
+ * calling party.
422
+ */
423
+ instant_ringback_enabled?: boolean;
424
+ /**
425
+ * A 2-character country code specifying the country whose national dialing rules
426
+ * should be used. For example, if set to `US` then any US number can be dialed
427
+ * without preprending +1 to the number. When left blank, Telnyx will try US and GB
428
+ * dialing rules, in that order, by default.
429
+ */
430
+ localization?: string;
431
+ /**
432
+ * Identifies the associated outbound voice profile.
433
+ */
434
+ outbound_voice_profile_id?: string;
435
+ /**
436
+ * This setting only affects connections with Fax-type Outbound Voice Profiles. The
437
+ * setting dictates whether or not Telnyx sends a t.38 reinvite.<br/><br/> By
438
+ * default, Telnyx will send the re-invite. If set to `customer`, the caller is
439
+ * expected to send the t.38 reinvite.
440
+ */
441
+ t38_reinvite_source?: 'telnyx' | 'customer' | 'disabled' | 'passthru' | 'caller-passthru' | 'callee-passthru';
442
+ }
443
+ }
444
+ }
445
+ export interface UacConnectionRetrieveResponse {
446
+ /**
447
+ * A UAC (User Agent Client) Connection registers Telnyx to your PBX — the opposite
448
+ * of a standard SIP trunk, where the PBX registers to Telnyx. Use UAC when your
449
+ * PBX doesn’t support outbound SIP registration or you need Telnyx to maintain the
450
+ * registration.
451
+ */
452
+ data?: UacConnectionRetrieveResponse.Data;
453
+ }
454
+ export declare namespace UacConnectionRetrieveResponse {
455
+ /**
456
+ * A UAC (User Agent Client) Connection registers Telnyx to your PBX — the opposite
457
+ * of a standard SIP trunk, where the PBX registers to Telnyx. Use UAC when your
458
+ * PBX doesn’t support outbound SIP registration or you need Telnyx to maintain the
459
+ * registration.
460
+ */
461
+ interface Data {
462
+ /**
463
+ * Identifies the type of resource.
464
+ */
465
+ id?: string;
466
+ /**
467
+ * Defaults to true
468
+ */
469
+ active?: boolean;
470
+ /**
471
+ * `Latency` directs Telnyx to route media through the site with the lowest
472
+ * round-trip time to the user's connection. Telnyx calculates this time using ICMP
473
+ * ping messages. This can be disabled by specifying a site to handle all media.
474
+ */
475
+ anchorsite_override?: CredentialConnectionsAPI.AnchorsiteOverride;
476
+ /**
477
+ * The uuid of the push credential for Android
478
+ */
479
+ android_push_credential_id?: string | null;
480
+ /**
481
+ * The authentication strategy used by this connection.
482
+ */
483
+ authentication?: 'uac-authentication';
484
+ /**
485
+ * Specifies if call cost webhooks should be sent for this connection.
486
+ */
487
+ call_cost_in_webhooks?: boolean;
488
+ connection_name?: string;
489
+ /**
490
+ * ISO-8601 formatted date indicating when the resource was created.
491
+ */
492
+ created_at?: string;
493
+ /**
494
+ * When enabled, Telnyx will generate comfort noise when you place the call on
495
+ * hold. If disabled, you will need to generate comfort noise or on hold music to
496
+ * avoid RTP timeout.
497
+ */
498
+ default_on_hold_comfort_noise_enabled?: boolean;
499
+ /**
500
+ * Sets the type of DTMF digits sent from Telnyx to this Connection. Note that DTMF
501
+ * digits sent to Telnyx will be accepted in all formats.
502
+ */
503
+ dtmf_type?: CredentialConnectionsAPI.DtmfType;
504
+ /**
505
+ * Encode the SIP contact header sent by Telnyx to avoid issues for NAT or ALG
506
+ * scenarios.
507
+ */
508
+ encode_contact_header_enabled?: boolean;
509
+ /**
510
+ * Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
511
+ * TLS.
512
+ */
513
+ encrypted_media?: CredentialConnectionsAPI.EncryptedMedia | null;
514
+ /**
515
+ * External SIP peer settings used by Telnyx when registering to your PBX and
516
+ * routing outbound calls.
517
+ */
518
+ external_uac_settings?: Data.ExternalUacSettings;
519
+ /**
520
+ * The Telnyx-managed FQDN generated for the UAC connection.
521
+ */
522
+ fqdn?: string;
523
+ /**
524
+ * The fixed outbound authentication mode used by UAC FQDN records.
525
+ */
526
+ fqdn_outbound_authentication?: 'credential-authentication';
527
+ /**
528
+ * FQDN records managed automatically by the UAC connection lifecycle.
529
+ */
530
+ fqdns?: Array<FqdnsAPI.Fqdn>;
531
+ inbound?: Data.Inbound;
532
+ /**
533
+ * Internal Telnyx-side settings for a UAC connection.
534
+ */
535
+ internal_uac_settings?: Data.InternalUacSettings;
536
+ /**
537
+ * The uuid of the push credential for Ios
538
+ */
539
+ ios_push_credential_id?: string | null;
540
+ /**
541
+ * Configuration options for Jitter Buffer. Enables Jitter Buffer for RTP streams
542
+ * of SIP Trunking calls. The feature is off unless enabled. You may define min and
543
+ * max values in msec for customized buffering behaviors. Larger values add latency
544
+ * but tolerate more jitter, while smaller values reduce latency but are more
545
+ * sensitive to jitter and reordering.
546
+ */
547
+ jitter_buffer?: Shared.ConnectionJitterBuffer;
548
+ /**
549
+ * Controls when noise suppression is applied to calls. When set to 'inbound',
550
+ * noise suppression is applied to incoming audio. When set to 'outbound', it's
551
+ * applied to outgoing audio. When set to 'both', it's applied in both directions.
552
+ * When set to 'disabled', noise suppression is turned off.
553
+ */
554
+ noise_suppression?: 'inbound' | 'outbound' | 'both' | 'disabled';
555
+ /**
556
+ * Configuration options for noise suppression. These settings are stored
557
+ * regardless of the noise_suppression value, but only take effect when
558
+ * noise_suppression is not 'disabled'. If you disable noise suppression and later
559
+ * re-enable it, the previously configured settings will be used.
560
+ */
561
+ noise_suppression_details?: Shared.ConnectionNoiseSuppressionDetails;
562
+ /**
563
+ * Enable on-net T38 if you prefer the sender and receiver negotiating T38 directly
564
+ * if both are on the Telnyx network. If this is disabled, Telnyx will be able to
565
+ * use T38 on just one leg of the call depending on each leg's settings.
566
+ */
567
+ onnet_t38_passthrough_enabled?: boolean;
568
+ outbound?: Data.Outbound;
569
+ /**
570
+ * The password to be used as part of the credentials. Must be 8 to 128 characters
571
+ * long.
572
+ */
573
+ password?: string;
574
+ /**
575
+ * Identifies the type of the resource.
576
+ */
577
+ record_type?: string;
578
+ /**
579
+ * The most recently known SIP registration status for this UAC connection.
580
+ */
581
+ registration_status?: string | null;
582
+ /**
583
+ * ISO 8601 formatted date indicating when the registration status was last
584
+ * updated.
585
+ */
586
+ registration_status_updated_at?: string | null;
587
+ rtcp_settings?: CredentialConnectionsAPI.ConnectionRtcpSettings;
588
+ /**
589
+ * This feature enables inbound SIP URI calls to your Credential Auth Connection.
590
+ * If enabled for all (unrestricted) then anyone who calls the SIP URI
591
+ * <your-username>@telnyx.com will be connected to your Connection. You can also
592
+ * choose to allow only calls that are originated on any Connections under your
593
+ * account (internal).
594
+ */
595
+ sip_uri_calling_preference?: 'disabled' | 'unrestricted' | 'internal';
596
+ /**
597
+ * Tags associated with the connection.
598
+ */
599
+ tags?: Array<string>;
600
+ /**
601
+ * ISO-8601 formatted date indicating when the resource was updated.
602
+ */
603
+ updated_at?: string;
604
+ /**
605
+ * The user name to be used as part of the credentials. Must be 4-32 characters
606
+ * long and alphanumeric values only (no spaces or special characters). At least
607
+ * one of the first 5 characters must be a letter.
608
+ */
609
+ user_name?: string;
610
+ /**
611
+ * Determines which webhook format will be used, Telnyx API v1 or v2.
612
+ */
613
+ webhook_api_version?: '1' | '2';
614
+ /**
615
+ * The failover URL where webhooks related to this connection will be sent if
616
+ * sending to the primary URL fails. Must include a scheme, such as 'https'.
617
+ */
618
+ webhook_event_failover_url?: string | null;
619
+ /**
620
+ * The URL where webhooks related to this connection will be sent. Must include a
621
+ * scheme, such as 'https'.
622
+ */
623
+ webhook_event_url?: string;
624
+ /**
625
+ * Specifies how many seconds to wait before timing out a webhook.
626
+ */
627
+ webhook_timeout_secs?: number | null;
628
+ }
629
+ namespace Data {
630
+ /**
631
+ * External SIP peer settings used by Telnyx when registering to your PBX and
632
+ * routing outbound calls.
633
+ */
634
+ interface ExternalUacSettings {
635
+ /**
636
+ * The authentication username used in SIP digest authentication. If not set, the
637
+ * Username value will be used.
638
+ */
639
+ auth_username?: string | null;
640
+ /**
641
+ * The registration interval, in seconds, indicating how often the system refreshes
642
+ * the SIP registration with the external SIP peer.
643
+ */
644
+ expiration_sec?: number | null;
645
+ /**
646
+ * The user portion of the SIP From header used in outbound requests. This controls
647
+ * the caller identity presented to the external SIP peer.
648
+ */
649
+ from_user?: string | null;
650
+ /**
651
+ * An optional SIP proxy used to route outbound requests before reaching the
652
+ * external SIP peer.
653
+ */
654
+ outbound_proxy?: string | null;
655
+ /**
656
+ * The SIP password used for digest authentication with the external SIP peer.
657
+ */
658
+ password?: string;
659
+ /**
660
+ * The SIP proxy address of the external SIP peer used for registrations and
661
+ * outbound call routing.
662
+ */
663
+ proxy?: string;
664
+ /**
665
+ * The transport protocol used for SIP signaling when communicating with the
666
+ * external SIP peer. One of UDP, TLS, or TCP.
667
+ */
668
+ transport?: 'UDP' | 'TLS' | 'TCP' | null;
669
+ /**
670
+ * The SIP username used to authenticate with the external SIP peer for
671
+ * registrations and outbound calls. Must start with a letter or number and contain
672
+ * only letters, numbers, hyphens, and underscores.
673
+ */
674
+ username?: string;
675
+ }
676
+ interface Inbound {
677
+ /**
678
+ * This setting allows you to set the format with which the caller's number (ANI)
679
+ * is sent for inbound phone calls.
680
+ */
681
+ ani_number_format?: '+E.164' | 'E.164' | '+E.164-national' | 'E.164-national';
682
+ /**
683
+ * When set, this will limit the total number of inbound calls to phone numbers
684
+ * associated with this connection.
685
+ */
686
+ channel_limit?: number;
687
+ /**
688
+ * Defines the list of codecs that Telnyx will send for inbound calls to a specific
689
+ * number on your portal account, in priority order. This only works when the
690
+ * Connection the number is assigned to uses Media Handling mode: default. OPUS and
691
+ * H.264 codecs are available only when using TCP or TLS transport for SIP.
692
+ */
693
+ codecs?: Array<string>;
694
+ /**
695
+ * Default routing method to be used when a number is associated with the
696
+ * connection. Must be one of the routing method types or left blank, other values
697
+ * are not allowed.
698
+ */
699
+ default_routing_method?: 'sequential' | 'round-robin';
700
+ dnis_number_format?: '+e164' | 'e164' | 'national' | 'sip_username';
701
+ /**
702
+ * Generate ringback tone through 183 session progress message with early media.
703
+ */
704
+ generate_ringback_tone?: boolean;
705
+ /**
706
+ * When set, inbound phone calls will receive ISUP parameters via SIP headers.
707
+ * (Only when available and only when using TCP or TLS transport.)
708
+ */
709
+ isup_headers_enabled?: boolean;
710
+ /**
711
+ * Enable PRACK messages as defined in RFC3262.
712
+ */
713
+ prack_enabled?: boolean;
714
+ /**
715
+ * When enabled the SIP Connection will receive the Identity header with
716
+ * Shaken/Stir data in the SIP INVITE message of inbound calls, even when using UDP
717
+ * transport.
718
+ */
719
+ shaken_stir_enabled?: boolean;
720
+ /**
721
+ * When enabled, allows multiple devices to ring simultaneously on incoming calls.
722
+ */
723
+ simultaneous_ringing?: 'disabled' | 'enabled';
724
+ /**
725
+ * Defaults to true.
726
+ */
727
+ sip_compact_headers_enabled?: boolean;
728
+ /**
729
+ * The Telnyx-generated SIP subdomain for this UAC connection.
730
+ */
731
+ sip_subdomain?: string;
732
+ /**
733
+ * Controls which SIP URI callers may reach this connection.
734
+ */
735
+ sip_subdomain_receive_settings?: 'only_my_connections' | 'from_anyone';
736
+ /**
737
+ * Time(sec) before aborting if connection is not made.
738
+ */
739
+ timeout_1xx_secs?: number;
740
+ /**
741
+ * Time(sec) before aborting if call is unanswered (min: 1, max: 600).
742
+ */
743
+ timeout_2xx_secs?: number;
744
+ }
745
+ /**
746
+ * Internal Telnyx-side settings for a UAC connection.
747
+ */
748
+ interface InternalUacSettings {
749
+ /**
750
+ * The SIP URI that Telnyx will call when handling an inbound request from the
751
+ * external peer. Do not include a `sip:` prefix. The value must be in the format
752
+ * `userinfo@[subdomain.]sip.telnyx.com` or
753
+ * `userinfo@[subdomain.]sipdev.telnyx.com`; the userinfo portion may contain only
754
+ * letters, digits, hyphens, and underscores.
755
+ */
756
+ destination_uri?: string;
757
+ }
758
+ interface Outbound {
759
+ /**
760
+ * Set a phone number as the ani_override value to override caller id number on
761
+ * outbound calls.
762
+ */
763
+ ani_override?: string;
764
+ /**
765
+ * Specifies when we apply your ani_override setting. Only applies when
766
+ * ani_override is not blank.
767
+ */
768
+ ani_override_type?: 'always' | 'normal' | 'emergency';
769
+ /**
770
+ * Forces all SIP calls originated on this connection to be "parked" instead of
771
+ * "bridged" to the destination specified on the URI. Parked calls will return
772
+ * ringback to the caller and will await for a Call Control command to define which
773
+ * action will be taken next.
774
+ */
775
+ call_parking_enabled?: boolean | null;
776
+ /**
777
+ * When set, this will limit the total number of outbound calls to phone numbers
778
+ * associated with this connection.
779
+ */
780
+ channel_limit?: number;
781
+ /**
782
+ * Generate ringback tone through 183 session progress message with early media.
783
+ */
784
+ generate_ringback_tone?: boolean;
785
+ /**
786
+ * When set, ringback will not wait for indication before sending ringback tone to
787
+ * calling party.
788
+ */
789
+ instant_ringback_enabled?: boolean;
790
+ /**
791
+ * A 2-character country code specifying the country whose national dialing rules
792
+ * should be used. For example, if set to `US` then any US number can be dialed
793
+ * without preprending +1 to the number. When left blank, Telnyx will try US and GB
794
+ * dialing rules, in that order, by default.
795
+ */
796
+ localization?: string;
797
+ /**
798
+ * Identifies the associated outbound voice profile.
799
+ */
800
+ outbound_voice_profile_id?: string;
801
+ /**
802
+ * This setting only affects connections with Fax-type Outbound Voice Profiles. The
803
+ * setting dictates whether or not Telnyx sends a t.38 reinvite.<br/><br/> By
804
+ * default, Telnyx will send the re-invite. If set to `customer`, the caller is
805
+ * expected to send the t.38 reinvite.
806
+ */
807
+ t38_reinvite_source?: 'telnyx' | 'customer' | 'disabled' | 'passthru' | 'caller-passthru' | 'callee-passthru';
808
+ }
809
+ }
810
+ }
811
+ export interface UacConnectionUpdateResponse {
812
+ /**
813
+ * A UAC (User Agent Client) Connection registers Telnyx to your PBX — the opposite
814
+ * of a standard SIP trunk, where the PBX registers to Telnyx. Use UAC when your
815
+ * PBX doesn’t support outbound SIP registration or you need Telnyx to maintain the
816
+ * registration.
817
+ */
818
+ data?: UacConnectionUpdateResponse.Data;
819
+ }
820
+ export declare namespace UacConnectionUpdateResponse {
821
+ /**
822
+ * A UAC (User Agent Client) Connection registers Telnyx to your PBX — the opposite
823
+ * of a standard SIP trunk, where the PBX registers to Telnyx. Use UAC when your
824
+ * PBX doesn’t support outbound SIP registration or you need Telnyx to maintain the
825
+ * registration.
826
+ */
827
+ interface Data {
828
+ /**
829
+ * Identifies the type of resource.
830
+ */
831
+ id?: string;
832
+ /**
833
+ * Defaults to true
834
+ */
835
+ active?: boolean;
836
+ /**
837
+ * `Latency` directs Telnyx to route media through the site with the lowest
838
+ * round-trip time to the user's connection. Telnyx calculates this time using ICMP
839
+ * ping messages. This can be disabled by specifying a site to handle all media.
840
+ */
841
+ anchorsite_override?: CredentialConnectionsAPI.AnchorsiteOverride;
842
+ /**
843
+ * The uuid of the push credential for Android
844
+ */
845
+ android_push_credential_id?: string | null;
846
+ /**
847
+ * The authentication strategy used by this connection.
848
+ */
849
+ authentication?: 'uac-authentication';
850
+ /**
851
+ * Specifies if call cost webhooks should be sent for this connection.
852
+ */
853
+ call_cost_in_webhooks?: boolean;
854
+ connection_name?: string;
855
+ /**
856
+ * ISO-8601 formatted date indicating when the resource was created.
857
+ */
858
+ created_at?: string;
859
+ /**
860
+ * When enabled, Telnyx will generate comfort noise when you place the call on
861
+ * hold. If disabled, you will need to generate comfort noise or on hold music to
862
+ * avoid RTP timeout.
863
+ */
864
+ default_on_hold_comfort_noise_enabled?: boolean;
865
+ /**
866
+ * Sets the type of DTMF digits sent from Telnyx to this Connection. Note that DTMF
867
+ * digits sent to Telnyx will be accepted in all formats.
868
+ */
869
+ dtmf_type?: CredentialConnectionsAPI.DtmfType;
870
+ /**
871
+ * Encode the SIP contact header sent by Telnyx to avoid issues for NAT or ALG
872
+ * scenarios.
873
+ */
874
+ encode_contact_header_enabled?: boolean;
875
+ /**
876
+ * Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
877
+ * TLS.
878
+ */
879
+ encrypted_media?: CredentialConnectionsAPI.EncryptedMedia | null;
880
+ /**
881
+ * External SIP peer settings used by Telnyx when registering to your PBX and
882
+ * routing outbound calls.
883
+ */
884
+ external_uac_settings?: Data.ExternalUacSettings;
885
+ /**
886
+ * The Telnyx-managed FQDN generated for the UAC connection.
887
+ */
888
+ fqdn?: string;
889
+ /**
890
+ * The fixed outbound authentication mode used by UAC FQDN records.
891
+ */
892
+ fqdn_outbound_authentication?: 'credential-authentication';
893
+ /**
894
+ * FQDN records managed automatically by the UAC connection lifecycle.
895
+ */
896
+ fqdns?: Array<FqdnsAPI.Fqdn>;
897
+ inbound?: Data.Inbound;
898
+ /**
899
+ * Internal Telnyx-side settings for a UAC connection.
900
+ */
901
+ internal_uac_settings?: Data.InternalUacSettings;
902
+ /**
903
+ * The uuid of the push credential for Ios
904
+ */
905
+ ios_push_credential_id?: string | null;
906
+ /**
907
+ * Configuration options for Jitter Buffer. Enables Jitter Buffer for RTP streams
908
+ * of SIP Trunking calls. The feature is off unless enabled. You may define min and
909
+ * max values in msec for customized buffering behaviors. Larger values add latency
910
+ * but tolerate more jitter, while smaller values reduce latency but are more
911
+ * sensitive to jitter and reordering.
912
+ */
913
+ jitter_buffer?: Shared.ConnectionJitterBuffer;
914
+ /**
915
+ * Controls when noise suppression is applied to calls. When set to 'inbound',
916
+ * noise suppression is applied to incoming audio. When set to 'outbound', it's
917
+ * applied to outgoing audio. When set to 'both', it's applied in both directions.
918
+ * When set to 'disabled', noise suppression is turned off.
919
+ */
920
+ noise_suppression?: 'inbound' | 'outbound' | 'both' | 'disabled';
921
+ /**
922
+ * Configuration options for noise suppression. These settings are stored
923
+ * regardless of the noise_suppression value, but only take effect when
924
+ * noise_suppression is not 'disabled'. If you disable noise suppression and later
925
+ * re-enable it, the previously configured settings will be used.
926
+ */
927
+ noise_suppression_details?: Shared.ConnectionNoiseSuppressionDetails;
928
+ /**
929
+ * Enable on-net T38 if you prefer the sender and receiver negotiating T38 directly
930
+ * if both are on the Telnyx network. If this is disabled, Telnyx will be able to
931
+ * use T38 on just one leg of the call depending on each leg's settings.
932
+ */
933
+ onnet_t38_passthrough_enabled?: boolean;
934
+ outbound?: Data.Outbound;
935
+ /**
936
+ * The password to be used as part of the credentials. Must be 8 to 128 characters
937
+ * long.
938
+ */
939
+ password?: string;
940
+ /**
941
+ * Identifies the type of the resource.
942
+ */
943
+ record_type?: string;
944
+ /**
945
+ * The most recently known SIP registration status for this UAC connection.
946
+ */
947
+ registration_status?: string | null;
948
+ /**
949
+ * ISO 8601 formatted date indicating when the registration status was last
950
+ * updated.
951
+ */
952
+ registration_status_updated_at?: string | null;
953
+ rtcp_settings?: CredentialConnectionsAPI.ConnectionRtcpSettings;
954
+ /**
955
+ * This feature enables inbound SIP URI calls to your Credential Auth Connection.
956
+ * If enabled for all (unrestricted) then anyone who calls the SIP URI
957
+ * <your-username>@telnyx.com will be connected to your Connection. You can also
958
+ * choose to allow only calls that are originated on any Connections under your
959
+ * account (internal).
960
+ */
961
+ sip_uri_calling_preference?: 'disabled' | 'unrestricted' | 'internal';
962
+ /**
963
+ * Tags associated with the connection.
964
+ */
965
+ tags?: Array<string>;
966
+ /**
967
+ * ISO-8601 formatted date indicating when the resource was updated.
968
+ */
969
+ updated_at?: string;
970
+ /**
971
+ * The user name to be used as part of the credentials. Must be 4-32 characters
972
+ * long and alphanumeric values only (no spaces or special characters). At least
973
+ * one of the first 5 characters must be a letter.
974
+ */
975
+ user_name?: string;
976
+ /**
977
+ * Determines which webhook format will be used, Telnyx API v1 or v2.
978
+ */
979
+ webhook_api_version?: '1' | '2';
980
+ /**
981
+ * The failover URL where webhooks related to this connection will be sent if
982
+ * sending to the primary URL fails. Must include a scheme, such as 'https'.
983
+ */
984
+ webhook_event_failover_url?: string | null;
985
+ /**
986
+ * The URL where webhooks related to this connection will be sent. Must include a
987
+ * scheme, such as 'https'.
988
+ */
989
+ webhook_event_url?: string;
990
+ /**
991
+ * Specifies how many seconds to wait before timing out a webhook.
992
+ */
993
+ webhook_timeout_secs?: number | null;
994
+ }
995
+ namespace Data {
996
+ /**
997
+ * External SIP peer settings used by Telnyx when registering to your PBX and
998
+ * routing outbound calls.
999
+ */
1000
+ interface ExternalUacSettings {
1001
+ /**
1002
+ * The authentication username used in SIP digest authentication. If not set, the
1003
+ * Username value will be used.
1004
+ */
1005
+ auth_username?: string | null;
1006
+ /**
1007
+ * The registration interval, in seconds, indicating how often the system refreshes
1008
+ * the SIP registration with the external SIP peer.
1009
+ */
1010
+ expiration_sec?: number | null;
1011
+ /**
1012
+ * The user portion of the SIP From header used in outbound requests. This controls
1013
+ * the caller identity presented to the external SIP peer.
1014
+ */
1015
+ from_user?: string | null;
1016
+ /**
1017
+ * An optional SIP proxy used to route outbound requests before reaching the
1018
+ * external SIP peer.
1019
+ */
1020
+ outbound_proxy?: string | null;
1021
+ /**
1022
+ * The SIP password used for digest authentication with the external SIP peer.
1023
+ */
1024
+ password?: string;
1025
+ /**
1026
+ * The SIP proxy address of the external SIP peer used for registrations and
1027
+ * outbound call routing.
1028
+ */
1029
+ proxy?: string;
1030
+ /**
1031
+ * The transport protocol used for SIP signaling when communicating with the
1032
+ * external SIP peer. One of UDP, TLS, or TCP.
1033
+ */
1034
+ transport?: 'UDP' | 'TLS' | 'TCP' | null;
1035
+ /**
1036
+ * The SIP username used to authenticate with the external SIP peer for
1037
+ * registrations and outbound calls. Must start with a letter or number and contain
1038
+ * only letters, numbers, hyphens, and underscores.
1039
+ */
1040
+ username?: string;
1041
+ }
1042
+ interface Inbound {
1043
+ /**
1044
+ * This setting allows you to set the format with which the caller's number (ANI)
1045
+ * is sent for inbound phone calls.
1046
+ */
1047
+ ani_number_format?: '+E.164' | 'E.164' | '+E.164-national' | 'E.164-national';
1048
+ /**
1049
+ * When set, this will limit the total number of inbound calls to phone numbers
1050
+ * associated with this connection.
1051
+ */
1052
+ channel_limit?: number;
1053
+ /**
1054
+ * Defines the list of codecs that Telnyx will send for inbound calls to a specific
1055
+ * number on your portal account, in priority order. This only works when the
1056
+ * Connection the number is assigned to uses Media Handling mode: default. OPUS and
1057
+ * H.264 codecs are available only when using TCP or TLS transport for SIP.
1058
+ */
1059
+ codecs?: Array<string>;
1060
+ /**
1061
+ * Default routing method to be used when a number is associated with the
1062
+ * connection. Must be one of the routing method types or left blank, other values
1063
+ * are not allowed.
1064
+ */
1065
+ default_routing_method?: 'sequential' | 'round-robin';
1066
+ dnis_number_format?: '+e164' | 'e164' | 'national' | 'sip_username';
1067
+ /**
1068
+ * Generate ringback tone through 183 session progress message with early media.
1069
+ */
1070
+ generate_ringback_tone?: boolean;
1071
+ /**
1072
+ * When set, inbound phone calls will receive ISUP parameters via SIP headers.
1073
+ * (Only when available and only when using TCP or TLS transport.)
1074
+ */
1075
+ isup_headers_enabled?: boolean;
1076
+ /**
1077
+ * Enable PRACK messages as defined in RFC3262.
1078
+ */
1079
+ prack_enabled?: boolean;
1080
+ /**
1081
+ * When enabled the SIP Connection will receive the Identity header with
1082
+ * Shaken/Stir data in the SIP INVITE message of inbound calls, even when using UDP
1083
+ * transport.
1084
+ */
1085
+ shaken_stir_enabled?: boolean;
1086
+ /**
1087
+ * When enabled, allows multiple devices to ring simultaneously on incoming calls.
1088
+ */
1089
+ simultaneous_ringing?: 'disabled' | 'enabled';
1090
+ /**
1091
+ * Defaults to true.
1092
+ */
1093
+ sip_compact_headers_enabled?: boolean;
1094
+ /**
1095
+ * The Telnyx-generated SIP subdomain for this UAC connection.
1096
+ */
1097
+ sip_subdomain?: string;
1098
+ /**
1099
+ * Controls which SIP URI callers may reach this connection.
1100
+ */
1101
+ sip_subdomain_receive_settings?: 'only_my_connections' | 'from_anyone';
1102
+ /**
1103
+ * Time(sec) before aborting if connection is not made.
1104
+ */
1105
+ timeout_1xx_secs?: number;
1106
+ /**
1107
+ * Time(sec) before aborting if call is unanswered (min: 1, max: 600).
1108
+ */
1109
+ timeout_2xx_secs?: number;
1110
+ }
1111
+ /**
1112
+ * Internal Telnyx-side settings for a UAC connection.
1113
+ */
1114
+ interface InternalUacSettings {
1115
+ /**
1116
+ * The SIP URI that Telnyx will call when handling an inbound request from the
1117
+ * external peer. Do not include a `sip:` prefix. The value must be in the format
1118
+ * `userinfo@[subdomain.]sip.telnyx.com` or
1119
+ * `userinfo@[subdomain.]sipdev.telnyx.com`; the userinfo portion may contain only
1120
+ * letters, digits, hyphens, and underscores.
1121
+ */
1122
+ destination_uri?: string;
1123
+ }
1124
+ interface Outbound {
1125
+ /**
1126
+ * Set a phone number as the ani_override value to override caller id number on
1127
+ * outbound calls.
1128
+ */
1129
+ ani_override?: string;
1130
+ /**
1131
+ * Specifies when we apply your ani_override setting. Only applies when
1132
+ * ani_override is not blank.
1133
+ */
1134
+ ani_override_type?: 'always' | 'normal' | 'emergency';
1135
+ /**
1136
+ * Forces all SIP calls originated on this connection to be "parked" instead of
1137
+ * "bridged" to the destination specified on the URI. Parked calls will return
1138
+ * ringback to the caller and will await for a Call Control command to define which
1139
+ * action will be taken next.
1140
+ */
1141
+ call_parking_enabled?: boolean | null;
1142
+ /**
1143
+ * When set, this will limit the total number of outbound calls to phone numbers
1144
+ * associated with this connection.
1145
+ */
1146
+ channel_limit?: number;
1147
+ /**
1148
+ * Generate ringback tone through 183 session progress message with early media.
1149
+ */
1150
+ generate_ringback_tone?: boolean;
1151
+ /**
1152
+ * When set, ringback will not wait for indication before sending ringback tone to
1153
+ * calling party.
1154
+ */
1155
+ instant_ringback_enabled?: boolean;
1156
+ /**
1157
+ * A 2-character country code specifying the country whose national dialing rules
1158
+ * should be used. For example, if set to `US` then any US number can be dialed
1159
+ * without preprending +1 to the number. When left blank, Telnyx will try US and GB
1160
+ * dialing rules, in that order, by default.
1161
+ */
1162
+ localization?: string;
1163
+ /**
1164
+ * Identifies the associated outbound voice profile.
1165
+ */
1166
+ outbound_voice_profile_id?: string;
1167
+ /**
1168
+ * This setting only affects connections with Fax-type Outbound Voice Profiles. The
1169
+ * setting dictates whether or not Telnyx sends a t.38 reinvite.<br/><br/> By
1170
+ * default, Telnyx will send the re-invite. If set to `customer`, the caller is
1171
+ * expected to send the t.38 reinvite.
1172
+ */
1173
+ t38_reinvite_source?: 'telnyx' | 'customer' | 'disabled' | 'passthru' | 'caller-passthru' | 'callee-passthru';
1174
+ }
1175
+ }
1176
+ }
1177
+ /**
1178
+ * A UAC (User Agent Client) Connection registers Telnyx to your PBX — the opposite
1179
+ * of a standard SIP trunk, where the PBX registers to Telnyx. Use UAC when your
1180
+ * PBX doesn’t support outbound SIP registration or you need Telnyx to maintain the
1181
+ * registration.
1182
+ */
1183
+ export interface UacConnectionListResponse {
1184
+ /**
1185
+ * Identifies the type of resource.
1186
+ */
1187
+ id?: string;
1188
+ /**
1189
+ * Defaults to true
1190
+ */
1191
+ active?: boolean;
1192
+ /**
1193
+ * `Latency` directs Telnyx to route media through the site with the lowest
1194
+ * round-trip time to the user's connection. Telnyx calculates this time using ICMP
1195
+ * ping messages. This can be disabled by specifying a site to handle all media.
1196
+ */
1197
+ anchorsite_override?: CredentialConnectionsAPI.AnchorsiteOverride;
1198
+ /**
1199
+ * The uuid of the push credential for Android
1200
+ */
1201
+ android_push_credential_id?: string | null;
1202
+ /**
1203
+ * The authentication strategy used by this connection.
1204
+ */
1205
+ authentication?: 'uac-authentication';
1206
+ /**
1207
+ * Specifies if call cost webhooks should be sent for this connection.
1208
+ */
1209
+ call_cost_in_webhooks?: boolean;
1210
+ connection_name?: string;
1211
+ /**
1212
+ * ISO-8601 formatted date indicating when the resource was created.
1213
+ */
1214
+ created_at?: string;
1215
+ /**
1216
+ * When enabled, Telnyx will generate comfort noise when you place the call on
1217
+ * hold. If disabled, you will need to generate comfort noise or on hold music to
1218
+ * avoid RTP timeout.
1219
+ */
1220
+ default_on_hold_comfort_noise_enabled?: boolean;
1221
+ /**
1222
+ * Sets the type of DTMF digits sent from Telnyx to this Connection. Note that DTMF
1223
+ * digits sent to Telnyx will be accepted in all formats.
1224
+ */
1225
+ dtmf_type?: CredentialConnectionsAPI.DtmfType;
1226
+ /**
1227
+ * Encode the SIP contact header sent by Telnyx to avoid issues for NAT or ALG
1228
+ * scenarios.
1229
+ */
1230
+ encode_contact_header_enabled?: boolean;
1231
+ /**
1232
+ * Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
1233
+ * TLS.
1234
+ */
1235
+ encrypted_media?: CredentialConnectionsAPI.EncryptedMedia | null;
1236
+ /**
1237
+ * External SIP peer settings used by Telnyx when registering to your PBX and
1238
+ * routing outbound calls.
1239
+ */
1240
+ external_uac_settings?: UacConnectionListResponse.ExternalUacSettings;
1241
+ /**
1242
+ * The Telnyx-managed FQDN generated for the UAC connection.
1243
+ */
1244
+ fqdn?: string;
1245
+ /**
1246
+ * The fixed outbound authentication mode used by UAC FQDN records.
1247
+ */
1248
+ fqdn_outbound_authentication?: 'credential-authentication';
1249
+ /**
1250
+ * FQDN records managed automatically by the UAC connection lifecycle.
1251
+ */
1252
+ fqdns?: Array<FqdnsAPI.Fqdn>;
1253
+ inbound?: UacConnectionListResponse.Inbound;
1254
+ /**
1255
+ * Internal Telnyx-side settings for a UAC connection.
1256
+ */
1257
+ internal_uac_settings?: UacConnectionListResponse.InternalUacSettings;
1258
+ /**
1259
+ * The uuid of the push credential for Ios
1260
+ */
1261
+ ios_push_credential_id?: string | null;
1262
+ /**
1263
+ * Configuration options for Jitter Buffer. Enables Jitter Buffer for RTP streams
1264
+ * of SIP Trunking calls. The feature is off unless enabled. You may define min and
1265
+ * max values in msec for customized buffering behaviors. Larger values add latency
1266
+ * but tolerate more jitter, while smaller values reduce latency but are more
1267
+ * sensitive to jitter and reordering.
1268
+ */
1269
+ jitter_buffer?: Shared.ConnectionJitterBuffer;
1270
+ /**
1271
+ * Controls when noise suppression is applied to calls. When set to 'inbound',
1272
+ * noise suppression is applied to incoming audio. When set to 'outbound', it's
1273
+ * applied to outgoing audio. When set to 'both', it's applied in both directions.
1274
+ * When set to 'disabled', noise suppression is turned off.
1275
+ */
1276
+ noise_suppression?: 'inbound' | 'outbound' | 'both' | 'disabled';
1277
+ /**
1278
+ * Configuration options for noise suppression. These settings are stored
1279
+ * regardless of the noise_suppression value, but only take effect when
1280
+ * noise_suppression is not 'disabled'. If you disable noise suppression and later
1281
+ * re-enable it, the previously configured settings will be used.
1282
+ */
1283
+ noise_suppression_details?: Shared.ConnectionNoiseSuppressionDetails;
1284
+ /**
1285
+ * Enable on-net T38 if you prefer the sender and receiver negotiating T38 directly
1286
+ * if both are on the Telnyx network. If this is disabled, Telnyx will be able to
1287
+ * use T38 on just one leg of the call depending on each leg's settings.
1288
+ */
1289
+ onnet_t38_passthrough_enabled?: boolean;
1290
+ outbound?: UacConnectionListResponse.Outbound;
1291
+ /**
1292
+ * The password to be used as part of the credentials. Must be 8 to 128 characters
1293
+ * long.
1294
+ */
1295
+ password?: string;
1296
+ /**
1297
+ * Identifies the type of the resource.
1298
+ */
1299
+ record_type?: string;
1300
+ /**
1301
+ * The most recently known SIP registration status for this UAC connection.
1302
+ */
1303
+ registration_status?: string | null;
1304
+ /**
1305
+ * ISO 8601 formatted date indicating when the registration status was last
1306
+ * updated.
1307
+ */
1308
+ registration_status_updated_at?: string | null;
1309
+ rtcp_settings?: CredentialConnectionsAPI.ConnectionRtcpSettings;
1310
+ /**
1311
+ * This feature enables inbound SIP URI calls to your Credential Auth Connection.
1312
+ * If enabled for all (unrestricted) then anyone who calls the SIP URI
1313
+ * <your-username>@telnyx.com will be connected to your Connection. You can also
1314
+ * choose to allow only calls that are originated on any Connections under your
1315
+ * account (internal).
1316
+ */
1317
+ sip_uri_calling_preference?: 'disabled' | 'unrestricted' | 'internal';
1318
+ /**
1319
+ * Tags associated with the connection.
1320
+ */
1321
+ tags?: Array<string>;
1322
+ /**
1323
+ * ISO-8601 formatted date indicating when the resource was updated.
1324
+ */
1325
+ updated_at?: string;
1326
+ /**
1327
+ * The user name to be used as part of the credentials. Must be 4-32 characters
1328
+ * long and alphanumeric values only (no spaces or special characters). At least
1329
+ * one of the first 5 characters must be a letter.
1330
+ */
1331
+ user_name?: string;
1332
+ /**
1333
+ * Determines which webhook format will be used, Telnyx API v1 or v2.
1334
+ */
1335
+ webhook_api_version?: '1' | '2';
1336
+ /**
1337
+ * The failover URL where webhooks related to this connection will be sent if
1338
+ * sending to the primary URL fails. Must include a scheme, such as 'https'.
1339
+ */
1340
+ webhook_event_failover_url?: string | null;
1341
+ /**
1342
+ * The URL where webhooks related to this connection will be sent. Must include a
1343
+ * scheme, such as 'https'.
1344
+ */
1345
+ webhook_event_url?: string;
1346
+ /**
1347
+ * Specifies how many seconds to wait before timing out a webhook.
1348
+ */
1349
+ webhook_timeout_secs?: number | null;
1350
+ }
1351
+ export declare namespace UacConnectionListResponse {
1352
+ /**
1353
+ * External SIP peer settings used by Telnyx when registering to your PBX and
1354
+ * routing outbound calls.
1355
+ */
1356
+ interface ExternalUacSettings {
1357
+ /**
1358
+ * The authentication username used in SIP digest authentication. If not set, the
1359
+ * Username value will be used.
1360
+ */
1361
+ auth_username?: string | null;
1362
+ /**
1363
+ * The registration interval, in seconds, indicating how often the system refreshes
1364
+ * the SIP registration with the external SIP peer.
1365
+ */
1366
+ expiration_sec?: number | null;
1367
+ /**
1368
+ * The user portion of the SIP From header used in outbound requests. This controls
1369
+ * the caller identity presented to the external SIP peer.
1370
+ */
1371
+ from_user?: string | null;
1372
+ /**
1373
+ * An optional SIP proxy used to route outbound requests before reaching the
1374
+ * external SIP peer.
1375
+ */
1376
+ outbound_proxy?: string | null;
1377
+ /**
1378
+ * The SIP password used for digest authentication with the external SIP peer.
1379
+ */
1380
+ password?: string;
1381
+ /**
1382
+ * The SIP proxy address of the external SIP peer used for registrations and
1383
+ * outbound call routing.
1384
+ */
1385
+ proxy?: string;
1386
+ /**
1387
+ * The transport protocol used for SIP signaling when communicating with the
1388
+ * external SIP peer. One of UDP, TLS, or TCP.
1389
+ */
1390
+ transport?: 'UDP' | 'TLS' | 'TCP' | null;
1391
+ /**
1392
+ * The SIP username used to authenticate with the external SIP peer for
1393
+ * registrations and outbound calls. Must start with a letter or number and contain
1394
+ * only letters, numbers, hyphens, and underscores.
1395
+ */
1396
+ username?: string;
1397
+ }
1398
+ interface Inbound {
1399
+ /**
1400
+ * This setting allows you to set the format with which the caller's number (ANI)
1401
+ * is sent for inbound phone calls.
1402
+ */
1403
+ ani_number_format?: '+E.164' | 'E.164' | '+E.164-national' | 'E.164-national';
1404
+ /**
1405
+ * When set, this will limit the total number of inbound calls to phone numbers
1406
+ * associated with this connection.
1407
+ */
1408
+ channel_limit?: number;
1409
+ /**
1410
+ * Defines the list of codecs that Telnyx will send for inbound calls to a specific
1411
+ * number on your portal account, in priority order. This only works when the
1412
+ * Connection the number is assigned to uses Media Handling mode: default. OPUS and
1413
+ * H.264 codecs are available only when using TCP or TLS transport for SIP.
1414
+ */
1415
+ codecs?: Array<string>;
1416
+ /**
1417
+ * Default routing method to be used when a number is associated with the
1418
+ * connection. Must be one of the routing method types or left blank, other values
1419
+ * are not allowed.
1420
+ */
1421
+ default_routing_method?: 'sequential' | 'round-robin';
1422
+ dnis_number_format?: '+e164' | 'e164' | 'national' | 'sip_username';
1423
+ /**
1424
+ * Generate ringback tone through 183 session progress message with early media.
1425
+ */
1426
+ generate_ringback_tone?: boolean;
1427
+ /**
1428
+ * When set, inbound phone calls will receive ISUP parameters via SIP headers.
1429
+ * (Only when available and only when using TCP or TLS transport.)
1430
+ */
1431
+ isup_headers_enabled?: boolean;
1432
+ /**
1433
+ * Enable PRACK messages as defined in RFC3262.
1434
+ */
1435
+ prack_enabled?: boolean;
1436
+ /**
1437
+ * When enabled the SIP Connection will receive the Identity header with
1438
+ * Shaken/Stir data in the SIP INVITE message of inbound calls, even when using UDP
1439
+ * transport.
1440
+ */
1441
+ shaken_stir_enabled?: boolean;
1442
+ /**
1443
+ * When enabled, allows multiple devices to ring simultaneously on incoming calls.
1444
+ */
1445
+ simultaneous_ringing?: 'disabled' | 'enabled';
1446
+ /**
1447
+ * Defaults to true.
1448
+ */
1449
+ sip_compact_headers_enabled?: boolean;
1450
+ /**
1451
+ * The Telnyx-generated SIP subdomain for this UAC connection.
1452
+ */
1453
+ sip_subdomain?: string;
1454
+ /**
1455
+ * Controls which SIP URI callers may reach this connection.
1456
+ */
1457
+ sip_subdomain_receive_settings?: 'only_my_connections' | 'from_anyone';
1458
+ /**
1459
+ * Time(sec) before aborting if connection is not made.
1460
+ */
1461
+ timeout_1xx_secs?: number;
1462
+ /**
1463
+ * Time(sec) before aborting if call is unanswered (min: 1, max: 600).
1464
+ */
1465
+ timeout_2xx_secs?: number;
1466
+ }
1467
+ /**
1468
+ * Internal Telnyx-side settings for a UAC connection.
1469
+ */
1470
+ interface InternalUacSettings {
1471
+ /**
1472
+ * The SIP URI that Telnyx will call when handling an inbound request from the
1473
+ * external peer. Do not include a `sip:` prefix. The value must be in the format
1474
+ * `userinfo@[subdomain.]sip.telnyx.com` or
1475
+ * `userinfo@[subdomain.]sipdev.telnyx.com`; the userinfo portion may contain only
1476
+ * letters, digits, hyphens, and underscores.
1477
+ */
1478
+ destination_uri?: string;
1479
+ }
1480
+ interface Outbound {
1481
+ /**
1482
+ * Set a phone number as the ani_override value to override caller id number on
1483
+ * outbound calls.
1484
+ */
1485
+ ani_override?: string;
1486
+ /**
1487
+ * Specifies when we apply your ani_override setting. Only applies when
1488
+ * ani_override is not blank.
1489
+ */
1490
+ ani_override_type?: 'always' | 'normal' | 'emergency';
1491
+ /**
1492
+ * Forces all SIP calls originated on this connection to be "parked" instead of
1493
+ * "bridged" to the destination specified on the URI. Parked calls will return
1494
+ * ringback to the caller and will await for a Call Control command to define which
1495
+ * action will be taken next.
1496
+ */
1497
+ call_parking_enabled?: boolean | null;
1498
+ /**
1499
+ * When set, this will limit the total number of outbound calls to phone numbers
1500
+ * associated with this connection.
1501
+ */
1502
+ channel_limit?: number;
1503
+ /**
1504
+ * Generate ringback tone through 183 session progress message with early media.
1505
+ */
1506
+ generate_ringback_tone?: boolean;
1507
+ /**
1508
+ * When set, ringback will not wait for indication before sending ringback tone to
1509
+ * calling party.
1510
+ */
1511
+ instant_ringback_enabled?: boolean;
1512
+ /**
1513
+ * A 2-character country code specifying the country whose national dialing rules
1514
+ * should be used. For example, if set to `US` then any US number can be dialed
1515
+ * without preprending +1 to the number. When left blank, Telnyx will try US and GB
1516
+ * dialing rules, in that order, by default.
1517
+ */
1518
+ localization?: string;
1519
+ /**
1520
+ * Identifies the associated outbound voice profile.
1521
+ */
1522
+ outbound_voice_profile_id?: string;
1523
+ /**
1524
+ * This setting only affects connections with Fax-type Outbound Voice Profiles. The
1525
+ * setting dictates whether or not Telnyx sends a t.38 reinvite.<br/><br/> By
1526
+ * default, Telnyx will send the re-invite. If set to `customer`, the caller is
1527
+ * expected to send the t.38 reinvite.
1528
+ */
1529
+ t38_reinvite_source?: 'telnyx' | 'customer' | 'disabled' | 'passthru' | 'caller-passthru' | 'callee-passthru';
1530
+ }
1531
+ }
1532
+ export interface UacConnectionDeleteResponse {
1533
+ /**
1534
+ * A UAC (User Agent Client) Connection registers Telnyx to your PBX — the opposite
1535
+ * of a standard SIP trunk, where the PBX registers to Telnyx. Use UAC when your
1536
+ * PBX doesn’t support outbound SIP registration or you need Telnyx to maintain the
1537
+ * registration.
1538
+ */
1539
+ data?: UacConnectionDeleteResponse.Data;
1540
+ }
1541
+ export declare namespace UacConnectionDeleteResponse {
1542
+ /**
1543
+ * A UAC (User Agent Client) Connection registers Telnyx to your PBX — the opposite
1544
+ * of a standard SIP trunk, where the PBX registers to Telnyx. Use UAC when your
1545
+ * PBX doesn’t support outbound SIP registration or you need Telnyx to maintain the
1546
+ * registration.
1547
+ */
1548
+ interface Data {
1549
+ /**
1550
+ * Identifies the type of resource.
1551
+ */
1552
+ id?: string;
1553
+ /**
1554
+ * Defaults to true
1555
+ */
1556
+ active?: boolean;
1557
+ /**
1558
+ * `Latency` directs Telnyx to route media through the site with the lowest
1559
+ * round-trip time to the user's connection. Telnyx calculates this time using ICMP
1560
+ * ping messages. This can be disabled by specifying a site to handle all media.
1561
+ */
1562
+ anchorsite_override?: CredentialConnectionsAPI.AnchorsiteOverride;
1563
+ /**
1564
+ * The uuid of the push credential for Android
1565
+ */
1566
+ android_push_credential_id?: string | null;
1567
+ /**
1568
+ * The authentication strategy used by this connection.
1569
+ */
1570
+ authentication?: 'uac-authentication';
1571
+ /**
1572
+ * Specifies if call cost webhooks should be sent for this connection.
1573
+ */
1574
+ call_cost_in_webhooks?: boolean;
1575
+ connection_name?: string;
1576
+ /**
1577
+ * ISO-8601 formatted date indicating when the resource was created.
1578
+ */
1579
+ created_at?: string;
1580
+ /**
1581
+ * When enabled, Telnyx will generate comfort noise when you place the call on
1582
+ * hold. If disabled, you will need to generate comfort noise or on hold music to
1583
+ * avoid RTP timeout.
1584
+ */
1585
+ default_on_hold_comfort_noise_enabled?: boolean;
1586
+ /**
1587
+ * Sets the type of DTMF digits sent from Telnyx to this Connection. Note that DTMF
1588
+ * digits sent to Telnyx will be accepted in all formats.
1589
+ */
1590
+ dtmf_type?: CredentialConnectionsAPI.DtmfType;
1591
+ /**
1592
+ * Encode the SIP contact header sent by Telnyx to avoid issues for NAT or ALG
1593
+ * scenarios.
1594
+ */
1595
+ encode_contact_header_enabled?: boolean;
1596
+ /**
1597
+ * Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
1598
+ * TLS.
1599
+ */
1600
+ encrypted_media?: CredentialConnectionsAPI.EncryptedMedia | null;
1601
+ /**
1602
+ * External SIP peer settings used by Telnyx when registering to your PBX and
1603
+ * routing outbound calls.
1604
+ */
1605
+ external_uac_settings?: Data.ExternalUacSettings;
1606
+ /**
1607
+ * The Telnyx-managed FQDN generated for the UAC connection.
1608
+ */
1609
+ fqdn?: string;
1610
+ /**
1611
+ * The fixed outbound authentication mode used by UAC FQDN records.
1612
+ */
1613
+ fqdn_outbound_authentication?: 'credential-authentication';
1614
+ /**
1615
+ * FQDN records managed automatically by the UAC connection lifecycle.
1616
+ */
1617
+ fqdns?: Array<FqdnsAPI.Fqdn>;
1618
+ inbound?: Data.Inbound;
1619
+ /**
1620
+ * Internal Telnyx-side settings for a UAC connection.
1621
+ */
1622
+ internal_uac_settings?: Data.InternalUacSettings;
1623
+ /**
1624
+ * The uuid of the push credential for Ios
1625
+ */
1626
+ ios_push_credential_id?: string | null;
1627
+ /**
1628
+ * Configuration options for Jitter Buffer. Enables Jitter Buffer for RTP streams
1629
+ * of SIP Trunking calls. The feature is off unless enabled. You may define min and
1630
+ * max values in msec for customized buffering behaviors. Larger values add latency
1631
+ * but tolerate more jitter, while smaller values reduce latency but are more
1632
+ * sensitive to jitter and reordering.
1633
+ */
1634
+ jitter_buffer?: Shared.ConnectionJitterBuffer;
1635
+ /**
1636
+ * Controls when noise suppression is applied to calls. When set to 'inbound',
1637
+ * noise suppression is applied to incoming audio. When set to 'outbound', it's
1638
+ * applied to outgoing audio. When set to 'both', it's applied in both directions.
1639
+ * When set to 'disabled', noise suppression is turned off.
1640
+ */
1641
+ noise_suppression?: 'inbound' | 'outbound' | 'both' | 'disabled';
1642
+ /**
1643
+ * Configuration options for noise suppression. These settings are stored
1644
+ * regardless of the noise_suppression value, but only take effect when
1645
+ * noise_suppression is not 'disabled'. If you disable noise suppression and later
1646
+ * re-enable it, the previously configured settings will be used.
1647
+ */
1648
+ noise_suppression_details?: Shared.ConnectionNoiseSuppressionDetails;
1649
+ /**
1650
+ * Enable on-net T38 if you prefer the sender and receiver negotiating T38 directly
1651
+ * if both are on the Telnyx network. If this is disabled, Telnyx will be able to
1652
+ * use T38 on just one leg of the call depending on each leg's settings.
1653
+ */
1654
+ onnet_t38_passthrough_enabled?: boolean;
1655
+ outbound?: Data.Outbound;
1656
+ /**
1657
+ * The password to be used as part of the credentials. Must be 8 to 128 characters
1658
+ * long.
1659
+ */
1660
+ password?: string;
1661
+ /**
1662
+ * Identifies the type of the resource.
1663
+ */
1664
+ record_type?: string;
1665
+ /**
1666
+ * The most recently known SIP registration status for this UAC connection.
1667
+ */
1668
+ registration_status?: string | null;
1669
+ /**
1670
+ * ISO 8601 formatted date indicating when the registration status was last
1671
+ * updated.
1672
+ */
1673
+ registration_status_updated_at?: string | null;
1674
+ rtcp_settings?: CredentialConnectionsAPI.ConnectionRtcpSettings;
1675
+ /**
1676
+ * This feature enables inbound SIP URI calls to your Credential Auth Connection.
1677
+ * If enabled for all (unrestricted) then anyone who calls the SIP URI
1678
+ * <your-username>@telnyx.com will be connected to your Connection. You can also
1679
+ * choose to allow only calls that are originated on any Connections under your
1680
+ * account (internal).
1681
+ */
1682
+ sip_uri_calling_preference?: 'disabled' | 'unrestricted' | 'internal';
1683
+ /**
1684
+ * Tags associated with the connection.
1685
+ */
1686
+ tags?: Array<string>;
1687
+ /**
1688
+ * ISO-8601 formatted date indicating when the resource was updated.
1689
+ */
1690
+ updated_at?: string;
1691
+ /**
1692
+ * The user name to be used as part of the credentials. Must be 4-32 characters
1693
+ * long and alphanumeric values only (no spaces or special characters). At least
1694
+ * one of the first 5 characters must be a letter.
1695
+ */
1696
+ user_name?: string;
1697
+ /**
1698
+ * Determines which webhook format will be used, Telnyx API v1 or v2.
1699
+ */
1700
+ webhook_api_version?: '1' | '2';
1701
+ /**
1702
+ * The failover URL where webhooks related to this connection will be sent if
1703
+ * sending to the primary URL fails. Must include a scheme, such as 'https'.
1704
+ */
1705
+ webhook_event_failover_url?: string | null;
1706
+ /**
1707
+ * The URL where webhooks related to this connection will be sent. Must include a
1708
+ * scheme, such as 'https'.
1709
+ */
1710
+ webhook_event_url?: string;
1711
+ /**
1712
+ * Specifies how many seconds to wait before timing out a webhook.
1713
+ */
1714
+ webhook_timeout_secs?: number | null;
1715
+ }
1716
+ namespace Data {
1717
+ /**
1718
+ * External SIP peer settings used by Telnyx when registering to your PBX and
1719
+ * routing outbound calls.
1720
+ */
1721
+ interface ExternalUacSettings {
1722
+ /**
1723
+ * The authentication username used in SIP digest authentication. If not set, the
1724
+ * Username value will be used.
1725
+ */
1726
+ auth_username?: string | null;
1727
+ /**
1728
+ * The registration interval, in seconds, indicating how often the system refreshes
1729
+ * the SIP registration with the external SIP peer.
1730
+ */
1731
+ expiration_sec?: number | null;
1732
+ /**
1733
+ * The user portion of the SIP From header used in outbound requests. This controls
1734
+ * the caller identity presented to the external SIP peer.
1735
+ */
1736
+ from_user?: string | null;
1737
+ /**
1738
+ * An optional SIP proxy used to route outbound requests before reaching the
1739
+ * external SIP peer.
1740
+ */
1741
+ outbound_proxy?: string | null;
1742
+ /**
1743
+ * The SIP password used for digest authentication with the external SIP peer.
1744
+ */
1745
+ password?: string;
1746
+ /**
1747
+ * The SIP proxy address of the external SIP peer used for registrations and
1748
+ * outbound call routing.
1749
+ */
1750
+ proxy?: string;
1751
+ /**
1752
+ * The transport protocol used for SIP signaling when communicating with the
1753
+ * external SIP peer. One of UDP, TLS, or TCP.
1754
+ */
1755
+ transport?: 'UDP' | 'TLS' | 'TCP' | null;
1756
+ /**
1757
+ * The SIP username used to authenticate with the external SIP peer for
1758
+ * registrations and outbound calls. Must start with a letter or number and contain
1759
+ * only letters, numbers, hyphens, and underscores.
1760
+ */
1761
+ username?: string;
1762
+ }
1763
+ interface Inbound {
1764
+ /**
1765
+ * This setting allows you to set the format with which the caller's number (ANI)
1766
+ * is sent for inbound phone calls.
1767
+ */
1768
+ ani_number_format?: '+E.164' | 'E.164' | '+E.164-national' | 'E.164-national';
1769
+ /**
1770
+ * When set, this will limit the total number of inbound calls to phone numbers
1771
+ * associated with this connection.
1772
+ */
1773
+ channel_limit?: number;
1774
+ /**
1775
+ * Defines the list of codecs that Telnyx will send for inbound calls to a specific
1776
+ * number on your portal account, in priority order. This only works when the
1777
+ * Connection the number is assigned to uses Media Handling mode: default. OPUS and
1778
+ * H.264 codecs are available only when using TCP or TLS transport for SIP.
1779
+ */
1780
+ codecs?: Array<string>;
1781
+ /**
1782
+ * Default routing method to be used when a number is associated with the
1783
+ * connection. Must be one of the routing method types or left blank, other values
1784
+ * are not allowed.
1785
+ */
1786
+ default_routing_method?: 'sequential' | 'round-robin';
1787
+ dnis_number_format?: '+e164' | 'e164' | 'national' | 'sip_username';
1788
+ /**
1789
+ * Generate ringback tone through 183 session progress message with early media.
1790
+ */
1791
+ generate_ringback_tone?: boolean;
1792
+ /**
1793
+ * When set, inbound phone calls will receive ISUP parameters via SIP headers.
1794
+ * (Only when available and only when using TCP or TLS transport.)
1795
+ */
1796
+ isup_headers_enabled?: boolean;
1797
+ /**
1798
+ * Enable PRACK messages as defined in RFC3262.
1799
+ */
1800
+ prack_enabled?: boolean;
1801
+ /**
1802
+ * When enabled the SIP Connection will receive the Identity header with
1803
+ * Shaken/Stir data in the SIP INVITE message of inbound calls, even when using UDP
1804
+ * transport.
1805
+ */
1806
+ shaken_stir_enabled?: boolean;
1807
+ /**
1808
+ * When enabled, allows multiple devices to ring simultaneously on incoming calls.
1809
+ */
1810
+ simultaneous_ringing?: 'disabled' | 'enabled';
1811
+ /**
1812
+ * Defaults to true.
1813
+ */
1814
+ sip_compact_headers_enabled?: boolean;
1815
+ /**
1816
+ * The Telnyx-generated SIP subdomain for this UAC connection.
1817
+ */
1818
+ sip_subdomain?: string;
1819
+ /**
1820
+ * Controls which SIP URI callers may reach this connection.
1821
+ */
1822
+ sip_subdomain_receive_settings?: 'only_my_connections' | 'from_anyone';
1823
+ /**
1824
+ * Time(sec) before aborting if connection is not made.
1825
+ */
1826
+ timeout_1xx_secs?: number;
1827
+ /**
1828
+ * Time(sec) before aborting if call is unanswered (min: 1, max: 600).
1829
+ */
1830
+ timeout_2xx_secs?: number;
1831
+ }
1832
+ /**
1833
+ * Internal Telnyx-side settings for a UAC connection.
1834
+ */
1835
+ interface InternalUacSettings {
1836
+ /**
1837
+ * The SIP URI that Telnyx will call when handling an inbound request from the
1838
+ * external peer. Do not include a `sip:` prefix. The value must be in the format
1839
+ * `userinfo@[subdomain.]sip.telnyx.com` or
1840
+ * `userinfo@[subdomain.]sipdev.telnyx.com`; the userinfo portion may contain only
1841
+ * letters, digits, hyphens, and underscores.
1842
+ */
1843
+ destination_uri?: string;
1844
+ }
1845
+ interface Outbound {
1846
+ /**
1847
+ * Set a phone number as the ani_override value to override caller id number on
1848
+ * outbound calls.
1849
+ */
1850
+ ani_override?: string;
1851
+ /**
1852
+ * Specifies when we apply your ani_override setting. Only applies when
1853
+ * ani_override is not blank.
1854
+ */
1855
+ ani_override_type?: 'always' | 'normal' | 'emergency';
1856
+ /**
1857
+ * Forces all SIP calls originated on this connection to be "parked" instead of
1858
+ * "bridged" to the destination specified on the URI. Parked calls will return
1859
+ * ringback to the caller and will await for a Call Control command to define which
1860
+ * action will be taken next.
1861
+ */
1862
+ call_parking_enabled?: boolean | null;
1863
+ /**
1864
+ * When set, this will limit the total number of outbound calls to phone numbers
1865
+ * associated with this connection.
1866
+ */
1867
+ channel_limit?: number;
1868
+ /**
1869
+ * Generate ringback tone through 183 session progress message with early media.
1870
+ */
1871
+ generate_ringback_tone?: boolean;
1872
+ /**
1873
+ * When set, ringback will not wait for indication before sending ringback tone to
1874
+ * calling party.
1875
+ */
1876
+ instant_ringback_enabled?: boolean;
1877
+ /**
1878
+ * A 2-character country code specifying the country whose national dialing rules
1879
+ * should be used. For example, if set to `US` then any US number can be dialed
1880
+ * without preprending +1 to the number. When left blank, Telnyx will try US and GB
1881
+ * dialing rules, in that order, by default.
1882
+ */
1883
+ localization?: string;
1884
+ /**
1885
+ * Identifies the associated outbound voice profile.
1886
+ */
1887
+ outbound_voice_profile_id?: string;
1888
+ /**
1889
+ * This setting only affects connections with Fax-type Outbound Voice Profiles. The
1890
+ * setting dictates whether or not Telnyx sends a t.38 reinvite.<br/><br/> By
1891
+ * default, Telnyx will send the re-invite. If set to `customer`, the caller is
1892
+ * expected to send the t.38 reinvite.
1893
+ */
1894
+ t38_reinvite_source?: 'telnyx' | 'customer' | 'disabled' | 'passthru' | 'caller-passthru' | 'callee-passthru';
1895
+ }
1896
+ }
1897
+ }
1898
+ export interface UacConnectionCreateParams {
1899
+ /**
1900
+ * A user-assigned name to help manage the connection.
1901
+ */
1902
+ connection_name: string;
1903
+ /**
1904
+ * Defaults to true
1905
+ */
1906
+ active?: boolean;
1907
+ /**
1908
+ * `Latency` directs Telnyx to route media through the site with the lowest
1909
+ * round-trip time to the user's connection. Telnyx calculates this time using ICMP
1910
+ * ping messages. This can be disabled by specifying a site to handle all media.
1911
+ */
1912
+ anchorsite_override?: CredentialConnectionsAPI.AnchorsiteOverride;
1913
+ /**
1914
+ * The uuid of the push credential for Android
1915
+ */
1916
+ android_push_credential_id?: string | null;
1917
+ /**
1918
+ * Specifies if call cost webhooks should be sent for this connection.
1919
+ */
1920
+ call_cost_in_webhooks?: boolean;
1921
+ /**
1922
+ * When enabled, Telnyx will generate comfort noise when you place the call on
1923
+ * hold. If disabled, you will need to generate comfort noise or on hold music to
1924
+ * avoid RTP timeout.
1925
+ */
1926
+ default_on_hold_comfort_noise_enabled?: boolean;
1927
+ /**
1928
+ * Sets the type of DTMF digits sent from Telnyx to this Connection. Note that DTMF
1929
+ * digits sent to Telnyx will be accepted in all formats.
1930
+ */
1931
+ dtmf_type?: CredentialConnectionsAPI.DtmfType;
1932
+ /**
1933
+ * Encode the SIP contact header sent by Telnyx to avoid issues for NAT or ALG
1934
+ * scenarios.
1935
+ */
1936
+ encode_contact_header_enabled?: boolean;
1937
+ /**
1938
+ * Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
1939
+ * TLS.
1940
+ */
1941
+ encrypted_media?: CredentialConnectionsAPI.EncryptedMedia | null;
1942
+ /**
1943
+ * External SIP peer settings used by Telnyx when registering to your PBX and
1944
+ * routing outbound calls.
1945
+ */
1946
+ external_uac_settings?: UacConnectionCreateParams.ExternalUacSettings;
1947
+ /**
1948
+ * Inbound settings that can be supplied when creating or updating a UAC
1949
+ * connection. The SIP subdomain fields returned in UAC connection responses are
1950
+ * generated by Telnyx and are not accepted as request parameters.
1951
+ */
1952
+ inbound?: UacConnectionCreateParams.Inbound;
1953
+ /**
1954
+ * Internal Telnyx-side settings for a UAC connection.
1955
+ */
1956
+ internal_uac_settings?: UacConnectionCreateParams.InternalUacSettings;
1957
+ /**
1958
+ * The uuid of the push credential for Ios
1959
+ */
1960
+ ios_push_credential_id?: string | null;
1961
+ /**
1962
+ * Configuration options for Jitter Buffer. Enables Jitter Buffer for RTP streams
1963
+ * of SIP Trunking calls. The feature is off unless enabled. You may define min and
1964
+ * max values in msec for customized buffering behaviors. Larger values add latency
1965
+ * but tolerate more jitter, while smaller values reduce latency but are more
1966
+ * sensitive to jitter and reordering.
1967
+ */
1968
+ jitter_buffer?: Shared.ConnectionJitterBuffer;
1969
+ /**
1970
+ * Controls when noise suppression is applied to calls. When set to 'inbound',
1971
+ * noise suppression is applied to incoming audio. When set to 'outbound', it's
1972
+ * applied to outgoing audio. When set to 'both', it's applied in both directions.
1973
+ * When set to 'disabled', noise suppression is turned off.
1974
+ */
1975
+ noise_suppression?: 'inbound' | 'outbound' | 'both' | 'disabled';
1976
+ /**
1977
+ * Configuration options for noise suppression. These settings are stored
1978
+ * regardless of the noise_suppression value, but only take effect when
1979
+ * noise_suppression is not 'disabled'. If you disable noise suppression and later
1980
+ * re-enable it, the previously configured settings will be used.
1981
+ */
1982
+ noise_suppression_details?: Shared.ConnectionNoiseSuppressionDetails;
1983
+ /**
1984
+ * Enable on-net T38 if you prefer the sender and receiver negotiating T38 directly
1985
+ * if both are on the Telnyx network. If this is disabled, Telnyx will be able to
1986
+ * use T38 on just one leg of the call depending on each leg's settings.
1987
+ */
1988
+ onnet_t38_passthrough_enabled?: boolean;
1989
+ outbound?: UacConnectionCreateParams.Outbound;
1990
+ /**
1991
+ * The password to be used as part of the credentials. Must be 8 to 128 characters
1992
+ * long.
1993
+ */
1994
+ password?: string;
1995
+ rtcp_settings?: CredentialConnectionsAPI.ConnectionRtcpSettings;
1996
+ /**
1997
+ * This feature enables inbound SIP URI calls to your Credential Auth Connection.
1998
+ * If enabled for all (unrestricted) then anyone who calls the SIP URI
1999
+ * <your-username>@telnyx.com will be connected to your Connection. You can also
2000
+ * choose to allow only calls that are originated on any Connections under your
2001
+ * account (internal).
2002
+ */
2003
+ sip_uri_calling_preference?: 'disabled' | 'unrestricted' | 'internal';
2004
+ /**
2005
+ * Tags associated with the connection.
2006
+ */
2007
+ tags?: Array<string>;
2008
+ /**
2009
+ * The user name to be used as part of the credentials. Must be 4-32 characters
2010
+ * long and alphanumeric values only (no spaces or special characters).
2011
+ */
2012
+ user_name?: string;
2013
+ /**
2014
+ * Determines which webhook format will be used, Telnyx API v1, v2 or texml. Note -
2015
+ * texml can only be set when the outbound object parameter call_parking_enabled is
2016
+ * included and set to true.
2017
+ */
2018
+ webhook_api_version?: '1' | '2' | 'texml';
2019
+ /**
2020
+ * The failover URL where webhooks related to this connection will be sent if
2021
+ * sending to the primary URL fails. Must include a scheme, such as 'https'.
2022
+ */
2023
+ webhook_event_failover_url?: string | null;
2024
+ /**
2025
+ * The URL where webhooks related to this connection will be sent. Must include a
2026
+ * scheme, such as 'https'.
2027
+ */
2028
+ webhook_event_url?: string;
2029
+ /**
2030
+ * Specifies how many seconds to wait before timing out a webhook.
2031
+ */
2032
+ webhook_timeout_secs?: number | null;
2033
+ }
2034
+ export declare namespace UacConnectionCreateParams {
2035
+ /**
2036
+ * External SIP peer settings used by Telnyx when registering to your PBX and
2037
+ * routing outbound calls.
2038
+ */
2039
+ interface ExternalUacSettings {
2040
+ /**
2041
+ * The authentication username used in SIP digest authentication. If not set, the
2042
+ * Username value will be used.
2043
+ */
2044
+ auth_username?: string | null;
2045
+ /**
2046
+ * The registration interval, in seconds, indicating how often the system refreshes
2047
+ * the SIP registration with the external SIP peer.
2048
+ */
2049
+ expiration_sec?: number | null;
2050
+ /**
2051
+ * The user portion of the SIP From header used in outbound requests. This controls
2052
+ * the caller identity presented to the external SIP peer.
2053
+ */
2054
+ from_user?: string | null;
2055
+ /**
2056
+ * An optional SIP proxy used to route outbound requests before reaching the
2057
+ * external SIP peer.
2058
+ */
2059
+ outbound_proxy?: string | null;
2060
+ /**
2061
+ * The SIP password used for digest authentication with the external SIP peer.
2062
+ */
2063
+ password?: string;
2064
+ /**
2065
+ * The SIP proxy address of the external SIP peer used for registrations and
2066
+ * outbound call routing.
2067
+ */
2068
+ proxy?: string;
2069
+ /**
2070
+ * The transport protocol used for SIP signaling when communicating with the
2071
+ * external SIP peer. One of UDP, TLS, or TCP.
2072
+ */
2073
+ transport?: 'UDP' | 'TLS' | 'TCP' | null;
2074
+ /**
2075
+ * The SIP username used to authenticate with the external SIP peer for
2076
+ * registrations and outbound calls. Must start with a letter or number and contain
2077
+ * only letters, numbers, hyphens, and underscores.
2078
+ */
2079
+ username?: string;
2080
+ }
2081
+ /**
2082
+ * Inbound settings that can be supplied when creating or updating a UAC
2083
+ * connection. The SIP subdomain fields returned in UAC connection responses are
2084
+ * generated by Telnyx and are not accepted as request parameters.
2085
+ */
2086
+ interface Inbound {
2087
+ /**
2088
+ * This setting allows you to set the format with which the caller's number (ANI)
2089
+ * is sent for inbound phone calls.
2090
+ */
2091
+ ani_number_format?: '+E.164' | 'E.164' | '+E.164-national' | 'E.164-national';
2092
+ /**
2093
+ * When set, this will limit the total number of inbound calls to phone numbers
2094
+ * associated with this connection.
2095
+ */
2096
+ channel_limit?: number;
2097
+ /**
2098
+ * Defines the list of codecs that Telnyx will send for inbound calls to a specific
2099
+ * number on your portal account, in priority order. This only works when the
2100
+ * Connection the number is assigned to uses Media Handling mode: default. OPUS and
2101
+ * H.264 codecs are available only when using TCP or TLS transport for SIP.
2102
+ */
2103
+ codecs?: Array<string>;
2104
+ /**
2105
+ * Default routing method to be used when a number is associated with the
2106
+ * connection. Must be one of the routing method types or left blank, other values
2107
+ * are not allowed.
2108
+ */
2109
+ default_routing_method?: 'sequential' | 'round-robin';
2110
+ dnis_number_format?: '+e164' | 'e164' | 'national' | 'sip_username';
2111
+ /**
2112
+ * Generate ringback tone through 183 session progress message with early media.
2113
+ */
2114
+ generate_ringback_tone?: boolean;
2115
+ /**
2116
+ * When set, inbound phone calls will receive ISUP parameters via SIP headers.
2117
+ * (Only when available and only when using TCP or TLS transport.)
2118
+ */
2119
+ isup_headers_enabled?: boolean;
2120
+ /**
2121
+ * Enable PRACK messages as defined in RFC3262.
2122
+ */
2123
+ prack_enabled?: boolean;
2124
+ /**
2125
+ * When enabled the SIP Connection will receive the Identity header with
2126
+ * Shaken/Stir data in the SIP INVITE message of inbound calls, even when using UDP
2127
+ * transport.
2128
+ */
2129
+ shaken_stir_enabled?: boolean;
2130
+ /**
2131
+ * When enabled, allows multiple devices to ring simultaneously on incoming calls.
2132
+ */
2133
+ simultaneous_ringing?: 'disabled' | 'enabled';
2134
+ /**
2135
+ * Defaults to true.
2136
+ */
2137
+ sip_compact_headers_enabled?: boolean;
2138
+ /**
2139
+ * Time(sec) before aborting if connection is not made.
2140
+ */
2141
+ timeout_1xx_secs?: number;
2142
+ /**
2143
+ * Time(sec) before aborting if call is unanswered (min: 1, max: 600).
2144
+ */
2145
+ timeout_2xx_secs?: number;
2146
+ }
2147
+ /**
2148
+ * Internal Telnyx-side settings for a UAC connection.
2149
+ */
2150
+ interface InternalUacSettings {
2151
+ /**
2152
+ * The SIP URI that Telnyx will call when handling an inbound request from the
2153
+ * external peer. Do not include a `sip:` prefix. The value must be in the format
2154
+ * `userinfo@[subdomain.]sip.telnyx.com` or
2155
+ * `userinfo@[subdomain.]sipdev.telnyx.com`; the userinfo portion may contain only
2156
+ * letters, digits, hyphens, and underscores.
2157
+ */
2158
+ destination_uri?: string;
2159
+ }
2160
+ interface Outbound {
2161
+ /**
2162
+ * Set a phone number as the ani_override value to override caller id number on
2163
+ * outbound calls.
2164
+ */
2165
+ ani_override?: string;
2166
+ /**
2167
+ * Specifies when we apply your ani_override setting. Only applies when
2168
+ * ani_override is not blank.
2169
+ */
2170
+ ani_override_type?: 'always' | 'normal' | 'emergency';
2171
+ /**
2172
+ * Forces all SIP calls originated on this connection to be "parked" instead of
2173
+ * "bridged" to the destination specified on the URI. Parked calls will return
2174
+ * ringback to the caller and will await for a Call Control command to define which
2175
+ * action will be taken next.
2176
+ */
2177
+ call_parking_enabled?: boolean | null;
2178
+ /**
2179
+ * When set, this will limit the total number of outbound calls to phone numbers
2180
+ * associated with this connection.
2181
+ */
2182
+ channel_limit?: number;
2183
+ /**
2184
+ * Generate ringback tone through 183 session progress message with early media.
2185
+ */
2186
+ generate_ringback_tone?: boolean;
2187
+ /**
2188
+ * When set, ringback will not wait for indication before sending ringback tone to
2189
+ * calling party.
2190
+ */
2191
+ instant_ringback_enabled?: boolean;
2192
+ /**
2193
+ * A 2-character country code specifying the country whose national dialing rules
2194
+ * should be used. For example, if set to `US` then any US number can be dialed
2195
+ * without preprending +1 to the number. When left blank, Telnyx will try US and GB
2196
+ * dialing rules, in that order, by default.
2197
+ */
2198
+ localization?: string;
2199
+ /**
2200
+ * Identifies the associated outbound voice profile.
2201
+ */
2202
+ outbound_voice_profile_id?: string;
2203
+ /**
2204
+ * This setting only affects connections with Fax-type Outbound Voice Profiles. The
2205
+ * setting dictates whether or not Telnyx sends a t.38 reinvite.<br/><br/> By
2206
+ * default, Telnyx will send the re-invite. If set to `customer`, the caller is
2207
+ * expected to send the t.38 reinvite.
2208
+ */
2209
+ t38_reinvite_source?: 'telnyx' | 'customer' | 'disabled' | 'passthru' | 'caller-passthru' | 'callee-passthru';
2210
+ }
2211
+ }
2212
+ export interface UacConnectionUpdateParams {
2213
+ /**
2214
+ * Defaults to true
2215
+ */
2216
+ active?: boolean;
2217
+ /**
2218
+ * `Latency` directs Telnyx to route media through the site with the lowest
2219
+ * round-trip time to the user's connection. Telnyx calculates this time using ICMP
2220
+ * ping messages. This can be disabled by specifying a site to handle all media.
2221
+ */
2222
+ anchorsite_override?: CredentialConnectionsAPI.AnchorsiteOverride;
2223
+ /**
2224
+ * The uuid of the push credential for Android
2225
+ */
2226
+ android_push_credential_id?: string | null;
2227
+ /**
2228
+ * Specifies if call cost webhooks should be sent for this connection.
2229
+ */
2230
+ call_cost_in_webhooks?: boolean;
2231
+ /**
2232
+ * A user-assigned name to help manage the connection.
2233
+ */
2234
+ connection_name?: string;
2235
+ /**
2236
+ * When enabled, Telnyx will generate comfort noise when you place the call on
2237
+ * hold. If disabled, you will need to generate comfort noise or on hold music to
2238
+ * avoid RTP timeout.
2239
+ */
2240
+ default_on_hold_comfort_noise_enabled?: boolean;
2241
+ /**
2242
+ * Sets the type of DTMF digits sent from Telnyx to this Connection. Note that DTMF
2243
+ * digits sent to Telnyx will be accepted in all formats.
2244
+ */
2245
+ dtmf_type?: CredentialConnectionsAPI.DtmfType;
2246
+ /**
2247
+ * Encode the SIP contact header sent by Telnyx to avoid issues for NAT or ALG
2248
+ * scenarios.
2249
+ */
2250
+ encode_contact_header_enabled?: boolean;
2251
+ /**
2252
+ * Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
2253
+ * TLS.
2254
+ */
2255
+ encrypted_media?: CredentialConnectionsAPI.EncryptedMedia | null;
2256
+ /**
2257
+ * External SIP peer settings used by Telnyx when registering to your PBX and
2258
+ * routing outbound calls.
2259
+ */
2260
+ external_uac_settings?: UacConnectionUpdateParams.ExternalUacSettings;
2261
+ /**
2262
+ * Inbound settings that can be supplied when creating or updating a UAC
2263
+ * connection. The SIP subdomain fields returned in UAC connection responses are
2264
+ * generated by Telnyx and are not accepted as request parameters.
2265
+ */
2266
+ inbound?: UacConnectionUpdateParams.Inbound;
2267
+ /**
2268
+ * Internal Telnyx-side settings for a UAC connection.
2269
+ */
2270
+ internal_uac_settings?: UacConnectionUpdateParams.InternalUacSettings;
2271
+ /**
2272
+ * The uuid of the push credential for Ios
2273
+ */
2274
+ ios_push_credential_id?: string | null;
2275
+ /**
2276
+ * Configuration options for Jitter Buffer. Enables Jitter Buffer for RTP streams
2277
+ * of SIP Trunking calls. The feature is off unless enabled. You may define min and
2278
+ * max values in msec for customized buffering behaviors. Larger values add latency
2279
+ * but tolerate more jitter, while smaller values reduce latency but are more
2280
+ * sensitive to jitter and reordering.
2281
+ */
2282
+ jitter_buffer?: Shared.ConnectionJitterBuffer;
2283
+ /**
2284
+ * Controls when noise suppression is applied to calls. When set to 'inbound',
2285
+ * noise suppression is applied to incoming audio. When set to 'outbound', it's
2286
+ * applied to outgoing audio. When set to 'both', it's applied in both directions.
2287
+ * When set to 'disabled', noise suppression is turned off.
2288
+ */
2289
+ noise_suppression?: 'inbound' | 'outbound' | 'both' | 'disabled';
2290
+ /**
2291
+ * Configuration options for noise suppression. These settings are stored
2292
+ * regardless of the noise_suppression value, but only take effect when
2293
+ * noise_suppression is not 'disabled'. If you disable noise suppression and later
2294
+ * re-enable it, the previously configured settings will be used.
2295
+ */
2296
+ noise_suppression_details?: Shared.ConnectionNoiseSuppressionDetails;
2297
+ /**
2298
+ * Enable on-net T38 if you prefer the sender and receiver negotiating T38 directly
2299
+ * if both are on the Telnyx network. If this is disabled, Telnyx will be able to
2300
+ * use T38 on just one leg of the call depending on each leg's settings.
2301
+ */
2302
+ onnet_t38_passthrough_enabled?: boolean;
2303
+ outbound?: UacConnectionUpdateParams.Outbound;
2304
+ /**
2305
+ * The password to be used as part of the credentials. Must be 8 to 128 characters
2306
+ * long.
2307
+ */
2308
+ password?: string;
2309
+ rtcp_settings?: CredentialConnectionsAPI.ConnectionRtcpSettings;
2310
+ /**
2311
+ * This feature enables inbound SIP URI calls to your Credential Auth Connection.
2312
+ * If enabled for all (unrestricted) then anyone who calls the SIP URI
2313
+ * <your-username>@telnyx.com will be connected to your Connection. You can also
2314
+ * choose to allow only calls that are originated on any Connections under your
2315
+ * account (internal).
2316
+ */
2317
+ sip_uri_calling_preference?: 'disabled' | 'unrestricted' | 'internal';
2318
+ /**
2319
+ * Tags associated with the connection.
2320
+ */
2321
+ tags?: Array<string>;
2322
+ /**
2323
+ * The user name to be used as part of the credentials. Must be 4-32 characters
2324
+ * long and alphanumeric values only (no spaces or special characters).
2325
+ */
2326
+ user_name?: string;
2327
+ /**
2328
+ * Determines which webhook format will be used, Telnyx API v1 or v2.
2329
+ */
2330
+ webhook_api_version?: '1' | '2';
2331
+ /**
2332
+ * The failover URL where webhooks related to this connection will be sent if
2333
+ * sending to the primary URL fails. Must include a scheme, such as 'https'.
2334
+ */
2335
+ webhook_event_failover_url?: string | null;
2336
+ /**
2337
+ * The URL where webhooks related to this connection will be sent. Must include a
2338
+ * scheme, such as 'https'.
2339
+ */
2340
+ webhook_event_url?: string;
2341
+ /**
2342
+ * Specifies how many seconds to wait before timing out a webhook.
2343
+ */
2344
+ webhook_timeout_secs?: number | null;
2345
+ }
2346
+ export declare namespace UacConnectionUpdateParams {
2347
+ /**
2348
+ * External SIP peer settings used by Telnyx when registering to your PBX and
2349
+ * routing outbound calls.
2350
+ */
2351
+ interface ExternalUacSettings {
2352
+ /**
2353
+ * The authentication username used in SIP digest authentication. If not set, the
2354
+ * Username value will be used.
2355
+ */
2356
+ auth_username?: string | null;
2357
+ /**
2358
+ * The registration interval, in seconds, indicating how often the system refreshes
2359
+ * the SIP registration with the external SIP peer.
2360
+ */
2361
+ expiration_sec?: number | null;
2362
+ /**
2363
+ * The user portion of the SIP From header used in outbound requests. This controls
2364
+ * the caller identity presented to the external SIP peer.
2365
+ */
2366
+ from_user?: string | null;
2367
+ /**
2368
+ * An optional SIP proxy used to route outbound requests before reaching the
2369
+ * external SIP peer.
2370
+ */
2371
+ outbound_proxy?: string | null;
2372
+ /**
2373
+ * The SIP password used for digest authentication with the external SIP peer.
2374
+ */
2375
+ password?: string;
2376
+ /**
2377
+ * The SIP proxy address of the external SIP peer used for registrations and
2378
+ * outbound call routing.
2379
+ */
2380
+ proxy?: string;
2381
+ /**
2382
+ * The transport protocol used for SIP signaling when communicating with the
2383
+ * external SIP peer. One of UDP, TLS, or TCP.
2384
+ */
2385
+ transport?: 'UDP' | 'TLS' | 'TCP' | null;
2386
+ /**
2387
+ * The SIP username used to authenticate with the external SIP peer for
2388
+ * registrations and outbound calls. Must start with a letter or number and contain
2389
+ * only letters, numbers, hyphens, and underscores.
2390
+ */
2391
+ username?: string;
2392
+ }
2393
+ /**
2394
+ * Inbound settings that can be supplied when creating or updating a UAC
2395
+ * connection. The SIP subdomain fields returned in UAC connection responses are
2396
+ * generated by Telnyx and are not accepted as request parameters.
2397
+ */
2398
+ interface Inbound {
2399
+ /**
2400
+ * This setting allows you to set the format with which the caller's number (ANI)
2401
+ * is sent for inbound phone calls.
2402
+ */
2403
+ ani_number_format?: '+E.164' | 'E.164' | '+E.164-national' | 'E.164-national';
2404
+ /**
2405
+ * When set, this will limit the total number of inbound calls to phone numbers
2406
+ * associated with this connection.
2407
+ */
2408
+ channel_limit?: number;
2409
+ /**
2410
+ * Defines the list of codecs that Telnyx will send for inbound calls to a specific
2411
+ * number on your portal account, in priority order. This only works when the
2412
+ * Connection the number is assigned to uses Media Handling mode: default. OPUS and
2413
+ * H.264 codecs are available only when using TCP or TLS transport for SIP.
2414
+ */
2415
+ codecs?: Array<string>;
2416
+ /**
2417
+ * Default routing method to be used when a number is associated with the
2418
+ * connection. Must be one of the routing method types or left blank, other values
2419
+ * are not allowed.
2420
+ */
2421
+ default_routing_method?: 'sequential' | 'round-robin';
2422
+ dnis_number_format?: '+e164' | 'e164' | 'national' | 'sip_username';
2423
+ /**
2424
+ * Generate ringback tone through 183 session progress message with early media.
2425
+ */
2426
+ generate_ringback_tone?: boolean;
2427
+ /**
2428
+ * When set, inbound phone calls will receive ISUP parameters via SIP headers.
2429
+ * (Only when available and only when using TCP or TLS transport.)
2430
+ */
2431
+ isup_headers_enabled?: boolean;
2432
+ /**
2433
+ * Enable PRACK messages as defined in RFC3262.
2434
+ */
2435
+ prack_enabled?: boolean;
2436
+ /**
2437
+ * When enabled the SIP Connection will receive the Identity header with
2438
+ * Shaken/Stir data in the SIP INVITE message of inbound calls, even when using UDP
2439
+ * transport.
2440
+ */
2441
+ shaken_stir_enabled?: boolean;
2442
+ /**
2443
+ * When enabled, allows multiple devices to ring simultaneously on incoming calls.
2444
+ */
2445
+ simultaneous_ringing?: 'disabled' | 'enabled';
2446
+ /**
2447
+ * Defaults to true.
2448
+ */
2449
+ sip_compact_headers_enabled?: boolean;
2450
+ /**
2451
+ * Time(sec) before aborting if connection is not made.
2452
+ */
2453
+ timeout_1xx_secs?: number;
2454
+ /**
2455
+ * Time(sec) before aborting if call is unanswered (min: 1, max: 600).
2456
+ */
2457
+ timeout_2xx_secs?: number;
2458
+ }
2459
+ /**
2460
+ * Internal Telnyx-side settings for a UAC connection.
2461
+ */
2462
+ interface InternalUacSettings {
2463
+ /**
2464
+ * The SIP URI that Telnyx will call when handling an inbound request from the
2465
+ * external peer. Do not include a `sip:` prefix. The value must be in the format
2466
+ * `userinfo@[subdomain.]sip.telnyx.com` or
2467
+ * `userinfo@[subdomain.]sipdev.telnyx.com`; the userinfo portion may contain only
2468
+ * letters, digits, hyphens, and underscores.
2469
+ */
2470
+ destination_uri?: string;
2471
+ }
2472
+ interface Outbound {
2473
+ /**
2474
+ * Set a phone number as the ani_override value to override caller id number on
2475
+ * outbound calls.
2476
+ */
2477
+ ani_override?: string;
2478
+ /**
2479
+ * Specifies when we apply your ani_override setting. Only applies when
2480
+ * ani_override is not blank.
2481
+ */
2482
+ ani_override_type?: 'always' | 'normal' | 'emergency';
2483
+ /**
2484
+ * Forces all SIP calls originated on this connection to be "parked" instead of
2485
+ * "bridged" to the destination specified on the URI. Parked calls will return
2486
+ * ringback to the caller and will await for a Call Control command to define which
2487
+ * action will be taken next.
2488
+ */
2489
+ call_parking_enabled?: boolean | null;
2490
+ /**
2491
+ * When set, this will limit the total number of outbound calls to phone numbers
2492
+ * associated with this connection.
2493
+ */
2494
+ channel_limit?: number;
2495
+ /**
2496
+ * Generate ringback tone through 183 session progress message with early media.
2497
+ */
2498
+ generate_ringback_tone?: boolean;
2499
+ /**
2500
+ * When set, ringback will not wait for indication before sending ringback tone to
2501
+ * calling party.
2502
+ */
2503
+ instant_ringback_enabled?: boolean;
2504
+ /**
2505
+ * A 2-character country code specifying the country whose national dialing rules
2506
+ * should be used. For example, if set to `US` then any US number can be dialed
2507
+ * without preprending +1 to the number. When left blank, Telnyx will try US and GB
2508
+ * dialing rules, in that order, by default.
2509
+ */
2510
+ localization?: string;
2511
+ /**
2512
+ * Identifies the associated outbound voice profile.
2513
+ */
2514
+ outbound_voice_profile_id?: string;
2515
+ /**
2516
+ * This setting only affects connections with Fax-type Outbound Voice Profiles. The
2517
+ * setting dictates whether or not Telnyx sends a t.38 reinvite.<br/><br/> By
2518
+ * default, Telnyx will send the re-invite. If set to `customer`, the caller is
2519
+ * expected to send the t.38 reinvite.
2520
+ */
2521
+ t38_reinvite_source?: 'telnyx' | 'customer' | 'disabled' | 'passthru' | 'caller-passthru' | 'callee-passthru';
2522
+ }
2523
+ }
2524
+ export interface UacConnectionListParams extends DefaultFlatPaginationParams {
2525
+ /**
2526
+ * Consolidated filter parameter (deepObject style). Originally:
2527
+ * filter[connection_name], filter[fqdn], filter[outbound_voice_profile_id],
2528
+ * filter[outbound.outbound_voice_profile_id]
2529
+ */
2530
+ filter?: UacConnectionListParams.Filter;
2531
+ /**
2532
+ * Specifies the sort order for results. By default sorting direction is ascending.
2533
+ * To have the results sorted in descending order add the <code> -</code>
2534
+ * prefix.<br/><br/> That is: <ul>
2535
+ *
2536
+ * <li>
2537
+ * <code>connection_name</code>: sorts the result by the
2538
+ * <code>connection_name</code> field in ascending order.
2539
+ * </li>
2540
+ *
2541
+ * <li>
2542
+ * <code>-connection_name</code>: sorts the result by the
2543
+ * <code>connection_name</code> field in descending order.
2544
+ * </li>
2545
+ * </ul> <br/> If not given, results are sorted by <code>created_at</code> in descending order.
2546
+ */
2547
+ sort?: 'created_at' | 'connection_name' | 'active';
2548
+ }
2549
+ export declare namespace UacConnectionListParams {
2550
+ /**
2551
+ * Consolidated filter parameter (deepObject style). Originally:
2552
+ * filter[connection_name], filter[fqdn], filter[outbound_voice_profile_id],
2553
+ * filter[outbound.outbound_voice_profile_id]
2554
+ */
2555
+ interface Filter {
2556
+ /**
2557
+ * Filter by connection_name using nested operations
2558
+ */
2559
+ connection_name?: Filter.ConnectionName;
2560
+ /**
2561
+ * If present, connections with an `fqdn` that equals the given value will be
2562
+ * returned. Matching is case-sensitive, and the full string must match.
2563
+ */
2564
+ fqdn?: string;
2565
+ /**
2566
+ * Identifies the associated outbound voice profile.
2567
+ */
2568
+ outbound_voice_profile_id?: string;
2569
+ }
2570
+ namespace Filter {
2571
+ /**
2572
+ * Filter by connection_name using nested operations
2573
+ */
2574
+ interface ConnectionName {
2575
+ /**
2576
+ * If present, connections with <code>connection_name</code> containing the given
2577
+ * value will be returned. Matching is not case-sensitive. Requires at least three
2578
+ * characters.
2579
+ */
2580
+ contains?: string;
2581
+ }
2582
+ }
2583
+ }
2584
+ export declare namespace UacConnections {
2585
+ export { type UacConnectionCreateResponse as UacConnectionCreateResponse, type UacConnectionRetrieveResponse as UacConnectionRetrieveResponse, type UacConnectionUpdateResponse as UacConnectionUpdateResponse, type UacConnectionListResponse as UacConnectionListResponse, type UacConnectionDeleteResponse as UacConnectionDeleteResponse, type UacConnectionListResponsesDefaultFlatPagination as UacConnectionListResponsesDefaultFlatPagination, type UacConnectionCreateParams as UacConnectionCreateParams, type UacConnectionUpdateParams as UacConnectionUpdateParams, type UacConnectionListParams as UacConnectionListParams, };
2586
+ export { Actions as Actions, type ActionCheckRegistrationStatusResponse as ActionCheckRegistrationStatusResponse, };
2587
+ }
2588
+ //# sourceMappingURL=uac-connections.d.mts.map