Saltar al contenido principal

[Extensión] Cómo consultar datos de una hoja de cálculo de Google Sheets durante la conversación en Blip

  • Actualización

  1. Introducción

  2. Cómo configurar la búsqueda en el flujo

  3. Soporte

 

Descripción breve: Busca la fila de un cliente por RFC, correo electrónico o número de pedido en una hoja de cálculo de Google Sheets y usa el resultado para personalizar la respuesta del bot, sin crear una API.

 

Introducción

Cuando el cliente solicita el estado de un pedido o quiere confirmar un registro, el bot necesita consultar una base de datos para responder. Con la extensión Google Sheets, puedes usar tu propia hoja de cálculo como base de consulta: el bot busca una fila a partir de un valor que el contacto proporcionó (RFC, correo electrónico, número de pedido, número de folio) y devuelve los datos de esa fila para usarlos en el flujo.

Esto funciona bien cuando ya mantienes los datos en una hoja de cálculo y quieres consultarlos durante la conversación sin crear una API ni depender de desarrollo. Para guardar nuevos datos en la hoja de cálculo, consulta la píldora para agregar una nueva fila. Para leer un rango completo de celdas, consulta la píldora de lectura de rangos.

Antes de comenzar

Confirma que ya tienes:

  • La extensión Google Sheets activada en el bot. Activa Google Sheets en Blip Store.

  • La sesión iniciada con la cuenta de Google en la pantalla de Configuración de la extensión, con los permisos de hojas de cálculo otorgados.

  • La extensión del navegador de Builder instalada. Agrega el botón Nueva integración en Builder y tiene el enlace Instalar extensión en la pantalla de Configuración de la extensión.

  • Una hoja de cálculo en Google Sheets con una pestaña organizada en columnas y una columna que sirva como clave de búsqueda (por ejemplo, correo electrónico o RFC). La cuenta de Google conectada debe tener acceso a esa hoja de cálculo.

  • Una variable del flujo con el valor que se buscará, por ejemplo {{contact.email}}.

Ejemplo de estructura de la hoja de cálculo, con una columna de clave (correo electrónico) y las columnas de datos que se devolverán:

Planilha do Google Sheets com coluna de e-mail usada como chave e colunas de pedido e status

En este ejemplo, el bot consulta la fila mediante el correo electrónico proporcionado por el contacto y usa el estado del pedido en la respuesta.

 

Cómo configurar la búsqueda en el flujo

La integración se ejecuta como una acción de salida de un bloque. Coloca el bloque después del punto en el que el contacto proporcionó el valor que se buscará.

  1. En Builder, haz clic en Nueva integración para agregar un bloque de integración al flujo.

  2. Abre el bloque y, en la pestaña Integración, selecciona Google Sheets.

Bloco de integração no Builder com Google Sheets selecionado no campo Integração

  1. En el campo Acción, selecciona Buscar una fila a partir de un valor.

Campo Ação da extensão Google Sheets com a opção Procurar por linha a partir de um valor selecionada

  1. En ID de la hoja de cálculo, proporciona el identificador de la hoja de cálculo. Se encuentra en la URL, entre /d/ y /edit.

  2. En Rango, proporciona la pestaña y el rango donde se realizará la búsqueda, por ejemplo Página1!A:D.

  3. En Valor de búsqueda, proporciona el valor que se buscará usando la variable del flujo, por ejemplo {{contact.email}}.

  4. En Guardar resultado, proporciona la Variable de resultado. La extensión busca, dentro del rango, la primera fila que contenga ese valor en cualquiera de las columnas y guarda la fila completa en esa variable.

  5. Publica el flujo y realiza una prueba. Usa la variable de resultado en los siguientes bloques para personalizar la respuesta, haciendo referencia a la columna que necesitas mediante su posición en la fila devuelta.

Formulário da ação Procurar por linha com ID da planilha, intervalo, valor de busca e variável de resultado preenchidos

Atención

El valor buscado debe existir en la hoja de cálculo exactamente como se proporcionó. La búsqueda se realiza mediante una coincidencia exacta de la celda, por lo que las diferencias de espacios, mayúsculas y minúsculas, acentos o caracteres especiales impiden que se devuelva un resultado. Si ninguna fila coincide con el valor, la variable de resultado queda vacía. Trata este caso en el flujo, por ejemplo, con una condición que responda al contacto cuando no se encuentre nada.

 

Soporte

Si tienes alguna duda o problema con la extensión, escríbenos al correo electrónico support@wiv.com.br.


 

¿Necesitas más ayuda? Explora nuestros contenidos en Blip Academy o en Blip Community, mira tutoriales en nuestro canal de YouTube o resuelve tus dudas en nuestro canal de atención 😃