# Set up a Multi-language IVR

An IVR (Interactive Voice Response) is the automated menu that answers a call and asks the caller to press a key. A multi-language IVR greets callers, lets them pick a language, and then continues the interaction in that language. Once a caller makes a selection, every following system prompt plays in the chosen language and the call is sent to a destination you assign to that option. The result is a smoother experience for a mixed-language audience and calls that land with the right team.

## Requirements

Your Cloud Voice system must be running version 84.14.0.24 or later.

:::caution
Confirm the version before you begin. On older builds the **Language** checkbox described in Step 3 does not exist, so the multi-language feature cannot be enabled.
:::

## Step 1. Plan the language menu

Before you touch any settings, decide how the menu should behave. Map out three things for every language you want to offer:

- The languages the IVR will announce.
- The keypad digit a caller presses to choose each language.
- Where the call goes after each selection.

:::note
Build the routing destinations first. Each target you plan to use, an extension, another IVR, a queue, and so on, needs to already exist on the system before you can point a key at it.
:::

As an example, the table below sketches a two-option menu offering English and Mandarin.

| Language | Key | Destination |
|----------|-----|-------------|
| English | Key 1 | IVR: English (6202) |
| Mandarin | Key 2 | Queue: Mandarin-agents (6400) |

## Step 2. Upload the greeting prompt

The IVR needs an audio file that reads out the language choices and the key for each one.

1. Record a prompt that lists the options, for example: "Welcome. For English, press 1. For Mandarin, press 2."

   :::tip
   Speak each option in its own language so callers who do not understand your main language can still follow along. Say the English instruction in English, then repeat the Mandarin instruction in Mandarin.
   :::
2. Add the audio file to the system:
   1. Sign in to the web portal and open **PBX Settings > Voice Prompt > Custom Prompts**.
   2. Click **Upload** and choose your audio file.

      ![Custom Prompts page with the Upload control for adding a recorded greeting](/images/pbx/upload-voice-prompts.png)
   3. Click **Save**, then **Apply**.

## Step 3. Build the IVR

1. Go to **Call Features > IVR** and click **Add**.
2. On the **Basic** tab, set up the general options for the IVR.

   ![IVR Basic tab with the Prompt drop-down open for choosing a greeting](/images/pbx/ivr-select-prompt.png)

   1. Open the **Prompt** drop-down and pick the greeting you uploaded in Step 2.
   2. Fill in the rest of the basic settings to suit your needs.
3. Open the **Key Press Event** tab and turn on the language feature.

   ![Advanced Settings dialog with the Language option selected to enable per-key language routing](/images/pbx/enable-language-for-ivr.png)

   1. In the top-right corner, click **Advanced Settings**.
   2. In the dialog that opens, select the **Language** checkbox.
   3. Click **Confirm**.
4. Define a key event for each language you planned in Step 1.

   ![Key press row showing a destination and a system prompt language assigned to a single digit](/images/pbx/ivr-language-key-event-settings.png)

   - **Destination**: Choose where the call goes when a caller presses this key.
   - **Allow Opt-out of Call Recording** (optional): Select this to keep calls routed through this key from being recorded, even when [Call Recording](/pbx/administrator-guide/call-recording-overview/) is on.
   - **Language**: Pick the language for system prompts. From this point on, the caller hears system prompts in the language tied to the key they pressed.

     :::note
     The languages in this list are pulled from your installed System Prompts. If a language you planned in Step 1 is not showing, add it first under **PBX Settings > Voice Prompt > System Prompt**, then come back to this drop-down.
     :::
5. Click **Save**, then **Apply**.

## What callers experience

A caller reaching the IVR first hears your greeting asking them to choose a language. After they press a key, every system prompt that follows plays in the language assigned to that key, your own custom recordings are unaffected, and the call is handed off to the destination you set for that option.