Loading
Upcoming Mandatory Changes to Public Key Infrastructure (PKI)Read More
Salesforce Enforces New Security Requirements in Summer 2026Read More

Transfer to agent or queue using Salesforce Voice Toolkit API addParticipant

Publish Date: Jun 19, 2026
Description

Attempting to add an Agent ARN or Queue ARN through the Add Participant action results in a CAN_NOT_ADD_PARTICIPANT error with the message: "Invalid agent or contact state.

Steps to Reproduce

  1. Establish an active voice call.
  2. Enter a valid Agent ARN or Queue ARN in the Add Participant field.
  3. Click Add Participant.

Observed Behavior

The request fails and the following error is logged:

SCV dispatched error CAN_NOT_ADD_PARTICIPANT for eventType ADD_PARTICIPANT

{

  "type": "InvalidStateException",

  "message": "Cannot create new connection by endpoint ARN: <Agent ARN>: Invalid agent or contact state."

}

Expected Behavior

The specified agent or queue should be added to the active call successfully.

 

Resolution

Resolution

When using the Voice Toolkit API addParticipant method to add an agent or queue to an active call, the corresponding Quick Connect ARN should be used as the destination rather than the Agent ARN or Queue ARN directly.

Using an Agent ARN or Queue ARN may result in an InvalidStateException and prevent the participant from being added to the call.

Knowledge Article Number

005387384

 
Loading
Salesforce Help | Article