Mobile AI Voice Chat

Overview

Mobile AI Voice Chat lets you have spoken conversations with BlueClerk's AI assistant using your phone's microphone. Speak your requests naturally, and the AI responds with short, clear spoken answers - perfect for job sites where typing isn't practical. Create customers, tickets, jobs, invoices, search your data, and get help entirely hands-free.

How to Use Voice Chat on Mobile

Starting a Voice Conversation

1. Open the AI chat panel by tapping the sparkles icon in the header
2. Tap the microphone button at the bottom of the chat input
3. Allow microphone access when your phone prompts you
4. Speak your request - the AI transcribes and processes it
5. Hear the AI response spoken through your phone speaker

What You Can Say

Use the same natural language you'd use in text chat:

• Create records: "Add a customer named John Smith at 123 Main Street"
• Search data: "Show me all invoices from last week"
• Get information: "What's the status of ticket 1234?"
• Ask questions: "How much do we charge for HVAC tune-ups?"

How Voice Response Works

Spoken Response Types

The AI responds differently based on what you ask:

Confirmations - After you create something:

• Short confirmation of what was created
• Example: "Customer added. John Smith at 123 Main Street."

Questions - When the AI needs more info:

• Brief question asking for clarification
• Example: "Which property for this job?"

Information - When you search or ask questions:

• First sentence of the answer spoken aloud
• Full answer shown in text below

Response Length

Voice responses are intentionally short (1-3 sentences max) because:

• You're probably on a job site or driving
• Long spoken responses are hard to remember
• The full text is always visible in the chat for details

Tips for Best Results

Clear Audio

• Speak clearly in a normal voice
• Reduce background noise when possible
• Hold phone close if on a loud job site
• Use headphones for better audio in noisy environments

Natural Phrasing

• Speak naturally - don't use robot commands
• Be specific - include key details in one request
• Use names - reference customers and items by name
• Follow up - the AI remembers your conversation context

When to Use Voice vs Text

Use voice for:

• Quick updates on job sites
• Creating records while driving
• Hands-free work situations
• Simple searches and status checks

Use text for:

• Complex multi-step requests
• Reviewing detailed information
• Editing line items on estimates
• When you need to reference specific IDs

Technical Details

What Gets Processed

1. Your audio is transcribed using OpenAI Whisper
2. Transcribed text goes to the AI chat system
3. AI processes your request using tools (create, search, etc.)
4. Response text is converted to speech using Google TTS
5. Audio plays through your phone speaker

AI Credits Usage

Voice chat costs the same as text chat:

• 1 credit per message for simple requests
• More for complex operations (searches, multi-step actions)
• Check Settings > AI Usage to monitor your balance

Offline Behavior

Voice chat requires an internet connection:

• Transcription happens in the cloud (Whisper API)
• AI processing requires server access
• Text-to-speech is generated server-side
• Save offline work for when you reconnect

Privacy & Security

Audio Storage

• Audio is not stored - only the transcribed text is saved
• Conversations are logged like text chat for your records
• Your data stays private - only visible to your company

Permissions

• Microphone access required - iOS/Android will ask permission
• One-time approval - you only grant permission once
• Revoke anytime - change in your phone's app settings

Troubleshooting

"Microphone not working"

• Check app permissions in phone settings
• Restart the app after granting permission
• Try closing and reopening the chat panel

"Can't hear AI response"

• Check phone volume settings
• Ensure not in silent mode
• Try using headphones

"Transcription is inaccurate"

• Speak more clearly and slower
• Reduce background noise
• Use text input for complex requests

"AI doesn't understand me"

• Break requests into smaller steps
• Use more specific names and details
• Try rephrasing your request

Questions

Q: Does voice chat work offline? A: No, voice chat requires an internet connection for transcription, AI processing, and speech generation.

Q: Can I use voice chat on the web app? A: Yes, voice chat works on both mobile and web - just click the microphone button in the AI chat panel.

Q: How much do voice messages cost? A: Voice chat uses the same AI credit system as text chat - typically 1 credit per message for simple requests.

Q: Is my voice recorded? A: No, only the transcribed text is saved. Audio is processed in real-time and not stored.

Q: Can I turn off spoken responses? A: Yes, set returnAudio: false in the voice chat settings to get text-only responses while still using voice input.