2.2.3.15 addUser Dial-out Request Document

  • Article

In addition to the syntax rules given in section 2.2.1 for C3P requests, the following additional rules apply.

conferenceKeys: The conference-URI specified in the confEntity attribute of the conferenceKeys element MUST match the SIP URI in the To header field of the INVITE request.

The following rules apply to the user element:

  • Exactly one user element MUST be present inside the addUser body.

  • The entity attribute of the user element MUST be a SIP URI.

The following rules apply to the roles element:

  • Zero or one roles element MUST be present inside the user element.

  • The entry element MUST be populated with the desired role.

The following rules apply to the endpoint element:

  • Zero or one endpoint element MUST be present inside the user element.

  • The endpoint element MUST specify a valid entity attribute. Implementations SHOULD use a GUID for this purpose.

  • The endpoint-uri attribute can be specified. If specified, it MUST be a "sip:" URI or a "tel:" URI.

  • The refer-to-uri attribute can be specified. If specified, it MUST be a "sip:" URI or a "tel:" URI.

  • The joining-method element MUST be populated with the value "dialed-out".

  • The accessMethod and authMethod elements MUST be left empty when sent from the client.

mcuUri: The mcuUri attribute MUST be populated with the MCU-Conference-URI of the MCU that needs to execute the addUser dial-out command. Valid values are "IMMCU" and "AVMCU". "ASMCU" and "DMCU" are not supported.

Extensions to this specification can specify the semantics of other elements and attributes.

The following example is an addUser request document:

 <addUser mcuUri="sip:alice@fabrikam.com;gruu;opaque=app:conf:chat:id:5D3747C">
   <conferenceKeys confEntity="sip:alice@fabrikam.com;gruu;opaque=app:conf:focus:id:5D3747C"/>
   <user entity="sip:cathy@fabrikam.com">
     <display-text>Cathy Baker</display-text>
     <roles>
       <entry>presenter</entry>
     </roles>
     <endpoint entity="{5CD3FC0A-05F7-4A17-A95B-430A28FC9EFA}" 
 endpoint-uri="sip:cathy@fabrikam.com;opaque=user:epid:123;gruu">
       <joining-method>dialed-out</joining-method>
       <!-- other extension elements can follow -->
     </endpoint>
   </user>
 </addUser>