REST API‎ > ‎TalkSpaces‎ > ‎

Add To TalkSpace

This method adds an additional network ID to the TalkSpace.

Method: POST
URI: /api/rest/conference/{conferenceid} 

Path parameter:
  • conferenceid  The ID of the conference to add the new networkid to.
Form parameters:
  • networkid The networkid to add to the conference. 
  • appkey The application key associated with both the network IDs and the application. 
  • action The action to perform ("add").
  • 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
  • muted  Optional.  If provided and set to "true", the participant will be muted when they join the TalkSpace.
Returns:
  • ACCEPTED(202)  The networkid(s) have been added to the conference.
  • BAD_REQUEST(400)  Missing or invalid parameter(s).
  • BAD_GATEWAY(502)  Unable to initiate phone call(s) at this time.
  • UNAUTHORIZED((401)  The requested network ID is not associated with the supplied appkey.
Response format: JSON

Example

curl -d "appkey=1f1bbca5-b71f-4938-97b6-524ed80623bc&networkid=eta&greetingid=921e12353c4edca043eca2df697bf8&action=add"  https://api.telesocial.com/api/rest/conference/12368c94856898d99fa624b1a44

Response body:

{"ConferenceResponse":{"message":"Added","status":202,"conferenceId":"","uri":"/api/rest/conference/6d3406768c94856898d99fa624b1a44/eta"}}

Ruby Example

 def add_to_conference(conference_id, network_id, greeting_id = nil)
      response = post("/api/rest/conference/#{conference_id}", :body => {:networkid => network_id, :appkey => @api_key, :action => 'add', :greetingid => greeting_id})

      case response.status
      when 200
      when 400
        raise Telesocial::BadRequest.new("Missing or invalid parameter(s).", response)
      when 502
        raise Telesocial::BadGateway.new("Unable to initiate phone(s) call at this time.", response)
      end

      response

    end

Objective-C Example

/**
 This method adds one or more additional network IDs (call legs) to the conference.

 @param networks                One or more network IDs to add to the conference.
 @param conferenceId    The conference ID to add network to.
 @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.

 @see TSRestClientDelegate::restClient:didAddNetworksToConference:withStatus:
 */
- (void) addNetworks:(NSArray*) networks toConference:(NSString*) conferenceId greetingId:(NSString*) greetingId;