Dynamically Control Messaging Actions

Control what reps can or can’t do per Messaging session agentWork, according to your business needs. Enable or disable Messaging actions for a specific Bring Your Own Channel for CCaaS Messaging session. For example, turn on transfers for certain queues and turn off transfers for others.

Lighting App Builder settings for the Enhanced Conversation Component that hide controls take precedence over dynamically controlled Messaging actions. For example, if the transfer action in a Messaging session layout is hidden but transfers are enabled through Interaction Service API for that Messaging session agentWork, the transfer action isn’t visible to the rep.

  1. To create an AgentWork record when the system finds an agent to handle a work assignment, call the Interaction Service AgentWork API (POST /api/v1/agentWork).

  2. As part of the payload for the AgentWork API, include the optional agentActionVisibilities JSON object. This object specifies whether a particular action is enabled or disabled for the Messaging session agentWork using these parameters.

    • agentAction: Required. An enum that specifies which Messaging action is dynamically controlled. Transfer is currently the only available option.
    • visible: Required. A Boolean that indicates whether an action is enabled (true) or disabled (false). Although Messaging action buttons are visible if visible is false, they aren’t functional.

    Here are two example payloads. They differ based on whether a Pending Service Routing (PSR) record already exists when you call the AgentWork API.

See Also