Skip to main content

Connect your own account

When you create a telephone channel, you can connect your own third-party speech recognition and synthesis account. Click the ASR/TTS tab and select Create connection in the Connection field. Then select your provider and fill out connection settings.

Please note that there’s no need to re-create your connection if you already use ASR/TTS from another provider. Create a connection, e.g. for ASR, then select your connection from the list under TTS.

tip
If you prefer to use your own connection, Tovie AI ASR limit does not apply to you.

Google ASR/TTS​

You need to create a JWT Token to connect Google ASR/TTS. To do this:

  1. Open the Cloud Console and click IAM & Admin in the left panel. Select Service Accounts in the left panel.
  2. Click Select a project, select the project and click Open.
  3. Find the row for the account you want to create a key for. In this row, click the  icon and select Create key from the dropdown list.
  4. Select the key type and click Create. The newly created key will be saved to your computer.
tip
You can also use other methods to create a JWT Token for Google ASR/TTS (learn more here).

Please note that the key format may be different depending on how you create it. Keys created using Cloud Console look as follows:

{
  "type": "service_account",
  "project_id": "project-id",
  "private_key_id": "key-id",
  "private_key": "-----BEGIN PRIVATE KEY-----\nprivate-key\n-----END PRIVATE KEY-----\n",
  "client_email": "service-account-email",
  "client_id": "client-id",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/service-account-email"
}

Now load your key to the connection settings when you create a channel in Tovie Platform and click Save.

Azure ASR/TTS​

To connect Azure ASR/TTS, you will need a Microsoft Azure account.

If you have an enterprise subscription to Microsoft 365, you can also set up access to Azure services via Azure Active Directory, which is included in your subscription for free.

tip
Learn more about Azure integration with Microsoft 365

The whole connection process involves the following steps:

  1. Create a new subscription so that Azure resources become available to your account.
  2. Azure resources exist within resource groups. Create a new group for your future service.
  3. In this group, create a new resource which includes the Speech service.
  4. Use the resource key and region to configure the connection in Tovie Platform.

Skip the appropriate steps if you already have a subscription, resource group, or the necessary resource.

Subscription​

Sign in to the Azure portal. In order to use Azure services, including the one providing speech recognition and synthesis, your account will need an active subscription.

To create a new subscription:

  1. Go to the Subscriptions page.
  2. Click Add and select the appropriate subscription offer.
  3. Accept the terms of service.
  4. Assign a billing account if your subscription is a paid one.

Refer to your directory administrator if you don’t have the permissions to manage subscriptions in your directory.

Resource group​

All related Azure resources are created within resource groups.

To create a new resource group:

  1. Go to the Resource groups page and click Create.

  2. Fill out all fields on the Basics tab:

    • The Subscription which the resource group will be assigned to.

    • The Resource group name.

    • The Region where the resource group infrastructure will be located.

      tip

      The recommended option is to select a region closest to the infrastructure which will utilize the service: this will help reduce network latency. You should also bear in mind the data processing regulations in your local jurisdiction. For installations based in Europe, germanywestcentral is the optimal choice.

  3. Fill out the Tags tab if necessary.

  4. Click Review + create, then Create. The resource group will be created.

Resource​

In the newly created group, create a resource which will incorporate the Speech service.

tip
Speech is a unified service package including speech recognition and synthesis, language identification, speech translation, and other features. Learn more about the Speech service
  1. Go to the new resource group and click Create.
  2. Find and select Speech in the service marketplace.
  3. Fill out all fields on the Basics tab:
    • The Subscription, Resource group, and Region should be the same as for the resource group.
    • The Name of the new resource.
    • The resource Pricing tier (learn more about pricing here).
  4. On the Network tab, leave the public access on. Fill out the other tabs if necessary.
  5. Click Review + create, then Create. The resource will be created and deployed.

Azure connection settings​

Now everything is ready to create and set up the connection.

After creating the resource, click Go to resource and navigate to the Keys and Endpoint tab. Use the data from this page to configure the ASR/TTS connection in Tovie Platform:

  • The Resource key can be any of the two available keys.
  • The Resource region should match the region where the resource is located.

The fact that there are two keys helps ensure the connection stability. If you need to regenerate one of the keys, use the other key for the connection so that it doesn’t get disrupted.

Azure resource keys, region, and endpoint

Kaldi ASR​

caution
By default, Kaldi cannot be selected as a provider. Contact your account manager if you want it to become available.

You can deploy your own speech recognition service based on the Kaldi open-source toolkit and connect it to your Tovie Platform projects.

When creating a channel in Tovie Platform and setting up the connection, specify the service URL and the API key for authorizing service calls (if there is one).