Skip to content

Files

Latest commit

1f8041f · Sep 3, 2024

History

History
33 lines (25 loc) · 3.42 KB
·

TransferDisconnectCallback.md

File metadata and controls

33 lines (25 loc) · 3.42 KB
·

TransferDisconnectCallback

This event is sent to the transferDisconnectUrl of each tag when its respective call leg ends for any reason. The event is sent in the normal case, when the transferred leg is answered and later hung up, but is also sent if the new leg was never answered in the first place, if it was rejected, and if the original call leg hung up before the transferred leg.

Properties

Name Type Description Notes
eventType String The event type, value can be one of the following: answer, bridgeComplete, bridgeTargetComplete, conferenceCreated, conferenceRedirect, conferenceMemberJoin, conferenceMemberExit, conferenceCompleted, conferenceRecordingAvailable, disconnect, dtmf, gather, initiate, machineDetectionComplete, recordingComplete, recordingAvailable, redirect, transcriptionAvailable, transferAnswer, transferComplete, transferDisconnect. [optional]
eventTime OffsetDateTime The approximate UTC date and time when the event was generated by the Bandwidth server, in ISO 8601 format. This may not be exactly the time of event execution. [optional]
accountId String The user account associated with the call. [optional]
applicationId String The id of the application associated with the call. [optional]
from String The provided identifier of the caller. Must be a phone number in E.164 format (e.g. +15555555555). [optional]
to String The phone number that received the call, in E.164 format (e.g. +15555555555). [optional]
direction CallDirectionEnum [optional]
callId String The call id associated with the event. [optional]
callUrl URI The URL of the call associated with the event. [optional]
parentCallId String (optional) If the event is related to the B leg of a <Transfer>, the call id of the original call leg that executed the <Transfer>. Otherwise, this field will not be present. [optional]
enqueuedTime OffsetDateTime (optional) If call queueing is enabled and this is an outbound call, time the call was queued, in ISO 8601 format. [optional]
startTime OffsetDateTime Time the call was started, in ISO 8601 format. [optional]
answerTime OffsetDateTime Time the call was answered, in ISO 8601 format. [optional]
endTime OffsetDateTime The time that the recording ended in ISO-8601 format [optional]
tag String (optional) The tag specified on call creation. If no tag was specified or it was previously cleared, this field will not be present. [optional]
transferCallerId String The phone number used as the from field of the B-leg call, in E.164 format (e.g. +15555555555). [optional]
transferTo String The phone number used as the to field of the B-leg call, in E.164 format (e.g. +15555555555). [optional]
cause String Reason the call failed - hangup, busy, timeout, cancel, rejected, callback-error, invalid-bxml, application-error, account-limit, node-capacity-exceeded, error, or unknown. [optional]
errorMessage String Text explaining the reason that caused the call to fail in case of errors. [optional]
errorId String Bandwidth's internal id that references the error event. [optional]