CallEvents

Constants

Triggers after remote peer answered the call or set the call into the Call.startEarlyMedia state. Note that event is not triggered in P2P mode.

Parameters

call:
Call
Call that triggered the event
headers:
undefined
Optional
Optional SIP headers received with the message (the ones starting with "X-")
name:
string
The name of the event

Triggers when blind transfers are enabled by Call.handleBlindTransfer.

Parameters

call:
Call
Call that triggered the event
headers:
undefined
Optional
Optional SIP headers received with the message (the ones starting with "X-")
name:
string
The name of the event
transferTo:
string
Username

Triggers after an incoming/outgoing call is connected. For incoming call, it happens after the Call.answer is called. For outgoing call, it happens when a remote peer answers the call.

Parameters

call:
Call
Call that triggered the event
customData:
undefined
Optional
Optional: Custom data that is passed from client with call accept command
headers:
{[header: string]: string}
Optional SIP headers received with the message (the ones starting with "X-")
name:
string
The name of the event

Triggers when a call is terminated. Most frequent status codes (returned when a call is terminated before being answered):

Code	Description
408	Call is not answered within 60 seconds
603	Call is rejected
486	Destination number is busy
487	Request terminated

Note that this event does not mean the end of the JavaScript session. The session without calls and/or ACD requests are automatically terminated after some time (see the session limits for details). It's a good idea to explicitly terminate the session with VoxEngine.terminate after it is no longer needed.

Parameters

call:
Call
Call that triggered the event
code:
number
Status code of the call (i.e., 486)
cost:
number
Call cost in account currency
duration:
number
Total call duration in seconds
headers:
undefined
Optional
Optional SIP headers received with the message (the ones starting with "X-")
name:
string
The name of the event
reason:
string
Status message of call failure

Triggers when an outgoing call is terminated before connection. Most frequent status codes:

Code	Description
486	Destination number is busy
487	Request terminated
404	Invalid number
480	Destination number is unavailable
402	Insufficient funds
603	Call is rejected
408	Call is not answered within 60 seconds

Parameters

call:
Call
Call that triggered the event
code:
number
Status code of the call (i.e., 486)
headers:
undefined
Optional
Optional SIP headers received with the message (the ones starting with "X-")
name:
string
The name of the event
reason:
string
Status message of call failure

Triggers when the first video packet is received.

Parameters

call:
Call
Call that triggered the event
name:
string
The name of the event
url:
string
Record URL

Triggers when an INFO message is received.

Parameters

body:
string
Content of the message
call:
Call
Call that triggered the event
headers:
undefined
Optional
Optional SIP headers received with the message (the ones starting with "X-")
mimeType:
string
MIME type of INFO message
name:
string
The name of the event

Triggers when a text message is received.

Parameters

call:
Call
Call that triggered the event
headers:
undefined
Optional
Optional SIP headers received with the message (the ones starting with "X-")
name:
string
The name of the event
text:
string
Content of the message

Triggers each time when microphone status changes. There is the method for enabling status analyzing - Call.handleMicStatus.

Parameters

active:
boolean
Activity flag
call:
Call
Call that triggered the event
name:
string
The name of the event

Triggers when a call is taken off hold.

Parameters

call:
Call
Call that triggered the event
name:
string
The name of the event

Triggers when a call is put on hold.

Parameters

call:
Call
Call that triggered the event
name:
string
The name of the event

Triggers when the audio/voice playback is completed. Note that the Call.stopPlayback method finishes any media, so the PlaybackFinished event is not triggered. The playback may be started by the Call.say or Call.startPlayback methods.

Parameters

call:
Call
Call that triggered the event
error:
undefined
Optional
Optional: Error that occurred during the playback
name:
string
The name of the event

Triggers by the Call.startPlayback and Call.say methods when: 1) the audio file download to the Voximpant cache is finished;
2) the audio file is found in the cache (i.e., it is in the cache before).

Parameters

call:
Call
Call that triggered the event
name:
string
The name of the event

Triggers by the Call.startPlayback and Call.say methods when audio/voice playback is started.

Parameters

call:
Call
Call that triggered the event
duration:
number
Playback duration
name:
string
The name of the event

Triggers when a push notification is sent.

Parameters

call:
Call
Call that triggered the event
name:
string
The name of the event
result:
string

Triggers when the Voximplant cloud receives the ReInviteAccepted message. This message means that a call received video from the other participant.

Parameters

body:
string
Content of the message
call:
Call
Call that triggered the event
headers:
undefined
Optional
Optional SIP headers received with the message (the ones starting with "X-")
mimeType:
string
MIME type of INFO message
name:
string
The name of the event

Triggers when the Voximplant cloud receives the ReInviteReceived message. This message means that a caller:
1) started sending video;
2) started/stopped screensharing;
3) put a call on hold / took a call off hold.

Parameters

body:
string
Content of the message
call:
Call
Call that triggered the event
headers:
undefined
Optional
Optional SIP headers received with the message (the ones starting with "X-")
mimeType:
string
MIME type of INFO message
name:
string
The name of the event

Triggers when the Voximplant cloud receives the ReInviteRejected message. This message means that a call does not receive video from the other participant.

Parameters

call:
Call
Call that triggered the event
headers:
undefined
Optional
Optional SIP headers received with the message (the ones starting with "X-")
name:
string
The name of the event

Triggers in case of problems during the recording process.

Parameters

call:
Call
Call that triggered the event
error:
string
Is triggered in case of problems during the recording process
name:
string
The name of the event

Triggers when call recording is started as a result of the Call.record method call.

Parameters

call:
Call
Call that triggered the event
name:
string
The name of the event
url:
string
HTTP URL of a record file.

Triggers when call recording is stopped. This happens after the CallEvents.Disconnected event is triggered.

Parameters

call:
Call
Call that triggered the event
cost:
string
Record cost (in the account's currency: USD, EUR or RUR)
duration:
number
Record duration (sec)
name:
string
The name of the event
url:
string
HTTP URL of record file.

Triggers after outgoing call receives progress signal from a remote peer.

Parameters

call:
Call
Call that triggered the event
headers:
undefined
Optional
Optional SIP headers received with the message (the ones starting with "X-")
name:
string
The name of the event

Triggers when a call status is changed.

Parameters

call:
Call
Call that triggered the event
name:
string
The name of the event
newState:
string
oldState:
string

Triggers when call statistic changed.

Parameters

call:
Call
Call that triggered the event
name:
string
The name of the event

Triggers when a call progress tone is detected (either dial tone or busy tone). There is the deprecated method for enabling the tone detection - 'Call.detectProgressTone'. Note that:
1) Triggers only if the CallEvents.Connected event is triggered;
2) the event is only triggered once in a call session.

Parameters

ProgressTone:
boolean
If set to true, the detected tone is a progress tone.
VoicemailTone:
boolean
If set to true, the detected tone is a voicemail tone.
call:
Call
Call that triggered the event
name:
string
The name of the event

Triggers when a DTMF signal is received. Note that by default DTMF signals do not trigger this event, this behavior needs to be set explicitly by using the Call.handleTones method.

Parameters

call:
Call
Call that triggered the event
name:
string
The name of the event
tone:
string
Tone received in this event: 0-9,*,# are possible values

Triggers when a call transfer is complete.

Parameters

call:
Call
Call that triggered the event
headers:
undefined
Optional
Optional SIP headers received with the message (the ones starting with "X-")
name:
string
The name of the event
role:
transferor
Optional
All the transfer roles.

Triggers when a call transfer is failed.

Parameters

call:
Call
Call that triggered the event
code:
number
Status code of the call (i.e., 486)
headers:
undefined
Optional
Optional SIP headers received with the message (the ones starting with "X-")
name:
string
The name of the event
reason:
string
Status message of call failure
role:
transferor
Optional
All the transfer roles.

Triggers after the video track is created. This could happen only if the Call.record method with {video: true} parameters is called.

Parameters

call:
Call
Call that triggered the event
name:
string
The name of the event
url:
string
Record URL

Constants

AudioStarted

Parameters

call:

headers:

name:

BlindTransferRequested

Parameters

call:

headers:

name:

transferTo:

Connected

Parameters

call:

customData:

headers:

name:

Disconnected

Parameters

call:

code:

cost:

duration:

headers:

name:

reason:

Failed

Parameters

call:

code:

headers:

name:

reason:

FirstVideoPacket

Parameters

call:

name:

url:

InfoReceived

Parameters

body:

call:

headers:

mimeType:

name:

MessageReceived

Parameters

call:

headers:

name:

text:

MicStatusChange

Parameters

active:

call:

name:

OffHold

Parameters

call:

name:

OnHold

Parameters

call:

name:

PlaybackFinished

Parameters

call:

error:

name:

PlaybackReady

Parameters

call:

name:

PlaybackStarted

Parameters

call:

duration:

name:

PushSent