Skip to main content
In dit artikel leest u hoe u een speech-to-text-transcriptie (STT) vanuit CloudTalk naar HubSpot exporteert met ons model voor workflowautomatiseringen, voor gevallen waarin de native transcriptiefunctie van HubSpot niet werkt met uw oplossing.
Gebruikersniveau: Admin
We raden aan om waar mogelijk de native functionaliteit van HubSpot te gebruiken voor transcripties.

​
Vereisten

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.

​
Instellen

  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.
    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
    2. Methode: POST
  5. Selecteer Header toevoegen:
    1. Sleutel: content-type
    2. Waarde: application/json
  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
  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.

​
Naslag voor sleutel-waardeparen in de request body

  • 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 — we staan voor u klaar.