CallEvents
Constants
AudioStarted
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 that triggered the event
headers:
{[header: string]: string}
OptionalOptional SIP headers received with the message (the ones starting with "X-")
id:
string
The call's ID
name:
string
The name of the event
BlindTransferRequested
Triggers when blind transfers are enabled by Call.handleBlindTransfer.
Parameters
call:
Call that triggered the event
headers:
{[header: string]: string}
OptionalOptional SIP headers received with the message (the ones starting with "X-")
id:
string
The call's ID
name:
string
The name of the event
transferTo:
string
Username
Connected
Triggers after an inbound/outbound call is connected. For inbound call, it happens after the Call.answer is called. For outbound call, it happens when a remote peer answers the call.
Parameters
call:
Call that triggered the event
customData:
string
OptionalOptional: Custom data that was passed from client with call accept command
headers:
{[header: string]: string}
Optional SIP headers received with the message (the ones starting with "X-")
id:
string
The call's ID
name:
string
The name of the event
Disconnected
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 that triggered the event
cost:
number
Call cost in account currency
direction:
string
Call direction type according to billing
duration:
number
Total call duration in seconds
headers:
{[header: string]: string}
OptionalOptional SIP headers received with the message (the ones starting with "X-")
id:
string
The call's ID
internalCode:
number
Status code of the call (i.e., 486)
name:
string
The name of the event
reason:
string
Reason of the call failure
Failed
Triggers when an outbound 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 was rejected |
408 | Call was not answered within 60 seconds |
Parameters
call:
Call that triggered the event
code:
number
Status code of the call (i.e., 486)
headers:
{[header: string]: string}
OptionalOptional SIP headers received with the message (the ones starting with "X-")
id:
string
The call's ID
name:
string
The name of the event
reason:
string
Status message of call failure
FirstVideoPacket
Triggers when the first video packet is received.
Parameters
call:
Call that triggered the event
id:
string
The call's ID
name:
string
The name of the event
url:
string
Record URL
InfoReceived
Triggers when an INFO message is received.
Parameters
body:
string
Content of the message
call:
Call that triggered the event
headers:
{[header: string]: string}
OptionalOptional SIP headers received with the message (the ones starting with "X-")
id:
string
The call's ID
mimeType:
string
MIME type of INFO message
name:
string
The name of the event
MessageReceived
Triggers when a text message is received.
Parameters
call:
Call that triggered the event
headers:
{[header: string]: string}
OptionalOptional SIP headers received with the message (the ones starting with "X-")
id:
string
The call's ID
name:
string
The name of the event
text:
string
Content of the message
MicStatusChange
Triggers each time when microphone status changes. There is the method for enabling status analyzing - Call.handleMicStatus.
Parameters
active:
boolean
Activity flag
call:
Call that triggered the event
id:
string
The call's ID
name:
string
The name of the event
OffHold
Triggers when a call is taken off hold.
Parameters
call:
Call that triggered the event
id:
string
The call's ID
name:
string
The name of the event
OnHold
Triggers when a call is put on hold.
Parameters
call:
Call that triggered the event
id:
string
The call's ID
name:
string
The name of the event
PlaybackFinished
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 that triggered the event
error:
string
OptionalOptional: Error that occurred during the playback
id:
string
The call's ID
name:
string
The name of the event
PlaybackReady
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 that triggered the event
id:
string
The call's ID
name:
string
The name of the event
PlaybackStarted
Triggers by the Call.startPlayback and Call.say methods when audio/voice playback is started.
Parameters
call:
Call that triggered the event
duration:
number
Playback duration
id:
string
The call's ID
name:
string
The name of the event
PushSent
Triggers when a push notification is sent.
Parameters
call:
Call that triggered the event
id:
string
The call's ID
name:
string
The name of the event
result:
string
ReInviteAccepted
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 that triggered the event
headers:
{[header: string]: string}
OptionalOptional SIP headers received with the message (the ones starting with "X-")
id:
string
The call's ID
mimeType:
string
MIME type of INFO message
name:
string
The name of the event
ReInviteReceived
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 that triggered the event
headers:
{[header: string]: string}
OptionalOptional SIP headers received with the message (the ones starting with "X-")
id:
string
The call's ID
mimeType:
string
MIME type of INFO message
name:
string
The name of the event
ReInviteRejected
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 that triggered the event
headers:
{[header: string]: string}
OptionalOptional SIP headers received with the message (the ones starting with "X-")
id:
string
The call's ID
name:
string
The name of the event
RecordError
Triggers in case of problems during the recording process.
Parameters
call:
Call that triggered the event
error:
string
Is triggered in case of problems during the recording process
id:
string
The call's ID
name:
string
The name of the event
RecordStarted
Triggers when call recording is started as a result of the Call.record method call.
Parameters
call:
Call that triggered the event
id:
string
The call's ID
name:
string
The name of the event
url:
string
HTTP URL of a record file.
RecordStopped
Triggers when call recording is stopped. This happens after the CallEvents.Disconnected event is triggered.
Parameters
call:
Call that triggered the event
cost:
string
Record cost (in the account's currency: USD, EUR or RUR)
duration:
number
Record duration (sec)
id:
string
The call's ID
name:
string
The name of the event
url:
string
HTTP URL of record file.
Ringing
Triggers after outbound call receives progress signal from a remote peer.
Parameters
call:
Call that triggered the event
headers:
{[header: string]: string}
OptionalOptional SIP headers received with the message (the ones starting with "X-")
id:
string
The call's ID
name:
string
The name of the event
StateChanged
Triggers when a call status is changed.
Parameters
call:
Call that triggered the event
id:
string
The call's ID
name:
string
The name of the event
newState:
string
oldState:
string
Statistics
Triggers when call statistic changed.
Parameters
call:
Call that triggered the event
id:
string
The call's ID
name:
string
The name of the event
ToneDetected
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 that triggered the event
id:
string
The call's ID
name:
string
The name of the event
ToneReceived
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 that triggered the event
id:
string
The call's ID
name:
string
The name of the event
tone:
string
Tone received in this event: 0-9,*,# are possible values
TransferComplete
Triggers when a call transfer is complete.
Parameters
call:
Call that triggered the event
headers:
{[header: string]: string}
OptionalOptional SIP headers received with the message (the ones starting with "X-")
id:
string
The call's ID
name:
string
The name of the event
role:
transferor
OptionalAll the transfer roles.
TransferFailed
Triggers when a call transfer is failed.
Parameters
call:
Call that triggered the event
code:
number
Status code of the call (i.e., 486)
headers:
{[header: string]: string}
OptionalOptional SIP headers received with the message (the ones starting with "X-")
id:
string
The call's ID
name:
string
The name of the event
reason:
string
Status message of call failure
role:
transferor
OptionalAll the transfer roles.
VideoTrackCreated
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 that triggered the event
id:
string
The call's ID
name:
string
The name of the event
url:
string
Record URL