conferenceRecordingStatus

The statusCallbackUrl request includes Recording information for a Conference that ended. This is a notification only; any PerCL returned will be ignored.

The conferenceStatus webhook is always invoked whenever a Conference changes status. If a Conference was being recorded, that recording will end when a Conference is emptied or terminated. That will trigger the conferenceRecordingStatus webhook when the recording has been processed and is available for use.

Request Parameter

Type

Description

requestType

string

Context or reason why this request is being made. Will be conferenceRecordingStatus - The statusCallbackUrl request includes Recording information for a Conference that ended.

callId

string

Unique ID for this Call, generated by FreeClimb.

accountId

string

Account ID associated with your account.

from

string

Phone number of the party that initiated the Call (in E.164 format).

to

string

Phone number provisioned to you and to which this call is directed (in E.164 format).

callStatus

string

Descriptive status for the call. Valid values are:
ringing - all is currently ringing.
inProgress - Call was answered and is currently in progress (not queued, not in conference).
completed - Call ended normally.
busy - Caller received a busy signal.
failed - Call could not be completed as dialed, most likely because the phone number was non-existent.
noAnswer - Call ended without being answered.
canceled - Call was canceled via the REST API while queued or ringing.

direction

string

String describing the direction of the call – inbound for inbound calls, outbound for calls initiated via the REST API, or outboundDial for calls initiated by the OutDial command.

conferenceId

string

ID of the Conference.

queueId

string

This is only populated if the request pertains to a Queue. Otherwise, it is set to null.

status

string

New status of the conference. May be empty, populated, inProgress, or terminated.

recordingUrl

string

URL of the Conference’s recorded audio. Populated only if a Recording exists and the Conference was emptied.

recordingId

string

Unique ID of the Recording from this Conference. Populated only if a recording exists and the Conference was emptied.

recordingDurationSec

integer

Duration of the recorded audio (in seconds), rounded up to the nearest second. Populated only if a Recording exists and the Conference was emptied.