Copy your bot's name in Power Virtual Agents.

In the navigation menu under Settings , select Channels .

Select the channel you want to connect to. This topic uses Slack as an example.

To copy and save the Token Endpoint value, select Copy . You'll need your endpoint to connect your bot to the Azure Bot Service channel.

Manage conversation sessions with your Power Virtual Agents bot

There can be multiple conversations between the Azure Bot Service channels and the Direct Line connection with your Power Virtual Agents bot.

Your Azure Bot Service bot will need to map and relay the conversation from the Azure Bot Service channel to the Direct Line conversation with the Power Virtual Agents bot and vice versa.

Sample code example

The following example uses samples from the relay bot sample code .

On every new external Azure Bot Service channel conversation start, start a Power Virtual Agents conversation. Refer to Get Direct Line token and Use Direct Line to communicate with the bot for instructions on starting a new conversation with the bot.

using (var httpRequest = new HttpRequestMessage())
    httpRequest.Method = HttpMethod.Get;
    UriBuilder uriBuilder = new UriBuilder(TokenEndPoint);
    httpRequest.RequestUri = uriBuilder.Uri;
    using (var response = await s_httpClient.SendAsync(httpRequest))
        var responseString = await response.Content.ReadAsStringAsync();
        string token = SafeJsonConvert.DeserializeObject<DirectLineToken>(responseString).Token;
/// <summary>
/// class for serialization/deserialization DirectLineToken
/// </summary>
public class DirectLineToken
    public string Token { get; set; }
 // Use the retrieved token to create a DirectLineClient instance
 using (var directLineClient = new DirectLineClient(token))
     var conversation = await directLineClient.Conversations.StartConversationAsync();
     string conversationtId = conversation.ConversationId;
To manage multiple sessions, you need to maintain a mapping of external Azure Bot Service channel conversations to corresponding Power Virtual Agents conversations. A Power Virtual Agents conversation can be identified with and connected with two properties: ConversationtId and Token.
Dictionary<string, PowerVirtualAgentsConversation> ConversationRouter = new Dictionary<string, PowerVirtualAgentsConversation>();  
To manage the conversation lifecycle, refresh the Direct Line tokens or clean up idled conversations. Learn more about token refresh at Refresh Direct Line token. A Power Virtual Agents conversation to support those is defined as following:
/// <summary>
/// Data model class for Power Virtual Agents conversation
/// </summary>
public class PowerVirtualAgentsConversation
    public string ConversationtId { get; set; } // The Power Virtual Agents conversation ID retrieved from step 1
    public string Token { get; set; } // The DirectLine token retrieved from step 1
    public string WaterMark { get; set; } // Identify turn in a conversation
    public DateTime LastTokenRefreshTime { get; set; } = DateTime.Now; // Timestamp of last token refresh
    public DateTime LastConversationUpdateTime { get; set; } = DateTime.Now; // Timestamp of last active user message sent to bot
When a new Power Virtual Agents conversation starts, add a key value pair (external_Azure_Bot_Service_channel_conversationID, PowerVirtualAgentsConversation) to the mapping table.
// After new Power Virtual Agents conversation starts
ConversationRouter[external_Azure_Bot_Service_channel_conversationID] = new PowerVirtualAgentsConversation()
    Token = token,
    ConversationtId = conversationId,
    WaterMark = null,
    LastConversationUpdateTime = DateTime.Now,
    LastTokenRefreshTime = DateTime.Now,
To continue on an existing conversation, upon a new external Azure Bot Service channel message received, retrieve the existing conversation from the mapping table, relay the external conversation activity to your Power Virtual Agents bot, and get a response.
The following sample shows relaying conversation by overriding the ActivityHandler.OnMessageActivityAsync((ITurnContext<IMessageActivity>, CancellationToken) method
// Invoked when a message activity is received from the user
// Send the user message to Power Virtual Agents bot and get response
protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
    // Retrieve bot conversation from mapping table
    // If not exists for the given external conversation ID, start a new Power Virtual Agents conversation
    ConversationRouter.TryGetValue(externalCID, out PowerVirtualAgentsConversation currentConversation) ?
            currentConversation : /*await StartBotConversationAsync(externalCID)*/;
    // Create DirectLine client with the token associated to current conversation
    DirectLineClient client = new DirectLineClient(currentConversation.Token);
    // Send user message using directlineClient
    await client.Conversations.PostActivityAsync(currentConversation.ConversationtId, new DirectLineActivity()
      Type = DirectLineActivityTypes.Message,
      From = new ChannelAccount { Id = turnContext.Activity.From.Id, Name = turnContext.Activity.From.Name },
      Text = turnContext.Activity.Text,
      TextFormat = turnContext.Activity.TextFormat,
      Locale = turnContext.Activity.Locale,
    // Update LastConversationUpdateTime for session management
    currentConversation.LastConversationUpdateTime = DateTime.Now;
Refer to Use Direct Line to communicate with the bot for how to get the Power Virtual Agents bot's response. When the Power Virtual Agents bot's response is received, refer to Parse conversation payload from the bot for how to parse the response to the external Azure Bot Service channel response.
An example of response parsing can be found in the relay bot sample code ResponseConverter.cs.
Deploy to Azure Bot Service
After you have your Azure Bot Service relay bot ready, you need to deploy the bot to your Azure Bot Service.
Set up Azure Bot Service channels
You can set up the channels you want to connect to by signing in to the Azure portal and selecting the Azure Bot Service resource group you have deployed to. View the specific instructions for each channel at Azure Bot Service Channels.