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

# Exportar transcrições de voz para texto para o HubSpot

> Exporte as transcrições das suas chamadas para o HubSpot sob a forma de notas

<Note>
  Este artigo mostra como exportar uma [transcrição de voz para texto](/pt/articles/5671571-speech-to-text-transcription) (STT) da CloudTalk para o HubSpot através do nosso modelo de automações de fluxo de trabalho, nos casos em que a funcionalidade nativa de transcrição do HubSpot não funciona com a sua solução.
</Note>

**Nível de utilizador:** Admin

***

<Warning>
  **Recomendamos a utilização da [funcionalidade nativa do HubSpot](https://knowledge.hubspot.com/calling/review-call-recordings-and-transcripts)** para as transcrições sempre que possível.
</Warning>

<h2 id="h_cc2654becd">
  Requisitos
</h2>

* fluxo de trabalho existente com um acionador **Gravação Carregada** para a [criação de transcrições](/pt/articles/5671571-speech-to-text-transcription)

* função de administrador do HubSpot com acesso a aplicações privadas

<Info>
  O HubSpot atualizou a sua lógica de autorização para os pedidos de API. Agora, todos os pedidos são autenticados através da autorização OAuth guardada na sua instância de integração inicial com o HubSpot.

  * Nas automações de fluxo de trabalho recém-criadas, isto significa que não é necessário formatar manualmente chaves adicionais nem cabeçalhos de autenticação no URL do seu ponto final ou na configuração.

  * No entanto, existe uma limitação - apenas funcionam as automações de fluxo de trabalho associadas à instância de integração do HubSpot **configurada mais recentemente**. Se existirem várias instâncias de integração do HubSpot, apenas a mais recente estará ativa para as automações.
</Info>

<h2 id="h_fe96a378e8">
  Configuração
</h2>

1. No Dashboard, navegue até **Conta > Automações de fluxo de trabalho**.

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

3. No **Objeto** do acionador, selecione `Transcrição`. **Ação:** `Criado`.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/9VIELngG1B1_Y1Cb/images/help-center/articles/8386173/1c857262d156-screenshot-2025-03-18-at-15-17-11.png?fit=max&auto=format&n=9VIELngG1B1_Y1Cb&q=85&s=426631ca2460cb7b4760af60af82e361" alt="" width="400" data-path="images/help-center/articles/8386173/1c857262d156-screenshot-2025-03-18-at-15-17-11.png" />
   </Frame>

   1. ***Opcional***\*: adicione uma condição se pretender que apenas as transcrições que cumprem o filtro lógico sejam exportadas para o HubSpot. Para enviar todas as transcrições para o HubSpot, elimine este passo.\*

4. Como **Ação**, selecione `Pedido de API`.

   1. **Ponto Final**: [`https://api.hubapi.com/engagements/v1/engagements`](https://api.hubapi.com/engagements/v1/engagements)

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

      <Frame>
        <img src="https://mintcdn.com/cloudtalk/9VIELngG1B1_Y1Cb/images/help-center/articles/8386173/0a02fdc7070e-screenshot-2025-03-18-at-15-18-45.png?fit=max&auto=format&n=9VIELngG1B1_Y1Cb&q=85&s=e5cb0d1edc89e63cbd545f57dd147891" alt="" width="400" data-path="images/help-center/articles/8386173/0a02fdc7070e-screenshot-2025-03-18-at-15-18-45.png" />
      </Frame>

5. Selecione **Adicionar cabeçalho**:

   1. **Chave:** `content-type`

   2. **Valor:** `application/json`

      <Frame>
        <img src="https://mintcdn.com/cloudtalk/9VIELngG1B1_Y1Cb/images/help-center/articles/8386173/d63c7132f5f7-screenshot-2025-03-18-at-15-19-59.png?fit=max&auto=format&n=9VIELngG1B1_Y1Cb&q=85&s=672e29153e28d268a199a10f89385bce" alt="" width="400" data-path="images/help-center/articles/8386173/d63c7132f5f7-screenshot-2025-03-18-at-15-19-59.png" />
      </Frame>

6. Na secção **Valores** (o corpo do pedido), inclua os seguintes pares *chave*-*valor* com o **Formato** definido como `AUTO`:

   1. **Chave:** `engagement.active`, **Valor:** `True`

   2. na **Chave** `associations.contactIds.0` cole o seguinte **Valor:**

      1. `{%- for url in event.properties.call.contacts[0].external_urls -%} {%- if url.integration_name == "hubspot" -%} #{{ url.external_url | split("/") | last}} {%- endif -%} {%- endfor -%}`

   3. na **Chave** `metadata.body` cole o seguinte **Valor**:

      1. `{% set arr = [`

         `{ time: 0,`

         `person: '',`

         `text: 'text'`

         `}] %}{% set items = event.properties.transcription.json %}{% for item in items %}{% if item.out | length > 0 %}{% set arr = (arr.push({`

         `time: item.timestamp | int,`

         `person: 'Agent',`

         `text: item.out`

         `}), arr) %}{% endif %}{% if item.in | length >0 %}{% set arr = (arr.push({`

         `time: item.timestamp | int,`

         `person: 'Contact',`

         `text: item.in`

         `}), arr) %}{% endif %}{% endfor %}{% set sorted = arr |sort(attribute='time') %}{% for item in sorted %}{% if item.time < 1 %}<span><strong>Transcription of call between Cloudtalk and #{{ event.properties.call.contacts[0].name }} </strong></span><br>{%elif item.time > 0%}#{{item.person}} : '#{{item.text}}'<br>{% endif %}{% endfor %}`

   4. **Chave:** `engagement.type`, **Valor:** `NOTE`

      <Frame>
        <img src="https://mintcdn.com/cloudtalk/9VIELngG1B1_Y1Cb/images/help-center/articles/8386173/1224858bf1f5-screenshot-2025-03-18-at-15-32-48.png?fit=max&auto=format&n=9VIELngG1B1_Y1Cb&q=85&s=a6492c86c81c9ffe7847754f9d784e9d" alt="" width="400" data-path="images/help-center/articles/8386173/1224858bf1f5-screenshot-2025-03-18-at-15-32-48.png" />
      </Frame>

7. Quando terminar, selecione **`Confirmar e continuar`**.

8. Utilize o interruptor no topo para definir o seu fluxo de trabalho como ativo e selecione **`Guardar`** para aplicar as alterações. **`Confirmar`** a criação do fluxo de trabalho.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/9VIELngG1B1_Y1Cb/images/help-center/articles/8386173/04d60bd8a00a-screenshot-2025-03-18-at-15-33-35.png?fit=max&auto=format&n=9VIELngG1B1_Y1Cb&q=85&s=ee551f1e66cab7c865798ebe93ab0c15" alt="" width="400" data-path="images/help-center/articles/8386173/04d60bd8a00a-screenshot-2025-03-18-at-15-33-35.png" />
   </Frame>

<h4 id="h_7525005353">
  Referência dos *pares chave-valor* no corpo do pedido
</h4>

* `engagement.active` acede à atividade do engagement do HubSpot (HS).

- O código colado em `associations.contactIds.0` extrai o ID de contacto pretendido a partir do URL externo.

- O código colado em `metadata.body` contém referências dinâmicas (em Nunjuks) à transcrição em CSV. Isto cria o resultado para o corpo da nota.

- `engagement.type` refere o tipo de engagement a devolver.

***

*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)
- [Utilizar o HubSpot com os dialers de campanha](/pt/articles/9562215-using-hubspot-with-campaign-dialers.md)
- [Guia das Automações de fluxo de trabalho](/pt/articles/10568412-workflow-automations-guide.md)


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