PlcmDialOutParticipantV2

PlcmDialOutParticipantV2

An object used to initiate an H.323, SIP, or ISDN dial-out. Once processed, there will be a corresponding plcm-participant object.


PlcmDialOutParticipantV2 Fields

NameTypeDescriptionAttributes
namestring The display name of the participant. This value will be reflected on the MCU.
dtmfSuffixDtmfSuffix DTMF to be outpulsed to receiving endpoint upon successful connection.
audioOnlyboolean True if dial out is to be audio-only.
resourcePriorityNamespaceResourcePriorityNamespace Namespace parameter for the SIP Resource Priority header (namespace.value) for SIP dial outs for this participant. This is an optional value.
resourcePriorityValueResourcePriorityValue Value parameter for the SIP Resource Priority header (namespace.value) for SIP dial outs for this participant. This is an optional value.
passbackPassback User-defined value that is opaque to the system. This value will be reflected in the associated plcm-participant passback field, and allows a client to correlate the dial-out to the subsequent paritcipant.
passthruPassthru User defined value that is opaque to the system. Note: this value can be retreived from the running call in the passthru field or after the call is terminated in the userDataC field of the call CDR.
forwardDtmfSourceForwardDtmfSource The presence of this attribute indicates that DTMF should be forwarded from a chairperson to this participant. This attribute is set to the SIP URI of the chairperson if the URI is available, otherwise it is set to the literal string "chairperson". This attribute can be set only when a new dial-out participant is created using the REST-API request createParticipant, changing it during a call has no effect.
encryptedMediaboolean Indicates whether the media stream between the conference and this participant is encrypted.
autoDisconnectboolean True if this participant is a non-live far end device (like an RMX or recording device), and can be disconnected if the only participants left in a conference are of these types.
callBitRateCallBitRateType The participant call rate in kbps. The rate for h.323 and SIP can be according the the call-bit-rate-type, for ISDN it can be one of the following: automatic, 64, 128, 192, 256, 384, 512, 768, 1152, 1472, 1536, 1920. In case a different line rate is specified the DMA will round it down to one of the above values before sending it to the RMX
dialStringstring The string to dial out to. The dial string can start with a scheme (e.g., "h323:", "sip:", "sips:", "isdn:"), a string with no scheme is interpreted as h323. Either dial-string or plcm-itu-phone-number is required, not both. Only dial-string is supported in this version, plcm-itu-phone-number is not used Mandatory
plcmItuPhoneNumber PlcmItuPhoneNumberSee Definition of PlcmItuPhoneNumberMandatory


Nested Types/Restrictions


NameTypeRestrictions
CallBitRateType
ForwardDtmfSourcestring
Length of value must be >=1
Length of value must be <=128
Passthrustring
Length of value must be >=1
Length of value must be <=512
Passbackstring
Length of value must be >=1
Length of value must be <=512
ResourcePriorityValuestring
Length of value must be >=1
Length of value must be <=64
ResourcePriorityNamespacestring
Length of value must be >=1
Length of value must be <=64
DtmfSuffix
Length of value must be >=1
Length of value must be <=64
T0string
Pattern of value must match the regular expression [\dpP0-9#\*]+