This article shows how you can export a speech-to-text transcription (STT) from CloudTalk to HubSpot using our workflow automations model, for cases where HubSpot's native transcription functionality does not work with your solution.

User Level:

Admin

HubSpot Transcription Export

We recommend using HubSpot's native functionality for transcriptions when possible.

Requirements

existing workflow with a Recording Uploaded trigger for transcription creation
HubSpot admin role with access to private apps

HubSpot has updated its authorization logic for API requests. Now, all requests are authenticated using the OAuth authorization stored within your initial integration instance with HubSpot.

For newly created workflow automations, this means there is no need to manually format additional keys or authentication headers in your endpoint URL or setup.
However, there is a limitation—only workflow automations linked to the most recently configured HubSpot integration instance will function. If multiple HubSpot integration instances exist, only the latest one will be active for automations.

Setup

From the dashboard, navigate to Account > Workflow Automations.
Select +Add Workflow and name your workflow.
For a trigger Object, select Transcription. Action: Created.
1. Optional: Add a condition statement if you only want transcriptions to export to HubSpot when the logical filter is met. To forward all transcriptions to HubSpot, delete this step.
As an Action, select API request.
1. Endpoint: https://api.hubapi.com/engagements/v1/engagements
2. Method: POST
Select Add header:
1. Key: content-type
2. Value: application/json
In the Values section (the request body), include the following key-value pairs with the Format set to AUTO:
1. Key: engagement.active, Value: True
2. for Key associations.contactIds.0 paste the following Value:
 1. {%- for url in event.properties.call.contacts[0].external_urls -%} {%- if url.integration_name == "hubspot" -%} {{ url.external_url | split("/") | last}} {%- endif -%} {%- endfor -%}
3. for Key metadata.body paste the following Value:
 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 %}Transcription of call between Cloudtalk and {{ event.properties.call.contacts[0].name }} {%elif item.time > 0%}{{item.person}} : '{{item.text}}' {% endif %}{% endfor %}
4. Key: engagement.type, Value: NOTE
When done, select Confirm and continue.
Use the top toggle to set your workflow as active and select Save to enact your changes. Confirm creation of the workflow.

Reference for Key-Values in Request Body

engagement.active accesses the activity of the HubSpot (HS) engagement.

The code pasted for associations.contactIds.0 extracts the desired contact ID from the external URL.
The code pasted for metadata.body contains dynamic references (in Nunjuks) to the CSV transcription. This builds an output for the body of the note.
engagement.type references the type of engagement to output.

Have more questions? Don't hesitate to contact our Support team. We're always here to help you!

Configure HubSpot

Speech-to-Text Transcription

HubSpot SMS Workflows

Export Voicemail Speech-to-Text

HubSpot Authentication