Manage Multiparty Calls and Consult Calls
Include up to six participants on a voice call, including the rep and customer. In addition to the six participants, a supervisor can listen in or barge in. While on a call with a customer, a rep can make a separate consult call before merging the calls together or ending the consult call. During the consult call, multiparty call participants are on a type of hold. Telephony partners specify whether to disable hold music so that call group participants can continue their conversation.
Before you begin, get access to the demo connector sample code in GitHub. Use the demo connector as a reference when developing your custom integration code. Salesforce provides support for features in the demo connector, but we can’t debug or troubleshoot custom connector code.
Contact Salesforce Support to request that a support representative set these org permissions. If they’re set, the feature is automatically enabled and requires no admin setup.
- Salesforce Voice: Multi-party conferencing
- Salesforce Voice: Multi-party consult
To familiarize yourself with the API and event sequences for multiparty and consult calls, see Call Scenario Diagrams.
Keep these limitations and considerations in mind when setting up and using multiparty and consult calls.
Feature compatibility and support:
- Salesforce Voice Toolkit API isn’t supported for multiparty calls.
- Omni-Channel Unified Routing isn’t compatible with multiparty calls.
- Compact layout call controls on the Voice Call record page reflect the initial call before a multiparty call was started. The compact layout call controls don’t reflect a multiparty call or consult call.
- Using keyboard shortcuts for call controls and using a headset to control call actions aren’t supported for multiparty and consult calls.
- When Salesforce Voice is in Voice Resiliency mode, consult calls are supported, but there’s no association established between the consult call and multiparty call entities. Also, there’s no notification in the conversation component when a consult call starts.
- Multiparty calls and consult calls aren’t supported if Salesforce Voice is part of an app with standard navigation.
User experience:
- By design, a rep on a multiparty call can’t end the call for all participants at one time. They must end the call for each participant one by one, or each participant must leave the call individually.
- The contact list for adding a participant to a multiparty call doesn’t filter out reps that are already part of the call group. If a telephony partner requires this behavior, they are responsible for handling it when returning the
getContacts()orgetPhoneContacts()API. - Transfer calls and multiparty calls are not automatically merged if a rep selects New Call.
- Unlike a warm transfer, where a rep can hold or resume a call, there are no hold and resume options on the call entry for multiparty or consult calls.
- If the multiparty calls feature is enabled, phone controls in the Omni-Channel utility are updated for standard calls and multiparty calls.
- When the call group is toggled open, the timer can default to 00:00 for less than a second before displaying the correct time.
- In the demo connector implementation, if a rep adds an external contact to a multiparty call, the external contact appears in the call group for only the rep who added them. The external contact doesn’t appear in the call group for other call participants.
- A rep can start a consult call when there is an active multiparty call.
- A rep who receives a consult call isn’t able to add participants to the consult call or transfer the consult call. Their role is limited to consulting until the consult call is merged with a multiparty call.
- A rep can’t end a multiparty call while on an active consult call. First, the rep must end or merge the consult call, then end the multiparty call.
- A call participant’s name can appear incorrectly after starting a consult call or when merging a consult call and multiparty call.
- In certain scenarios, a multiparty call’s status remains In Progress after the call has ended or a participant has been removed. Partners can resolve this by calling the Update a VoiceCall Record API to close the conversation.
- If the multiparty calls feature is enabled, a supervisor with a Standard User profile can’t pause or resume call recording. If the supervisor joins an active call to listen in, reps on the call don’t get a supervisor joined notification. To work around this, reps can grant access to specific voice calls for supervisors with a Standard User profile by clicking Share Voice Call in the Voice Call record and searching for the supervisor they want to share the object with.
-
To add a new participant to an ongoing call, use
addParticipant(). Check whethercallAttributesfor thePhoneCallincludeisAutoMergeOn. TheisAutoMergeOnattribute signifies that the call created withaddParticipant()should be merged into the ongoing call without putting the initial caller on hold. IfcallAttributes.isAutoMergeOnistruefor one or more of the calls in the multiparty call, the multiparty call is rendered as a collapsible call group. If all calls havecallAttributes.isAutoMergeOnasfalseorundefined, the calls are rendered as two distinct calls instead, such as a warm transfer. -
As each new participant is added, call
addParticipant(). -
When implementing
addParticipant(), create a Voice Call ofCallTypeTransfer, and use these call attributes to auto merge the new participant to an existing multiparty call when the rep clicks the Add User button.
For an example, see the vendor-sdk.js file in the sample demo connector.
The isMultipleParticipants() method in the phone call controls template checks the length of phoneCallList and shows a call group if the length is greater than 1. The call group appears if there are additional participants in the call, aside from the rep and customer.
Mute call participants individually. Muting all participants in the call with one button click isn’t supported for multiparty calls.
-
Pass a call object as a parameter to
mute()to mute a specific call participant. -
Optionally, pass
isGlobaltoMuteToggleResultto specify whether the mute action is for the rep (global mute) or for another participant (entry mute). IfisGlobalistrue, the rep is muted. IfisGlobalisfalse, a participant in the call group is muted. The default isfalse. -
To unmute a specific participant, pass a call object as a parameter to
unmute(). PassisGlobaltoMuteToggleResult.
Remove call participants individually. Removing all participants in the call with one button click isn’t supported for multiparty calls.
-
To end the call for a specific participant, pass a call object as a parameter to
endCall().
To support consult calls, make these adjustments to your connector code.
-
Vendors should set the value of
hasConsultinVoiceCapabilitiesResulttotrue. After Salesforce receives a value oftruefrom thegetVoiceCapabilities()method, thehasConsultcapability is turned on for reps that support consult calls. -
In your
dial()implementation, make these adjustments.-
Include a
dialOptionsobject as a parameter to specify whetherisConsultCallistrue. When a rep starts a consult call, Salesforce callsvendorConnector.dial(contact, dialOptions)wheredialOptions: {isCallback, isConsultCall}withisConsultCallastrue.isConsultCallalso exists incall.callAttributes. Salesforce creates a new Voice Call of CallType Consult upon resolving thedial(contact, isConsultCall)promise. -
When implementing
dial(contact, isConsultCall), create a new Consult call leg while the rest of the multiparty call has no hold music. Partners can choose whether to play hold music in a multiparty call when a consult call is started. Hold without music allows call group participants to continue their conversation while a consult call is active. Note that the Connector APIhold()method isn’t invoked for the call group even though the UI shows a hold state for the call group.
-
-
To pause recording for a consult call, pass a call object as a parameter to
pauseRecording(). For a multiparty call, it’s optional to pass a call object as a parameter when pausing recording. -
Return a resolved
RecordingToggleResultthat includes thecallIdincontactId. -
To resume recording for consult call, pass a call object as a parameter to
resumeRecording(). For a multiparty call, it’s optional to pass a call object as a parameter when resuming recording. -
Return a resolved
RecordingToggleResultthat includes thecallIdincontactId.
To end a consult call while a multiparty call continues, invoke the endCall() API. When endCall() is invoked, it is typically handled in two ways: either the partner resolves the promise with the result and the base connector publishes HANGUP or PARTCIPANT_REMOVED events, or the partner implementation fires the HANGUP or PARTICIPANT_REMOVED events.
When ending a consult call while a multiparty call is ongoing, this is the order of events. This example assumes that the base connector publishes events.
- If the consult call is ended, the base connector publishes a
HANGUPevent for the consult call. Salesforce handles cleaning up the consult call. - If a multiparty participant is removed from the consult call, the base connector publishes the
PARTICIPANT_REMOVEDevent. - If the current rep is the only participant left in the consult call, the base connector sends the
HANGUPevent because theactiveCallsin this scenario are0.
Always update the activeCalls list upon the endCall() API invocation, so that the base connector can handle the end call events correctly.
-
To merge a multiparty call and a consult call together, implement
conference()where the first call is the initial multiparty call, and the second call is the consult call, wherecall.callAttributes.isConsultCall = true. -
To make sure the rep sees the merged calls in a call group, take these steps.
-
Once the rep clicks Merge in Omni-Channel, return a promise that resolves the connector
conference()method withHoldToggleResultcontainingisCallMerged: trueand the calls to be conferenced. See our conference() documentation for information on the promise. -
If using a deskphone, call the publishEvent() method like this example.
-
-
Remove the participant from the consult call and add them to the original call. Close the consult call after merging the calls and return a resolved
HoldToggleResult. To make sure the calls are merged,HoldToggleResultmust include these fields.param.calls: A list of phone calls associated with this result. Required if Multiparty Calls are enabled.param.isCallMerged: Indicates whether a consult call has been merged with a multiparty call. This must betrue.