> For the complete documentation index, see [llms.txt](https://docs.fortics.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/chat-center/como-configurar-o-google-stt-transformando-audio-em-dados.md).

# Como configurar o Google STT: Transformando áudio em dados

Como configurar o Google STT: Transformando áudio em dados

O **Google STT** utiliza a infraestrutura de ponta do Google Cloud para converter mensagens de voz em texto em tempo real. Isso permite que o seu fluxo processe informações enviadas por áudio, facilitando a vida do agente e permitindo que [tecnologias como a Análise de Sentimento](/perguntas-frequentes/perguntas-frequentes-1/chat-center/analise-de-sentimento-com-google.md) funcionem mesmo em conversas por voz.

{% hint style="warning" icon="lightbulb-exclamation-on" %}
**##Dica**

A integração com o Google STT permite que as mensagens de voz recebidas sejam transcritas automaticamente na tela de atendimento. Isso garante que o **agente compreenda o contexto do áudio rapidamente pela leitura**, sem a necessidade de ouvi-lo, otimizando o tempo de resposta e mantendo o foco na conversa.
{% endhint %}

Para ativar a transcrição no seu fluxo, você deve acessar as configurações de **Edição** do fluxo e alterar a chave do **STT (Transcrição de áudio)** para **Ligado**.

<div align="left"><figure><img src="/files/GsYXKl6y5iPJhLAAmcnX" alt=""><figcaption></figcaption></figure></div>

No formulário exibido, preencha os campos da seguinte forma:

**Reconhecimento de fala (STT)**: Selecione a opção **Google.**

{% hint style="warning" icon="lightbulb-exclamation-on" %}
\##Dica

Mantenha todo o seu setup dentro do ecossistema da Fortics utilizando a IA como ferramenta para o seu SST acessando o tutorial de <mark style="color:$danger;">configuração da IA aqui.</mark>
{% endhint %}

**Idioma:** Selecione o idioma principal dos seus clientes (ex.: **Portuguese (Brazil)**). Isso é fundamental para que a IA entenda corretamente os fonemas e gírias locais.

**Credencial do Google (JSON):** Clique em "**Selecionar arquivo”** e envie o arquivo de credenciais JSON gerado no Console do Google Cloud. Nos próximos passos, você verá como obter esse JSON para o Google STT dentro deste tutorial.

**Validador de áudio:** Este campo permite inserir uma URL de um arquivo de áudio para realizar um teste imediato. Após colar o link, clique no botão **“Testar”** para validar se a integração e a credencial estão funcionando corretamente.

### Pegando a credencial do Google STT

Google Cloud Console: Acesse o[ Google Cloud Console](https://console.cloud.google.com/) e faça login com sua conta Google.

<div align="left"><figure><img src="/files/52gPujNh9cKwBc9KnFov" alt=""><figcaption></figcaption></figure></div>

Na parte superior da tela, ao lado do logotipo do Google Cloud, verifique o projeto que você está usando.

<div align="left"><figure><img src="/files/s7CyyX5VzydMAPrwUswW" alt=""><figcaption></figcaption></figure></div>

#### Ativando a API Cloud Natural Language&#x20;

Se o projeto exibido não for o correto, clique no nome do projeto e selecione outro existente ou crie um novo.

Com o projeto correto selecionado, procure no menu por **API e Serviços > Bibliotecas**, como na imagem abaixo.

<div align="left"><figure><img src="/files/i9001ErlxsMwRyZ8KUA4" alt=""><figcaption></figcaption></figure></div>

Na tela da biblioteca, localize a API **“Cloud Speech-to-Text API”**. Use o campo de busca para encontrá-la rapidamente.

Na lista de resultados, selecione “Cloud Speech-to-Text API” para abrir os detalhes da API. Em seguida, clique em Ativar para liberar o uso da API e garantir a continuidade da configuração.

<div align="left"><figure><img src="/files/LOnrX47Fp8UM6HmJO5Z9" alt=""><figcaption></figcaption></figure></div>

Considere que esta é uma ferramenta paga do Google. Para utilizá-la, configure o faturamento no Google Cloud. Se o projeto ainda não tiver faturamento ativo, o sistema exibirá um alerta.

Se o faturamento já estiver configurado no projeto, você será direcionado automaticamente para a tela da API. Nesse caso, avance para a etapa **“Configurando as credenciais de acesso à API”** e otimize seu fluxo de configuração.

<div align="left"><figure><img src="/files/gy4y91fEJckTpOEmWf4e" alt=""><figcaption></figcaption></figure></div>

Se você já tiver uma forma de pagamento cadastrada no Google Cloud, selecione a conta desejada e vincule-a ao projeto.

<div align="left"><figure><img src="/files/NcfvYmGwZrSbZ7kNp2h7" alt=""><figcaption></figcaption></figure></div>

Se ainda não houver uma [<mark style="color:$primary;">conta de faturamento cadastrada no Google Cloud</mark>](/perguntas-frequentes/perguntas-frequentes-1/chat-center/cadastrando-uma-conta-de-faturamento-no-google-cloud.md), acesse o tutorial e configure uma para garantir a continuidade da integração.

#### Configurando as credenciais de acesso à API

Após ativar a API, você será direcionado automaticamente para o painel da API, conforme a imagem abaixo.

<div align="left"><figure><img src="/files/9qxnjHMns6T3M5JFDg6r" alt=""><figcaption></figcaption></figure></div>

No menu lateral, acesse “**Credenciais**” e crie uma nova “**Conta de serviço**” para configurar o acesso à API com segurança e controle.&#x20;

<div align="left"><figure><img src="/files/a7xsFpj3gerXQ73oSMFx" alt=""><figcaption></figcaption></figure></div>

Selecione o botão **“Criar credenciais** + ” e no menu suspenso selecione a opção **“Contas de Serviço”.**

Será exibido um formulário em três etapas para configurar a chave de acesso.

<div align="left"><figure><img src="/files/NH0Fi0CJsBznKGOD4Co2" alt=""><figcaption></figcaption></figure></div>

Na primeira etapa, preencha as informações de cadastro para identificar a conta de serviço no Google Cloud.

**Nome da conta de serviço**: defina um nome para a sua conta.

**ID da conta de serviço:** A ID será criada automaticamente com base no nome criado.

**Descrição da conta de serviço:** Informe de forma clara para qual finalidade essa chave será utilizada.

As etapas 2 e 3 tratam de configurações de segurança. Ajuste essas opções se quiser adicionar camadas extras de controle no uso da chave. Para manter a eficiência e avançar na configuração, siga sem alterações neste tutorial. Se precisar aprofundar,[ acesse a documentação oficial do Google](https://docs.cloud.google.com/iam/docs/manage-access-service-accounts?hl=pt_BR).

Clique em **Concluído** para finalizar a criação da conta de serviço.

Após concluir, o sistema redireciona você para a tela de credenciais, onde a nova conta de serviço já aparece na lista, garantindo mais controle e continuidade na configuração.

<div align="left"><figure><img src="/files/EnsknWhgVUThKVG9lAhO" alt=""><figcaption></figcaption></figure></div>

Agora, clique no nome da conta de serviço recém-criada para acessar as configurações, conforme a imagem abaixo.

<div align="left"><figure><img src="/files/zjituzglBdbJ44uoVmJp" alt=""><figcaption></figcaption></figure></div>

Acesse a aba **Permissões**&#x20;

<div align="left"><figure><img src="/files/DDaZJj7pbRCYIq2BPpoJ" alt=""><figcaption></figcaption></figure></div>

Clique em **“Gerenciar acessos”.**&#x20;

<div align="left"><figure><img src="/files/Zi94Ro7hO2qy5b3fZapQ" alt=""><figcaption></figcaption></figure></div>

Na janela exibida, clique em “**+ Adicionar papel**”.

<div align="left"><figure><img src="/files/Wbfa8RWSO8LsDraULS9I" alt=""><figcaption></figcaption></figure></div>

No menu exibido, pesquise por “**Administrador de armazenamento”** e clique em **Salvar** para aplicar a permissão.

<div align="left"><figure><img src="/files/7kBlX6P5mnILFGoegoH7" alt=""><figcaption></figcaption></figure></div>

Acesse a aba **“Chaves”** e inicie a criação de uma nova chave para habilitar a autenticação da conta de serviço.

<div align="left"><figure><img src="/files/yMOiRy0A4V616tjxuJyh" alt=""><figcaption></figcaption></figure></div>

Clique em “**Adicionar chave”** e, no menu suspenso, selecione **“Criar nova chave”** para gerar a credencial de acesso com segurança e garantir a continuidade da configuração.

<div align="left"><figure><img src="/files/tm3ULbz03La2hyloKh0Q" alt=""><figcaption></figcaption></figure></div>

Selecione a opção **“JSON”** na janela exibida e clique em **Criar** para gerar a chave de acesso.

<div align="left"><figure><img src="/files/H93QSS5eGzo5ZqPMbwJl" alt=""><figcaption></figcaption></figure></div>

O arquivo JSON é baixado automaticamente pelo navegador após a exibição da mensagem de confirmação.

<div align="left"><figure><img src="/files/MO26cCKOBQlGWKS0kR9R" alt=""><figcaption></figcaption></figure></div>

### Finalizando a configuração no Chat Center

De volta ao Chat Center, clique em **“Selecionar arquivo”** no campo **Credencial do Google (JSON)** e envie o arquivo gerado para concluir a configuração.

<div align="left"><img src="/files/QmNRU6niO4lJEFdLIzsb" alt="" height="731" width="559"></div>

<br>


---

# 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.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/chat-center/como-configurar-o-google-stt-transformando-audio-em-dados.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.