SDK de extensiones de llamada

El SDK de extensiones de llamada permite que las aplicaciones proporcionen una opción de llamadas personalizada a los usuarios de HubSpot directamente desde un registro en CRM. 

Una extensión de llamadas consta de tres componentes principales:

  1. El SDK de extensiones de llamada, un SDK de JavaScript que permite la comunicación entre tu aplicación y HubSpot.
  2. Los puntos finales de configuración de llamadas, los cuales se usan para establecer la configuración de llamadas para tu aplicación. Cada cuenta de HubSpot que conecta tu aplicación utilizará estas configuraciones.
  3. El iframe de llamadas, que es donde aparece tu aplicación para los usuarios de HubSpot y está configurado usando los puntos finales de la configuración de llamadas.

Para obtener más información sobre la experiencia de llamadas en la aplicación, revisa este artículo de la base de conocimientos. Una vez que la aplicación de la extensión de llamadas esté conectada a HubSpot, aparecerá como opción en el conmutador de llamadas cuando un usuario haga una llamada desde HubSpot.

Please note: only outgoing calls are currently supported.

El SDK de extensiones de llamada

El SDK de extensiones de llamada es una biblioteca JavaScript que se utiliza para comunicarse entre HubSpot y tu aplicación de llamadas, la cual aparecerá dentro de un iframe. Esta comunicación incluye:

  • HubSpot le indica a tu aplicación a qué número llamar.
  • Tu aplicación le dice a HubSpot cuándo se ha conectado la llamada y cuándo ha terminado.
  • HubSpot le dice a tu aplicación el ID de interacción del marcador de posición que debe actualizarse con los detalles de la llamada.

Puedes encontrar el SDK en este repositorio de GitHub, junto con los requisitos técnicos y los detalles de uso de SDK dentro de tu aplicación web.

Configuración

Las extensiones de llamadas están configuradas como parte de una aplicación de HubSpot. Si no tienes una aplicación, puedes crear una desde tu cuenta de desarrollador de HubSpot. Si aún no tienes una cuenta de desarrollador de HubSpot, inicia sesión aquí.

Una vez que hayas configurado la configuración de llamadas para tu aplicación, que es una tarea única, esta configuración se aplicará a todos los usuarios que conectan la aplicación a su cuenta de HubSpot. Revisa la pestaña Puntos finales para obtener más información sobre cómo crear esas configuraciones.

Después de que la configuración de llamadas esté lista, los usuarios deberán realizar el proceso de conexión de la aplicación para que tu servicio de llamadas esté disponible en su cuenta de HubSpot. 

El proceso de llamadas

Las llamadas realizadas usando extensiones de llamadas siguen los siguientes pasos:

  1. El usuario hace clic en el icono de Llamada en un registro de CRM.
  2. El usuario selecciona la aplicación como proveedor de llamadas y hace clic en el botón Llamar desde el explorador.
  3. Un iframe abre la URL especificada en la configuración de llamadas en tu aplicación.
  4. La llamada se completa a través de tu aplicación (se muestra en el iframe).
  5. HubSpot crea una interacción de marcador de posición y envía el ID de esta interacción a tu aplicación mediante el SDK de extensiones de llamada.
  6. Tu aplicación actualiza la interacción con el marcador de posición con los detalles completos de la llamada.

Después de que un usuario conecta tu aplicación a HubSpot, aparecerá como una opción adicional cuando se llame desde un registro. Cuando los usuarios hagan clic en el símbolo Llamada, aparecerá la opción de hacer que la llamada use tu aplicación en lugar del sistema de llamadas predeterminadas de HubSpot. 

Más información sobre cómo hacer llamadas desde HubSpot

calling_provider

Cuando el usuario elige hacer la llamada a través de su navegador, un iframe abre la URL especificada en la configuración de llamadas para tu aplicación. Esta URL debe apuntar a una aplicación web personalizada que hará la llamada a través de tu servicio de llamadas. Usando el SDK de extensiones de llamada, tu aplicación se comunicará con la aplicación HubSpot. Los mensajes de la aplicación HubSpot permiten que tu aplicación sepa a qué número llamar, y tu aplicación será capaz de enviar mensajes para eventos, como la finalización de la llamada o el cierre de sesión de un usuario en tu servicio.

calling_iframe

Al crear tu aplicación, hay algunas consideraciones que debes recordar:

  • Deberás tener una aplicación web que se pueda mostrar dentro de un iframe porque HubSpot no procesará ningún contenido de iframe, por lo que no puedes establecer la URL de iframe en un servicio SIP de back-end.
  • Los parámetros de alto y ancho establecidos a través de la API de configuración determinarán el tamaño del iframe. Las ventanas con una un alto de 600px y un ancho de 400px funcionan mejor para el mayor rango de tamaños de ventana del navegador, incluidas pantallas más pequeñas.
  • Asegúrate de que las condiciones de error aparezcan dentro del iframe. Esto es para que tu aplicación pueda alertar a los usuarios sobre problemas de audio, problemas de red u otros errores.

Pruebas

Mientras estás en el proceso de crear tu aplicación, puedes establecer manualmente la URL de iframe para tu navegador configurando un valor de localStorage. Esto te permitirá establecer una URL de localhost para las pruebas locales.

Para establecer el valor, abre las herramientas de desarrollador para tu navegador y ejecuta el siguiente comando JavaScript en la consola:

localStorage.setItem('LocalSettings:Sales:CallingExtensions', '{"name": "Example Calling app Title", "url": "https://myWidgetUrl/path/"}')

El valor de nombre aparecerá en el encabezado del widget de llamada y la url será la URL utilizada para iframe. Cuando este elemento esté establecido, el nombre que configuras aparecerá como opción para el proveedor de llamadas cuando hagas clic en el icono Llamada y el widget de llamada utilizará la url de iframe que configuraste.

Cómo registrar la llamada en HubSpot

En HubSpot, las llamadas se registran como objetos de interacción. Estas interacciones se utilizan para mostrar los detalles de la llamada en la cronología del objeto de CRM asociado. También se usan para los informes de ventas integrados de HubSpot.

Cuando se realiza una llamada a través de tu aplicación, HubSpot creará automáticamente el objeto de interacción base y enviará el ID de esa interacción a tu aplicación mediante el SDK de extensiones de llamada. El ID se pasará a tu aplicación usando la función onEngagementCreated. HubSpot establecerá los detalles básicos de la interacción, incluido el propietario, tipo y asociaciones. Deberás actualizar los detalles en los metadatos del registro de interacción para establecer la duración de la llamada, así como cualquier nota para la llamada en el campo body. Si hay una grabación de la llamada, también puedes establecer la recordingUrl, lo que permitirá que los usuarios de HubSpot puedan reproducir la grabación cuando vean el registro de contacto en HubSpot.

Echa un vistazo a más detalles sobre cómo actualizar las interacciones en nuestra documentación de interacciones de CRM.

Por ejemplo:

// { "engagement": { "timestamp": 1561953600000 // A millisecond timestamp of the time of the call. This will default to the time that the call was initiated, but can be updated if needed. }, "metadata": { // Details for the call "toNumber": "+1 (888) 482-7768", // The number that was called. Displayed as a string, with no further formatting. "durationMilliseconds": 38000, // The length of the call in milliseconds. "recordingUrl": "https://app.example.com/Recordings/callrecordpath", // A path to a recording of the call "body": "Call notes" // Details about the call, displayed as the description } }

Los detalles anteriores ocasionarían una interacción que aparece como la siguiente imagen cuando se visualiza en HubSpot:

calling-sdk-engagement

Revisa Interacciones de CRM para obtener más información sobre cómo trabajar con interacciones.


¿Te resultó útil este artículo? *
Con este formulario puedes enviar tu opinión sobre nuestros documentos para desarrolladores. Si tienes comentarios sobre el producto de HubSpot, puedes enviarlos al Foro de ideas.