Configure seamless and contextual hand-off to Omnichannel for Customer Service

[This topic is pre-release documentation and is subject to change.]

With Power Virtual Agents, you can seamlessly and contextually hand off escalated Power Virtual Agents conversations to live (human) agents using Omnichannel for Dynamics 365 Customer Service.

When you hand off a conversation, you share the full history of the conversation (the context) as well as all user-defined variables. This allows Omnichannel for Customer Service to route incoming escalations to the right live agent queue and enables engaging live agents to review context from the prior conversation and resume the conversation.

For more information about hand off, and how to use hand-off within a bot conversation, see the Using Transfer to agent node topic.


Configure hand-off in the Power Virtual Agents app

Sign in to the Power Virtual Agents bot you want to connect to Omnichannel for Customer Service.

  1. Select Settings, and then Transfer to agent.


  2. Select the Dynamics 365 Omnichannel for Customer Service tile.


  3. To acknowledge the privacy policy, select Next.


    Ensure that you adhere to data sovereignty laws when you configure this integration as your bot will store and send user information to your Omnichannel for Customer Service instance.

  4. Follow the steps to create or reuse an existing Azure application ID. Copy the Application (client) ID and paste it in the text box provided.


    Omnichannel models bots as "application users" in the system. Therefore, the Application (client) ID that you use must be unique to your organization (your Microsoft Dataverse organization or environment).

  5. Power Virtual Agents uses a Teams channel to communicate with Omnichannel for Customer Service. If a Teams channel is not enabled, a Teams channel will be enabled when you select Next.

  6. Select the environment where your Omnichannel for Customer Service instance is provisioned.

  7. Select the Go to Omnichannel link to continue configuring the bot connection in Omnichannel for Customer Service.


Your bot must be in a published state for end-to-end capabilities to work as expected. Ensure that you have published your bot prior to validating the integrated experience.

If you want to test the bot on your custom website, you must use the embed code that is specified in the chat widget you set up in Omnichannel (see Prerequisites in the Integrate a Power Virtual Agents bot article). If you use the embed code from the Power Virtual Agents site, hand-off will not occur correctly.

Remove Omnichannel for Customer Service connection

You can remove a bot from Omnichannel for Customer Service by disconnecting the connection in Power Virtual Agents.

  1. Sign in to the Power Virtual Agents bot you want to connect to Omnichannel for Customer Service.

  2. Select Settings, and then Transfer to agent.

  3. Under Dynamics 365 Omnichannel Customer Engagement, select Disconnect.

    Screenshot of the Transfer to agent page in Power Virtual Agents where you can select the Disconnect button to remove the connection.

Known limitations

See Known limitations when using Power Virtual Agents with Omnichannel for Customer Service for more information.