Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.voxworks.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
What are Keywords?

Keywords are a list of terms you provide to help the transcription service recognise specific words accurately. When the user speaks these terms, the transcription is more likely to capture them correctly. Common use cases:
  • Brand names — “Voxworks”, “iPhone”, company names
  • Product names — Model numbers, product lines
  • Industry terms — Technical jargon, acronyms
  • Names — Common names that might be transcribed incorrectly

​
How Keywords Work

When you add keywords to your script:
  1. The transcription service is primed to recognise these terms
  2. When audio matches a keyword, it’s more likely to be transcribed correctly
  3. The assistant receives the accurate transcription and can respond appropriately
Keywords don’t change how the assistant responds — they improve what the assistant “hears” from the user.

​
Automatic Keywords

Voxworks automatically includes certain keywords for each call without any configuration:
  • Contact name — The caller’s first and last name
  • Contact company — The caller’s business or organisation
  • Your business name — Your team’s business name
These automatic keywords mean common names and business terms are already optimised for transcription. You only need to add additional keywords for specialised terms not covered by your script content.

​
Adding Custom Keywords

Add keywords in the Script settings. Enter each term that should be recognised accurately during calls.

​
Examples

A law firm might add: 
power
attorney
affidavit
litigation
deposition
A tech company might add: 
Voxworks
API
OAuth
webhook
A healthcare provider might add: 
paracetamol
Ibuprofen
referral
GP

​
Best Practices

  1. Use single words where possible — Better performance is achieved with single words. For example, add “Power” and “Attorney” as separate keywords rather than “Power of Attorney”
  2. Two words maximum — Keywords should be two words or less for best results
  3. Avoid common words — Don’t include words like “the”, “and”, “is”, or other everyday terms
  4. Keep the list focused — Aim for 20 keywords or fewer. A targeted list is more effective than an exhaustive one
  5. Match your desired capitalisation — Keywords are transcribed as entered, so ensure capitalisation matches how you want terms to appear
  6. Focus on problem words — Only add terms that are commonly misheard or important to get right
  7. Test and refine — Review call recordings and transcripts to identify words that need adding

​
Limitations

Keywords improve transcription but cannot guarantee perfect accuracy. Factors like audio quality, background noise, and speaker clarity still affect results. For guidance on handling of accents and soft speech, see Assistant Behaviour.