Use este guia quando você precisar configurar, entender ou validar **Como traduzir mensagens com Google Translate** na IAra.

## Antes de começar na IAra

- Confirme que seu usuário tem permissão para acessar a área citada no artigo.
- Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais.
- Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar.

## Guia detalhado

Se você recebe frequentemente perguntas em idiomas que você/os membros de sua equipe não entendem, você pode utilizar a integração do Google Tradutor na IAra. Quando ativado, você pode traduzir instantaneamente as mensagens recebidas usando o menu do botão direito. Dessa forma, você pode se comunicar facilmente com os clientes em seu idioma nativo, mesmo que você não o fale.

## Como ativar o Google Tradutor na IAra?

**Etapa 1.** Vá para Configurações -> Aplicativos -> Google Tradutor. Clique no botão "Configurar" correspondente.

**Etapa 2.** Você verá a página do aplicativo Google Tradutor. Clique no botão "Conectar".

**Etapa 3.** Insira o ID do projeto do Google Cloud e o arquivo de chave do projeto. Se precisar de ajuda para obter esses valores, consulte este [doc](https://cloud.google.com/translate/docs/setup) do Google.

Depois de inserir os valores, clique no botão "Criar".

Agora, sua integração com o Google Tradutor está completa.

### Como alterar o idioma da tradução?

Suas mensagens são traduzidas para o idioma do seu site. Para selecionar o idioma do seu site, visite a página "Configurações da conta".

**Etapa 1.** Vá para Configurações -> Configurações da conta -> Idioma do site. Abra o menu suspenso e selecione seu idioma preferido.

**Etapa 2.** Clique no botão "Atualizar configurações" no canto superior direito da página. Isso traduzirá todo o seu painel para o idioma selecionado.

**Observação:** os agentes também podem selecionar seus idiomas preferidos individuais.

## Como traduzir mensagens recebidas?

Sempre que receber uma mensagem em um idioma com o qual precisar de ajuda, clique nos 3 pontos ao lado da mensagem para abrir o menu e selecione “Traduzir”.

Encontre o conteúdo traduzido in-line.

## Como criar uma conta de serviço no Google Cloud Console?

Para criar uma conta de serviço para a API Google Translate, comece fazendo login no [Console do Google Cloud](https://console.cloud.google.com/) e selecionando ou criando um novo projeto. Quando seu projeto estiver pronto, ative a **API Cloud Translation** navegando até **“APIs e serviços” > “Biblioteca”** e pesquisando por “API Cloud Translation”. Clique em “Ativar” para ativá-lo para o seu projeto. A ativação do faturamento também é necessária, caso ainda não o tenha feito.

Em seguida, vá para **“IAM e Admin” > “Contas de serviço”** e clique em **“Criar conta de serviço”.** Forneça um nome (por exemplo, translate-api-user) e continue atribuindo a função **“Usuário da API Cloud Translation”**.

Depois de criar a conta de serviço, navegue até a seção **“Chaves”**, clique em **“Adicionar chave”** e selecione **“Criar nova chave”** no formato **JSON**. Baixe e armazene com segurança este arquivo JSON.

Use o conteúdo do arquivo que você recebeu acima no campo de entrada **Arquivo de chave do projeto do Google Cloud** na IAra.

---

## Como validar na IAra

1. Execute o fluxo em uma conta ou conversa de teste.
2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado.
3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe.

## Problemas comuns

- Usuário sem permissão para acessar a configuração.
- Nome de tela diferente entre versões ou contas.
- Recurso dependente de plano, provedor externo ou habilitação pela Digi2B.
- Falta de teste em conversa realista antes de liberar para a equipe.

## Checklist final

- [ ] Configuração revisada por um administrador.
- [ ] Teste realizado com dado ou conversa controlada.
- [ ] Impacto para agentes e gestores entendido.
- [ ] Artigos relacionados revisados para evitar links quebrados.