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

# Voices and Languages

> At NLPearl, we offer a wide variety of languages and accents to cater to a global audience. You can configure your Pearl to handle conversations in multiple languages, providing a seamless and personalized experience for your users.

<div className="block dark:hidden">
  <Frame>
    <div className="p-1">
      <img src="https://mintcdn.com/nlpearl/tAyL-PAMsD9LnbQ9/images/light_mode/language_cover.svg?fit=max&auto=format&n=tAyL-PAMsD9LnbQ9&q=85&s=e6c829440969222e0328446de3b1a388" alt="Voices and Languages cover" className="rounded-[14px]" width="1048" height="720" data-path="images/light_mode/language_cover.svg" />
    </div>
  </Frame>
</div>

<div className="hidden dark:block">
  <Frame>
    <div className="p-1">
      <img src="https://mintcdn.com/nlpearl/tAyL-PAMsD9LnbQ9/images/dark_mode/language_cover.svg?fit=max&auto=format&n=tAyL-PAMsD9LnbQ9&q=85&s=0573c19116786202d5b393d904a948e6" alt="Voices and Languages cover" className="rounded-[14px]" width="1048" height="720" data-path="images/dark_mode/language_cover.svg" />
    </div>
  </Frame>
</div>

***

### Configuring Agent Names, Languages & Voices

When creating or editing your Pearl, you can set up multiple agents with different languages and voices. This flexibility allows your Pearl to engage in conversations in more than one language and switch smoothly between them as needed.

***

#### How to Add Multiple Languages and Voices

<Steps>
  <Step title="Agent Names, Languages & Voices Section">
    This section combines the configuration of your agent's name, language, and voice.

    <div className="block dark:hidden">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/DSJnNLmkdffV1qq-/images/light_mode/language_section.jpg?fit=max&auto=format&n=DSJnNLmkdffV1qq-&q=85&s=6c0dbf6966705234719e77c61ea72537" alt="Send Email action interface on light mode" className="rounded-[14px]" width="2868" height="1066" data-path="images/light_mode/language_section.jpg" />
        </div>
      </Frame>
    </div>

    <div className="hidden dark:block">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/OLkkXJCUYovrG0y1/images/dark_mode/language_section.jpg?fit=max&auto=format&n=OLkkXJCUYovrG0y1&q=85&s=aab26aaf00733ba164c852bd801ee70b" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="2868" height="1066" data-path="images/dark_mode/language_section.jpg" />
        </div>
      </Frame>
    </div>
  </Step>

  <Step title="Add a New Language">
    * Click on the **"+"** button to add a new agent configuration.

    <div className="block dark:hidden">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/DSJnNLmkdffV1qq-/images/light_mode/language_plus.jpg?fit=max&auto=format&n=DSJnNLmkdffV1qq-&q=85&s=3096e442efc24744aacc329a76ef892a" alt="Send Email action interface on light mode" className="rounded-[14px]" width="2868" height="1066" data-path="images/light_mode/language_plus.jpg" />
        </div>
      </Frame>
    </div>

    <div className="hidden dark:block">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/OLkkXJCUYovrG0y1/images/dark_mode/language_plus.jpg?fit=max&auto=format&n=OLkkXJCUYovrG0y1&q=85&s=7bdea129b93fd3134583fd446508caf9" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="2868" height="1066" data-path="images/dark_mode/language_plus.jpg" />
        </div>
      </Frame>
    </div>

    * For each agent configuration, you can set:
      * **Agent Name**: The name that the agent will use during conversations in that language.
      * **Language**: Select the desired language from the supported list.
      * **Voice**: Choose a voice corresponding to the selected language. Voices come with labels indicating the accent (e.g., "en-US" for American English).

    <div className="block dark:hidden">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/DSJnNLmkdffV1qq-/images/light_mode/language_multi.jpg?fit=max&auto=format&n=DSJnNLmkdffV1qq-&q=85&s=110eb5633b60791bb6cfdc4199884189" alt="Send Email action interface on light mode" className="rounded-[14px]" width="2868" height="1066" data-path="images/light_mode/language_multi.jpg" />
        </div>
      </Frame>
    </div>

    <div className="hidden dark:block">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/OLkkXJCUYovrG0y1/images/dark_mode/language_multi.jpg?fit=max&auto=format&n=OLkkXJCUYovrG0y1&q=85&s=e366c5811da8f49e4b6701f47e38f3a6" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="2868" height="1066" data-path="images/dark_mode/language_multi.jpg" />
        </div>
      </Frame>
    </div>
  </Step>

  <Step title="Default Language">
    * The first agent configuration you add is set as the **default**.
    * This is the language your Pearl will use to start the conversation.

    <div className="block dark:hidden">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/DSJnNLmkdffV1qq-/images/light_mode/language_default.jpg?fit=max&auto=format&n=DSJnNLmkdffV1qq-&q=85&s=56b8951ff93dc619b847f7b811fef8d6" alt="Send Email action interface on light mode" className="rounded-[14px]" width="2868" height="1066" data-path="images/light_mode/language_default.jpg" />
        </div>
      </Frame>
    </div>

    <div className="hidden dark:block">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/OLkkXJCUYovrG0y1/images/dark_mode/language_default.jpg?fit=max&auto=format&n=OLkkXJCUYovrG0y1&q=85&s=950c550163343913566fb2ceb8000b3a" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="2868" height="1066" data-path="images/dark_mode/language_default.jpg" />
        </div>
      </Frame>
    </div>

    <br />

    <div className="block dark:hidden">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/DSJnNLmkdffV1qq-/images/light_mode/language_opening-sentence.jpg?fit=max&auto=format&n=DSJnNLmkdffV1qq-&q=85&s=e9025fb2d772f00f8023f85a3c12aa7c" alt="Send Email action interface on light mode" className="rounded-[14px]" width="2868" height="1066" data-path="images/light_mode/language_opening-sentence.jpg" />
        </div>
      </Frame>
    </div>

    <div className="hidden dark:block">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/OLkkXJCUYovrG0y1/images/dark_mode/language_opening-sentence.jpg?fit=max&auto=format&n=OLkkXJCUYovrG0y1&q=85&s=734274817faba48cb5af0b694d121619" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="2868" height="1066" data-path="images/dark_mode/language_opening-sentence.jpg" />
        </div>
      </Frame>
    </div>
  </Step>

  <Step title="Accents">
    Use the accent labels to select the voice that best suits your target audience.

    <div className="block dark:hidden">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/DSJnNLmkdffV1qq-/images/light_mode/language_accents.jpg?fit=max&auto=format&n=DSJnNLmkdffV1qq-&q=85&s=88ac6efa8e4cab8e3fb73e4f6392db39" alt="Send Email action interface on light mode" className="rounded-[14px]" width="2868" height="1066" data-path="images/light_mode/language_accents.jpg" />
        </div>
      </Frame>
    </div>

    <div className="hidden dark:block">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/OLkkXJCUYovrG0y1/images/dark_mode/language_accents.jpg?fit=max&auto=format&n=OLkkXJCUYovrG0y1&q=85&s=264a358043d5616a60d6355424d863f3" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="2868" height="1066" data-path="images/dark_mode/language_accents.jpg" />
        </div>
      </Frame>
    </div>
  </Step>
</Steps>

<Note>
  Switching Languages During a Call

  * If, during the conversation, the caller requests to switch to another language, and you've added that language to your agent configurations, Pearl will smoothly handle the transition.
  * The agent will inform the caller that they will be transferred to a representative who speaks the requested language.
  * The conversation will then continue with the agent configured for that language.
</Note>

***

### Supported Languages and Accents

Currently, NLPearl.AI supports the following languages and accents:

| **Language**   | **Accent(s)**                                                  | **Locale Code(s)**                                   |
| -------------- | -------------------------------------------------------------- | ---------------------------------------------------- |
| **English**    | American, Australian, British, South African, Indian, Scotland | `en-US`, `en-AU`, `en-UK`, `en-ZA`, `en-SC`, `en-HI` |
| **French**     | French, Canadian French                                        | `fr-FR`, `fr-CA`                                     |
| **Italian**    | Italian                                                        | `it-IT`                                              |
| **Spanish**    | Spanish, Argentine, Colombian, Mexican                         | `es-ES`, `es-AR`, `es-CO`, `es-MX`                   |
| **Dutch**      | Dutch                                                          | `nl-NL`                                              |
| **German**     | German                                                         | `de-DE`                                              |
| **Hindi**      | Hindi                                                          | `hi-IN`                                              |
| **Japanese**   | Japanese                                                       | `ja-JP`                                              |
| **Mandarin**   | Chinese Mandarin                                               | `zh-CN`                                              |
| **Korean**     | Korean                                                         | `ko-KR`                                              |
| **Russian**    | Russian                                                        | `ru-RU`                                              |
| **Portuguese** | Brazilian Portuguese, European Portuguese                      | `pt-BR`, `pt-PT`                                     |
| **Turkish**    | Turkish                                                        | `tr-TR`                                              |
| **Vietnamese** | Vietnamese                                                     | `vi-VN`                                              |
| **Polish**     | Polish                                                         | `pl-PL`                                              |
| **Arabic**     | Levantine Arabic                                               | `ar-LEV`                                             |
| **Greek**      | Greek                                                          | `el-GR`                                              |
| **Hebrew**     | Hebrew                                                         | `he-IL`                                              |
| **Indonesian** | Indonesian                                                     | `id-ID`                                              |

***

<Card icon="circle-info" iconType="light">
  ### Important Notes

  * **Language Consistency**:
    * Ensure that your conversational flow and scripts are consistent with the languages you've configured.
    * For example, if you have English and Spanish agents, provide scripts in both languages.

  * **Default Language**:
    * The default language is crucial as it determines how the conversation begins.
    * Make sure the default language aligns with the expectations of your target audience.

  * **Accents and Regional Variations**:
    * Choose accents that best match your audience to enhance the user experience.
</Card>

***

### Expanding Language Support

We are continuously working to expand our range of supported languages and accents to meet the diverse needs of our users. Stay tuned for updates as we grow our offerings.

<Note>
  Feedback and Requests

  If you have specific language or accent requirements that are not currently supported, please reach out to our support team. We are committed to accommodating your needs and will consider your requests as we expand our capabilities.
</Note>

***

<CardGroup cols={2}>
  <Card title="Create Your Pearl" icon="subtitles" iconType="light" href="/pages/create_pearl">
    Learn how to create a Pearl and configure multiple languages and voices.
  </Card>

  <Card title="Contact Support" icon="headset" iconType="light" href="mailto:support@nlpearl.ai">
    Contact our support team to request additional languages or accents.
  </Card>
</CardGroup>