Conectar Looker Studio a ¡Hola! Suite
Ruta en ¡Hola! Suite: Usuarios → [usuario de la integración] → Registro → Permisos, para obtener el token. La conexión se hace en Looker Studio, en lookerstudio.google.com.
Visión general
Looker Studio es la herramienta de Google para crear informes y paneles interactivos. Con la conexión a ¡Hola! Suite, copias un informe modelo y lo alimentas con los datos de tu instalación, como atenciones, tiempos de atención y evaluaciones. Así, sigues la operación en un panel propio, sin exportar planillas.
Requisitos previos
- Una cuenta de Google con acceso a Looker Studio.
- Un usuario de ¡Hola! Suite con acceso a la API y un grupo de permisos de API con el permiso Acceso a Looker Studio, en la sección Otros. Consulta Funciones de cada permiso.
- El token de ese usuario. Consulta Generar el token de acceso de la API.
- La dirección de tu instalación de ¡Hola! Suite, con
https://.
Paso a paso
Copiar el informe modelo
- Accede al informe modelo de ¡Hola! Suite.
- Haz una copia del informe y confirma en Copiar informe.
- En la copia, haz clic en Agregar datos.
- Busca y selecciona el conector de ¡Hola! Suite.
Agregar el servidor
- En el campo Seleccione la acción que desea realizar, elige Agregar servidor.
- Completa los campos:
- Nombre del servidor de tu ¡Hola! Suite: el nombre que prefieras.
- URL del servidor de tu ¡Hola! Suite: la dirección de tu instalación.
- Token API de tu ¡Hola! Suite: el token del usuario de la integración.
- Haz clic en Conectar o Guardar.
La URL debe comenzar con https://, no puede terminar con / y no puede tener nada después de .com. Ejemplo: https://tu-hola-suite.com.
Conectar al servidor
- Cambia la acción a Conectar a un servidor.
- Elige el servidor creado y haz clic en Agregar y Guardar.
Configurar la base de datos de las páginas
- En el menú del informe, selecciona Página y luego Configuración de la página actual.
- En el menú lateral, selecciona la base de datos ¡Hola! Suite.
- Repite en las tres páginas del informe.
Resultado esperado
Los gráficos del informe pasan a mostrar los datos de tu instalación.
Datos disponibles
¡Hola! Suite entrega cuatro conjuntos de datos a Looker Studio. Cada consulta devuelve hasta 10 mil filas y, si no se informa ningún período, usa el último mes.
Atenciones
El período considera la fecha de apertura de la atención.
| Campo | Qué devuelve |
|---|---|
| Protocolo | Protocolo de la atención. |
| Status | Código del estado: AG (esperando), EA (en atención), F (finalizado) o PS (en encuesta de satisfacción). |
| IdCliente | ID del cliente en la integración con el ERP. |
| Cliente | Nombre del cliente. |
| Contato | Nombre del contacto. |
| Departamento | Nombre del departamento. |
| Atendente | Nombre del agente. |
| Canal | Tipo del canal de comunicación. |
| CanalNome | Nombre del canal de comunicación. |
| AbertoPor | Quién inició la atención: atendente o contato. |
| Origem | Para atenciones que vinieron de un anuncio de WhatsApp, el título, el enlace y el ID del anuncio. En las demás, -. |
| Motivo | Último motivo registrado en la atención. |
| DataAbertura | Fecha en que se abrió la atención. |
| DataInicio | Fecha en que la atención fue asumida o salió del agente virtual. |
| DataUltimaInteracao | Fecha de la última interacción. |
| DataFinalizacao | Fecha en que la atención fue finalizada. |
| AvaliacaoFS | Promedio de las notas de satisfacción dadas por el cliente, de 1 a 5. Vacío cuando no hay evaluación. |
| FCR | Sim o Não, según la última respuesta a la pregunta de resolución en el primer contacto. - cuando no hay respuesta. Consulta [[encuesta-de-satisfaccion-y-fcr |
| TA | Tiempo total de atención, en segundos. |
| TE | Tiempo total de espera en la fila, en segundos. |
| FinalizadoAgenteVirtual | true cuando la atención fue finalizada por el agente virtual. |
| FinalizadoAtendente | true cuando la atención fue finalizada por un agente. |
Las fechas llegan en el formato año, mes, día, hora, minuto y segundo (AAAAMMDDhhmmss). Los campos sin valor llegan como -.
Atenciones asumidas
El período considera la fecha en que el agente asumió la atención.
| Campo | Qué devuelve |
|---|---|
| Protocolo | Protocolo de la atención. |
| Atendente | Nombre del agente. |
| Departamento | Nombre del departamento. |
| DataAssuncao | Fecha en que el agente asumió. |
| DataSaida | Fecha en que el agente salió de la atención. |
| AtendimentoHumano | Indica si la atención fue hecha por una persona. |
Estado de los usuarios
El período considera la fecha de fin de cada estado.
| Campo | Qué devuelve |
|---|---|
| Usuario | Nombre del usuario. |
| Situacao | En línea, Offline, Ocupado, En pausa, Ausente o En llamada. |
| Pausa | Nombre de la pausa, cuando el estado es En pausa. |
| Inicio | Fecha en que el estado comenzó. |
| Fim | Fecha en que el estado terminó. |
| Tempo | Tiempo en el estado, en segundos. |
Llamadas perdidas
Solo llamadas recibidas que se perdieron.
| Campo | Qué devuelve |
|---|---|
| Data | Fecha y hora de la llamada. |
| Departamento | Departamento que recibiría la llamada. |
| Origem | Número de quien llamó. |
Problemas comunes
| Síntoma | Qué verificar |
|---|---|
| Looker Studio no conecta | Verifica que la URL tenga https://, no termine con / y no tenga nada después de .com. |
| Error de permiso al buscar datos | El grupo de API del usuario no tiene el permiso Acceso a Looker Studio. |
| Error de autenticación | El token fue reemplazado por uno nuevo. Actualiza el token en el servidor de Looker Studio. |
| Acceso negado por la red | La IP de Looker Studio no está en las Redes permitidas del grupo de API. Consulta [[redes-permitidas |
| Los datos no aparecen en una página | Configura la base de datos ¡Hola! Suite en Configuración de la página actual, en las tres páginas. |
Buenas prácticas
- Usa un usuario y un grupo de API solo para Looker Studio, con el permiso Acceso a Looker Studio y ningún otro.
- Guarda el token en un lugar seguro y comparte la copia del informe solo con quien lo necesita.