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

# Speech-to-text exporteren naar HubSpot

> Exporteer uw gesprekstranscripties als notities naar HubSpot

<Note>
  In dit artikel leest u hoe u een [speech-to-text-transcriptie](/nl/articles/5671571-speech-to-text-transcription) (STT) vanuit CloudTalk naar HubSpot exporteert met ons model voor workflowautomatiseringen, voor gevallen waarin de native transcriptiefunctie van HubSpot niet werkt met uw oplossing.
</Note>

**Gebruikersniveau:** Admin

***

<Warning>
  **We raden aan om waar mogelijk [de native functionaliteit van HubSpot](https://knowledge.hubspot.com/calling/review-call-recordings-and-transcripts)** te gebruiken voor transcripties.
</Warning>

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

* bestaande workflow met een trigger **Opname geüpload** voor [het aanmaken van transcripties](/nl/articles/5671571-speech-to-text-transcription)

* HubSpot-adminrol met toegang tot private apps

<Info>
  HubSpot heeft de autorisatielogica voor API-verzoeken aangepast. Alle verzoeken worden nu geauthenticeerd via de OAuth-autorisatie die is opgeslagen in uw oorspronkelijke integratie-instantie met HubSpot.

  * Voor nieuw aangemaakte workflowautomatiseringen betekent dit dat u geen extra sleutels of authenticatieheaders handmatig hoeft op te maken in uw eindpunt-URL of instellingen.

  * Er is echter een beperking: alleen workflowautomatiseringen die gekoppeld zijn aan de **als laatste geconfigureerde** HubSpot-integratie-instantie werken. Als er meerdere HubSpot-integratie-instanties bestaan, is alleen de meest recente actief voor automatiseringen.
</Info>

<h2 id="h_fe96a378e8">
  Instellen
</h2>

1. Ga in het Dashboard naar **Account > Workflowautomatiseringen**.

2. Selecteer **`+ Workflow toevoegen`** en geef uw workflow een naam.

3. Selecteer bij **Object** van de trigger `Transcriptie`. **Actie:** `Aangemaakt`.

   <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. ***Optioneel***\*: Voeg een voorwaarde toe als u transcripties alleen naar HubSpot wilt exporteren wanneer aan het logische filter wordt voldaan. Verwijder deze stap om alle transcripties naar HubSpot door te sturen.\*

4. Selecteer als **Actie** `API-verzoek`.

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

   2. **Methode**: `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. Selecteer **Header toevoegen**:

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

   2. **Waarde:** `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. Neem in het gedeelte **Waarden** (de request body) de volgende *sleutel*-*waarde*-paren op met **Formaat** ingesteld op `AUTO`:

   1. **Sleutel:** `engagement.active`, **Waarde:** `True`

   2. plak bij **Sleutel** `associations.contactIds.0` de volgende **Waarde:**

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

   3. plak bij **Sleutel** `metadata.body` de volgende **Waarde**:

      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. **Sleutel:** `engagement.type`, **Waarde:** `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. Selecteer als u klaar bent **`Bevestigen en doorgaan`**.

8. Zet uw workflow met de schakelaar bovenaan op actief en selecteer **`Opslaan`** om uw wijzigingen door te voeren. **`Bevestigen`** het aanmaken van de workflow.

   <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">
  Naslag voor *sleutel-waardeparen* in de request body
</h4>

* `engagement.active` geeft toegang tot de activiteit van de HubSpot (HS) engagement.

- De code die u plakt bij `associations.contactIds.0` haalt de gewenste contact-ID uit de externe URL.

- De code die u plakt bij `metadata.body` bevat dynamische verwijzingen (in Nunjuks) naar de CSV-transcriptie. Hiermee wordt de inhoud van de notitie opgebouwd.

- `engagement.type` verwijst naar het type engagement dat wordt uitgevoerd.

***

*Hulp nodig of een vraag?* Neem gerust contact met ons op via ons [supportportaal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — we staan voor u klaar.


## Related topics

- [HubSpot gebruiken met campagnedialers](/nl/articles/9562215-using-hubspot-with-campaign-dialers.md)
- [Voicemail speech-to-text exporteren](/nl/articles/6926594-export-voicemail-speech-to-text.md)
- [Speech-to-Text-transcriptie](/nl/articles/5671571-speech-to-text-transcription.md)


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