> For the complete documentation index, see [llms.txt](https://docs.chatlayer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/nlp/languages/change-language-within-the-conversation.md).

# Mudar de idioma durante a conversa

As duas soluções apresentadas abaixo andam de mãos dadas para determinar qual é o idioma favorito do usuário para interagir.

{% hint style="info" %}
Um bot que não tem nenhuma informação sobre o idioma do usuário usará automaticamente o [idioma principal](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/nlp/languages/pages/98b34870afcb1c9baeee16833e9081e7982b0873#primary-vs.-extra-languages). O idioma ativo dentro da conversa pode ser alterado dentro do fluxo.
{% endhint %}

{% hint style="danger" %}
Observe que o bot não consegue descobrir o idioma com base no que o usuário está dizendo. O que o bot pode fazer, em vez disso, é usar as informações do canal. No Facebook, por exemplo, o bot usará o valor que recebe da API do usuário do Facebook. No widget da web, ele usará o idioma do SDK.
{% endhint %}

## Ative a Detecção de idioma

Você pode usar [**Detecção de idioma**](/chatlayer-documentation-pt-br/navegacao/settings/settings.md#language-detection) para verificar se o idioma do usuário é compatível com o seu bot. Se o seu bot não suportar o idioma do usuário, redirecione a detecção de idioma para [um bloco que coleta o idioma do usuário](#collect-the-users-preferred-language).

## Colete o preferredLanguage do usuário

{% hint style="warning" %}
A variável que armazena o idioma preferido do usuário se chama `preferredLanguage`. Você pode coletar e alterar essa variável de várias maneiras.
{% endhint %}

### Com botões

Para criar um fluxo com botões que colete o `preferredLanguage`:

1. Acesse seu canvas em [**Fluxos**](/chatlayer-documentation-pt-br/navegacao/bot-builder/flows.md).
2. Crie um [**Coletar entrada** ](/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/user-input-bot-dialog.md)bloco.
3. Dentro desse bloco, pergunte ao usuário em qual idioma ele gostaria de continuar, com botões correspondentes aos idiomas do seu bot.
4. Para cada botão, defina o `preferredLanguage` **variável** com **valor** correspondente ao código do idioma escolhido.

<figure><img src="/files/21a50712480441259ffccb0fe97a8f76fde44cb0" alt="" width="278"><figcaption></figcaption></figure>

5. Preencha a parte inferior com estas informações:

<figure><img src="/files/1463a9383add990536c8bfd04dbfece16bab2ee7" alt="" width="276"><figcaption></figcaption></figure>

6. Clique em **Salvar**.

### Com um intent

{% stepper %}
{% step %}
Acesse seu [**Entidades**](/chatlayer-documentation-pt-br/navegacao/natural-language-processing-nlp/synonym-entities.md) guia.
{% endstep %}

{% step %}
[Crie um **Entidade contextual**](/chatlayer-documentation-pt-br/nlp/natural-language-processing-nlp/detect-information-with-entities/contextual-entities.md#add-contextual-entities) para o intent que acionará o fluxo para alterar o idioma.

No exemplo abaixo, criamos uma entidade chamada **@language** para identificar os idiomas disponíveis no bot e definimos um valor para eles:

* `en` para inglês
* `pt` para português
* `es` para espanhol

<figure><img src="/files/657e46d02ca0d9c59dc3b45c7466bc2e793872f2" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
[Crie um **intenção**](/chatlayer-documentation-pt-br/navegacao/natural-language-processing-nlp/intents.md#add-a-new-intent) que acionará o fluxo para alterar o idioma.

O intent deste exemplo se chama **alterar idioma** e está usando a entidade **@language**.

<div align="left"><figure><img src="/files/a2b7d2ea946265a4c5bf3bd631ce7bb616f8d9a5" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
[**Treinar** seu NLP](/chatlayer-documentation-pt-br/nlp/natural-language-processing-nlp/train-your-nlp.md).
{% endstep %}

{% step %}
Volte para o seu [**Fluxos**](/chatlayer-documentation-pt-br/navegacao/bot-builder/flows.md) e adicione seu **alterar idioma** intent ao canvas.
{% endstep %}

{% step %}
Faça o intent alterar idioma ir para um **Condição** bloco que chamaremos de **Ir para o idioma.**
{% endstep %}

{% step %}
Neste **Condição** bloco, crie condições para que sua `idioma` variável vá para o próximo bloco com o novo idioma definido como valor da `preferredLanguage` variável, como no exemplo abaixo:

<figure><img src="/files/7abfac81bd21fd3e1180f35ba75b98ad84ce0d8d" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
No final, seu fluxo deve ficar algo como isto:

<figure><img src="/files/1a7c44ae59fadf65916a0e1b5fca3a123bbe7e70" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Acione um idioma com o canal Web

No widget da web, você pode acionar um idioma específico do bot com base no idioma da página que o usuário está visualizando. Encontre mais informações sobre isso neste [aqui](/chatlayer-documentation-pt-br/channels/all-channels/web/web-v2.md#set-to-a-specific-language)[.](/chatlayer-documentation-pt-br/channels/all-channels/web/web-v2/web-v2-methods-and-options.md#change-the-language)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.chatlayer.ai/chatlayer-documentation-pt-br/nlp/languages/change-language-within-the-conversation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.