Play secure audio file from Copilot Studio

Applies to: Dynamics 365 Customer Service

For customer voice solutions, if you want to play a custom audio clip through Interactive Voice Response (IVR), then you must use secure storage.

Enhanced voice bot

To add a custom audio clip to your enhanced voice bot, perform the following steps.

Prerequisites

• Active Azure subscription.
• An Azure storage account. Learn more in Create an Azure storage account.

Upload audio files in Azure Blob Storage

In the Azure portal, perform the following steps:

1. Enable static website hosting. Learn more in Enable static website hosting. Make sure that the Primary endpoint is set to the URL of your website.
2. Navigate to Data Storage > Containers.
3. Select $web and upload your audio files.
4. To secure the storage folder, perform the following steps:
   • Assign a Storage Blob Data Reader role to Copilot Studio app registration or the specific user/group that needs access. Learn more in Assign a storage blob data role.
   • Navigate to the container where you uploaded the file, select the required audio file, and then select Shared access tokens. Specify the required permissions, start, and expiry dates.

   Tip

   The audio file doesn't play after the expiry date. Make sure to specify this date accordingly.

   • Select Generate SAS token and URL. Copy the value in BLOB SAS URL.

Add the URL to the bot

Navigate to Copilot Studio and perform the following steps:

1. Select the voice bot to which you want to add the audio file as a latency message.
2. Add a latency message for long running operations.
3. In the message box, specify the SSML tag, <audio src=""/>, and paste the BLOB SAS URL you copied from the Azure portal as the value of the src attribute. For example, <audio src="https://<storageaccount>.blob.core.windows.net/$web/<audiofile>?<SAS token>"/>. Learn more in Format speech synthesis with SSML.
4. Save and publish the bot.

Classic bot

For classic bots, you can add audio files using Azure Blob Storage. Security scanning code filters out certain values from Azure Blob storage URLs by default when they're passed between systems.

Prerequisites

• Have a custom Copilot Studio classic bot, such as Sample Copilot Studio classic Bot solution.
• Create an Azure Storage account.
• Have a custom audio clip.
• Install Bot Framework Composer.

Solution

• Utilize Azure Blob storage to host audio files for playback through SSML.
• Encode the URLs such that they meet content security scan requirements for Microsoft systems.

Create storage account and secure audio files

1. Sign in to the Azure portal.

2. Create an Azure Storage account. When you're provisioning the account, perform the following steps:

   1. Uncheck Allow enabling public access on individual containers to ensure only URLs with secure access tokens are allowed.

      

   2. Make sure the Enable public access from all networks checkbox is selected.

      

3. Create a blob storage container under Containers.

4. Upload audio files as blobs to the container.

5. Double select on an uploaded audio file row in container view, and navigate to Generate SAS.

6. Set an expiration time, and then choose Generate SAS token and URL.

7. Copy the value in the Blob SAS URL field.

8. Before pasting the URL in Copilot Studio, you must encode the URL. Replace all the & with & to make sure it passed through the Copilot Studio.

Tip

The system stops playing the audio file once the Expiration field date and time are reached. Select an appropriate date and time for this field.

Use audio file from secure storage

1. Open your custom Copilot Studio in Bot Framework composer.

2. Open your Bot in Copilot Studio.

3. Go to Topics > New topic and then select Open in Bot Framework Composer.

   

4. In the Bot Framework Composer, add a new dialog to your bot.

   

5. In the new dialog, select BeginDialog.

   

6. In the edit panel, add a new event Send a response.

   

7. Add speech component to your bot response. Learn more in Add speech components to your bot responses.

8. Select the audio option, and then paste your secure URL generated in the Create storage account and secure audio files section in the URL tag.

   

9. Save and publish your Copilot Studio classic bot.