|
|
@@ -5,12 +5,12 @@ This document provides a step-by-step guide for setting up the email transcripti
|
|
|
|
|
|
## Step-by-Step
|
|
|
1. **Log in to FusionPBX**
|
|
|
- - Access the FusionPBX administrative interface.
|
|
|
+ - Access the FusionPBX administrative interface.
|
|
|
|
|
|
2. **Check for the "Transcribe" Option**
|
|
|
- Navigate to **Advanced** > **Default Settings**.
|
|
|
- Use the drop-down filter to select "**Transcribe**".
|
|
|
- - If the "**Transcribe**" option is already available, skip to step **5**. Otherwise, proceed to step **3**.
|
|
|
+ - If the "**Transcribe**" option is already available, skip to step **5**. Otherwise, proceed to step **3**.
|
|
|
|
|
|
3. **Install the Transcribe and Speech Apps**
|
|
|
- SSH into your server and run the following commands:
|
|
|
@@ -40,19 +40,21 @@ This document provides a step-by-step guide for setting up the email transcripti
|
|
|
- Click **Reload** to apply the changes.
|
|
|
|
|
|
6. **Enable Transcription for a Single Extension**
|
|
|
-- Navigate to **Accounts** > **Extensions**.
|
|
|
-- Select the desired extension.
|
|
|
-- Set **Transcription Enabled** to **True**.
|
|
|
+ - Navigate to **Accounts** > **Extensions**.
|
|
|
+ - Select the desired extension.
|
|
|
+ - Set **Transcription Enabled** to **True**.
|
|
|
|
|
|
7. **Enable Transcription by Default for All Extensions**
|
|
|
-- Navigate to **Advanced** > **Default Settings**.
|
|
|
-- Use the drop-down filter to select "**Voicemail**".
|
|
|
-- Enable the **transcription_enabled_default** setting.
|
|
|
+ - Navigate to **Advanced** > **Default Settings**.
|
|
|
+ - Use the drop-down filter to select "**Voicemail**".
|
|
|
+ - Enable the **transcription_enabled_default** setting.
|
|
|
|
|
|
8. **Test the Service**
|
|
|
-- Leave a voicemail for the enabled extension to verify that the transcription works correctly.
|
|
|
+ - Leave a voicemail for the enabled extension to verify that the transcription works correctly.
|
|
|
|
|
|
-> **Note**: The primary function handling voicemail transcriptions is defined in [transcribe.php](https://github.com/fusionpbx/fusionpbx/blob/master/app/email_queue/resources/functions/transcribe.php).
|
|
|
+:::{note}
|
|
|
+The primary function handling voicemail transcriptions is defined in [transcribe.php](https://github.com/fusionpbx/fusionpbx/blob/master/app/email_queue/resources/functions/transcribe.php).
|
|
|
+:::
|
|
|
|
|
|
---
|
|
|
|
|
|
@@ -63,9 +65,8 @@ Uses API services to transcribe voicemails into text for use in the app-sms and
|
|
|
## IBM Watson API
|
|
|
Sign up and language information is located on [IBM Watson's Site](https://cloud.ibm.com/catalog/services/speech-to-text).
|
|
|
|
|
|
-:::{warning}
|
|
|
-
|
|
|
-We cannot use mod_shout to record voicemails because the transcription service needs an uncompressed version of the audio. Therefore, we will record in WAV and then use LAME to re-encode in MP3. This could cause added resource utilization to your system.
|
|
|
+:::{warning}
|
|
|
+We cannot use mod_shout to record voicemails because the transcription service needs an uncompressed version of the audio. Therefore, we will record in WAV and then use LAME to re-encode in MP3. This could cause added resource utilization to your system.
|
|
|
:::
|
|
|
|
|
|
**Go to Advanced > Default Settings.**
|
|
|
@@ -80,10 +81,9 @@ Add the following entries:
|
|
|
| voicemail | transcribe_enabled | boolean| true | True |
|
|
|
| voicemail | json_enabled | boolean| true | True |
|
|
|
|
|
|
-:::{note}
|
|
|
-
|
|
|
+:::{note}
|
|
|
Watson URL used for testing was:
|
|
|
-https://example.url.api.us-south.speech-to-text.watson.cloud.ibm.com/instances/{GUID}/v1/recognize?model=en-US_Telephony&smart_formatting=true*
|
|
|
+https://example.url.api.us-south.speech-to-text.watson.cloud.ibm.com/instances/{GUID}/v1/recognize?model=en-US_Telephony&smart_formatting=true*
|
|
|
:::
|
|
|
|
|
|
**List of available IBM Watson speech-to-text models**:
|
|
|
@@ -106,8 +106,8 @@ Add the following entries:
|
|
|
| voicemail | azure_key | text | {your azure key} | True |
|
|
|
| voicemail | azure_server_region | text | {your server region} | True |
|
|
|
| voicemail | transcribe_language | text | en-US | True |
|
|
|
-| voicemail | transcribe_enabled | boolean| true | True |
|
|
|
-| voicemail | json_enabled | boolean| true | True |
|
|
|
+| voicemail | transcribe_enabled | boolean| true | True |
|
|
|
+| voicemail | json_enabled | boolean| true | True |
|
|
|
|
|
|
Click "Reload" at the top of the page.
|
|
|
|
|
|
@@ -142,9 +142,8 @@ Recommend using Azure as an alternative to Bing.
|
|
|
Sign up and language information is located on [Microsoft Site](https://www.microsoft.com/cognitive-services/en-us/Speech-api/documentation/API-Reference-REST/BingVoiceRecognition).
|
|
|
Note: The Bing Speech API is deprecated as of October 2018; this works for now but needs to be ported to [the new API](https://github.com/MicrosoftDocs/azure-docs/blob/master/articles/cognitive-services/Speech-Service/how-to-migrate-from-bing-speech.md).
|
|
|
|
|
|
-:::{warning}
|
|
|
-
|
|
|
-We cannot use mod_shout to record voicemails because the transcription service needs an uncompressed version of the audio. Therefore, we will record in WAV and then use LAME to re-encode in MP3. This could cause added resource utilization to your system.
|
|
|
+:::{warning}
|
|
|
+We cannot use mod_shout to record voicemails because the transcription service needs an uncompressed version of the audio. Therefore, we will record in WAV and then use LAME to re-encode in MP3. This could cause added resource utilization to your system.
|
|
|
:::
|
|
|
|
|
|
**Go to Advanced > Default Settings.**
|
Anthony
