# Voice Mail Transcription

#### IBM Watson STT

##### Creating IBM Watson Credentials

1. [Login to IBM Cloud using your new credentials](https://console.ng.bluemix.net/login?state=/catalog/?category=watson).
2. Once logged in, choose *IBM Cloud* from the Title Bar to display your Dashboard.
3. Choose *Create Resource*.
4. Click *Speech to Text* from the AI Section.
5. Name your STT service, choose the desired region, and choose Default resource group.
6. Select a *Pricing Plan*: 
    - LITE provides 500 minutes/month free. Plan is deleted after 30 days of inactivity.
    - STANDARD is 2¢/minute with no free minutes.
7. When *Speech to Text* dialog opens, copy your *API Key* and *URL*.
8. Logout by clicking on image icon in upper right corner of dialog window.

##### Installing STT Engine

1\. Unpack the file

```shell
wget http://incrediblepbx.com/sendmailibm-13.tar.gz
tar zxvf sendmailibm-13.tar.gz
cp sendmailmp3.ibm /usr/local/sbin/sendmailmp3
chmod 0755 /usr/local/sbin/sendmailmp3
```

2\. Edit `sendmailmp3.ibm` and insert your IBM STT API\_KEY and URL. Save file.

3\. Edit `bluemix-test` and insert your IBM STT API\_KEY and URL. Save the file.

4\. Copy the updated `sendmailmp3.ibm` file to `sendmailmp3`:

```shell
cp sendmailmp3.ibm /usr/local/sbin/sendmailmp3
chmod 0755 /usr/local/sbin/sendmailmp3
```

5\. Test your Bluemix STT setup: `bluemix-test`

Result should be: *we are now transferring you out of the company directory…*

##### FreePBX Setup

Settings > Voicemail Admin > Settings > Email Config > Mail Command: /usr/local/sbin/sendmailmp3

Set up voicemail for an extension and include your email address.

##### Tutorials

- [Free IBM Voicemail Transcription with Incredible PBX 2020](https://nerdvittles.com/free-ibm-voicemail-transcription-with-incredible-pbx-2020/)
- [IBM’s Speech Recognition Engine Comes to Asterisk](http://nerdvittles.com/ibms-speech-recognition-engine-comes-to-asterisk/)
- [Free Asterisk Voicemail Transcription with IBM Watson STT](http://nerdvittles.com/free-asterisk-voicemail-transcription-with-ibms-stt-engine/)
- [Creating IBM Watson Credentials](http://nerdvittles.com/creating-ibm-watson-credentials/)
- [Release notes for Speech to Text for IBM Cloud](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-release-notes)
- [Getting started with Speech to Text](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-gettingStarted)
- [Github: lgaetz/sendmail-bluemix](https://gist.github.com/lgaetz/2cd9c54fb1714e0d509f5f8215b3f5e6)
- [Github: jtsage/sendmail.asterisk](https://gist.github.com/jtsage/f38151b43debb6bd90ebaa4f0ab2687f)

#### Google STT

##### Tutorials

- [Speech to text using Google Cloud (voicemails to text)](https://wiki.freepbx.org/pages/viewpage.action?pageId=191138309)
- [FreePBX-VM-Transcription](https://github.com/westparkcom/FreePBX-VM-Transcription)

#### Kroko

Kroko module for Asterisk real-time transcripts.

- [Integration demos - Kroko ASR Documentation](https://docs.kroko.ai/demos/#kroko-module-for-asterisk-real-time-transcripts)
- GitHub: [https://github.com/kroko-ai/integration-demos/tree/master/asterisk-kroko](https://github.com/kroko-ai/integration-demos/tree/master/asterisk-kroko)