> ## 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 la transcripción de voz a texto a HubSpot

> Exporta tus transcripciones de llamadas a HubSpot en forma de notas

<Note>
  En este artículo te mostramos cómo exportar una [transcripción de voz a texto](/es/articles/5671571-speech-to-text-transcription) (STT) de CloudTalk a HubSpot mediante nuestro modelo de automatizaciones de flujo de trabajo, para los casos en los que la funcionalidad de transcripción nativa de HubSpot no funciona con tu solución.
</Note>

**Nivel de usuario:** Admin

***

<Warning>
  **Te recomendamos usar [la funcionalidad nativa de HubSpot](https://knowledge.hubspot.com/calling/review-call-recordings-and-transcripts)** para las transcripciones siempre que sea posible.
</Warning>

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

* un flujo de trabajo existente con un activador **Grabación cargada** para la [creación de transcripciones](/es/articles/5671571-speech-to-text-transcription)

* rol de administrador de HubSpot con acceso a las aplicaciones privadas

<Info>
  HubSpot ha actualizado su lógica de autorización para las solicitudes de API. Ahora todas las solicitudes se autentican con la autorización OAuth almacenada en tu instancia de integración inicial con HubSpot.

  * En las automatizaciones de flujo de trabajo de nueva creación, esto significa que no hace falta formatear manualmente claves adicionales ni encabezados de autenticación en la URL de tu punto final ni en la configuración.

  * Sin embargo, hay una limitación: solo funcionarán las automatizaciones de flujo de trabajo vinculadas a la instancia de integración de HubSpot **configurada más recientemente**. Si existen varias instancias de integración de HubSpot, solo la última estará activa para las automatizaciones.
</Info>

<h2 id="h_fe96a378e8">
  Configuración
</h2>

1. Desde el Dashboard, ve a **Cuenta > Automatizaciones de flujo de trabajo**.

2. Selecciona **`+ Agregar Flujo de Trabajo`** y ponle nombre a tu flujo de trabajo.

3. Como **Objeto** del activador, selecciona `Transcripción`. **Acción:** `Creado`.

   <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***\*: añade una condición si solo quieres que las transcripciones se exporten a HubSpot cuando se cumpla el filtro lógico. Para enviar todas las transcripciones a HubSpot, elimina este paso.\*

4. Como **Acción**, selecciona `Solicitud de API`.

   1. **Punto 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. Selecciona **Agregar encabezado**:

   1. **Clave:** `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. En la sección **Valores** (el cuerpo de la solicitud), incluye los siguientes pares *clave*-*valor* con el **Formato** configurado como `AUTO`:

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

   2. para la **Clave** `associations.contactIds.0` pega el siguiente **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. para la **Clave** `metadata.body` pega el siguiente **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. **Clave:** `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. Cuando hayas terminado, selecciona **`Confirmar y continuar`**.

8. Usa el interruptor superior para activar tu flujo de trabajo y selecciona **`Guardar`** para aplicar los cambios. **`Confirmar`** la creación del flujo de trabajo.

   <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">
  Referencia de los pares *clave-valor* del cuerpo de la solicitud
</h4>

* `engagement.active` accede a la actividad del engagement de HubSpot (HS).

- El código pegado en `associations.contactIds.0` extrae el ID de contacto deseado de la URL externa.

- El código pegado en `metadata.body` contiene referencias dinámicas (en Nunjuks) a la transcripción CSV. Con ello se genera el resultado para el cuerpo de la nota.

- `engagement.type` indica el tipo de engagement que se va a generar.

***

*¿Necesitas ayuda o tienes alguna pregunta?* Escríbenos a través de nuestro [Portal de atención al cliente](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) : estamos aquí para ayudarte.


## Related topics

- [Exportar la conversión de voz a texto del buzón de voz](/es/articles/6926594-export-voicemail-speech-to-text.md)
- [Configurar HubSpot](/es/articles/3206271-configure-hubspot.md)
- [Uso de HubSpot con los marcadores de campaña](/es/articles/9562215-using-hubspot-with-campaign-dialers.md)


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