Manual de Usuario - Integración de Callpicker Voice para HubSpot: Marcador (Click2Call)
Resumen
Este manual describe el funcionamiento, alcance y configuración del Marcador (Click2Call) de Callpicker Voice para HubSpot. Aprenda a realizar llamadas con un solo clic (Click2Call) y a consultar el registro automático de su actividad saliente.
Documentos relacionados
Funcionamiento y alcances
Configurar marcador en HubSpot
Este marcador fue desarrollado para ser incorporado en HubSpot a través de los botones integrados para realizar llamadas nativamente para de facilitar el proceso de marcación dentro de HubSpot.
Para configurar el marcador para recibir llamadas entrantes, se debe hacer clic en el icono de Llamadas en la barra de navegación y seleccionar como proveedor a Callpicker.

Para configurar el marcador para realizar llamadas salientes, posiciónate en un contacto dentro de HubSpot y haz clic en Llamada.
Esto abrirá la siguiente ventana. Para continuar, haz clic en Cambiar proveedor

Selecciona a Callpicker como proveedor

Realizar llamadas salientes
En HubSpot, posicionarse en un registro de un contacto o una empresa y hacer clic en “Llamada”

Hacer clic sobre el número correspondiente que se desea llamar

Cuando se realice la llamada, se abrirá una ventana emergente en el navegador con el marcador. Todas las llamadas salientes efectuadas por este medio se realizan de acuerdo a los criterios descritos en la sección de llamadas salientes.

Cuando se realiza una llamada, se envía una notificación a Callpicker para verificar si existe una extensión que coincida con el nombre de usuario que ha iniciado sesión en HubSpot, por ejemplo:
En HubSpot existen cinco usuarios, y el usuario que ha iniciado sesión se llama “Ana García”. Cuando este usuario realice una llamada, se verificará si existe una extensión Callpicker con el nombre de ese usuario.
En caso de existir esta extensión, la llamada se realizará de manera automática usando la extensión coincidente
En caso de no existir una extensión, se solicitarán las las credenciales SIP de la extensión que se desea usar para realizar llamadas en el marcador. Cuando una llamada no se realiza de manera automática se mostrará la siguiente interfaz en HubSpot:

Recibir llamadas entrantes
En HubSpot, hacer clic en el icono de Llamadas en la barra de navegación. Hacer clic en “Abrir la ventana de llamadas”

Se abrirá una ventana emergente en el navegador con el marcador. Para poder recibir llamadas entrantes debe mantenerse abierta esta interfaz en todo momento.

Cuando se abre la ventana emergente del marcador por primera vez, se envía una notificación a Callpicker para verificar si existe una extensión que coincida con el nombre de usuario que ha iniciado sesión en HubSpot. En caso de no existir una extensión, se solicitarán las las credenciales SIP de la extensión que se desea usar para recibir llamadas en el marcador. Si las credenciales ingresadas son válidas, el marcador lo reflejará mediante el indicador de la esquina superior derecha en color verde.

Consideraciones
Siempre que abras el marcador, asegúrate de que la conexión se encuentre activa. Puedes verificarlo con el indicador en la esquina superior derecha:
🟡 indica que el marcado se está intentando conectar a Callpicker
🟢 indica que la conexión se realizó correctamente

Esta integración no puede ser usada mediante la app móvil de HubSpot. Todas las llamadas que se realicen mediante la app móvil se realizarán desde el mismo dispositivo móvil.
Al acceder a HubSpot desde el navegador de un dispositivo móvil, es posible hacer uso de la integración en estos dispositivos. Sin embargo, no se recomienda hacer uso de la integración de esta manera, ya que HubSpot no ofrece una buena experiencia al interactuar con el CRM en los navegadores móviles y la integración tampoco fue diseñada para este tipo de escenarios, por lo que es posible que la integración no funcione correctamente.
Para que un número de contacto aparezca en la opción de “Llamada” debe establecerse en los campos predeterminados de HubSpot o en un campo de teléfono personalizado. Esto aplica solamente para los objetos de tipo contacto o empresa. En el caso de los objetos de tipo negocio o ticket, los campos de teléfono personalizado no se mostrarán en la interfaz, sin embargo, si se asocia un contacto o empresa a un negocio o ticket, la interfaz mostrará los números de teléfono del objeto asociado (contacto o empresa) sin ningún inconveniente. Este comportamiento es propio de HubSpot y Callpicker no puede modificarlo.
Estatus de la llamada
Una llamada puede tener los siguientes estatus:
Llamando…: la llamada ha comenzado a sonar al contacto o destino de la llamada. También se escuchará un “ringing” en el navegador durante el transcurso del estatus.
Llamada entrante: indica cuando se reciba una llamada entrante desde el marcador en HubSpot. Adicionalmente se escuchará un ringtone para notificar al usuario.
En curso: el destino de la llamada ha contestado y se ha establecido la comunicación entre ambos
Finalizada: la llamada ha sido terminada por el contacto/destino de la llamada o por el usuario que realiza la llamada.
Todos los estatus se muestran en la interfaz del marcador, como se muestra a continuación:

Estatus de la llamada: Llamando...

Estatus de la llamada: Llamada entrante

Estatus de la llamada: En curso

Estatus de la llamada: Finalizada
Activar y desactivar micrófono
Durante el transcurso de una llamada, es posible activar o desactivar el audio del micrófono para evitar que pueda ser escuchado por el contacto o destino de la llamada. Para ello, se debe realizar lo siguiente:
Tener previamente una llamada en curso
En la interfaz de la marcación, hacer clic en el icono del micrófono

Cuando el micrófono se encuentre desactivado, el icono del micrófono cambia su estado como se muestra a continuación:

Para activar el micrófono, se debe hacer clic nuevamente sobre el icono. Esto también permitirá al icono volver a su estado original.
Finalizar la llamada
Durante el transcurso de una llamada, es posible finalizar la llamada para terminar la comunicación entre ambas partes. Para ello, se debe realizar lo siguiente:
En la interfaz de la marcación, hacer clic en el icono de finalizar llamada

Cuando la llamada sea finalizada, el estatus de la llamada cambiará automáticamente a “Llamada finalizada” y el icono se deshabilitará

Configurar los dispositivos de entrada y salida (micrófono / altavoces)
Es posible cambiar el micrófono y los altavoces que se utilizan durante el transcurso de las llamadas, en caso de que se quiera usar un micrófono diferente al predeterminado en el sistema operativo o un altavoz donde se desea que salga el audio de la llamada. Para ello, se debe realizar lo siguiente:
Micrófono
En el apartado de Micrófono, seleccionar un dispositivo de la lista. La configuración se aplicará de manera automática.


Al aplicar la configuración, el destino de la llamada debe de escuchar el micrófono seleccionado en la lista de dispositivos

Altavoces
En el apartado de Altavoz, seleccionar un dispositivo de la lista y hacer clic en Aplicar


Al aplicar la configuración, se escuchará un sonido “ring” en el altavoz seleccionado en la lista de dispositivos

Limitaciones
No es posible configurar los dispositivos de salida o altavoces en navegadores que no están basados en Chromium (chrome), esto debido a una limitación propia de estos navegadores, algunos de ellos son los siguientes:
Firefox
Safari
Esta lista no se limita únicamente a los navegadores mencionados anteriormente. Todos los navegadores en los que no sea posible configurar el altavoz se mostrará únicamente el dispositivo predeterminado “Default” del sistema operativo en la lista de altavoces.

Registrar llamadas en HubSpot
Esta es una funcionalidad que permite crear un registro de las llamadas realizadas. En esta primera versión la funcionalidad se encuentra activada por defecto. En caso de que esta funcionalidad sea desactivada, NO se creará ningún registro.
Por cada llamada realizada se creará un registro con la siguiente información:
Campo | Descripción | Ejemplo |
|---|---|---|
Título de la llamada | Es el nombre del registro de la llamada. Cuando la llamada saliente se realice, HubSpot por defecto establece el siguiente nombre del registro: Call with {{nombre del contacto}}. Al finalizar la llamada, el nombre es modificado por el siguiente título:
|
|
Notas | En este apartado se agregará siguiente información de la llamada:
| Llamada entrante Callpicker
Llamada saliente Callpicker
|
A continuación, se muestran unos ejemplos de registros de llamadas. Todos los registros creados serán asociados al respectivo contacto, empresa o negocio marcado.

Registro de llamadas en HubSpot

Llamada saliente (Completada)

Llamada saliente (Perdida)

Llamada saliente (sin nombre y número de extensión)

Llamada entrante (Completada)

Llamada entrante (sin nombre y número de extensión)
Instalación
A continuación, se especifican los pasos a realizar del lado del cliente para la instalación de la integración.
Pre-requisitos
HubSpot
Tener una cuenta en HubSpot y un usuario con permisos de Superadministrador
Callpicker
Tener una cuenta de Callpicker que tenga habilitado el acceso a API y el scope API Marcación (calls)
Procedimiento para la instalación
Obtener Client ID y Secret ID de Callpicker
Ingresar a Admin Callpicker: admin.callpicker.com
Dirigirse a Desarrolladores > Funciones API

Copiar y guardar los valores de Client ID y Secret ID para usarlos posteriormente en la instalación

Instalar la app de la integración en HubSpot
En caso de cualquier error que impida continuar con la instalación, contactar a soporte para solucionar el problema
Abrir la siguiente URL en el navegador: https://connectors.callpicker.com/integrations/hubspot/click2call/install

Llenar los campos del formulario con los valores solicitados
Hacer clic en Conectar
Usted será redirigido a la página de instalación de HubSpot. Para continuar, se debe seleccionar la cuenta de HubSpot en la que se desea instalar la app de la integración y hacer clic en Elegir cuenta

Hacer clic en Conectar la aplicación

Si la instalación se realiza de manera exitosa, usted será redirigido a la vista de confirmación de la integración, en donde podrá visualizar los usuarios de HubSpot y su relación con las extensiones de la cuenta Callpicker usada en la instalación.
Dependiendo de la configuración que usted haya realizado previamente para relacionar sus extensiones Callpicker con los usuarios de HubSpot, la vista mostrará alguna de las siguientes advertencias:
Todos los usuarios se asignaron correctamente: Esta advertencia significa que todos los usuarios de HubSpot se encuentran asociados a una extensión Callpicker.

Algunos usuarios HubSpot no se asociaron: Esta advertencia significa que algunos usuarios de HubSpot no se encuentran asociados a una extensión Callpicker. Los usuarios de HubSpot que no tengan una extensión Callpicker asociada no podrán realizar llamadas de manera automática y tendrán que proporcionar las credenciales SIP manualmente.

Ningún usuario HubSpot fue asociado: Esta advertencia significa que ningún usuario de HubSpot tiene asociada una extensión Callpicker. Esto podría afectar completamente el uso de la integración, debido a que ninguna de las llamadas realizadas por cualquier usuario se realizarán de manera automática y en cambio se tendrán que proporcionar las credenciales SIP manualmente.

Se recomienda en la medida de lo posible configurar una extensión Callpicker por cada usuario de HubSpot, esto permitirá que la integración funcione de manera adecuada y ofrezca la mejor experiencia a todos los usuarios.
Configurar el registro de llamadas en HubSpot
Por defecto, la creación de registro de llamadas se encuentra activada en la integración. Para desactivar o activar esta funcionalidad, se debe realizar lo siguiente:
En HubSpot, hacer clic en Mercado > Aplicaciones conectadas en la barra de navegación

Seleccionar la app correspondiente y hacer clic en Ir a la configuración

En la pestaña de Configuración general, hacer clic sobre el toggle para desactivar o activar esta funcionalidad

Verificar estado de las extensiones
Puedes confirmar en cualquier momento desde la página de configuración como se encuentran asociadas las extensiones de la cuenta Callpicker conectada a la aplicación con los usuarios usuario de HubSpot. Para ello, se debe realizar lo siguiente:
En HubSpot, hacer clic en Mercado > Aplicaciones conectadas en la barra de navegación

Seleccionar la app correspondiente y hacer clic en Ir a la configuración

En la pestaña de Configuración general, hacer clic en Verificar

Se abrirá una ventana emergente en donde muestra la asociación entre los usuarios de HubSpot y las las extensiones de la cuenta Callpicker usada durante la instalación

Ver el historial de cambios en registro de llamadas
Puedes consultar quién y cuándo ha activado o desactivado el registro de llamadas en HubSpot desde la página de configuración. Para ello, se debe realizar lo siguiente:
En HubSpot, hacer clic en Mercado > Aplicaciones conectadas en la barra de navegación

Seleccionar la app correspondiente y hacer clic en Ir a la configuración

En la pestaña de Configuración general, hacer clic en Verificar

Se abrirá una ventana emergente en donde muestra quien ha activado o desactivado la funcionalidad de registrar llamadas en HubSpot

Preguntas y respuestas
¿Qué pasa si realizo una llamada y tengo dos extensiones que coincidan con un nombre de usuario en HubSpot?
La llamada se realizará sin ningún inconveniente usando la extensión que se muestra en la vista de confirmación de la integración, pero lo ideal sería no tener múltiples extensiones con el mismo nombre de usuario de HubSpot.
No configuré ninguna extensión con mi nombre de usuario en HubSpot, ¿esto afecta el uso de la integración?
Sí, en caso de no configurar ninguna extensión con tu nombre de usuario en HubSpot, las llamadas no se realizarán de manera automática y se te pedirá ingresar las credenciales SIP de alguna de las extensiones de tu cuenta de Callpicker.
No conozco las credenciales SIP de mis extensiones, ¿cómo puedo obtenerlas?
En caso de no haber configurado una extensión previamente, deberás ingresar las credenciales SIP de alguna de las extensiones de tu cuenta de Callpicker para poder realizar o recibir llamadas. En caso de conocer tus credenciales, puedes contactar a soporte para solicitar esta información.
¿Se puede configurar la troncal que se desea usar para realizar las llamadas?
No, actualmente no es posible configurar una troncal preferida para realizar llamadas.
¿Puede instalar la integración en múltiples ocasiones usando la misma cuenta de Callpicker?
Sí, es posible vincular una cuenta de Callpicker con múltiples cuentas de HubSpot para instalar la app de la integración en diferentes cuentas de HubSpot.
¿Puedo instalar la integración en múltiples ocasiones usando la misma cuenta de HubSpot?
No, actualmente no es posible vincular una cuenta de HubSpot con múltiples cuentas de Callpicker, debido a que al instalar nuevamente la app de la integración se anula la instalación realizada previamente.