> ## 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.

# Enviar transcrições para o Slack

> As nossas automações de fluxo de trabalho permitem encaminhar as chamadas transcritas para o Slack da sua empresa.

<Note>
  Crie um fluxo de trabalho para enviar automaticamente as transcrições de chamadas para um canal do Slack.
</Note>

**Nível de utilizador:** Admin

***

<h2 id="h_3248403432">
  Criar a aplicação CloudTalk no Slack
</h2>

Antes de enviar chamadas de API para o Slack, tem de criar uma aplicação CloudTalk e autorizá-la a publicar nos canais designados.

1. Na página [Slack API apps](https://api.slack.com/apps), selecione **`Create an App`**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/5959405/a05e9cfb6a36-screenshot-2023-12-13-at-11-49-52.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=8c24b99b69943fa5430ac75f942dd7af" alt="" width="2406" height="872" data-path="images/help-center/articles/5959405/a05e9cfb6a36-screenshot-2023-12-13-at-11-49-52.png" />
   </Frame>

2. Selecione **From scratch**.

3. Introduza `CloudTalk` como **App Name** e selecione o workspace Slack da sua empresa.

4. **`Create App`**.

5. Aceda a **Features** **>** **Incoming Webhooks** nas páginas da aplicação.

   1. Ative **Activate Incoming Webhooks**.

      <Frame>
        <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/5959405/4a2be47ca83e-activate-incoming-webhooks.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=fbed9c09cec452b114c95b9b7e8698ed" alt="" width="1814" height="872" data-path="images/help-center/articles/5959405/4a2be47ca83e-activate-incoming-webhooks.png" />
      </Frame>

6. Aceda a **Features >** **OAuth & Permissions**.

   1. Em *Scopes* **> Bot Token Scopes**, selecione **`Add an OAuth Scope`**.

      1. Selecione o âmbito **chat:write.customize**.

      2. Selecione **`Add scopes`** quando lhe for pedido para adicionar **chat:write**.

      3. Selecione **chat:write.public** como o último âmbito desta secção.

         <Frame>
           <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/5959405/ea88f15da8d2-adding-bot-scopes.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=b3acbef2b2047139a8c7b8a644570136" alt="" width="400" data-path="images/help-center/articles/5959405/ea88f15da8d2-adding-bot-scopes.png" />
         </Frame>

   2. Em *Scopes* **> User Token Scopes**, selecione **`Add an OAuth Scope`**.

      1. Selecione **chat:write**.

7. Aceda a **Settings > Install App** e selecione **`Install to Workspace`**.

8. Escolha o canal onde pretende que a sua aplicação CloudTalk publique. **Allow**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/5959405/f667fab921e2-test-app-auth-to-channel.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=b50618ede20cb66b2d8b3644d2cf10e1" alt="" width="400" data-path="images/help-center/articles/5959405/f667fab921e2-test-app-auth-to-channel.png" />
   </Frame>

9. Quando for reencaminhado para **Settings > Install App**, poderá ver o **User OAuth Token** e o **Bot User OAuth Token**. Terá de copiar um destes valores ao configurar o seu fluxo de trabalho.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/5959405/981abab211bd-user-oauth-token-copy.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=5a74b7f8da5c8261f131742e0489e490" alt="" width="400" data-path="images/help-center/articles/5959405/981abab211bd-user-oauth-token-copy.png" />
   </Frame>

<Warning>
  **Se o administrador que configura a automação de fluxo** **de trabalho** não estiver adicionado ao canal que selecionou para publicação, terá de utilizar o **Bot User OAuth Token** para o valor `token` nos passos seguintes. Isto acontece porque o **User OAuth Token** só permite publicar em canais onde o utilizador CloudTalk associado esteja adicionado.
</Warning>

***

<h2 id="h_e42db0933e">
  Encaminhar transcrições para o Slack
</h2>

Neste exemplo, vamos precisar de utilizar dois fluxos de trabalho: um para automatizar a criação das transcrições e outro para automatizar o processo de exportação dessas transcrições depois de concluídas.

**Objetivo:**

* Transcrever todas as gravações de chamadas.

* Encaminhar essas transcrições para o Slack.

<h3 id="h_ffc90e97d3">
  Pré-requisitos
</h3>

* Ativou com sucesso um plano Expert ou Custom com a CloudTalk

* O suporte da [CloudTalk](mailto:support@cloudtalk.io) ativou a funcionalidade **Fala para Texto** na sua conta

* Criou uma aplicação CloudTalk no Slack e ligou-a ao canal Slack pretendido (consulte [Criar a aplicação CloudTalk no Slack](#h_3248403432))

* As permissões de token do seu canal Slack incluem permissões **chat:write**, ou seja, o seu espaço de trabalho permite que dados provenientes de outra aplicação sejam publicados nos canais do Slack em vez de um utilizador individual. Pode consultar o guia de ajuda da API do Slack para [saber como funcionam os tokens do Slack](https://api.slack.com/authentication/token-types).

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

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)**. Neste exemplo, o nosso acionador será sempre que uma gravação for carregada. Em **Objeto**, vamos selecionar **recording**. Em **Ação**, selecionamos **uploaded**.

   *Nota: Esta é a única ação disponível para um Objeto recording.*

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

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

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/5959405/1ec69202d16b-stt-usefulldata.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=d198064b8b69d56a55e62ce6f0ab37cb" alt="" width="1223" height="680" data-path="images/help-center/articles/5959405/1ec69202d16b-stt-usefulldata.png" />
   </Frame>

5. O passo seguinte é escolher um tipo de [ação](/pt/articles/5649782-actions) que ocorrerá sempre que uma gravação for carregada. Selecionamos **Tipo de ação > Fala para Texto.**

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/5959405/b7d24c96280c-stt-action.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=ad42faa88e0f2114821a790934c8ed3d" alt="" width="810" height="220" data-path="images/help-center/articles/5959405/b7d24c96280c-stt-action.png" />
   </Frame>

   1. Para **Chave > language**, introduza na caixa **Valor** o idioma adequado às nossas gravações. Escolha na [lista de idiomas do Google Cloud](https://cloud.google.com/speech-to-text/docs/languages) e copie/cole o código indicado na coluna **BCP-47** correspondente**.**

   2. Para **Chave > model**, pode [escolher um modelo específico de machine learning](https://cloud.google.com/speech-to-text/docs/transcription-model). Na maioria dos casos, o modelo **phone\_call** é suficiente para a plataforma CloudTalk.

   3. Quando **Chave > enhancedModel** está definido como **true**, é aplicado [um modelo mais avançado](https://cloud.google.com/speech-to-text/docs/enhanced-models), otimizado para a precisão. No entanto, esta opção aumenta os custos de transcrição.

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

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

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

<h3 id="h_d0be96e965">
  Encaminhar transcrições para o Slack
</h3>

Na secção anterior deste artigo, configurámos a nossa automação de fluxo de trabalho para garantir a criação de uma transcrição de Fala para Texto. Na próxima secção, vamos configurar o fluxo de trabalho para enviar esta transcrição para o workspace do Slack à sua escolha.

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.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/5959405/930344ce4c3e-stt-slack-name.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=d0a86a93637ac5a90059994a15c2cfe8" alt="" width="394" data-path="images/help-center/articles/5959405/930344ce4c3e-stt-slack-name.png" />
   </Frame>

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

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/5959405/de76b7a01446-stt-trigger-2.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=c4fd419bbd32e12ddab6f634db11b76f" alt="" width="862" height="255" data-path="images/help-center/articles/5959405/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 exemplo de **Valor** na secção *Dados úteis para o seu fluxo de trabalho*, caso sejam necessárias **Condições**. Para efeitos do nosso exemplo, não precisamos de nenhuma. Podemos clicar em **`Skip and continue without action`**.

5. O passo seguinte é escolher uma [ação](/pt/articles/5649782-actions) que ocorrerá quando as nossas condições forem cumpridas. Selecionamos **Tipo de ação > Enviar notificação para o Slack.**

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/5959405/91cba79119d3-stt-slack-action.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=48d3f9bf6d5c548d98dfb0dce90e7a47" alt="" width="765" height="224" data-path="images/help-center/articles/5959405/91cba79119d3-stt-slack-action.png" />
   </Frame>

6. Em *Valores*, devem aparecer várias Chaves com as respetivas caixas já preenchidas. Estas não podem ser editadas. A entrada `token` deve preencher automaticamente a primeira caixa **Chave** . Os `x's` que preenchem a caixa **Valor** correspondente à **Chave:** `token` são apenas marcadores de posição. Para estabelecer ligação ao Slack, temos de introduzir o **User OAuth token** OU o **Bot User OAuth Token** que se encontra nas definições da sua aplicação Slack (consulte [Criar a aplicação CloudTalk no Slack](#h_3248403432)).

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/5959405/1072873aead6-image.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=62489993a665a9939196a682eba5d36a" alt="" width="821" height="380" data-path="images/help-center/articles/5959405/1072873aead6-image.png" />
   </Frame>

   1. O **Bot User OAuth** permite publicar em qualquer canal público do Slack, enquanto o **User OAuth** exige que esteja adicionado ao canal.

   2. *Consulte o [centro de ajuda do Slack](https://slack.com/help/articles/215770388-Create-and-regenerate-API-tokens) para obter mais orientações sobre os tokens do Slack.*

7. Introduza o nome do seu canal Slack na caixa **Valor** da **Chave:** `channel`. Neste caso, o nome do nosso canal Slack é **#call-transcript**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/5959405/de3ba1672a2a-image.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=d8466f2570577c6ba2f455e0c13f1363" alt="" width="687" height="293" data-path="images/help-center/articles/5959405/de3ba1672a2a-image.png" />
   </Frame>

8. Junto a **Chave:** `text`, optamos por introduzir um *valor dinâmico*, ou seja, um valor que será preenchido com base em informações do sistema. Para o fazer, clicamos na caixa **Valor** da **Chave:** `text` e, em seguida, clicamos numa palavra-chave da secção **Dados úteis para o seu fluxo de trabalho**. Ao clicar no `blue + sign` junto a **transcription**, abrem-se mais opções, a partir das quais podemos escolher o formato de ficheiro **`json`** ou **`csv`**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/5959405/f5b6989a3477-transcription.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=5f513bd0fa9a21f6eca8af49ff46c031" alt="" width="1336" height="302" data-path="images/help-center/articles/5959405/f5b6989a3477-transcription.png" />
   </Frame>

9. Escolhemos o valor dinâmico **transcription.csv,** que será enviado para o Slack. Sabemos que a notificação do Slack irá conter o conteúdo da transcrição que desencadeou a automação, em formato csv.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/O5rJITGT3VgCy4bd/images/help-center/articles/5959405/708d9d9e821b-image.png?fit=max&auto=format&n=O5rJITGT3VgCy4bd&q=85&s=3703cdcb3338b565aab9f15614dd3e9f" alt="" width="708" height="240" data-path="images/help-center/articles/5959405/708d9d9e821b-image.png" />
   </Frame>

10. **`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.

Alcançámos assim o nosso objetivo de encaminhar as transcrições para o canal Slack da equipa, um processo que podemos editar mais tarde e **desativar** ou **ativar** quando quisermos.

<h2 id="h_30e7cbb201">
  **Dicas de resolução de problemas**
</h2>

* No que diz respeito ao Slack:

  * Confirme que a aplicação Slack da sua equipa está a funcionar e que tem sessão iniciada

  * Verifique se autorizou corretamente o Slack a aceder à CloudTalk

  * Certifique-se de que os âmbitos do seu token incluem as permissões **chat:write**. Consulte os [guias da API do Slack](https://api.slack.com/authentication/token-types) ou o [centro de ajuda do Slack](https://slack.com/help/articles/215770388-Create-and-regenerate-API-tokens) para obter ajuda.

- As condições incorretas resultam muitas vezes de entradas não reconhecidas na caixa **Propriedade** ou de entradas na caixa **Valor** que nunca produzem correspondências.

- Depois de clicar na caixa **Propriedade**, *tem de clicar numa das **palavras-chave pré-selecionadas*** da secção **Dados úteis para o seu fluxo de trabalho** à direita. Caso contrário, consulte as imagens para ver a formatação correta dos valores dinâmicos.

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

- Ao definir um valor para uma condição que pesquisa números de telefone introduzidos, certifique-se de que utiliza o número reconhecido pela CloudTalk. O formato é importante. Se o exemplo de valor sugerido na secção **Dados úteis para o seu fluxo de trabalho** apresentar um número com o formato «*[+55 55 5555 5555](ct+tel://+555555555555)*» (sem hífenes), mas o valor introduzido for «*[+55 55 5555 5555](ct+tel://+555555555555)*» (com hífenes), a sua condição nunca encontrará correspondências.

***

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


## Related topics

- [Guia das Automações de fluxo de trabalho](/pt/articles/10568412-workflow-automations-guide.md)
- [Ações](/pt/articles/5649782-actions.md)
- [Configurar as Automações de fluxo de trabalho](/pt/articles/5450779-configuring-workflow-automations.md)


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