ShareDo has implemented Transcription directly into the platform. This will be available first as part of the Rich Text or WYSIWYG Editor (CK Editor). This means that if you have a Transcription Provider Enabled and set up, you will be able to speak text directly into these fields all around ShareDo.

As of release v7.10.0, we have rolled out transcription to Voice Notes and the Batch Transcription Workflow Block.

Details

From any Blade, Comment Field, Wiki, and more, so long as you are in a Rich Text Editor (one of those boxes with text and formatting controls, such as in the screenshot above). If your ShareDo environment has a Transcription provider installed and configured, you will see this microphone icon. The button won't be visible if you don't have a provider installed and configured. If it's something you can't see, but think you should, contact your own internal ShareDo Administrator.

When you first click the microphone icon, you may need to give the browser permission to access the microphone. If you already use the Voice Notes feature in ShareDo, you may have done this in the past, and the microphone will activate straight away.

If not, you will see a dialogue box like this.

Decide whether you want to give access to the microphone just this time or whenever you use ShareDo. Once you've done that, the microphone should activate. This is indicated by the microphone icon pulsing. As soon as this has happened, the microphone is active.

You will briefly see a Blue Information Box warning you that the Microphone is active and transcription is in progress. This will fade after a second or so.

Once you're finished, pause for a second or two before deactivating the microphone button and closing the connection. Different providers process the text differently, and you may notice that once paused, it applies some slight formatting and corrects punctuation or any mistakes it finds. This is the benefit of AI-powered transcription tools: once you finish, they get a sense of the context and use that to improve transcription accuracy. 

Available Providers

From day one, ShareDo will launch with two Transcription providers, though we may add others in the future.

Provider	Name	Website
	Speechmatics	https://www.speechmatics.com/
	Azure Speech SDK	https://learn.microsoft.com/en-us/azure/ai-services/speech-service/speech-sdk

ShareDo operates both of these providers in a BYOL (Bring Your Own Licence) format, meaning you can register for the service and the package/tier of your choice, and then simply enter your credentials to get going once installed.

How to get it

To get started with one of these product plugins, contact your ShareDo CSM and let them know which provider you would like to install.

• Visual Workflow blocks for managing batch transcription through a 3rd party provider.
• Interface adjustments on Related Documents to allow for the workflow to be called on relevant (i.e. voice note) documents.
• Interface adjustments to the voice note playback screen to allow for viewing and editing completed transcriptions, and for providing an indication of the last edit made.
• Audit Logging on voice notes to record when a recording/transcription is requested, opened, edited, or downloaded.

Transcription is a feature of the ShareDo platform, enabling quick, easy speech-to-text conversion across a range of ShareDo functions. For more information about how you can use the Transcription functionality, check out the Transcription article.

Provider

Azure Speech is one of the available providers for the Transcription Functionality in the ShareDo platform. This functions on a BYOL (Bring Your Own License) basis. We recommend you check out their website and trial their service before committing. Once you're happy and have an agreement, tier, contract or package in place, you will be able to use your credentials to set up Azure Speech as a provider in ShareDo.

You can find more about Azure Speech on the Microsoft Learn site. You can register for an account and get credentials from the Azure Portal.

Installation

To have Azure Speech installed in your ShareDo environment, you must be on ShareDo version 7.9.0 or later.

Reach out to your CSM, and they will install the latest version of the plugin for you. Initially, in a non-production environment for you to test, and then in production.

Configuration

Configuring a transcription plugin involves two steps.

• Configuring the Global Feature.
• Configuring a Linked Service for authentication.

Global Feature Config

1. Navigate to Modeller > Global Features
2. Then search for the transcription Feature.
   
3. Ensure the checkbox is enabled, then click the green cog to open the configuration blade.
   
4. On this screen, you have a drop-down to choose the provider (if you have more than one provider installed), choose Azure Speech Service.
5. Next, the Global Feature will check to see if there is a matching Linked Service and whether it is configured correctly. This Message will be red, amber, or green.
   1. Red - No Linked Service found.
   2. Amber - Linked Service exists, but some fields are missing or incorrect.
   3. Green - Everything looks good, and is working as expected.
6. You can configure the Linked service directly from the button on the Global Feature blade, but we'll come back to that shortly.
7. For now, you need to select your Azure Region and the Speech Recognition Language.
   Please consult your IT Administrator, or whoever will be providing your API Key, as they will be able to let you know which Azure region to select.
   In our case, we created our API Key in the uksouth Azure Region and are operating speech recognition in English, specifically en-GB from the ISO 639-1 list of language codes.
8. Don't forget to Save and Close the Global Feature.

Linked Service Config

Next, we need to configure the Linked Service. If you are still on the Transcription Global Feature Blade, you can click Configure it. Otherwise, you can navigate to Admin > Integrations > Manage Linked Services.

1. Look for a service called Azure Speech Service.
   
2. You can create it by clicking the Green Add New icon in the top right-hand corner if it doesn't exist.
   
3. Then, choose Shared secret from the list of available service providers.
   
4. You will need to populate the following fields:

• Fields in Bold are mandatory.
• Fields with [No Specific Value] can be set as you please.
• Secret must be populated with your own API Key.
• Make sure you update the API Base URL with the region for which your Azure Speech subscription is set up.

Once you're done, hit Save and Close. Then, navigate back to the User side of ShareDo, and you can test it out in any Rich Text Field.

Transcription is a feature of the ShareDo platform that enables quick, easy speech-to-text conversion across several ShareDo functions. The Transcription article provides more information about using this functionality.

Provider

Speechmatics is one of the providers available for transcription functionality on the ShareDo platform. This functions on a BYOL (Bring Your Own License) basis. We recommend you check out their website and trial their service before committing. Once you're happy and have an agreement, tier, contract or package in place, you will be able to use your credentials to set up Speechmatics as a provider in ShareDo.

You can find more about Speechmatics and register for an account on their website.

Installation

To have Speechmatics installed in your ShareDo environment, you must be on ShareDo version 7.9.0 or later.

Reach out to your CSM, and they will install the latest version of the plugin for you, initially in a non-production environment for testing, then in production.

Configuration

The configuration of a transcription plugin involves two steps: the Global Feature and a Linked Service for authentication.

Global Feature Config

Navigate to: Modeller > Global Features

Then search for the transcription Feature.

1. Firstly, ensure the checkbox is enabled, then click the green cog. This opens the configurtion blade.
   
2. On this screen, you have a drop-down to choose the provider (if you have more than one provider installed), choose Speechmatics.
3. Next, the Global Feature will check to see if there is a matching Linked Service and whether it is configured correctly. This message will be red, amber, or green.
   1. Red - No Linked Service found.
   2. Amber - Linked Service exists, but some fields are missing or incorrect.
   3. Green - Everything looks good, and is working as expected.
4. You can configure the Linked service directly from the button on the Global Feature blade, but we'll come back to that shortly.
5. For now, you need to make sure you enter the:
   1. Socket API URL: In our case, this was wss://eu2.rt.speechmatics.com/
      For now, it looks like all Speechmatics Customers use the same URL, but this could change in future. Please consult the Speechmatics Documentation.
6. Don't forget to Save & Close the Global Feature.

Linked Service Config

Next, we need to configure the Linked Service. If you are still on the Transcription Global Feature Blade, you can click Configure it. Otherwise, you can navigate to Admin > Integrations > Manage Linked Services.

1. Look for a service called Speechmatics.
   
2. If it doesn't exist, you can create it by clicking the green Add New icon in the top right-hand corner.
   
3. Then choose Shared secret from the list of available service providers.
   
4. You will need to populate the following fields:

• Fields in Bold are mandatory
• Fields with [No Specific Value] can be set as you please
• Secret must be populated with your own API Key

Once you're done, hit Save & Close. Then, navigate back to the User side of ShareDo, and you can test it out in any Rich Text Field.