> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fliiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Voice Translator

> Translate text between languages and deliver audio pronunciation via Telegram

This example demonstrates Fliiq's translation capability paired with text-to-speech — translate text and get native audio pronunciation delivered straight to Telegram.

## The Setup

A user traveling to Hong Kong wanted to translate phrases on the go and hear how they should sound. They told Fliiq:

```
"I need a translator I can message on Telegram. I'll send English phrases
and I want back the Cantonese translation with audio pronunciation."
```

## How It Works

The user already had a [Telegram bot](/examples/telegram-bot) set up. Through the real-time Telegram listener, they message Fliiq directly:

```
User: How do I say "Where is the nearest MTR station?"
```

Fliiq translates the phrase, generates audio, and replies:

```
🔄 English → Cantonese

最近嘅地鐵站喺邊度？
(zeoi3 gan6 ge3 dei6 tit3 zaam6 hai2 bin1 dou6?)

"Where is the nearest MTR station?"

💡 Tip: 地鐵 (dei6 tit3) specifically means MTR/subway.
Locals will understand and point you in the right direction.

🎧 Audio pronunciation attached below.
```

The audio file follows immediately — generated by `text_to_speech` with the `Cantonese_GentleLady` voice and sent via `send_telegram_audio`.

## Multi-Language Support

The same pattern works across languages. The agent picks the right TTS voice based on the target language:

### English → Mandarin

```
User: Translate "I'd like to check in" to Mandarin

🔄 English → Mandarin

我想办理入住
(wǒ xiǎng bànlǐ rùzhù)

"I'd like to check in."

🎧 Audio attached.
```

### Cantonese → English

Translation works in both directions:

```
User: What does 唔好意思 mean?

🔄 Cantonese → English

唔好意思 (m4 hou2 ji3 si1)

Means: "Sorry" / "Excuse me" (apologetic)

Used when you've inconvenienced someone — bumping into
them, being late, asking for a favor. More apologetic
than 唔該 which is transactional.

🎧 Cantonese pronunciation attached.
```

## As a Scheduled Job

For systematic learning, set up a daily translation challenge:

```yaml theme={null}
name: daily-translations
trigger:
  type: cron
  schedule: "0 13 * * *"
prompt: |
  Pick 5 useful travel phrases and translate them to Cantonese.
  Generate audio for each phrase. Send to Telegram as a daily
  translation drill. Read memory for previous phrases to avoid repeats.
skills:
  - memory_read
  - memory_write
  - text_to_speech
  - send_telegram
  - send_telegram_audio
  - get_current_time
delivery:
  type: telegram
  chat_id: "12345678"
enabled: true
```

## Available Voices

The `text_to_speech` skill supports multiple voices for different languages and styles:

| Voice                  | Best for                         |
| ---------------------- | -------------------------------- |
| `Cantonese_GentleLady` | Cantonese translations           |
| `female-shaonv`        | Mandarin — casual/conversational |
| `male-qn-jingying`     | Mandarin — formal/professional   |

See the [full voice list](/skills/core-skills#audio) in the Core Skills reference.

## The Key Insight

Translation isn't just text — **pronunciation matters**. By pairing the LLM's translation ability with MiniMax text-to-speech and Telegram delivery, Fliiq becomes a pocket translator that you can hear. Send a message, get back a translation with audio you can play to a taxi driver, waiter, or shopkeeper.

For languages like Cantonese where tones completely change meaning, hearing the correct pronunciation is essential — not optional.