-
Notifications
You must be signed in to change notification settings - Fork 181
Vonage Voice
Vonage Voice • Docs
Documentation / Vonage Voice
Enum representing different modes for advanced machine detection in the Connect NCCO action.
| Enumeration Member | Value | Description | Defined in |
|---|---|---|---|
DEFAULT |
"default" |
Default mode, used for advanced async machine detection, including beep detection. | voice/lib/enums/AdvancedMachineDetectionMode.ts:8 |
DETECT |
"detect" |
Detect mode, used for advanced sync machine detection without beep detection. | voice/lib/enums/AdvancedMachineDetectionMode.ts:13 |
DETECTBEEP |
"detect_beep" |
Detect beep mode, used for advanced sync machine detection with beep detection. | voice/lib/enums/AdvancedMachineDetectionMode.ts:18 |
Enum representing the direction of a call, whether it is outbound or inbound.
| Enumeration Member | Value | Description | Defined in |
|---|---|---|---|
INBOUND |
"inbound" |
Inbound call direction. | voice/lib/enums/CallDirection.ts:13 |
OUTBOUND |
"outbound" |
Outbound call direction. | voice/lib/enums/CallDirection.ts:8 |
Enum representing the status of a call, including its various stages and outcomes.
| Enumeration Member | Value | Description | Defined in |
|---|---|---|---|
ANSWERED |
"answered" |
The call has been answered. | voice/lib/enums/CallStatus.ts:18 |
BUSY |
"busy" |
The call is busy. | voice/lib/enums/CallStatus.ts:33 |
CANCELLED |
"cancelled" |
The call has been cancelled. | voice/lib/enums/CallStatus.ts:38 |
COMPLETED |
"completed" |
The call has been completed. | voice/lib/enums/CallStatus.ts:28 |
FAILED |
"failed" |
The call has failed. | voice/lib/enums/CallStatus.ts:43 |
MACHINE |
"machine" |
The call has been detected as a machine. | voice/lib/enums/CallStatus.ts:23 |
REJECTED |
"rejected" |
The call has been rejected. | voice/lib/enums/CallStatus.ts:48 |
RINGING |
"ringing" |
The call is ringing. | voice/lib/enums/CallStatus.ts:13 |
STARTED |
"started" |
The call has started. | voice/lib/enums/CallStatus.ts:8 |
TIMEOUT |
"timeout" |
The call has timed out. | voice/lib/enums/CallStatus.ts:53 |
UNANSWERED |
"unanswered" |
The call went unanswered. | voice/lib/enums/CallStatus.ts:58 |
Enum representing different event types for the Connect NCCO action.
| Enumeration Member | Value | Description | Defined in |
|---|---|---|---|
SYNCHRONOUS |
"synchronous" |
Synchronous event type. | voice/lib/enums/NCCO/ConnectEventType.ts:8 |
Enum representing HTTP methods used for making web requests.
| Enumeration Member | Value | Description | Defined in |
|---|---|---|---|
GET |
"GET" |
The HTTP GET method, used for retrieving data from a server. | voice/lib/enums/HttpMethod.ts:8 |
POST |
"POST" |
The HTTP POST method, used for sending data to a server to create or update resources. | voice/lib/enums/HttpMethod.ts:13 |
Enum representing machine detection behavior for the Connect NCCO action.
| Enumeration Member | Value | Description | Defined in |
|---|---|---|---|
CONTINUE |
"continue" |
Continue with the call if machine detection is triggered. | voice/lib/enums/NCCO/MachineDetection.ts:8 |
HANGUP |
"hangup" |
Hang up the call if machine detection is triggered. | voice/lib/enums/NCCO/MachineDetection.ts:13 |
Enum representing the behavior of machine detection in a call.
| Enumeration Member | Value | Description | Defined in |
|---|---|---|---|
CONTINUE |
"continue" |
Continue the call even if a machine is detected. | voice/lib/enums/MachineDetctionBehavior.ts:8 |
HANGUP |
"hangup" |
Hang up the call if a machine is detected. | voice/lib/enums/MachineDetctionBehavior.ts:13 |
Enum representing the available actions in a Nexmo Call Control Object (NCCO).
| Enumeration Member | Value | Description | Defined in |
|---|---|---|---|
CONNECT |
"connect" |
Connect the call to an endpoint or multiple endpoints. | voice/lib/enums/NCCOActions.ts:8 |
CONVERSATION |
"conversation" |
Start a conversation that can include multiple participants. | voice/lib/enums/NCCOActions.ts:13 |
INPUT |
"input" |
Collect input from the caller, including DTMF tones or speech. | voice/lib/enums/NCCOActions.ts:18 |
NOTIFY |
"notify" |
Send a notification or message to a specified endpoint. | voice/lib/enums/NCCOActions.ts:23 |
RECORD |
"record" |
Record the audio of a call. | voice/lib/enums/NCCOActions.ts:28 |
STREAM |
"stream" |
Stream audio to a call. | voice/lib/enums/NCCOActions.ts:33 |
TALK |
"talk" |
Play a text-to-speech message to the caller. | voice/lib/enums/NCCOActions.ts:38 |
Enum representing different recording formats for the Record NCCO action.
| Enumeration Member | Value | Description | Defined in |
|---|---|---|---|
MP3 |
"mp3" |
MP3 audio format. | voice/lib/enums/NCCO/RecordingFormat.ts:8 |
OGG |
"ogg" |
OGG audio format. | voice/lib/enums/NCCO/RecordingFormat.ts:18 |
WAV |
"wav" |
WAV audio format. | voice/lib/enums/NCCO/RecordingFormat.ts:13 |
Enum representing the supported Text-to-Speech (TTS) languages for Nexmo's voice calls.
| Enumeration Member | Value | Description | Defined in |
|---|---|---|---|
AF_ZA |
"af-ZA" |
Afrikaans (af-ZA) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:8 |
AR |
"ar" |
Arabic (ar) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:13 |
BG_BG |
"bg-BG" |
Bulgarian (bg-BG) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:18 |
BN_IN |
"bn-IN" |
Bengali (bn-IN) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:23 |
CA_ES |
"ca-ES" |
Catalan, Valencian (ca-ES) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:28 |
CMN_CN |
"cmn-CN" |
China Chinese, Mandarin (cmn-CN) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:33 |
CMN_TW |
"cmn-TW" |
Taiwan Chinese, Mandarin (cmn-TW) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:38 |
CS_CZ |
"cs-CZ" |
Czech (cs-CZ) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:43 |
CY_GB |
"cy-GB" |
Welsh (cy-GB) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:48 |
DA_DK |
"da-DK" |
Danish (da-DK) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:53 |
DE_AT |
"de-AT" |
Austria German (de-AT) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:58 |
DE_DE |
"de-DE" |
German (de-DE) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:63 |
DE_ET |
"de-ET" |
Ethiopia German (de-ET) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:68 |
EL_GR |
"el-GR" |
Greek (el-GR) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:73 |
EN_AU |
"en-AU" |
Australia English (en-AU) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:78 |
EN_GB |
"en-GB" |
United Kingdom English (en-GB) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:83 |
EN_GB_SCT |
"en-GB-SCT" |
Scotland English (en-GB-SCT) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:88 |
EN_GB_WLS |
"en-GB-WLS" |
Wales English (en-GB-WLS) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:93 |
EN_IE |
"en-IE" |
Ireland English (en-IE) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:98 |
EN_IN |
"en-IN" |
India English (en-IN) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:103 |
EN_NZ |
"en-NZ" |
New Zealand English (en-NZ) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:108 |
EN_US |
"en-US" |
United States English (en-US) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:113 |
EN_ZA |
"en-ZA" |
South Africa English (en-ZA) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:118 |
ES_CO |
"es-CO" |
Colombia Spanish (es-CO) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:123 |
ES_ES |
"es-ES" |
Spain Spanish (es-ES) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:128 |
ES_MX |
"es-MX" |
Mexico Spanish (es-MX) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:133 |
ES_US |
"es-US" |
United States Spanish (es-US) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:138 |
EU_ES |
"eu-ES" |
Basque (eu-ES) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:143 |
FI_FI |
"fi-FI" |
Finnish (fi-FI) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:148 |
FIL_PH |
"fil-PH" |
Filipino (fil-PH) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:153 |
FR_CA |
"fr-CA" |
Canada French (fr-CA) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:158 |
FR_FR |
"fr-FR" |
France French (fr-FR) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:163 |
GL_ES |
"gl-ES" |
Spain Galician (gl-ES) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:168 |
GU_IN |
"gu-IN" |
Gujarati (gu-IN) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:173 |
HE_IL |
"he-IL" |
Hebrew (he-IL) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:178 |
HI_IN |
"hi-IN" |
Hindi (hi-IN) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:183 |
HU_HU |
"hu-HU" |
Hungarian (hu-HU) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:188 |
ID_ID |
"id-ID" |
Indonesian (id-ID) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:193 |
IS_IS |
"is-IS" |
Icelandic (is-IS) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:198 |
IT_IT |
"it-IT" |
Italian (it-IT) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:203 |
JA_JP |
"ja-JP" |
Japanese (ja-JP) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:208 |
KN_IN |
"kn-IN" |
Kannada (kn-IN) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:213 |
KO_KR |
"ko-KR" |
Korean (ko-KR) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:218 |
LV_LV |
"lv-LV" |
Latvian (lv-LV) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:223 |
ML_IN |
"ml-IN" |
Malayalam (ml-IN) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:228 |
MS_MY |
"ms-MY" |
Malay (ms-MY) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:233 |
NB_NO |
"nb-NO" |
Norwegian (nb-NO) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:238 |
NL_BE |
"nl-BE" |
Belgium Dutch (nl-BE) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:243 |
NL_NL |
"nl-NL" |
Netherlands Dutch (nl-NL) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:248 |
NO_NO |
"no-NO" |
Norwegian (no-NO) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:253 |
PA_IN |
"pa-IN" |
Punjabi (pa-IN) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:258 |
PL_PL |
"pl-PL" |
Polish (pl-PL) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:263 |
PT_BR |
"pt-BR" |
Brazil Portuguese (pt-BR) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:268 |
PT_PT |
"pt-PT" |
Portugal Portuguese (pt-PT) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:273 |
RO_RO |
"ro-RO" |
Romanian (ro-RO) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:278 |
RU_RU |
"ru-RU" |
Russian (ru-RU) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:283 |
SK_SK |
"sk-SK" |
Slovak (sk-SK) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:288 |
SR_RS |
"sr-RS" |
Serbian (sr-RS) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:293 |
SV_SE |
"sv-SE" |
Swedish (sv-SE) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:298 |
TA_IN |
"ta-IN" |
Tamil (ta-IN) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:303 |
TE_IN |
"te-IN" |
Telugu (te-IN) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:308 |
TH_TH |
"th-TH" |
Thai (th-TH) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:313 |
TR_TR |
"tr-TR" |
Turkish (tr-TR) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:318 |
UK_UA |
"uk-UA" |
Ukrainian (uk-UA) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:323 |
VI_VN |
"vi-VN" |
Vietnamese (vi-VN) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:328 |
YUE_CN |
"yue-CN" |
China Chinese, Cantonese (yue-CN) - Supported Text-to-Speech (TTS) language. | voice/lib/enums/TTSLanguages.ts:333 |
Enum representing supported Text-to-Speech (TTS) voices.
| Enumeration Member | Value | Description | Defined in |
|---|---|---|---|
ADITI |
"Aditi" |
Aditi - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:8 |
AGNIESZKA |
"Agnieszka" |
Agnieszka - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:13 |
ALVA |
"Alva" |
Alva - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:18 |
AMY |
"Amy" |
Amy - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:23 |
ASTRID |
"Astrid" |
Astrid - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:28 |
BIANCA |
"Bianca" |
Bianca - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:33 |
BRIAN |
"Brian" |
Brian - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:38 |
CARLA |
"Carla" |
Carla - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:43 |
CARMEN |
"Carmen" |
Carmen - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:48 |
CARMIT |
"Carmit" |
Carmit - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:53 |
CATARINA |
"Catarina" |
Catarina - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:58 |
CELINE |
"Celine" |
Celine - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:63 |
CEM |
"Cem" |
Cem - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:68 |
CHANTAL |
"Chantal" |
Chantal - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:73 |
CHIPMUNK |
"Chipmunk" |
Chipmunk - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:78 |
CONCHITA |
"Conchita" |
Conchita - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:83 |
CRISTIANO |
"Cristiano" |
Cristiano - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:88 |
DAMAYANTI |
"Damayanti" |
Damayanti - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:93 |
DORA |
"Dora" |
Dora - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:98 |
EMMA |
"Emma" |
Emma - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:103 |
EMPAR |
"Empar" |
Empar - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:108 |
ENRIQUE |
"Enrique" |
Enrique - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:113 |
ERIC |
"Eric" |
Eric - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:118 |
EWA |
"Ewa" |
Ewa - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:123 |
FELIPE |
"Felipe" |
Felipe - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:128 |
FILIZ |
"Filiz" |
Filiz - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:133 |
GERAINT |
"Geraint" |
Geraint - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:138 |
GIORGIO |
"Giorgio" |
Giorgio - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:143 |
GWYNETH |
"Gwyneth" |
Gwyneth - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:148 |
HANS |
"Hans" |
Hans - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:153 |
HENRIK |
"Henrik" |
Henrik - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:158 |
INES |
"Ines" |
Ines - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:163 |
IOANA |
"Ioana" |
Ioana - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:168 |
IVETA |
"Iveta" |
Iveta - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:173 |
IVY |
"Ivy" |
Ivy - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:178 |
JACEK |
"Jacek" |
Jacek - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:183 |
JAN |
"Jan" |
Jan - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:188 |
JENNIFER |
"Jennifer" |
Jennifer - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:193 |
JOANA |
"Joana" |
Joana - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:198 |
JOANNA |
"Joanna" |
Joanna - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:203 |
JOEY |
"Joey" |
Joey - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:208 |
JORDI |
"Jordi" |
Jordi - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:213 |
JUSTIN |
"Justin" |
Justin - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:218 |
KANYA |
"Kanya" |
Kanya - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:223 |
KARL |
"Karl" |
Karl - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:228 |
KENDRA |
"Kendra" |
Kendra - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:233 |
KIMBERLY |
"Kimberly" |
Kimberly - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:238 |
LAILA |
"Laila" |
Laila - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:243 |
LAURA |
"Laura" |
Laura - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:248 |
LEA |
"Lea" |
Lea - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:253 |
LEKHA |
"Lekha" |
Lekha - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:258 |
LIV |
"Liv" |
Liv - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:263 |
LOTTE |
"Lotte" |
Lotte - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:268 |
LUCIA |
"Lucia" |
Lucia - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:273 |
LUCIANA |
"Luciana" |
Luciana - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:278 |
MADS |
"Mads" |
Mads - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:283 |
MAGED |
"Maged" |
Maged - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:288 |
MAJA |
"Maja" |
Maja - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:293 |
MARISKA |
"Mariska" |
Mariska - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:298 |
MARLENE |
"Marlene" |
Marlene - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:303 |
MATHIEU |
"Mathieu" |
Mathieu - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:308 |
MATTHEW |
"Matthew" |
Matthew - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:313 |
MAXIM |
"Maxim" |
Maxim - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:318 |
MEI_JIA |
"Mei-Jia" |
Mei-Jia - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:323 |
MELINA |
"Melina" |
Melina - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:328 |
MIA |
"Mia" |
Mia - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:333 |
MIGUEL |
"Miguel" |
Miguel - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:338 |
MIREN |
"Miren" |
Miren - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:343 |
MIZUKI |
"Mizuki" |
Mizuki - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:348 |
MONTSERRAT |
"Montserrat" |
Montserrat - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:353 |
NAJA |
"Naja" |
Naja - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:358 |
NICOLE |
"Nicole" |
Nicole - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:363 |
NIKOS |
"Nikos" |
Nikos - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:368 |
NORA |
"Nora" |
Nora - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:373 |
OSKAR |
"Oskar" |
Oskar - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:378 |
PENELOPE |
"Penelope" |
Penelope - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:383 |
RAVEENA |
"Raveena" |
Raveena - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:388 |
RICARDO |
"Ricardo" |
Ricardo - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:393 |
RUBEN |
"Ruben" |
Ruben - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:398 |
RUSSELL |
"Russell" |
Russell - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:403 |
SALLI |
"Salli" |
Salli - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:408 |
SATU |
"Satu" |
Satu - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:413 |
SEOYEON |
"Seoyeon" |
Seoyeon - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:418 |
SIN_JI |
"Sin-Ji" |
Sin-Ji - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:423 |
SORA |
"Sora" |
Sora - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:428 |
TAKUMI |
"Takumi" |
Takumi - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:433 |
TARIK |
"Tarik" |
Tarik - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:438 |
TATYANA |
"Tatyana" |
Tatyana - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:443 |
TESSA |
"Tessa" |
Tessa - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:448 |
TIAN_TIAN |
"Tian-Tian" |
Tian-Tian - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:453 |
VICKI |
"Vicki" |
Vicki - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:458 |
VITORIA |
"Vitoria" |
Vitoria - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:463 |
YELDA |
"Yelda" |
Yelda - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:468 |
ZEINA |
"Zeina" |
Zeina - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:473 |
ZHIYU |
"Zhiyu" |
Zhiyu - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:478 |
ZUZANA |
"Zuzana" |
Zuzana - Supported Text-to-Speech (TTS) voice. | voice/lib/enums/TTSVoices.ts:483 |
Enum representing different bitrate options for audio in a WebSocket configuration.
| Enumeration Member | Value | Description | Defined in |
|---|---|---|---|
RATE_16000 |
"audio/l16;rate=16000" |
Audio bitrate at 16000 samples per second. | voice/lib/enums/Endpoint/WebsocketBitrate.ts:13 |
RATE_8000 |
"audio/l16;rate=8000" |
Audio bitrate at 8000 samples per second. | voice/lib/enums/Endpoint/WebsocketBitrate.ts:8 |
Represents a Connect action in the Nexmo Call Control Object (NCCO) for making voice calls.
ConnectActionSerializable
new Connect(
endpoint,
from?,
randomFromNumber?,
eventType?,
timeout?,
limit?,
machineDetection?,
eventUrl?,
eventMethod?,
ringbackTone?): ConnectCreate a new Connect instance.
• endpoint: CallEndpoint
An array of CallEndpoint objects representing the endpoints to connect to in the call.
• from?: string
The caller's phone number to display as the caller ID.
• randomFromNumber?: boolean
Set to true to use a random phone number as the caller ID.
• eventType?: ConnectEventType
The event type for call progress events.
• timeout?: number
The timeout value in seconds.
• limit?: number
The maximum number of concurrent calls.
• machineDetection?: MachineDetection
The behavior when voicemail is detected.
• eventUrl?: string
An array of event URLs.
• eventMethod?: string
The HTTP method used for event callbacks.
• ringbackTone?: string
The URL of the ringback tone audio file.
voice/lib/classes/NCCO/Connect.ts:104
action: CONNECT = NCCOActions.CONNECT;The action type, which is always 'connect'.
ConnectAction.action
voice/lib/classes/NCCO/Connect.ts:15
endpoint: CallEndpoint[];An array of CallEndpoint objects representing the endpoints to connect to in the call.
An array of CallEndpoint objects representing the endpoints to connect to in the call.
ConnectAction.endpoint
voice/lib/classes/NCCO/Connect.ts:23
optional eventMethod: string;The HTTP method used to send event information to the event URL(s).
The HTTP method used for event callbacks.
ConnectAction.eventMethod
voice/lib/classes/NCCO/Connect.ts:80
optional eventType: ConnectEventType;The event type for call progress events sent to the specified event URL.
The event type for call progress events.
ConnectAction.eventType
voice/lib/classes/NCCO/Connect.ts:45
optional eventUrl: string[];An array of event URLs where call progress events are sent to. Multiple URLs can be specified.
An array of event URLs.
ConnectAction.eventUrl
voice/lib/classes/NCCO/Connect.ts:73
optional from: string;The caller's phone number to display as the caller ID.
The caller's phone number to display as the caller ID.
ConnectAction.from
voice/lib/classes/NCCO/Connect.ts:30
optional limit: number;The maximum number of concurrent calls that can be handled by your application.
The maximum number of concurrent calls.
ConnectAction.limit
voice/lib/classes/NCCO/Connect.ts:59
optional machineDetection: MachineDetection;Configure the behavior when Vonage detects that the call is answered by voicemail.
The behavior when voicemail is detected.
ConnectAction.machineDetection
voice/lib/classes/NCCO/Connect.ts:66
optional randomFromNumber: boolean;Set to true to use a random phone number as the caller ID from the list of numbers assigned to the current application.
Set to true to use a random phone number as the caller ID.
ConnectAction.randomFromNumber
voice/lib/classes/NCCO/Connect.ts:38
optional ringbackTone: string;The URL of a ringback tone to play to the caller while waiting for the call to be answered.
The URL of the ringback tone audio file.
ConnectAction.ringbackTone
voice/lib/classes/NCCO/Connect.ts:87
optional timeout: number;The time in seconds that Vonage waits for the call to be answered before timing out.
The timeout value in seconds.
ConnectAction.timeout
voice/lib/classes/NCCO/Connect.ts:52
serializeToNCCO(): ConnectActionSerialize the Connect action to a Nexmo Call Control Object (NCCO) format.
ConnectAction
- The serialized Connect action.
Serializable.serializeToNCCO
voice/lib/classes/NCCO/Connect.ts:152
Represents a Conversation action in the Nexmo Call Control Object (NCCO) for managing audio conferences.
ConversationActionSerializable
new Conversation(
name,
musicOnHoldUrl?,
startOnEnter?,
endOnExit?,
record?,
canSpeak?,
canHear?,
mute?): ConversationCreate a new Conversation instance.
• name: string
The name of the conversation.
• musicOnHoldUrl?: string
An array of music on hold URLs.
• startOnEnter?: boolean
Set to true to start the conversation on participant enter.
• endOnExit?: boolean
Set to true to end the conversation on last participant exit.
• record?: boolean
Set to true to record the conversation.
• canSpeak?: string[]
An array of participant IDs who can speak in the conversation.
• canHear?: string[]
An array of participant IDs who can hear in the conversation.
• mute?: boolean
Set to true to mute all participants in the conversation.
voice/lib/classes/NCCO/Conversation.ts:82
action: CONVERSATION = NCCOActions.CONVERSATION;The action type, which is always 'conversation'.
ConversationAction.action
voice/lib/classes/NCCO/Conversation.ts:12
optional canHear: string[];An array of participant IDs (e.g., phone numbers) who can hear in the conversation.
An array of participant IDs who can hear in the conversation.
ConversationAction.canHear
voice/lib/classes/NCCO/Conversation.ts:61
optional canSpeak: string[];An array of participant IDs (e.g., phone numbers) who can speak in the conversation.
An array of participant IDs who can speak in the conversation.
ConversationAction.canSpeak
voice/lib/classes/NCCO/Conversation.ts:54
optional endOnExit: boolean;Set to true to end the conversation when the last participant exits.
Set to true to end the conversation on last participant exit.
ConversationAction.endOnExit
voice/lib/classes/NCCO/Conversation.ts:40
optional musicOnHoldUrl: string[];An array of URLs for music to be played while participants are on hold.
An array of music on hold URLs.
ConversationAction.musicOnHoldUrl
voice/lib/classes/NCCO/Conversation.ts:26
optional mute: boolean;Set to true to mute all participants in the conversation.
Set to true to mute all participants in the conversation.
ConversationAction.mute
voice/lib/classes/NCCO/Conversation.ts:68
name: string;The name of the conversation.
The name of the conversation.
ConversationAction.name
voice/lib/classes/NCCO/Conversation.ts:19
optional record: boolean;Set to true to record the conversation.
Set to true to record the conversation.
ConversationAction.record
voice/lib/classes/NCCO/Conversation.ts:47
optional startOnEnter: boolean;Set to true to start the conversation when a participant enters.
Set to true to start the conversation on participant enter.
ConversationAction.startOnEnter
voice/lib/classes/NCCO/Conversation.ts:33
serializeToNCCO(): ConversationActionSerialize the Conversation action to a Nexmo Call Control Object (NCCO) format.
ConversationAction
- The serialized Conversation action.
Serializable.serializeToNCCO
voice/lib/classes/NCCO/Conversation.ts:122
Represents an Input action in the Nexmo Call Control Object (NCCO) for gathering user input.
InputActionSerializable
new Input(
dtmf?,
speech?,
eventUrl?,
eventMethod?): InputCreate a new Input instance.
• dtmf?: DTMFSettings
DTMF input settings.
• speech?: SpeechSettings
Speech input settings.
• eventUrl?: string
URL to send events to asynchronously.
• eventMethod?: string
The HTTP method used to send events.
voice/lib/classes/NCCO/Input.ts:49
action: INPUT = NCCOActions.INPUT;The action type, which is always 'input'.
InputAction.action
voice/lib/classes/NCCO/Input.ts:14
optional dtmf: DTMFSettings;DTMF input settings.
InputAction.dtmf
voice/lib/classes/NCCO/Input.ts:24
optional eventMethod: string;The HTTP method used to send events (e.g., 'POST' or 'GET').
InputAction.eventMethod
voice/lib/classes/NCCO/Input.ts:39
optional eventUrl: string[] = [];An array of URLs to send events to asynchronously.
InputAction.eventUrl
voice/lib/classes/NCCO/Input.ts:34
optional speech: SpeechSettings;Speech input settings.
InputAction.speech
voice/lib/classes/NCCO/Input.ts:29
type: string[] = [];An array of input types ('dtmf' and/or 'speech').
InputAction.type
voice/lib/classes/NCCO/Input.ts:19
serializeToNCCO(): InputActionSerialize the Input action to a Nexmo Call Control Object (NCCO) format.
InputAction
- The serialized Input action.
Serializable.serializeToNCCO
voice/lib/classes/NCCO/Input.ts:85
A builder class for creating Nexmo Call Control Objects (NCCOs).
new NCCOBuilder(): NCCOBuilderprotected actions: NCCOAction[] = [];voice/lib/classes/NCCO/NCCOBuilder.ts:8
addAction(action): NCCOBuilderAdd an action to the NCCO builder.
• action: NCCOAction
The action to add to the NCCO.
- The NCCO builder instance (for method chaining).
voice/lib/classes/NCCO/NCCOBuilder.ts:16
build(): NCCOAction[]Build the NCCO by serializing the added actions.
- The built NCCO, which is an array of actions.
voice/lib/classes/NCCO/NCCOBuilder.ts:31
Represents a Notify action in an NCCO.
NotifyActionSerializable
new Notify(
payload,
eventUrl,
eventMethod?): NotifyCreates a new Notify action.
• payload
The payload data to send with the notification.
• eventUrl: string
The URL where the notification events will be sent.
• eventMethod?: string
The HTTP method for sending notification events (e.g., "POST").
voice/lib/classes/NCCO/Notify.ts:23
action: NOTIFY = NCCOActions.NOTIFY;The action type, which should be set to 'notify'.
NotifyAction.action
voice/lib/classes/NCCO/Notify.ts:9
optional eventMethod: string;(Optional) The HTTP method used for sending the notification to the event URLs. If not specified, the default HTTP method is used.
NotifyAction.eventMethod
voice/lib/classes/NCCO/Notify.ts:14
eventUrl: string[];An array of event URLs to which the notification will be sent.
NotifyAction.eventUrl
voice/lib/classes/NCCO/Notify.ts:13
payload: object;The payload to be sent as part of the notification. It is a key-value pair object where the keys and values are both strings.
[key: string]: string
NotifyAction.payload
voice/lib/classes/NCCO/Notify.ts:10
serializeToNCCO(): NotifyActionSerialize the Notify action to an NCCO-compatible format.
NotifyAction
- The serialized Notify action.
Serializable.serializeToNCCO
voice/lib/classes/NCCO/Notify.ts:41
Represents an outbound call with an answer URL.
This class is deprecated. Please update to use the CallWithAnswerURL type
OutboundCall
new OutboundCallWithAnswerURL(
answerUrl,
to,
from?): OutboundCallWithAnswerURLCreates a new outbound call with an answer URL.
• answerUrl: string
The answer URL for the call.
• to: CallEndpoint
The call endpoint to which the outbound call will be made.
• from?: PhoneEndpoint
The phone endpoint object representing the caller's information.
OutboundCall.constructor
voice/lib/classes/OutboundCallWithAnswerURL.ts:38
answer_url: string[];The list of answer URLs.
voice/lib/classes/OutboundCallWithAnswerURL.ts:22
answerUrl: string[];The list of answer URLs.
Use answer_url instead.
voice/lib/classes/OutboundCallWithAnswerURL.ts:29
optional eventMethod: HttpMethod;The HTTP method to use for event notifications (optional).
OutboundCall.eventMethod
voice/lib/classes/OutboundCall.ts:39
optional eventUrl: string[];The list of event URLs (optional).
OutboundCall.eventUrl
voice/lib/classes/OutboundCall.ts:34
optional from: PhoneEndpoint;The phone endpoint object representing the caller's information.
OutboundCall.from
voice/lib/classes/OutboundCall.ts:24
optional lengthTimer: number;The length timer for the call (optional).
OutboundCall.lengthTimer
voice/lib/classes/OutboundCall.ts:49
optional machineDetection: MachineDetectionBehavior;The machine detection behavior (optional).
OutboundCall.machineDetection
voice/lib/classes/OutboundCall.ts:44
optional randomFromNumber: boolean;Indicates whether to use a random from number (optional).
OutboundCall.randomFromNumber
voice/lib/classes/OutboundCall.ts:29
optional ringingTimer: number;The ringing timer for the call (optional).
OutboundCall.ringingTimer
voice/lib/classes/OutboundCall.ts:54
to: CallEndpoint[];The list of call endpoints to which the outbound call will be made.
OutboundCall.to
voice/lib/classes/OutboundCall.ts:19
Represents an outbound call with NCCO (Nexmo Call Control Object).
This class is deprecated. Please update to use the CallWithNCCO type
OutboundCall
new OutboundCallWithNCCO(
ncco,
to,
from?): OutboundCallWithNCCOCreates a new outbound call with NCCO.
• ncco: NCCOAction[]
The NCCO actions for the call.
• to: CallEndpoint
The call endpoint to which the outbound call will be made.
• from?: PhoneEndpoint
The phone endpoint object representing the caller's information.
OutboundCall.constructor
voice/lib/classes/OutboundCallWithNCCO.ts:30
optional eventMethod: HttpMethod;The HTTP method to use for event notifications (optional).
OutboundCall.eventMethod
voice/lib/classes/OutboundCall.ts:39
optional eventUrl: string[];The list of event URLs (optional).
OutboundCall.eventUrl
voice/lib/classes/OutboundCall.ts:34
optional from: PhoneEndpoint;The phone endpoint object representing the caller's information.
OutboundCall.from
voice/lib/classes/OutboundCall.ts:24
optional lengthTimer: number;The length timer for the call (optional).
OutboundCall.lengthTimer
voice/lib/classes/OutboundCall.ts:49
optional machineDetection: MachineDetectionBehavior;The machine detection behavior (optional).
OutboundCall.machineDetection
voice/lib/classes/OutboundCall.ts:44
ncco: NCCOAction[];The list of NCCO actions.
voice/lib/classes/OutboundCallWithNCCO.ts:21
optional randomFromNumber: boolean;Indicates whether to use a random from number (optional).
OutboundCall.randomFromNumber
voice/lib/classes/OutboundCall.ts:29
optional ringingTimer: number;The ringing timer for the call (optional).
OutboundCall.ringingTimer
voice/lib/classes/OutboundCall.ts:54
to: CallEndpoint[];The list of call endpoints to which the outbound call will be made.
OutboundCall.to
voice/lib/classes/OutboundCall.ts:19
Represents a Record action in an NCCO.
RecordAction
new Record(
format?,
split?,
channels?,
endOnSilence?,
endOnKey?,
timeout?,
beepStart?,
eventUrl?,
eventMethod?): RecordCreates a new Record action.
• format?: RecordingFormat
The recording format (e.g., "mp3", "wav").
• split?: string
The split type for recording (should be "conversation").
• channels?: number
The number of audio channels (1 to 32).
• endOnSilence?: number
The duration of silence (in seconds) to end the recording (3 to 10 seconds).
• endOnKey?: string
The DTMF key that ends the recording (e.g., "0", "*", "#").
• timeout?: number
The maximum recording duration in seconds (3 to 7200 seconds).
• beepStart?: boolean
Whether to play a beep before recording starts.
• eventUrl?: string
The URL where recording events will be sent.
• eventMethod?: string
The HTTP method for sending recording events (e.g., "POST").
voice/lib/classes/NCCO/Record.ts:72
action: RECORD = NCCOActions.RECORD;The action type for the Record action.
RecordAction.action
voice/lib/classes/NCCO/Record.ts:12
optional beepStart: boolean;Whether to play a beep before recording starts.
RecordAction.beepStart
voice/lib/classes/NCCO/Record.ts:47
optional eventMethod: string;The HTTP method for sending recording events (e.g., "POST").
RecordAction.eventMethod
voice/lib/classes/NCCO/Record.ts:57
optional eventUrl: string[];The URL where recording events will be sent.
RecordAction.eventUrl
voice/lib/classes/NCCO/Record.ts:52
optional format: RecordingFormat;The recording format (e.g., "mp3", "wav").
RecordAction.format
voice/lib/classes/NCCO/Record.ts:17
protected optional wrappedChannels: number;The number of audio channels (1 to 32).
voice/lib/classes/NCCO/Record.ts:27
protected optional wrappedEndOnKey: string;The DTMF key that ends the recording (e.g., "0", "*", "#").
voice/lib/classes/NCCO/Record.ts:37
protected optional wrappedEndOnSilence: number;The duration of silence (in seconds) to end the recording (3 to 10 seconds).
voice/lib/classes/NCCO/Record.ts:32
protected optional wrappedSplit: string;The split type for recording (always "conversation").
voice/lib/classes/NCCO/Record.ts:22
protected optional wrappedTimeOut: number;The maximum recording duration in seconds (3 to 7200 seconds).
voice/lib/classes/NCCO/Record.ts:42
get channels(): undefined | numberGetter for the number of audio channels.
set channels(channels): voidSetter for the number of audio channels.
- If the channel value is invalid or split is not set to "conversation."
• channels: number
The number of audio channels (1 to 32).
undefined | number
- The current number of audio channels.
RecordAction.channels
voice/lib/classes/NCCO/Record.ts:117
get endOnKey(): undefined | stringGetter for the character that signals the end of recording.
set endOnKey(character): voidSetter for the DTMF key that ends the recording.
- If the character is not a valid DTMF key.
• character: string
The DTMF key that ends the recording (e.g., "0", "*", "#").
undefined | string
- The character that signals the end of recording.
RecordAction.endOnKey
voice/lib/classes/NCCO/Record.ts:146
get endOnSilence(): undefined | numberGetter for the duration of silence (in seconds) that signals the end of recording.
set endOnSilence(numSeconds): voidSetter for the duration of silence to end the recording.
- If the duration value is out of the valid range.
• numSeconds: number
The duration of silence in seconds (3 to 10 seconds).
undefined | number
- The duration of silence (in seconds) that signals the end of recording.
RecordAction.endOnSilence
voice/lib/classes/NCCO/Record.ts:170
get split(): "conversation"Getter for the recording split type.
set split(splitType): voidSetter for the recording split type.
- Throws an error if the splitType is not 'conversation'.
• splitType: string
The recording split type. Must be set to 'conversation'.
"conversation"
- The recording split type, which is always 'conversation'.
RecordAction.split
voice/lib/classes/NCCO/Record.ts:195
get timeout(): undefined | numberGetter for the recording timeout duration in seconds.
set timeout(seconds): voidSetter for the recording timeout.
- If the timeout value is out of the valid range.
• seconds: number
The maximum recording duration in seconds (3 to 7200 seconds).
undefined | number
- The recording timeout duration in seconds.
voice/lib/classes/NCCO/Record.ts:218
serializeToNCCO(): RecordActionSerializes the Record action to NCCO format.
RecordAction
- The serialized Record action.
voice/lib/classes/NCCO/Record.ts:243
Represents a Stream action in a Nexmo Call Control Object (NCCO).
This action allows streaming audio into the call.
StreamActionSerializable
new Stream(
streamUrl,
level?,
bargeIn?,
loop?): StreamCreates a new Stream action.
• streamUrl: string
The URL of the audio stream.
• level?: number
The audio level at which to play the stream (optional).
• bargeIn?: boolean
Indicates whether the stream should allow barge-in (optional).
• loop?: number
The number of times to loop the audio (optional).
voice/lib/classes/NCCO/Stream.ts:44
action: STREAM = NCCOActions.STREAM;The action type for this NCCO action.
StreamAction.action
voice/lib/classes/NCCO/Stream.ts:14
optional bargeIn: boolean;Indicates whether the stream should allow barge-in (optional).
StreamAction.bargeIn
voice/lib/classes/NCCO/Stream.ts:29
optional level: number;The audio level at which to play the stream (optional).
StreamAction.level
voice/lib/classes/NCCO/Stream.ts:24
optional loop: number;The number of times to loop the audio (optional).
StreamAction.loop
voice/lib/classes/NCCO/Stream.ts:34
streamUrl: string[];An array of stream URLs to play audio from.
StreamAction.streamUrl
voice/lib/classes/NCCO/Stream.ts:19
serializeToNCCO(): StreamActionSerializes the Stream action to a Nexmo Call Control Object (NCCO).
StreamAction
- The serialized Stream action.
Serializable.serializeToNCCO
voice/lib/classes/NCCO/Stream.ts:68
Represents a Talk action in a Nexmo Call Control Object (NCCO).
This action allows the text-to-speech (TTS) synthesis of spoken words in the call.
TalkActionSerializable
new Talk(
text,
bargeIn?,
loop?,
level?,
language?,
style?,
premium?): TalkCreates a new Talk action.
• text: string
The text to be spoken during the call.
• bargeIn?: boolean
Indicates whether the talk action allows barge-in (optional).
• loop?: number
The number of times to loop the speech (optional).
• level?: string
The audio level at which to play the speech (optional).
• language?: string
The language for the text-to-speech synthesis (optional).
• style?: string
The speech style (optional).
• premium?: boolean
Indicates whether to use premium text-to-speech (optional).
voice/lib/classes/NCCO/Talk.ts:62
action: TALK = NCCOActions.TALK;The action type for this NCCO action.
TalkAction.action
voice/lib/classes/NCCO/Talk.ts:14
optional bargeIn: boolean;Indicates whether the talk action allows barge-in (optional).
TalkAction.bargeIn
voice/lib/classes/NCCO/Talk.ts:24
optional language: string;The language for the text-to-speech synthesis (optional).
TalkAction.language
voice/lib/classes/NCCO/Talk.ts:39
optional level: string;The audio level at which to play the speech (optional).
TalkAction.level
voice/lib/classes/NCCO/Talk.ts:34
optional loop: number;The number of times to loop the speech (optional).
TalkAction.loop
voice/lib/classes/NCCO/Talk.ts:29
optional premium: boolean;Indicates whether to use premium text-to-speech (optional).
TalkAction.premium
voice/lib/classes/NCCO/Talk.ts:49
optional style: string;The speech style (optional).
TalkAction.style
voice/lib/classes/NCCO/Talk.ts:44
text: string;The text to be spoken during the call.
TalkAction.text
voice/lib/classes/NCCO/Talk.ts:19
serializeToNCCO(): TalkActionSerializes the Talk action to a Nexmo Call Control Object (NCCO).
TalkAction
- The serialized Talk action.
Serializable.serializeToNCCO
voice/lib/classes/NCCO/Talk.ts:98
A Clint to make calls to the Vonage Voice API.
Vonage API's will return information using snake_case. This represents the
pure response before the client will transform the keys into camelCase.
Create a standalone Voice client
import { Voice } from '@vonage/voice';
const voiceClient = new Voice({
apiKey: VONAGE_API_KEY,
apiSecret: VONAGE_API_SECRET
});Create an Voice client from the Vonage client
import { Vonage } from '@vonage/server-client';
const vonage = new Vonage({
apiKey: VONAGE_API_KEY,
apiSecret: VONAGE_API_SECRET
});
const voiceClient = vonage.voice;new Voice(credentials, options?): VoiceCreates a new instance of the Client.
• credentials: AuthInterface | AuthParams
The authentication credentials or an authentication instance.
• options?: ConfigParams
Optional configuration settings for the client.
server-client/dist/lib/client.d.ts:35
protected auth: AuthInterface;The authentication instance responsible for generating authentication headers and query parameters.
server-client/dist/lib/client.d.ts:24
protected authType: AuthenticationType = AuthenticationType.JWT;The type of authentication used for the client's requests.
protected config: ConfigParams;Configuration settings for the client, including default hosts for various services and other request settings.
server-client/dist/lib/client.d.ts:28
static transformers: object;Static property containing utility transformers.
camelCaseObjectKeys: PartialTransformFunction;kebabCaseObjectKeys: PartialTransformFunction;omit: (keys, obj) => TransformedObject;• keys: string[]
• obj: ObjectToTransform
snakeCaseObjectKeys: PartialTransformFunction;server-client/dist/lib/client.d.ts:11
addAuthenticationToRequest(request): Promise<VetchOptions>Adds the appropriate authentication headers or parameters to the request based on the authentication type.
• request: VetchOptions
The request options to which authentication needs to be added.
Promise<VetchOptions>
- The request options with the added authentication.
Client.addAuthenticationToRequest
server-client/dist/lib/client.d.ts:43
protected addBasicAuthToRequest(request): Promise<VetchOptions>Adds basic authentication headers to the request.
• request: VetchOptions
The request options to which authentication needs to be added.
Promise<VetchOptions>
- The request options with the added authentication.
server-client/dist/lib/client.d.ts:71
protected addJWTToRequest(request): Promise<VetchOptions>Adds a JWT to the request.
• request: VetchOptions
The request options to which authentication needs to be added.
Promise<VetchOptions>
- The request options with the added authentication.
server-client/dist/lib/client.d.ts:64
protected addQueryKeySecretToRequest(request): Promise<VetchOptions>Adds API key and secret to the request.
• request: VetchOptions
The request options to which authentication needs to be added.
Promise<VetchOptions>
- The request options with the added authentication.
Client.addQueryKeySecretToRequest
server-client/dist/lib/client.d.ts:57
protected addQueryKeySecretToRequestBody(request): Promise<VetchOptions>Adds API key and secret to the request body.
• request: VetchOptions
The request options to which authentication needs to be added.
Promise<VetchOptions>
- The request options with the added authentication.
Client.addQueryKeySecretToRequestBody
server-client/dist/lib/client.d.ts:50
protected callAction(
uuid,
action,
destination?): Promise<void>Send a call action to a specific call identified by its UUID.
• uuid: string
The UUID of the call to which the action should be applied.
• action: string
The action to perform on the call (e.g., 'hangup', 'mute', 'unmute').
• destination?: NCCODestination
The destination details for transfer actions.
Promise<void>
A promise that resolves when the call action has been successfully executed.
await voiceClient.callAction(CALL_UUID, 'mute');createOutboundCall(call): Promise<CallResult>Initiates an outbound call with the specified configuration.
• call: OutboundCall
The configuration for the outbound call.
Promise<CallResult>
A promise that resolves to the result of the outbound call initiation.
Create a call with answer NCCO
const call = await voiceClient.createOutboundCall({
to: [{
type: 'phone',
number: TO_NUMBER
}],
asnwer_url: ['https://example.com/answer'],
});
console.log(call.uuid);Create a call with answer URL
const call = await voiceClient.createOutboundCall({
to: [{
type: 'phone',
number: TO_NUMBER
}],
ncco: [{
action: 'talk',
text: 'This is a text to speech call from Vonage'
}]
});
console.log(call.uuid);downloadRecording(file, path): Promise<void>Download the recording of a call to the specified file path.
• file: string
The name of the recording file to download.
• path: string
The local file path where the recording will be saved.
Promise<void>
A promise that resolves when the recording has been successfully downloaded.
await voiceClient.downloadRecording(RECORDING_UUID, './recording.mp3');downloadTranscription(file, path): Promise<void>Download the transcription of a call to the specified file path.
• file: string
The name of the transcription file to download.
• path: string
The local file path where the transcription will be saved.
Promise<void>
A promise that resolves when the transcription has been successfully downloaded.
await voiceClient.downloadTranscription(TRANSCRIPTION_UUID, './transcription.txt');earmuffCall(uuid): Promise<void>Places a call on earmuff, muting the audio for all participants except the user.
• uuid: string
The UUID of the call to earmuff.
Promise<void>
A promise that resolves when the call has been successfully earmuffed.
await voiceClient.earmuffCall(CALL_UUID);getAllCalls(params): AsyncGenerator<CallDetail, void & CommonCallFields & BasicCallDetail & object, undefined>Retrieves details of all calls using pagination.
• params: GetCallDetailsParameters = {}
Optional parameters for filtering and pagination.
AsyncGenerator<CallDetail & object, undefined>
An async generator that yields call details or void when there are no more results.
for await (const call of voiceClient.getAllCalls()) {
console.log(call.startTime);
}getCall(uuid): Promise<CallDetail>Retrieves detailed information about a specific call using its UUID.
• uuid: string
The UUID of the call to retrieve details for.
Promise<CallDetail>
A promise that resolves to detailed information about the call.
const call = await voiceClient.getCall('CALL_UUID');
console.log(call.startTime);getCallsPage(params): Promise<CallPageResponse>Retrieves a page of call details based on the specified parameters.
• params: GetCallDetailsParameters
Optional parameters for filtering and pagination.
Promise<CallPageResponse>
A promise that resolves to a page of call details.
const page = await voiceClient.getCallsPage();
for (const call of page._embedded.calls) {
console.log(call.startTime);
}Get the next page of call details
const page = await voiceClient.getCallsPage({
pageSize: 4,
recordIndex: 10,
});
for (const call of page._embedded.calls) {
console.log(call.startTime);
}Get all started calls
import { CallStatus } from '@vonage/voice';
const page = await voiceClient.getCallsPage({
pageSize: 4,
recordIndex: 10,
status: CallStatus.STARTED,
});
for (const call of page._embedded.calls) {
console.log(call.startTime);
}getConfig(): ConfigParamsserver-client/dist/lib/client.d.ts:36
hangupCall(uuid): Promise<void>Hang up an active call.
• uuid: string
The UUID of the call to hang up.
Promise<void>
A promise that resolves when the call has been successfully hung up.
await voiceClient.hangupCall(CALL_UUID);muteCall(uuid): Promise<void>Mute an active call.
• uuid: string
The UUID of the call to mute.
Promise<void>
A promise that resolves when the call has been successfully muted.
await voiceClient.muteCall(CALL_UUID);protected parseResponse<T>(request, response): Promise<VetchResponse<T>>Parses the response based on its content type.
• T
The expected type of the parsed response data.
• request: VetchOptions
The request options.
• response: Response
The raw response from the request.
Promise<VetchResponse<T>>
- The parsed response.
server-client/dist/lib/client.d.ts:168
playDTMF(uuid, digits): Promise<CallUpdateResult>Plays DTMF (Dual-Tone Multi-Frequency) tones on an active call.
• uuid: string
The UUID of the call on which to play DTMF tones.
• digits: string
The DTMF tones to play.
Promise<CallUpdateResult>
A promise that resolves to the result of playing DTMF tones on the call.
const result = await voiceClient.playDTMF('CALL_UUID', '1234');
console.log(result.status);playTTS(uuid, action): Promise<CallUpdateResult>Plays text-to-speech (TTS) audio on an active call.
• uuid: string
The UUID of the call on which to play TTS audio.
• action: TalkAction
The TTS action configuration.
Promise<CallUpdateResult>
A promise that resolves to the result of playing TTS audio on the call.
const result = await voiceClient.playTTS(
CALL_UUID,
{
text: 'This is a text to speech call from Vonage',
},
);
console.log(result.status);protected prepareBody(request): undefined | stringPrepares the body for the request based on the content type.
• request: VetchOptions
The request options.
undefined | string
- The prepared request body as a string or undefined.
server-client/dist/lib/client.d.ts:158
protected prepareRequest(request): Promise<VetchOptions>Prepares the request with necessary headers, authentication, and query parameters.
• request: VetchOptions
The initial request options.
Promise<VetchOptions>
- The modified request options.
server-client/dist/lib/client.d.ts:151
search(filter?): Promise<CallPageResponse>Searches for call details based on the provided filter.
• filter?: GetCallDetailsParameters
Optional filter criteria to narrow down the search.
Promise<CallPageResponse>
A promise that resolves to a page of call details matching the filter.
const page = await voiceClient.search({
pageSize: 4,
});
for (const call of page._embedded.calls) {
console.log(call.startTime);
console.log(call.status);
console.log(call.direction);
console.log(call.duration);
};sendDeleteRequest<T>(url): Promise<VetchResponse<T>>Sends a DELETE request to the specified URL.
• T
• url: string
The URL endpoint for the DELETE request.
Promise<VetchResponse<T>>
- The response from the DELETE request.
server-client/dist/lib/client.d.ts:78
sendFormSubmitRequest<T>(url, payload?): Promise<VetchResponse<T>>Sends a POST request with form data to the specified URL.
• T
• url: string
The URL endpoint for the POST request.
• payload?: Record<string, string>
Optional payload containing form data to send with the POST request.
Promise<VetchResponse<T>>
- The response from the POST request.
server-client/dist/lib/client.d.ts:86
sendGetRequest<T>(url, queryParams?): Promise<VetchResponse<T>>Sends a GET request to the specified URL with optional query parameters.
• T
• url: string
The URL endpoint for the GET request.
• queryParams?
Optional query parameters to append to the URL. These should be compatible with Node's URLSearchParams.
Promise<VetchResponse<T>>
- The response from the GET request.
server-client/dist/lib/client.d.ts:94
sendPatchRequest<T>(url, payload?): Promise<VetchResponse<T>>Sends a PATCH request to the specified URL with an optional payload.
• T
• url: string
The URL endpoint for the PATCH request.
• payload?
Optional payload to be sent as the body of the PATCH request.
Promise<VetchResponse<T>>
- The response from the PATCH request.
server-client/dist/lib/client.d.ts:104
sendPostRequest<T>(url, payload?): Promise<VetchResponse<T>>Sends a POST request to the specified URL with an optional payload.
• T
• url: string
The URL endpoint for the POST request.
• payload?
Optional payload to be sent as the body of the POST request.
Promise<VetchResponse<T>>
- The response from the POST request.
server-client/dist/lib/client.d.ts:114
sendPutRequest<T>(url, payload?): Promise<VetchResponse<T>>Sends a PUT request to the specified URL with an optional payload.
• T
• url: string
The URL endpoint for the PUT request.
• payload?
Optional payload to be sent as the body of the PUT request.
Promise<VetchResponse<T>>
- The response from the PUT request.
server-client/dist/lib/client.d.ts:124
sendRequest<T>(request): Promise<VetchResponse<T>>Sends a request adding necessary headers, handling authentication, and parsing the response.
• T
• request: VetchOptions
The options defining the request, including URL, method, headers, and data.
Promise<VetchResponse<T>>
- The parsed response from the request.
server-client/dist/lib/client.d.ts:144
sendRequestWithData<T>(
method,
url,
payload?): Promise<VetchResponse<T>>Sends a request with JSON-encoded data to the specified URL using the provided HTTP method.
• T
• method: POST | PUT | PATCH
The HTTP method to be used for the request (only POST, PATCH, or PUT are acceptable).
• url: string
The URL endpoint for the request.
• payload?
Optional payload to be sent as the body of the request, JSON-encoded.
Promise<VetchResponse<T>>
- The response from the request.
server-client/dist/lib/client.d.ts:135
stopStreamAudio(uuid): Promise<CallUpdateResult>Stop streaming audio to an active call.
• uuid: string
The UUID of the call from which to stop streaming audio.
Promise<CallUpdateResult>
A promise that resolves to the result of stopping audio streaming to the call.
const result = await voiceClient.stopStreamAudio(CALL_UUID);
console.log(result.message);stopTTS(uuid): Promise<CallUpdateResult>Stops any ongoing text-to-speech (TTS) audio playback on an active call.
• uuid: string
The UUID of the call on which to stop TTS audio playback.
Promise<CallUpdateResult>
A promise that resolves to the result of stopping TTS audio playback on the call.
const result = await voiceClient.stopTTS(CALL_UUID);
console.log(result.status);streamAudio(
uuid,
url,
loop?,
volumeLevel?): Promise<UpdateCallResponse>Stream audio to an active call, allowing you to play audio files or live audio streams.
• uuid: string
The UUID of the call to which to stream audio.
• url: string
The URL of the audio stream to play.
• loop?: number = 1
The number of times to loop the audio stream (default is 1).
• volumeLevel?: number = 0.0
The volume level of the audio stream (0.0 to 1.0, default is 0.0).
Promise<UpdateCallResponse>
A promise that resolves to the result of streaming audio to the call.
const result = await voiceClient.streamAudio(CALL_UUID, 'https://example.com/audio.mp3');
console.log(result.message);transferCallWithNCCO(uuid, ncco): Promise<void>Transfer an active call to a new destination using a Nexmo Call Control Object (NCCO).
• uuid: string
The UUID of the call to transfer.
• ncco: NCCOAction[]
The NCCO actions defining the transfer destination.
Promise<void>
A promise that resolves when the call has been successfully transferred.
await voiceClient.transferCallWithNCCO(
CALL_UUID,
[{
action: 'talk',
text: 'You will now be transferred to a new destination''
}],
)transferCallWithURL(uuid, url): Promise<void>Transfer an active call to a new destination using a URL.
• uuid: string
The UUID of the call to transfer.
• url: string
The URL of the transfer destination.
Promise<void>
A promise that resolves when the call has been successfully transferred.
await voiceClient.transferCallWithURL(
CALL_UUID,
'https://example.com/transfer',
);unearmuffCall(uuid): Promise<void>Remove an earmuff from a call, allowing all participants to hear each other again.
• uuid: string
The UUID of the call to unearmuff.
Promise<void>
A promise that resolves when the call has been successfully unearmuffed.
await voiceClient.unearmuffCall(CALL_UUID);unmuteCall(uuid): Promise<void>Unmute a muted call, allowing audio to be transmitted again.
• uuid: string
The UUID of the call to unmute.
Promise<void>
A promise that resolves when the call has been successfully unmuted.
await voiceClient.unmuteCall(CALL_UUID);Represents a Nexmo Call Control Object (NCCO) transfer action.
action: string;The action type, which is 'transfer'.
voice/lib/interfaces/NCCO/Transfer.ts:10
destination: object;The destination of the transfer, including the type and NCCO actions.
ncco: NCCOAction[];The NCCO actions to be executed at the destination.
type: string;The type of destination, which is 'ncco'.
voice/lib/interfaces/NCCO/Transfer.ts:15
Represents a Nexmo Call Control Object (NCCO) URL transfer action.
action: string;The action type, which is 'transfer'.
voice/lib/interfaces/NCCO/Transfer.ts:35
destination: object;The destination of the transfer, including the type and URL.
type: string;The type of destination, which is 'url'.
url: string[];The URL to which the call will be transferred.
voice/lib/interfaces/NCCO/Transfer.ts:40
type Action: NCCOAction;Represents a Nexmo Call Control Object (NCCO) action that defines the behavior of a call.
This type is an alias for the NCCOAction type.
voice/lib/types/NCCO/Action.ts:7
type AdvancedMachineDetection: object;Represents advanced settings for machine detection during a call, including behavior, mode, and optional beep timeout.
optional beepTimeout: number;(Optional) The timeout duration (in seconds) for detecting a beep during machine detection.
behavior: MachineDetectionBehavior;The behavior to follow when machine detection occurs.
mode: AdvancedMachineDetectionMode;The mode of advanced machine detection.
voice/lib/types/AdvancedMachineDetection.ts:10
type BasicCallDetail: object;Represents basic details of a call, including its UUID, conversation UUID, duration, and status.
conversationUUID: string;The UUID of the conversation associated with the call.
duration: string;The duration of the call in a string format.
status: CallStatus;The status of the call, indicating its current state.
uuid: string;The UUID of the call.
voice/lib/types/BasicCallDetail.ts:6
type CallDetail: CommonCallFields & BasicCallDetail & object;Represents detailed information about a call, including common call fields, call direction, rate, price, start time, end time, and network information.
direction: CallDirection;The direction of the call, indicating whether it is inbound or outbound.
endTime: string;The end time of the call in a string format.
network: string;The network information related to the call.
price: string;The price of the call in a string format.
rate: string;The rate associated with the call in a string format.
startTime: string;The start time of the call in a string format.
voice/lib/types/CallDetail.ts:9
type CallDetailResponse: object & Omit<CallDetail,
| "conversationUUID"
| "startTime"
| "endTime"
| "to"
| "from"> & APILinks;Represents the response for retrieving call details.
conversation_uuid: string;The UUID of the conversation associated with the call.
end_time: string;The end time of the call.
start_time: string;The start time of the call.
to: CallEndpointResponse;Information about the recipient (callee) of the call.
Vonage API's will return information using snake_case. This represents the
pure response before the client will transform the keys into camelCase.
voice/lib/types/Responses/CallDetailResponse.ts:12
type CallEndpoint: WebsocketEndpoint | PhoneEndpoint | SIPEndpoint | VBCEndpoint;Represents a call endpoint, which can be of different types such as Phone, SIP, VBC, or Websocket. This type can be used to specify the destination for an outbound call.
voice/lib/types/Endpoint/CallEndpoint.ts:10
type CallEndpointObject: CallEndpoint;This interface is deprecated. Please update to use the CallEndpoint type
voice/lib/interfaces/Endpoint/CallEndpointObject.ts:11
type CallEndpointResponse: PhoneEndpoint | WebsocketEndpoint | SIPEndpoint | VBCEndpoint;Represents the response for a call endpoint, which can be one of the following:
- Phone endpoint
- Websocket endpoint
- SIP endpoint
- VBC (Vonage Business Cloud) endpoint
Vonage API's will return information using snake_case. This represents the
pure response before the client will transform the keys into camelCase.
voice/lib/types/Responses/CallEndpointResponse.ts:19
type CallListFilter: object & GetCallDetailsParameters;optional conversation_uuid: string;optional date_end: string;optional date_start: string;optional page_size: string;optional record_index: string;Pelease use GetCallDetailsParameters instead
voice/lib/types/Parameters/CallListFilter.ts:6
type CallPageResponse: object & APILinks;Represents the response for a page of call details, including information about the page itself and an array of call details.
_embedded: object;An embedded object containing an array of call details.
_embedded.calls: CallDetailResponse[];An array of call details.
count: number;The total count of call details in the response.
page_size: number;The number of call details per page.
record_index: number;The index of the first call detail in the current page.
Vonage API's will return information using snake_case. This represents the
pure response before the client will transform the keys into camelCase.
voice/lib/types/Responses/CallPageResponse.ts:12
type CallResult: object;Represents the result of a call, including the UUID, status, direction (inbound or outbound), and conversation UUID.
conversationUUID: string;The UUID associated with the conversation related to the call.
direction: "inbound" | "outbound";The direction of the call, specifying whether it is inbound or outbound.
status: CallStatus;The status of the call, indicating its current state or outcome.
uuid: string;The universally unique identifier (UUID) associated with the call.
voice/lib/types/CallResult.ts:6
type CallUpdateResult: object;Represents the result of updating a call, including the UUID and a message describing the update.
message: string;A message describing the update or the result of the call update operation.
uuid: string;The universally unique identifier (UUID) associated with the call.
voice/lib/types/CallUpdateResult.ts:4
type CallWithAnswerURL: CommonOutboundCall & object;Represents an outbound call with an answer URL, including common call properties and the answer URL information.
optional answerMethod: HttpMethod;The HTTP method used to send events to the answer URL(s), typically "GET" or "POST."
answerUrl: string[];The URL(s) to which call events should be sent when the call is answered.
voice/lib/types/CallWithAnswerURL.ts:7
type CallWithNCCO: CommonOutboundCall & object;Represents an outbound call with associated Nexmo Call Control Objects (NCCO) actions.
ncco: NCCOAction[];An array of NCCO actions to be executed during the call.
voice/lib/types/CallWithNCCO.ts:7
type CommonCallFields: object;Represents common fields for defining an outbound call, including the caller (from) and recipient (to) endpoints.
from: Omit<PSTNEndpoint, "dtmfAnswer">;The caller's endpoint information, excluding DTMF answer details.
to: CallEndpoint;The recipient's endpoint information for the call.
voice/lib/types/CommonCallFields.ts:6
type CommonOutboundCall: Omit<CommonCallFields, "to"> & object;Represents common fields for defining an outbound call, including the caller (from) and recipient (to) endpoints, along with additional call parameters.
optional advancedMachineDetection: AdvancedMachineDetection;Advanced machine detection settings for the call.
optional eventMethod: HttpMethod;The HTTP method to use when sending events to the specified event URLs.
optional eventUrl: string[];An array of URLs to notify with call events.
optional lengthTimer: number;The length of time to wait for call answer, in seconds.
optional machineDetection: MachineDetectionBehavior;Specifies the behavior for machine detection during the call.
optional ringingTimer: number;The length of time to wait for the call to ring before considering it unanswered, in seconds.
to: CallEndpoint[];An array of recipient endpoints for the call.
voice/lib/types/CommonOutboundCall.ts:10
type ConnectAction: ConnectActionType;This interface is deprecated. Please update to use the ConnectActionType type
voice/lib/interfaces/NCCO/ConnectAction.ts:12
type ConversationAction: ConnectionActionType;This interface is deprecated. Please update to use the ConnectionActionType type
voice/lib/interfaces/NCCO/ConversationAction.ts:12
type CreateCallParameters: OutboundCall;voice/lib/types/Parameters/CreateCallParameters.ts:3
type CreateCallRequest: object & Omit<OutboundCall,
| "randomFromNumber"
| "eventUrl"
| "machineDetection"
| "advancedMachineDetection"
| "lengthTimer"
| "ringingTimer">;Represents the request payload for creating a call, including various call settings.
advanced_machine_detection: object & Omit<AdvancedMachineDetection, "beepTimeout">;Advanced machine detection settings, including beep timeout.
optional beep_timeout: number;The beep timeout setting for advanced machine detection.
optional event_url: string[];An array of URLs for event callbacks during the call's lifecycle.
optional length_timer: number;The length timer setting for the call.
optional machine_detection: MachineDetection;The type of machine detection to use for the call.
optional random_from_number: boolean;Specifies whether to use a random caller number for the call.
optional ringing_timer: number;The ringing timer setting for the call.
Vonage API's will return information using snake_case. This represents the
pure response before the client will transform the keys into camelCase.
voice/lib/types/Requests/CreateCallRequest.ts:12
type CreateCallResponse: object;Represents the response for creating a call, including the call's UUID, status, direction, and conversation UUID.
conversation_uuid: string;The UUID of the conversation associated with the call.
direction: string;The direction of the call (e.g., "outbound" or "inbound").
status: string;The status of the created call.
uuid: string;The UUID of the created call.
Vonage API's will return information using snake_case. This represents the
pure response before the client will transform the keys into camelCase.
voice/lib/types/Responses/CreateCallResponse.ts:8
type CreateOutboundCallResponse: object & Omit<BasicCallDetail, "conversationUUID">;Represents the response for creating an outbound call, including the conversation UUID and basic call details.
conversation_uuid: string;The UUID of the conversation associated with the outbound call.
Vonage API's will return information using snake_case. This represents the
pure response before the client will transform the keys into camelCase.
voice/lib/types/Responses/CreateOutboundCallResponse.ts:10
type DTMFSettings: DTMFSettingsType;This interface is deprecated. Please update to use the DTMFSettingsType type
voice/lib/interfaces/NCCO/DTMFSettings.ts:12
type EarmuffCallParameters: object;Represents parameters for an "earmuff" action in a call.
action: "earmuff";The action to earmuff the call.
voice/lib/types/Parameters/EarmuffCallParameters.ts:4
type GetCallDetailsParameters: object;Represents parameters for retrieving call details.
optional conversationUuid: string;Optional: The conversation UUID for filtering calls.
optional dateEnd: string;Optional: The end date for filtering calls.
optional dateStart: string;Optional: The start date for filtering calls.
optional order: "asc" | "desc";Optional: The order in which calls are retrieved (ascending or descending).
optional pageSize: number;Optional: The page size for pagination.
optional recordIndex: number;Optional: The record index for pagination.
optional status: CallStatus;Optional: The status of the calls to retrieve.
voice/lib/types/Parameters/GetCallsDetailsParameters.ts:6
type GetCallDetailsRequest: object & Omit<GetCallDetailsParameters,
| "dateEnd"
| "dateStart"
| "pageSize"
| "recordIndex"
| "conversationUuid">;Represents the request payload for retrieving call details with various filtering options.
optional conversation_uuid: string;The UUID of the conversation to filter call records by.
optional date_end: string;The end date for filtering call records.
optional date_start: string;The start date for filtering call records.
optional page_size: number;The maximum number of records to return per page.
optional record_index: number;The record index for pagination.
Vonage API's will return information using snake_case. This represents the
pure response before the client will transform the keys into camelCase.
voice/lib/types/Requests/GetCallsDetailsRequest.ts:10
type HangupCallParameters: object;Represents parameters for hanging up a call.
action: "hangup";The action indicating that the call should be hung up.
voice/lib/types/Parameters/HangupCallParameters.ts:4
type InputAction: InputActionType;This interface is deprecated. Please update to use the InputActionType type
voice/lib/interfaces/NCCO/InputAction.ts:11
type IOutboundCallWithAnswerURL: CallWithAnswerURL;This interface is deprecated. Please update to use the CallWithAnswerURL type
voice/lib/interfaces/OutboundCallWithAnswerURL.ts:12
type IOutboundCallWithNCCO: CallWithNCCO;This interface is deprecated. Please update to use the CallWithNCCO type
voice/lib/interfaces/OutboundCallWithNCCO.ts:11
type ModifyCallRequestParameters:
| EarmuffCallParameters
| HangupCallParameters
| MuteCallParameters
| TransferCallParameters
| UnearmuffCallParameters
| UnmuteCallParameters;Represents the parameters for modifying a call, including actions like earmuff, hangup, mute, transfer, unearmuff, and unmute.
Vonage API's will return information using snake_case. This represents the
pure response before the client will transform the keys into camelCase.
voice/lib/types/Requests/ModifyCallRequest.ts:18
type MuteCallParameters: object;Represents parameters for muting a call.
action: "mute";The action indicating that the call should be muted.
voice/lib/types/Parameters/MuteCallParameters.ts:4
type NCCOAction:
| ConnectAction
| ConversationAction
| InputAction
| NotifyAction
| RecordAction
| StreamAction
| TalkAction;Represents a Nexmo Call Control Object (NCCO) action, which can be one of the following types:
- ConnectAction
- ConversationAction
- InputAction
- NotifyAction
- RecordAction
- StreamAction
- TalkAction
An NCCO action defines a specific action or behavior in a call flow, and these actions can be combined to create complex call scenarios when constructing NCCOs.
voice/lib/types/NCCO/NCCOActions.ts:22
type NotifyAction: NotifyActionType;This interface is deprecated. Please update to use the NotifyActionType type
voice/lib/interfaces/NCCO/NotifyAction.ts:12
type OutboundCall: CallWithNCCO | CallWithAnswerURL;Represents an outbound call, which can either include an answer URL (for simple call scenarios)
or an NCCO (Nexmo Call Control Object) for more complex call scenarios. Depending on the use case,
it can be either a CallWithAnswerURL or a CallWithNCCO.
voice/lib/types/OutboundCall.ts:9
type PhoneEndpoint: object;Represents a phone endpoint, which can be used as a call destination.
number: string;The phone number associated with the endpoint.
type: "phone";Specifies the type of endpoint, which is 'phone' for phone numbers.
voice/lib/types/Endpoint/PhoneEndpoint.ts:4
type PhoneEndpointObject: PhoneEndpoint;This interface is deprecated. Please update to use the PhoneEndpoint type
voice/lib/interfaces/Endpoint/PhoneEndpointObject.ts:11
type PlayDTMFRequest: PlayDTMFParameters;Represents the parameters for playing DTMF (Dual-Tone Multi-Frequency) tones during a call.
Vonage API's will return information using snake_case. This represents the
pure response before the client will transform the keys into camelCase.
voice/lib/types/Requests/PlayDTMFRequest.ts:10
type PlayTTSParameters: object;Represents parameters for playing Text-to-Speech (TTS) in a call.
optional language: TTSLanguages | string;The language in which the text should be spoken. Optional.
optional level: string;The audio level for the TTS playback. Optional.
optional loop: number;The number of times to loop the TTS playback. Optional.
optional premium: boolean;Indicates if premium TTS features should be used. Optional.
optional style: number;The style or voice variant for the TTS. Optional.
text: string;The text to be converted to speech and played in the call.
optional voiceName: TTSVoices;The name of the specific TTS voice to use. Optional.
voice/lib/types/Parameters/PlayTTSParameters.ts:6
type PlayTTSRequest: object & Omit<PlayTTSParameters, "voiceName">;Represents the parameters for playing text-to-speech (TTS) during a call.
optional voice_name: TTSVoices;The name of the TTS voice to use for speech synthesis.
Vonage API's will return information using snake_case. This represents the
pure response before the client will transform the keys into camelCase.
voice/lib/types/Requests/PlayTTSRequest.ts:11
type PSTNEndpoint: object;Represents a PSTN (Public Switched Telephone Network) endpoint, which can be used as a call destination.
optional dtmfAnswer: string;An optional DTMF (Dual-Tone Multi-Frequency) answer string. When provided, it enables automated call answering by sending DTMF tones.
number: string;The phone number associated with the endpoint.
type: "phone";Specifies the type of endpoint, which is 'phone' for phone numbers.
voice/lib/types/Endpoint/PSTNEndpoint.ts:4
type RecordAction: RecordActionType;This interface is deprecated. Please update to use the RecordActionType type
voice/lib/interfaces/NCCO/RecordAction.ts:12
type SIPEndpoint: object;Represents a SIP (Session Initiation Protocol) endpoint, which can be used as a call destination.
optional headers: Record<string, unknown>;An optional array of headers as key-value pairs. These headers can be included in the SIP request.
optional standardHeaders: object;Standard SIP INVITE headers. Unlike the headers property, these are not prepended with X-.
standardHeaders.userToUser: string;Transmit user-to-user information if supported by the CC / PBX vendor, as per RFC 7433.
https://tools.ietf.org/html/rfc7433
type: "sip";Specifies the type of endpoint, which is 'sip' for SIP URIs.
uri: string;The SIP URI associated with the endpoint.
voice/lib/types/Endpoint/SIPEndpoint.ts:4
type SIPEndpointObject: SIPEndpoint;This interface is deprecated. Please update to use the SIPEndpoint type
voice/lib/interfaces/Endpoint/SIPEndpointObject.ts:11
type SpeechSettings: SpeechSettingsType;This interface is deprecated. Please update to use the SpeechSettingsType type
voice/lib/interfaces/NCCO/SpeechSettings.ts:12
type StreamAction: StreamActionType;This interface is deprecated. Please update to use the StreamActionType type
voice/lib/interfaces/NCCO/StreamAction.ts:12
type StreamAudioRequest: object & Omit<StreamAudioParameters, "streamUrl">;Represents the parameters for streaming audio during a call.
stream_url: string[];An array of stream URLs for the audio source.
Vonage API's will return information using snake_case. This represents the
pure response before the client will transform the keys into camelCase.
voice/lib/types/Requests/StreamAudioRequest.ts:10
type TalkAction: TalkActionType;This interface is deprecated. Please update to use the TalkActionType type
voice/lib/interfaces/NCCO/TalkAction.ts:11
type TransferCallParameters: object;Represents parameters for transferring a call to another destination.
action: "transfer";The action type indicating a call transfer.
destination: object & XOR<TransferWithURL, TransferWithNCCO>;The destination of the transfer, which can be specified using NCCO or a URL.
type: "ncco";The type of destination, either 'ncco' for NCCO-based transfer or 'url' for URL-based transfer.
voice/lib/types/Parameters/TransferCallParameters.ts:21
type UnearmuffCallParameters: object;Represents parameters for unearmuffing a call, allowing the call audio to be heard again.
action: "unearmuff";The action type indicating unearmuffing of a call.
voice/lib/types/Parameters/UnearmuffCallParameters.ts:4
type UnmuteCallParameters: object;Represents parameters for unmuting a call, allowing audio to be transmitted and received again.
action: "unmute";The action type indicating unmuting of a call.
voice/lib/types/Parameters/UnmuteCallParameters.ts:4
type UpdateCallResponse: object;Represents the response for updating a call, including a message and the UUID of the call.
message: string;A message associated with the call update response.
uuid: string;The UUID of the call that was updated.
Vonage API's will return information using snake_case. This represents the
pure response before the client will transform the keys into camelCase.
voice/lib/types/Responses/UpdateCallResponse.ts:8
type VBCEndpoint: object;Represents a Vonage Business Cloud (VBC) endpoint, which can be used as a call destination.
optional extension: string;An optional extension associated with the VBC endpoint. If provided, the call will be directed to this extension.
type: "vbc";Specifies the type of endpoint, which is 'vbc' for Vonage Business Cloud.
voice/lib/types/Endpoint/VBCEndpoint.ts:4
type VBCEndpointObject: VBCEndpoint;This interface is deprecated. Please update to use the VBCEndpoint type
voice/lib/interfaces/Endpoint/VBCEndpointObject.ts:11
type WebsocketEndpoint: object;Represents a WebSocket endpoint, which can be used as a call destination.
optional contentType: string;An optional content type to specify the format of the data sent to the WebSocket endpoint.
optional headers: Record<string, unknown>;Optional headers to include when connecting to the WebSocket endpoint.
type: "websocket";Specifies the type of endpoint, which is 'websocket' for WebSocket.
uri: string;The URI (Uniform Resource Identifier) of the WebSocket endpoint.
voice/lib/types/Endpoint/WebsocketEndpoint.ts:4
type WebsocketEndpointObject: WebsocketEndpoint;This interface is deprecated. Please update to use the WebsocketEndpoint type