View source for 5.19:Desktop-integration-api-net-version-tutorial/Conference

= Conference=

The following code snippet shows how to merge calls into a [[agent-guide/HowtoHostaConference|conference]]. 

* For an conference via consultation, it assumes existence of a held primary call and an active consult call. Execution of the code snippet would be triggered by an explicit user action (e.g., pressing of a ''Merge'' button).

* For a single-step conference, it assumes existence of an active primary call and another call attempt initiated by the logged-in user. Execution of the code snippet would be triggered by connection of the second call.


 public void MergeCalls(List&lt;Call&gt; calls) {
 
 Call conferencingCall = FindConferencingCall(calls, null);
 
 if (conferencingCall == null)
 
 return;
 
 
 List&lt;Call&gt; callsToMerge = new List&lt;Call&gt;();
 
 foreach (Call call in calls) {
 
 if (call.id != conferencingCall.id &amp;&amp; call.state != CallState.Disconnected) {
 
 callsToMerge.Add(call);
 
 }
 
 }
 
 conferencingCall.mergeConference(callsToMerge);
 
 }
 
 
 private Call FindConferencingCall(List&lt;Call&gt; calls) {
 
 Call bestCall = null;
 
 DateTime bestTime = DateTime.Now;
 
 
 foreach (Call call in calls) {
 
 if (call.state != CallState.Disconnected &amp;&amp; call.state != CallState.Unknown) {
 
 foreach (CallParty cp in call.parties.Values) {
 
 switch (cp.phoneType) {
 
 case PhoneType.Trunk:
 
 return call;
 
 case PhoneType.DialOut:
 
 return call;
 
 case PhoneType.AccessNumber:
 
 return call;
 
 case PhoneType.Phone:
 
 case PhoneType.Softphone:
 
 
 if (bestCall == null) {
 
  bestCall = call;
 
  bestTime = call.startTime;
 
 }
 
 else if (call.startTime &lt; bestTime) {
 
 bestCall = call;
 
 bestTime = call.startTime;
 
 }
 
 break;
 
 }
 
 }
 
 }
 
 }
 
 return bestCall;
 
 }



To remove a participant from a conference, the ''removeParty'' method from Call should be used as follows:

 void RemoveFromConference(string callId, string partyId)''
 
 {     
 Call call = AgentPlace.call(callId);
 if (call != null)
 {
 CallParty party = call.parties[partyId];
 if (party != null)
 {
 call.removeParty(party);
 }
 }
 
 }



To leave a conference (remove oneself from a conference), use the ''drop'' method from ''Call'': 
 public void drop();


To end a conference, use the ''endConference'' method from ''Call'':
 public void endConference();