Índice:
- Video demonstrativo
- Inclusión de nuevos datos en una hoja de cálculo de Google mediante una API
- Creando el flujo de investigación en el Builder
- Integración del flujo de investigación con Google Sheet
- Finalización del flujo de investigación
Video demonstrativo
Inclusión de nuevos datos en una hoja de cálculo de Google mediante una API
1º Activación del servicio de Sheets en su proyecto
Cree un token de OAuth a través del ID de Cliente y el ID Secreto y una cuenta de Google para acceder a Google Developer.
2º Agregar Proyecto.
En la esquina superior izquierda, haga clic en su proyecto actual. Se abrirá una nueva ventana y en este momento deberá hacer clic en Crear Nuevo Proyecto, en la esquina superior derecha de esta ventana.
La siguiente imagen muestra el paso a paso:
Dale un nombre a tu proyecto y guárdalo.
3º Activar el Servicio de Hojas de cálculo en tu Proyecto
En la esquina superior izquierda, haz clic en ☰. Esto abrirá una nueva ventana a la izquierda y en este punto, haz clic en APIs y Servicios y luego en Biblioteca. Busca la palabra "Sheets" y selecciona la primera opción. Ahora simplemente haz clic en "Activar" en el centro de la pantalla.
Este proceso debe repetirse, pero esta vez, haz clic en ☰ y ve a APIs y servicios > Panel.
En este nuevo entorno, haz clic en Pantalla de Consentimiento de OAuth en el menú lateral izquierdo y, en Tipo de Usuario, selecciona Externo, luego haz clic en CREAR.
Luego, establece un nombre para la API, ingresa el correo electrónico de soporte y de los desarrolladores. Al final de la página, haz clic en GUARDAR Y CONTINUAR. A continuación, en la siguiente página que aparecerá, haz clic en el mismo botón al final de la página de GUARDAR Y CONTINUAR. Haz esto hasta llegar al paso 4.
En el cuarto paso, deberás ir al final de la página y hacer clic en VOLVER AL PANEL, que será la Pantalla de Consentimiento de OAuth.
Simplemente ve a PUBLICAR APLICACIÓN, como se muestra en la imagen a continuación:
El estado cambiará a "En producción".
Creando Credenciales
En el menú lateral izquierdo, haz clic en Credenciales. En esta página, haz clic en + CREAR CREDENCIALES y luego en la opción ID de cliente OAuth.
Ahora, selecciona "Aplicación web" como opción para el Tipo de aplicación e introduce el nombre de tu elección. En este momento, necesitarás prestar mucha atención, ya que es una parte importante. Ingresa los siguientes enlaces del portal en las URLs de redireccionamiento autorizadas:
- https://www.portal.blip.ai/application
- https://developers.google.com/oauthplayground
- https://www.developers.google.com/oauthplayground
Luego, haz clic en "Crear" y sigue con las claves:
En este punto, aparecerá una ventana con las credenciales. ¡Asegúrate de guardar toda esta información!
Autorizando las credenciales
El siguiente paso es acceder a https://developers.google.com/oauthplayground y hacer clic en el engranaje en la esquina superior derecha. En el nuevo cuadro de diálogo, habilita la opción "Use your own OAuth credentials" y completa con los datos que recopilaste en el paso anterior.
Para finalizar, selecciona el correo electrónico al cual se vinculará OAuth y haz clic en "Permitir":
A continuación, haz clic en "Código de autorización de intercambio de tokens" para obtener el token de actualización. Esto se usará para actualizar el token de acceso una vez que expire cada 60.
Presiona CTRL+F para buscar la palabra "Sheets". Selecciona la opción "Google Sheets API v4" para expandirla. Luego, selecciona la opción que tenga el nombre de las hojas de cálculo.
Después de seleccionar, haz clic en "Autorizar API". Si se te pide que autorices el acceso a dominios desconocidos, no hay problema: simplemente continúa como de costumbre.
Si te encuentras con este error, haz clic en la descripción que aparece debajo de "Más información" y copia la URL del aviso.
En "Intercambio de código de autorización por tokens", habrá un código de autorización.
Si los tokens no se generaron automáticamente, haz clic en "Intercambio de código de autorización por tokens".
Necesitarás el "Refresh token" más adelante, así que guarda esa información.
Creando la hoja de cálculo
En esta última etapa de integración con Sheets, necesitarás crear una hoja de cálculo en Google y nombrar las columnas.
ATENCIÓN: si no nombras las columnas, es posible que falle la integración. Utiliza al menos un nombre "temporal".
Con tu hoja de cálculo lista, deberás almacenar el código, que es la información que se encuentra después de /d/ y antes de /edit en la URL.
En nuestra propuesta, la hoja de cálculo tendrá las siguientes columnas:
Data | ticket | agente | tiempo | puntuación |
Puedes incluir o excluir información según sea necesario.
Creando un flujo de encuesta en el Builder
1º Para crear el flujo, necesitamos:
- Bloque de finalización de atención;
- Bloque de realización de encuesta;
- Bloque de justificación de la calificación (opcional);
- Bloque de agradecimiento por la evaluación.
El bloque de finalización debe estar justo después del bloque de atención humana. Si estás utilizando una estructura de enrutador y subbots, puedes usar un flujo para capturar la encuesta de satisfacción, por ejemplo.
El flujo debe seguir esta lógica:
2º En el bloque de Finalización, vamos a definir las siguientes variables:
- agente;
- ticket;
- time.
Nota: Puedes utilizar otros nombres.
Acciones > Acciones de Entrada > Definir Variable
Cada variable tendrá el siguiente valor:
agente > {{input.content@agentIdentity}}
ticket > {{input.content@sequentialId}}
time > {{input.content@team}}
El nombre de tu variable puede ser cambiado, pero estos valores son estándar de Blip.
Para asegurarte de que el usuario pase a la siguiente etapa del flujo (Encuesta de Satisfacción), cambia la Salida Predeterminada al bloque de Encuesta de Satisfacción.
Como sugerencia de contenido para este bloque, podríamos poner algo como: "Su atención fue finalizada por la persona que lo atendió, ¡está hablando nuevamente conmigo, Joy! 😃"
3º Bloque de Encuesta de Satisfacción
Haga clic en la entrada del usuario y active Guardar respuesta en variable y Validar entrada del usuario. Asigne un nombre a su variable. Aquí la llamaremos "score".
En el tipo de validación, elija Número y proporcione una instrucción al usuario en caso de error, por ejemplo: "Por favor, ingrese un número entre 0 y 5, donde 0 es pésimo y 5 excelente".
Vamos a poner las siguientes condiciones de salida en este bloque:
Si la calificación es igual o menor a tres, el usuario irá al bloque de justificación.
Si la calificación es igual o mayor que 4, irá al bloque de verificación (o a otro bloque de finalización que tengas).
Integrando el flujo de encuesta con Google Sheet
Solicitud HTTP
Ahora, crearemos dos Acciones de Salida en el bloque Encuesta de Satisfacción del tipo Solicitud HTTP. Haremos esto para integrar nuestra encuesta con Google Sheet.
La primera será para autorizar Google Sheet. Utilizaremos el método POST y la URL https://accounts.google.com/o/oauth2/token
Los Encabezados vacíos permanecen vacíos. En el campo Guardar Respuesta, coloque status1 y oauth.
En el cuerpo de esta solicitud, colocaremos el siguiente código:
{
"client_secret": "seu_id_secreto",
"grant_type": "refresh_token",
"refresh_token": "seu_refresh_token",
"client_id": "seu_id_de_cliente"
}
Recuerda que esta información debe ser reemplazada con los datos generados en tus credenciales de Google Cloud Platform seu_id_secreto, seu_refresh_token e seu_id_de_cliente
Una vez realizados los cambios, presiona ctrl + s para guardar
La siguiente solicitud es para integrar con la hoja de cálculo. En el mismo bloque, regrese a las Acciones de Salida y seleccione Solicitud HTTP. Una vez más, el método será POST y en la URL, ingresará el siguiente enlace completado:
https://sheets.googleapis.com/v4/spreadsheets/{{codigo da sua planilha}}/values/{{nome da aba}}!{{colunas escolhidas}}:append?insertDataOption=INSERT_ROWS&responseDateTimeRenderOption=FORMATTED_STRING&valueInputOption=USER_ENTERED
Ejemplo de enlace completado:
https://sheets.googleapis.com/v4/spreadsheets/1nwvwDBddNRJoKe9P3OO6j4CO53c2JUyuzwgvTS1g2qg/values/nota!A:C:append?insertDataOption=INSERT_ROWS&responseDateTimeRenderOption=FORMATTED_STRING&valueInputOption=USER_ENTERED
Em cabeçalhos, coloque KEY Authorization e Value Bearer {{oauth@access_token}}
En el cuerpo, coloque el siguiente código (o según las variables que desee usar):
{
"values": [
[
"{{calendar.datetime}}",
"{{ticket}}",
"{{agente}}",
"{{time}}",
"{{score}}"
]
]
}
Esa variable {{calendar.datetime}} es estándar en la biblioteca Blip para registrar la fecha y hora.
Las variables deben insertarse en el orden correcto según la columna a la que pertenecen.
En 'Salvar Resposta', coloque 'status2' y 'resposta'.
Por favor, preste atención al orden de las solicitudes. La primera debe ser la de autorización, seguida de la de la hoja de cálculo.
Finalizando el flujo de encuesta
1. Bloque Justificar Nota
Aquí, agradeceremos la evaluación y pediremos al usuario que explique el motivo de su calificación. Puede registrar la entrada del usuario en un registro de eventos, dirigirlo al servicio de atención al cliente, integrarlo con la hoja de cálculo. ¡Use la imaginación!
Como condición de salida, dirigiremos al usuario al bloque Agradecer Justificación.
2. Agradecer la justificación
Si el usuario deja un mensaje, debemos agradecérselo. Luego, diríjalo al bloque de finalización. Asegúrese de cambiar las condiciones de salida según la estrategia que va a adoptar en su flujo.
Ejemplo de una hoja de cálculo completada:
Ahora solo tienes que publicar y probarlo.
¡Aquí te dejamos algunas sugerencias de frases, registros de datos y flujo, pero nadie mejor que tú para saber qué tiene sentido para tu negocio!
Si necesitas ayuda, ¡cuenta con el equipo de éxito del cliente de Blip!
Para obtener más información, acceda a la discusión sobre el tema en nuestra comunidad o los videos en nuestro canal. 😃