Skip to main content
Crea un flujo de trabajo para enviar automáticamente las transcripciones de llamadas a un canal de Slack.
Nivel de usuario: Admin

Crear la app de CloudTalk en Slack

Antes de enviar llamadas de API a Slack, debes crear una app de CloudTalk y permitirle publicar en los canales designados.
  1. En la página de Slack API apps, selecciona Create an App.
  2. Selecciona From scratch.
  3. Introduce CloudTalk como App Name y selecciona el espacio de trabajo de Slack de tu empresa.
  4. Create App.
  5. Ve a Features > Incoming Webhooks dentro de las páginas de la app.
    1. Activa Activate Incoming Webhooks.
  6. Ve a Features > OAuth & Permissions.
    1. En Scopes > Bot Token Scopes, selecciona Add an OAuth Scope.
      1. Selecciona el ámbito chat:write.customize.
      2. Selecciona Add scopes cuando se te pida añadir chat:write.
      3. Selecciona chat:write.public como último ámbito de esta sección.
    2. En Scopes > User Token Scopes, selecciona Add an OAuth Scope.
      1. Selecciona chat:write.
  7. Ve a Settings > Install App y selecciona Install to Workspace.
  8. Elige el canal en el que quieres que publique tu app de CloudTalk. Allow.
  9. Cuando vuelvas a Settings > Install App, podrás ver el User OAuth Token y el Bot User OAuth Token. Tendrás que copiar uno de estos valores al configurar tu flujo de trabajo.
Si el admin que configura la automatización de flujo de trabajo no está añadido al canal que has seleccionado para publicar, tendrás que usar el Bot User OAuth Token para el valor token en los siguientes pasos. Esto se debe a que usar el User OAuth Token solo permite publicar en los canales donde está añadido el usuario de CloudTalk asociado.

Reenviar transcripciones a Slack

En este ejemplo, necesitaremos usar dos flujos de trabajo: uno para automatizar la creación de las transcripciones y otro para automatizar el proceso de exportación de esas transcripciones una vez terminadas. Objetivo:
  • Transcribir todas las grabaciones de llamadas.
  • Reenviar esas transcripciones a Slack.

Requisitos previos

  • Has contratado correctamente un plan Expert o Custom con CloudTalk
  • El equipo de atención al cliente de CloudTalk ha activado el Reconocimiento de Voz a Texto en tu cuenta
  • Has creado una app de CloudTalk en Slack y la has conectado al canal de Slack que quieras (consulta Crear la app de CloudTalk en Slack)
  • Los permisos del token de tu canal de Slack incluyen permisos chat:write, es decir, tu espacio de trabajo permite que los datos que llegan desde otra app se publiquen en los canales de Slack en lugar de un usuario individual. Puedes consultar la guía de ayuda de la API de Slack para leer cómo funcionan los tokens de Slack.

Transcribir las grabaciones de llamadas

  1. Desde tu Dashboard, ve a Cuenta -> Automatizaciones de flujo de trabajo.
  2. Selecciona + Agregar Flujo de Trabajo y ponle nombre a tu flujo de trabajo.
  3. Define un activador. En este ejemplo, nuestro activador será cada vez que se suba una grabación. En Objeto, seleccionaremos recording. En Acción, seleccionamos uploaded. Nota: Esta es la única acción disponible para un Objeto recording.
  4. Podríamos optar por configurar una condición opcional. Elige una Propiedad dinámica y consulta su Valor de ejemplo en la sección Datos útiles para tu Workflow, si son necesarias Condiciones. Para nuestro ejemplo, no necesitamos ninguna. Podemos hacer clic en Skip and continue without action.
  5. El siguiente paso es elegir un tipo de acción que se ejecutará cada vez que se suba una grabación. Seleccionamos el Tipo de acción > Reconocimiento de Voz a Texto.
    1. En Clave > language, introduce en el campo Valor el idioma correspondiente a nuestras grabaciones. Elige en la lista de idiomas de Google Cloud y copia y pega el código indicado en la columna BCP-47**.**
    2. En Clave > model, puedes elegir un modelo de aprendizaje automático concreto. En la mayoría de los casos, el modelo phone_call es suficiente para la plataforma de CloudTalk.
    3. Cuando Clave > enhancedModel se establece en true, se aplicará un modelo más avanzado optimizado para la precisión. Sin embargo, esta opción aumentará los costes de la transcripción.
  6. Confirmar y continuar.
  7. Guardar tu flujo de trabajo y actívalo con el interruptor de la parte superior de la página de configuración del flujo de trabajo.

Reenviar transcripciones a Slack

En la sección anterior de este artículo, configuramos nuestra Automatización de flujo de trabajo para garantizar la creación de una transcripción de Reconocimiento de Voz a Texto. En la siguiente sección, configuraremos el flujo de trabajo para enviar esta transcripción al espacio de trabajo de Slack que elijas.
  1. Desde tu Dashboard, ve a Cuenta -> Automatizaciones de flujo de trabajo.
  2. Selecciona + Agregar Flujo de Trabajo y ponle nombre a tu flujo de trabajo.
  3. Define un activador con Objeto de tipo transcription y Acción de tipo created. Este activador se iniciará cada vez que se cree una transcripción.
  4. Podríamos optar por configurar una condición opcional. Elige una Propiedad dinámica y consulta su Valor de ejemplo en la sección Datos útiles para tu Workflow, si son necesarias Condiciones. Para nuestro ejemplo, no necesitamos ninguna. Podemos hacer clic en Skip and continue without action.
  5. El siguiente paso es elegir una acción que se ejecutará cuando se cumplan nuestras condiciones. Seleccionamos el Tipo de acción > Enviar notificación a Slack.
  6. En Valores, deberían aparecer varias Claves con sus campos ya rellenados. No se pueden editar. La entrada token debería rellenar automáticamente el primer campo Clave. Las x's que aparecen en el campo Valor correspondiente a Clave: token son solo marcadores de posición. Para conectar con Slack, debemos introducir el User OAuth token O el Bot User OAuth Token que encontrarás en la configuración de tu app de Slack (consulta Crear la app de CloudTalk en Slack).
    1. El Bot User OAuth permite publicar en cualquier canal público de Slack, mientras que el User OAuth requiere que estés añadido al canal.
    2. Consulta el centro de ayuda de Slack para obtener más información sobre los tokens de Slack.
  7. Introduce el nombre de tu canal de Slack en el campo Valor de Clave: channel. El nombre de nuestro canal de Slack aquí es #call-transcript.
  8. Junto a Clave: text, elegimos introducir un valor dinámico, es decir, un valor que se rellenará con información del sistema. Para ello, haremos clic en el campo Valor de Clave: text y después en una palabra clave de la sección Datos útiles para tu Workflow. Al hacer clic en el blue + sign junto a transcription se abren más opciones, entre las que podemos elegir un formato de archivo json o csv.
  9. Hemos elegido el valor dinámico de transcription.csv, que se enviará a Slack. Sabemos que la notificación de Slack contendrá el contenido de la transcripción que haya activado la automatización, en formato csv.
  10. Confirmar y continuar. Guarda tu flujo de trabajo y actívalo con el interruptor de la parte superior de la página de configuración del flujo de trabajo.
Ya hemos cumplido nuestro objetivo de reenviar las transcripciones al canal de Slack del equipo, un proceso que podemos editar más adelante y desactivar o activar cuando queramos.

Consejos para la resolución de problemas

  • En lo que respecta a Slack:
    • Comprueba que la app de Slack de tu equipo está funcionando y que has iniciado sesión
    • Comprueba que has autorizado correctamente a Slack para acceder a CloudTalk
    • Asegúrate de que los ámbitos de tu token incluyen permisos chat:write. Consulta las guías de la API de Slack o el centro de ayuda de Slack si necesitas ayuda.
  • Las condiciones defectuosas suelen deberse a entradas no reconocidas en el campo Propiedad o a entradas en el campo Valor que nunca darán coincidencias.
  • Después de hacer clic en el campo Propiedad, debes hacer clic en una de las palabras clave preseleccionadas de la sección Datos útiles para tu Workflow que hay a la derecha. Si no, consulta las imágenes para ver el formato correcto de los valores dinámicos.
  • También puedes consultar la sección Datos útiles para tu Workflow para comprobar si el Valor que has introducido encaja con la propiedad que has elegido.
  • Al establecer un valor para una condición que busca números de teléfono introducidos, asegúrate de usar el número que reconoce CloudTalk. El formato importa. Si el ejemplo de valor sugerido en la sección Datos útiles para tu Workflow muestra un número con el formato “+55 55 5555 5555” (sin guiones) pero el valor introducido es “+55 55 5555 5555” (con guiones), tu condición nunca encontrará coincidencias.

¿Necesitas ayuda o tienes alguna pregunta? Escríbenos a través de nuestro Portal de atención al cliente — estamos aquí para ayudarte.