Cómo hacer que la Asistencia de IA consulte una Hoja de cálculo de Google

Las siguientes instrucciones son solo para computadoras de escritorio y portátiles.
Puedes conectar Hojas de cálculo de Google a la Asistencia de IA, permitiendo que tu agente de IA incorpore datos de la hoja de cálculo en tiempo real a las conversaciones. Esta función te permite buscar inventario, confirmar reservas, encontrar detalles de pedidos o recuperar registros de clientes, todo sin salir del chat.

 Antes de empezar 

Asegúrate de tener:


  • Un plan activo y pagado de Asistencia de IA: Growth, Business o Enterprise.
  • Una cuenta de Google con acceso a la hoja que deseas usar.
  • Conocimientos básicos de codificación en Google Apps Script y OpenAPI/YAML. Si no estás familiarizado con la codificación, te recomendamos solicitar la ayuda de un desarrollador. Para obtener más información, visita nuestro portal de desarrolladores.

 Prepara tu Hoja de cálculo de Google 

Aquí tienes algunos consejos para organizar tu hoja de cálculo para que sea fácil de buscar y devuelva resultados fiables:


  • Utiliza una fila de encabezado clara con nombres de columna descriptivos.
  • Agrega una columna de identificador único para búsquedas directas (por ejemplo: SKU, ID de pedido o Correo electrónico).
  • Mantén un único tipo de datos dentro de cada columna. Por ejemplo, mantén las fechas en una columna y los números en otra para simplificar la gestión de datos.
  • Evita las celdas fusionadas o las columnas ocultas. En su lugar, mantén tus datos en un formato tabular para una mejor accesibilidad.


Ejemplo


Tu Hoja de cálculo de Google puede contener detalles de pedidos, descripciones de productos o información general.

Por ejemplo:
Importar una hoja de cálculo desde tu computadora
Si tus datos están en un archivo, puedes importarlos fácilmente a Hojas de cálculo de Google:


  1. Abre Hojas de cálculo de Google y haz clic en Archivo > Importar.
  2. Selecciona la pestaña Subir y elige tu archivo, o arrástralo a la ventana.
  3. Elige cómo deseas importar el archivo:
    • Crear una hoja de cálculo nueva (recomendado)
    • Insertar hoja(s) nueva(s) en la hoja de cálculo actual
    • Reemplazar hoja de cálculo o Reemplazar hoja (usar con precaución)
  4. Haz clic en Importar datos y verifica la fila de encabezado y los tipos de columna.

Tipos de archivo compatibles: .xlsx, .xls, .csv, .tsv, .ods.

Crear e implementar una aplicación web de Google Apps Script 

1. En tu Hoja de cálculo de Google, ve a Extensiones > Apps Script.
2. La consola de Apps Script se abrirá en una nueva pestaña. Ingresa un script en Code.gs para describir los métodos para consultar tu hoja.

Puedes comenzar con este script de ejemplo: Code.gs en GitHub. El ejemplo busca en una columna específica (SKU) y es un punto de partida simple; modifícalo para que coincida con tus datos y reglas de búsqueda. Para obtener más información sobre cómo personalizar el script, haz clic aquí.
3. Haz clic en Implementar > Nueva implementación.
4. Haz clic en el ícono de engranaje junto a Seleccionar tipo y elige Aplicación web.
5. Ingresa la Descripción. Configura Ejecutar como en Yo. Esto le da a tu script acceso a tu hoja.

Configura Quién tiene acceso en Cualquier persona. Esto permite que la Asistencia de IA consulte tu hoja usando tu script.

Luego, haz clic en Implementar.

6. Copia y guarda la URL de la Aplicación web. La necesitarás para tus especificaciones de API.
Nota: Se genera una nueva URL con cada implementación.

 Crear una especificación OpenAPI 

La Asistencia de IA necesita un archivo OpenAPI (YAML o JSON) que describa cómo llamar a tu aplicación web.

Puedes copiar las especificaciones en este ejemplo. Asegúrate de:
  • Reemplazar el valor de servers.urls con la URL de la Aplicación web copiada de Apps Script anterior.
  • Eliminar /exec del final de la URL.
  • Modificar los parámetros relevantes para que se ajusten a tus necesidades. Para obtener más información sobre cómo personalizar las especificaciones, haz clic aquí.

Utiliza un validador/editor como Swagger Editor para verificar tu YAML/JSON. Copia y guarda la URL de tu archivo sin procesar. La necesitarás para la siguiente sección.

Nota: El “título” en tus especificaciones aparecerá como el nombre de la integración en tu panel de tawk.to.


Por ejemplo:

Si tienes varias integraciones de API, dale a cada una un nombre descriptivo para que sea fácil de encontrar.

Agregar la integración en tawk.to
Nota: Necesitarás un plan de pago de Asistencia de IA para realizar esta integración.
1. Inicia sesión en tu cuenta de tawk.to y selecciona la propiedad correcta.
2. Haz clic en Automatización en la barra de navegación izquierda.
3. Haz clic en Integraciones en el submenú de la izquierda.
4. Haz clic en OpenAPI Server en Herramienta personalizada.
También puedes buscar “OpenAPI” utilizando la barra de Búsqueda en la parte superior.
5. Esto abre la página Descripción general del Servidor OpenAPI. Haz clic en Instalar en la esquina superior derecha.
6. En la ventana emergente, ingresa los detalles de tu esquema:
- Selecciona URL del Archivo de Esquema e ingresa la URL de tu esquema, o
- Selecciona Paste Schema y pega tu esquema en JSON

Deja URL Base de la API blank, y elige Sin Autenticación bajo Método de autenticación.

Luego, haz clic en Guardar.
7. Después de guardar, haz clic en Agentes en el submenú de la izquierda.
8. Selecciona tu agente de IA. Luego, haz clic en Herramientas en el menú de la izquierda. Asegúrate de que la integración esté habilitada en Estado.
Prueba tu integración usando la vista previa del widget a la derecha. 

 Prueba y refina 


  • Ejecuta consultas comunes y de casos extremos en la vista previa del panel.

  • Usa Logger.log() en Apps Script y verifica la página de Ejecuciones en busca de errores.

  • Confirma que el esquema OpenAPI coincide con la salida JSON real.

  • Almacena en caché los resultados frecuentes si las respuestas son lentas.

  • Mantén las respuestas consistentes (mismos campos y tipos) para que la Asistencia de IA pueda analizarlas de manera confiable.

 Notas de seguridad 

Sé cauteloso al manejar información sensible. Devuelve solo los campos que la Asistencia de IA necesita y monitorea el uso en busca de actividad inusual.

 Consideraciones adicionales 


  • Límites de frecuencia (Rate limits)
    Considera las cuotas de Google Apps Script y diseña para reintentos y retroceso exponencial.

  • Protección de datos
    Cumple con GDPR y otras leyes de privacidad aplicables al devolver datos personales.

  • Control de versiones
    Cuando cambies tu especificación OpenAPI, incrementa una versión o update el título para que las integraciones sigan siendo claras.

Si tienes comentarios sobre este artículo o si necesitas más ayuda:




¿Te ha sido útil el artículo?

A 5 de 15 les gusta este artículo