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

# Transcrição Fala para Texto

> Configure a transcrição automática e a exportação de transcrições de chamadas através de automações de fluxo de trabalho.

<Note>
  Este artigo apresenta uma configuração de fluxo de trabalho em duas partes: uma para automatizar a transcrição depois de uma gravação ser criada e outra para automatizar a exportação das transcrições através de um pedido de API.
</Note>

**Nível de utilizador:** Admin

***

<h2 id="h_b946f22507">
  Pré-requisitos
</h2>

Para aceder às funcionalidades necessárias para esta configuração, certifique-se de que:

* Foi adicionado com sucesso a um plano Expert ou Custom da CloudTalk

* O [Suporte da CloudTalk](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) ativou a funcionalidade **Fala para Texto** na sua conta

<Info>
  **A faturação de Fala para Texto depende** de optar ou não por utilizar um modelo melhorado para a transcrição, que é uma opção disponível para alguns idiomas. Numa transcrição melhorada, a tarifa é de 0.072 por minuto, enquanto no modelo predefinido a tarifa é de 0.048 por minuto.
</Info>

<h3 id="h_a5aa55703e">
  Transcrever gravações de chamadas
</h3>

Esta secção do artigo centra-se na criação da primeira automação de fluxo de trabalho, responsável pela criação da transcrição Fala para Texto.

<h4 id="h_9b0ce24436">
  Passos
</h4>

1. No seu Dashboard, aceda a **Conta -> Automações de fluxo de trabalho**.

2. Selecione **`+ Adicionar Fluxo de Trabalho`** e atribua um nome ao seu fluxo de trabalho.

3. Como **[acionador](/pt/articles/5648924-triggers)**, selecione `recording` `uploaded`.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5671571/0008a81f9fd2-stt-trigger.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=fbb879e79b75b9c4d7b4da084d954d70" alt="" width="761" height="274" data-path="images/help-center/articles/5671571/0008a81f9fd2-stt-trigger.png" />
   </Frame>

   1. `uploaded` é o único tipo de **Ação** disponível para um `recording` como **Objeto**\*.\*

   2. **Nota**: *Se não forem definidas condições, esta automação é executada para todas as gravações que sejam carregadas.*

4. **Opcional:** *Adicione condições se quiser transcrever gravações apenas nos casos em que essas condições sejam cumpridas.*

5. Selecione a **Ação** `Fala para Texto`**.**

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5671571/9c388bc139a6-stt-action.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=390e572e84b4da7aea2bcba4966fc856" alt="" width="796" height="183" data-path="images/help-center/articles/5671571/9c388bc139a6-stt-action.png" />
   </Frame>

   1. Na **Chave:** `language`, introduza a referência de idioma adequada a partir da coluna **BCP-47** na [lista de idiomas da Google Cloud](https://cloud.google.com/speech-to-text/docs/languages).

      1. **Nota:** *Embora suportemos todos os idiomas listados, nem todos têm um modelo **Enhanced Phone call** disponível.*

   2. Na **Chave:** `model`, pode [escolher um modelo de machine learning específico](https://cloud.google.com/speech-to-text/docs/transcription-model). Na maioria dos casos, `phone_call` é a melhor opção. Se tiver problemas, experimente `default`.

   3. Defina a **Chave:** `enhancedModel` como `true` para utilizar [o modelo avançado para chamadas telefónicas](https://cloud.google.com/speech-to-text/docs/enhanced-models), que otimiza a precisão.

      1. Os idiomas suportados nesta opção são: inglês (AU, GB, US), francês (CA, FR), alemão, italiano, japonês, português, russo e espanhol (US, ES).

      2. A utilização deste modelo aumenta os custos da transcrição.

6. **`Confirmar e continuar`**.

7. **`Guardar`** o seu fluxo de trabalho e ativá-lo através do interruptor no topo da página de configuração do fluxo de trabalho.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5671571/d4cb7cb2ce2f-stt-activate.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=5ebb361b43a59f141ecae56aab86dab8" alt="" width="807" height="315" data-path="images/help-center/articles/5671571/d4cb7cb2ce2f-stt-activate.png" />
   </Frame>

<h3 id="h_a572972373">
  Encaminhar transcrições para uma API externa
</h3>

Esta secção do artigo centra-se na configuração da segunda automação de fluxo de trabalho, responsável pelo processo de exportação.

1. No seu Dashboard, aceda a **Conta -> Automações de fluxo de trabalho**.

2. Selecione **`+ Adicionar Fluxo de Trabalho`** e atribua um nome ao seu fluxo de trabalho.

3. Defina um [acionador](/pt/articles/5648924-triggers) com o tipo de **Objeto** **transcription** e o tipo de **Ação** **created**. Este acionador é iniciado sempre que uma transcrição é criada.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5671571/de76b7a01446-stt-trigger-2.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=b067818dcb54bfe46ff93ed39350d82e" alt="" width="862" height="255" data-path="images/help-center/articles/5671571/de76b7a01446-stt-trigger-2.png" />
   </Frame>

4. Podemos optar por configurar uma **[condição](/pt/articles/5649346-conditions)** opcional. Escolha uma **Propriedade** dinâmica e consulte o respetivo **Valor** de exemplo na secção *Dados úteis para o seu fluxo de trabalho*, caso sejam necessárias **Condições**. Para efeitos do nosso exemplo

5. Selecione a **Ação** `Pedido de API`.

   1. Introduza o URL do **Ponto Final**. Normalmente, encontra-o na documentação da API ou no modo de programador do respetivo serviço (a não ser que esteja a utilizar uma aplicação personalizada).

      1. **Exemplo:** [`https://api.hubapi.com/engagements/v1/engagements`](https://api.hubapi.com/engagements/v1/engagements) (engagements do HubSpot)

   2. **Método:** `POST`.

      <Frame>
        <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5671571/baa804feaa31-image.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=b040edd90d3e4d9f25963d80ae5692f5" alt="" width="773" height="287" data-path="images/help-center/articles/5671571/baa804feaa31-image.png" />
      </Frame>

6. Na secção **Valores** (o corpo do pedido), inclua o seguinte par *chave*-*valor*:

   1. Na **Chave:** `transcription`, cole o **Valor:**

      `#{{ event.properties.transcription.csv }}`

      1. *Este é um valor dinâmico que referencia a transcrição a exportar, convertida para o formato CSV.*

         <Frame>
           <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5671571/2fd3bf1bdd1d-stt-dynamics.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=0ae90bbaf57c670604bbb292d66e7c98" alt="" width="1126" height="607" data-path="images/help-center/articles/5671571/2fd3bf1bdd1d-stt-dynamics.png" />
         </Frame>

7. Inclua todos os componentes necessários do pedido de API nas secções **Valores** e **Cabeçalhos** da configuração do Pedido de API, seguindo a documentação da API externa que está a utilizar para exportar os seus dados de Fala para Texto.

8. **`Confirmar e continuar`**. Guarde o seu fluxo de trabalho e ative-o através do interruptor no topo da página de configuração do fluxo de trabalho.

<h2 id="h_34446d8b73">
  Sugestões de resolução de problemas
</h2>

* Para obter informações sobre a transcrição, consulte a [lista de idiomas da Google](https://cloud.google.com/speech-to-text/docs/languages), os [modelos de transcrição](https://cloud.google.com/speech-to-text/docs/transcription-model) e os [modelos de transcrição](https://cloud.google.com/speech-to-text/docs/enhanced-models) avançados.

* Na maioria dos casos, o envio de informação para outra API (como uma API associada a um CRM ou a outra ferramenta ligada à Internet) exige uma ou mais chaves ou tokens de autorização. Se tiver dificuldade em encontrar esta informação, pergunte a um administrador que conheça a API recetora.

- As condições incorretas resultam frequentemente de valores não reconhecidos no campo **Propriedade** ou de valores no campo **Valor** que nunca produzem correspondências.

- Depois de clicar no campo **Propriedade**, *tem de clicar numa das palavras-chave pré-selecionadas* na secção **Dados úteis para o seu fluxo de trabalho**, à direita.

- Também pode consultar a secção **Dados úteis para o seu fluxo de trabalho** para validar se um **Valor** que introduziu corresponde à propriedade que escolheu.

***

*Precisa de ajuda ou tem alguma questão?* Contacte-nos através do nosso [Portal de Suporte](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — estamos aqui para si.


## Related topics

- [Exportar a transcrição de voz para texto do correio de voz](/pt/articles/6926594-export-voicemail-speech-to-text.md)
- [Ações](/pt/articles/5649782-actions.md)
- [Rácio de fala/escuta](/pt/articles/9214999-talk-listen-ratio.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.