REST API‎ > ‎TalkSpaces‎ > ‎

Create TalkSpace

This method creates a TalkSpace, initially with a single participant.

Method: POST 
URI: /api/rest/conference

Form parameters: 
  • networkid  The network ID of the conference "leader".
  • appkey  The application key of the application requesting the conference. 
  • recordingid  Optional.  The media ID to which the conference audio is to be recorded.  When the conference ends, an audio file will be produced that is mapped to this media ID.
  • greetingid  Optional.  The media ID of a pre-recorded greeting, to be played to conference participants when they answer their phones.  If this parameter is not supplied, the default greeting will be used.
Returns:

  • CREATED(201) - The conference request has been accepted.
  • BAD_REQUEST(400) - Missing or invalid parameter(s).
  • BAD_GATEWAY(502) - The request cannot be fulfilled at this time. 
Response format: JSON 

Examples:

curl -d "appkey=1f1bbca5-b71f-4938-97b6-59fed80623bc&networkid=eta&greetingid=921e85baf53c4edca043eca2df697bf8" https://api.telesocial.com/api/rest/conference

JSON Response body

{"ConferenceResponse":{"message":"Created, leader is eta","status":201,"conferenceId":"63c9b03b84e9476080f7afe9ac2aa58e","uri":"\/api\/rest\/conference\/63c9b03b84e9476080f7afe9ac2aa58e"}}



Cool PHP Example

public function createConference($networkID, $greetingID = '5364e479ab04061ae5f5de8250d90c8', $recordingID = false)
    {
        $query = new telesocialQuery('conference');
        $query->addApiKey();
        $query->add('networkid', $networkID);
        if ($recordingID)
        {
            $query->add('recordingid', $recordingID);
        }
        if ($greetingID)
        {
            $query->add('greetingid', $greetingID);
        }
        if ($query->make() && $query->response['status'] == 201)
        {
            return $query->response['conferenceId'];
        }
        return false;
    }

Objective-C Example

/**
 This method creates a conference call with two or more participants.

 @param networkId       The network ID of the conference leader.
 @param greetingId      The media ID of a pre-recorded greeting to be played to conference participants
                                        when they answer their phones. If this parameter is <i>nil</i>, the default
                                        greeting is used.
 @param recordingId The media ID to which the conference audio is to be recorded or <i>nil</i>.
                                        When the conference ends, an audio file will be produced that is mapped to this
                                        media id. If the parameter is <i>nil</i> then no recording will be performed.

 @see TSRestClientDelegate::restClient:didCreateConferenceId:withStatus:
 */
- (void) createConferenceWithNetwork:(NSString*) networkId greetingId:(NSString *)greetingId recordingId:(NSString *)recordingId ;