MTS SuiteVoice Transcriber is a SuiteCRM plugin that automatically transcribes audio and video attachments on Notes using AI (Google Gemini, OpenAI). Staff can get a full transcript or an AI-generated summary in seconds — directly inside the Note record — without leaving SuiteCRM.
Admin Guide
Configuration
Administration Overview
The MTS SuiteVoice Transcriber plugin includes 3 main administration areas:
| Area | Function |
|---|---|
| AI Providers | Configure AI connections (Google Gemini, OpenAI) |
| Settings | Configure transcription modes, language, limits |
| License | Enter and validate the SuiteCRM Store license key |
All admin pages are accessible via Admin > MTS SuiteVoice Transcriber.
Managing AI Providers
Create a New Provider
Go to: Admin > MTS SuiteVoice Transcriber > Settings > AI Providers tab > Add Provider
| Field | Required | Description |
|---|---|---|
| Name | ✓ | Friendly name for this provider |
| Provider Type | ✓ | gemini or openai |
| API URL | Leave blank to use the provider default endpoint | |
| API Key | ✓ (new) | API key from Google AI Studio or OpenAI platform — stored encrypted |
| Default Model | Model identifier (e.g. gemini-2.0-flash, gpt-4o-transcribe) |
|
| Active | ✓ | Only one active provider is used at a time |
Provider Types and Defaults
Google Gemini:
- Default API URL: https://generativelanguage.googleapis.com
- Models: gemini-2.0-flash, gemini-1.5-pro, gemini-1.5-flash
- Get API key at: Google AI Studio
OpenAI:
- Default API URL: https://api.openai.com/v1
- Models: gpt-4o-transcribe, whisper-1
- Get API key at: OpenAI Platform
Load Models
After entering the API key, click Load Models to auto-populate a dropdown of available models for that provider and key. This avoids typos and shows exactly what is accessible with the current key.
Test Connection
Click Test Connection to send a lightweight ping to the provider and confirm the API key and model are valid before saving.
Edit Provider
Click the edit icon on any row in the provider table. Leave the API Key field blank to keep the existing key unchanged.
Delete Provider
Click the delete icon. You will be asked to confirm. If the deleted provider was the only active one, transcription will fail until another active provider is configured.
API Key Security
API keys are encrypted using SugarBean's built-in encrypt field type. They are never stored in plaintext and never exposed in list views.
Managing Settings
Go to: Admin > MTS SuiteVoice Transcriber > Settings > Settings tab
Transcribe Options
| Option | Description | Default |
|---|---|---|
| Full Text (original language) | Enable verbatim transcript mode | On |
| Summary (original language) | Enable AI-generated summary mode | On |
| Full Text + Translate | Enable full transcript translated to local language | Off |
| Summary + Translate | Enable AI summary translated to local language | Off |
Disabled modes will not appear as action buttons on Note records.
Local Language
| Field | Description | Example |
|---|---|---|
| Language Code | BCP-47 language code for translation target | vi (Vietnamese), ja (Japanese), zh (Chinese), fr (French) |
This setting applies to both translation modes (Full Text + Translate and Summary + Translate).
Features
| Option | Description | Default |
|---|---|---|
| Enable Suggested Actions | After transcription, AI suggests creating Tasks, Meetings, etc. | On |
Limits
| Field | Description | Default |
|---|---|---|
| Max File Size (MB) | Maximum audio/video file size accepted for transcription | 50 |
| Request Timeout (seconds) | Maximum seconds to wait for AI API response (minimum 10) | 30 |
Managing the License
Go to: Admin > MTS SuiteVoice Transcriber > License
- Enter your license key in the License Key field
- Click Activate License
- Status will update to show valid/invalid and expiry date
If the license is invalid or expired: - The Settings page will show a banner warning - Transcription attempts will return an error message - Admin users will see a direct link to the License page
Renew License
Before expiry, purchase a renewal from the SuiteCRM Store. Enter the new key on the License page and activate.
Advanced Settings
Controlling Which Modes Are Available to Users
Disable unwanted transcription modes in the Settings tab. Only enabled modes appear as action buttons. This lets admins limit users to, for example, only the Summary mode to control AI token usage.
Multiple Providers
You can configure multiple providers but only one active provider is used at a time. To switch providers, deactivate the current one and activate another — or edit the Active flag directly.
Common Troubleshooting
License Banner Shown on Settings Page
- Go to Admin > MTS SuiteVoice Transcriber > License
- Verify the license key is entered correctly
- Click Activate License
- If expired, renew via the SuiteCRM Store
Transcription Returns "No active AI provider configured"
- Go to Settings > AI Providers tab
- Confirm at least one provider has Active = On
- If no providers exist, create one
Transcription Returns "File type is not supported"
The Note's attachment is not an audio or video file. Supported MIME types are: audio/mpeg, audio/mp4, audio/wav, audio/ogg, audio/webm, audio/flac, audio/x-m4a, audio/aac, audio/3gpp, video/mp4, video/webm, video/ogg, video/quicktime, video/x-msvideo.
API Error or Timeout
- Check the API key is valid and the account has quota remaining
- Increase Request Timeout in Settings for large files
- Use Test Connection on the provider to isolate the error
- Check
suitecrm.logfor detailed error messages
Transcription Buttons Not Appearing on Notes
- Run Admin > Repair > Quick Repair and Rebuild
- Clear browser cache
- Verify the plugin is installed: Admin > Module Loader > Installed Packages
Contact
- Website: mientrungsoft.com
- Email: anhnhatuit@gmail.com
- WhatsApp: +84973131884
Saving Comment...
