---
schema_version: "1"
id: c68db16a4ed85a129e0364e1bf94e801d8f5c4fd94f26139449efd3f8b8f5b1f
title: Considerations for Speech To Text Integration
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ind/264-0-0/cg_concept_speech_to_text_considerations.md
canonical_url: https://help.salesforce.com/s/articleView?id=ind.cg_concept_speech_to_text_considerations.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: ef782f41ce83a6a8def7c5143228c34208ef6f5163e19f50bfa8a830c505c224
description: Review these important considerations for setting up speech-to-text. These include changing session limits and silence detection, designing the user interface and theme, stopping sessions automatically, handling errors, and setting up offline language packs.
products:
  - Consumer Goods
release: "264"
---
# Considerations for Speech To Text Integration

Review these important considerations for setting up speech-to-text. These include changing session limits and silence detection, designing the user interface and theme, stopping sessions automatically, handling errors, and setting up offline language packs.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition">
      <colgroup>
        <col>
      </colgroup>
      <tbody>
        <tr class="">
          <td class="slds-cell-wrap" style="vertical-align:top;">
            <p>Available in: Lightning Experience </p>
            <p style="margin-bottom:0;">Available in: <strong>Enterprise</strong> and
              <strong>Unlimited</strong> Editions where Consumer Goods Cloud is enabled
            </p>
          </td>

        </tr>
      </tbody>
    </table>

## Speech-to-Text Session Limits and Customization

You can configure the speech duration and silence detection settings to fit your needs.

- Session Limits: You can start only one transcription session each time you open the Speech-to-Text screen.
- Speech Duration: Recording will stop automatically if the total speech length reaches the set limit. You can choose any duration between 1 and 180 seconds. By default, the limit is set to 180 seconds (3 minutes). See [`maxDurationSec`](https://help.salesforce.com/s/articleView?id=modeler_vscode_voicemanager_launchsttasync.htm&language=en_US).
- Silence Detection: Recording will automatically stop if there’s no sound for a set amount of time. You can choose a threshold from 1 to 30 seconds. By default, recording stops after 15 seconds of silence. See [`silenceTimeoutSec`](https://help.salesforce.com/s/articleView?id=modeler_vscode_voicemanager_launchsttasync.htm&language=en_US).
- UI Text: You can customize the title and the information text.

## User Interface and Theming

To update your branding, follow these design constraints.

You can customize the App Bar that appears when Speech-to-Text opens. These elements can’t be themed and will keep their default appearance:

- Info text
- Send, Start Listening, and Stop Listening buttons
- Input field
- Alert modals

The input text field doesn’t show a scrollbar if the transcribed text goes beyond the visible area. This is expected behavior.

## Operational Behavior

The transcription session ends automatically for users in these situations.

 
| Trigger Type | Scenario |
| --- | --- |
| Manual stop | The user taps Stop Listening. |
| Total timeout | The total speech duration reaches the configured limit. In the default setting, you can speak for up to 15 seconds. |
| Silence threshold | The user has been silent for more than 180 seconds, which is the default time limit. |
| Focus change | The user taps the text field to manually edit the text. |
| App in background | The app moves to the background when the user goes to the home screen or switches to another application. |
| Cancellation | The user stops the transcription by tapping Back and confirming the choice. |

## System and Platform Specifics (Android)

The technical requirements and constraints for Android are:

- Offline Priority: The voice SDK uses offline transcription by default, even when internet connection is available. When connected, the device uses on-device transcription.
- Device Requirements: The device must have built-in speech recognition. Compatibility with older Android versions may vary, as testing on older physical devices is limited.
- Deep Links: Deep links are disabled when the Speech-to-Text screen is open.

## Error Handling and Language Support

If transcription doesn’t work, an error appears and users can switch to manual text entry. This may happen when your:

- Device doesn’t support speech recognition.
- Device doesn’t support offline speech recognition.
- The selected language is not supported or not available for offline recognition.
- The required language model isn’t downloaded on the device.

## Language Pack Setup

Sales reps can enable offline recognition by downloading language packs to their Android mobile device and setting them up. For detailed instructions, check the documentation for your specific mobile device.