Cuando un bot recopila información valiosa durante una conversación, esos datos no pueden quedarse atrapados en el chat. La verdadera utilidad aparece al enviar esa información a un lugar accesible fuera de la conversación, como una hoja de cálculo en la nube. Integrar Google Sheets con un bot permite centralizar solicitudes de agenda para que un asistente las gestione en tiempo real, por ejemplo, en una veterinaria.
¿Cómo configurar Google Cloud Console para conectar la API de Google Sheets?
El primer paso es acceder a Google Cloud Console [0:44], la plataforma donde se administran todas las APIs de la nube de Google. Puedes registrarte o iniciar sesión con cualquier cuenta de Gmail. Aunque la mayoría de servicios de Google Cloud pueden tener un costo, para este tipo de integración existe una capa gratuita que permite trabajar sin configurar facturación.
Una vez dentro de la consola, es necesario crear un nuevo proyecto [1:24]. Este proyecto funciona como un contenedor donde se asignan las APIs que va a consumir tu aplicación. En este ejemplo, el proyecto se llama "MedPet" y se asocia a una organización existente.
¿Qué significa habilitar la API de Google Sheets?
Con el proyecto creado y seleccionado, el siguiente paso es buscar la Google Sheets API y habilitarla [1:55]. Habilitar una API significa activar el permiso para que tu proyecto pueda comunicarse con ese servicio específico de Google. Una vez habilitada, se obtiene acceso a un archivo de configuración que conecta tu código con la API para realizar acciones sobre documentos de Google Sheets.
¿Cómo crear las credenciales necesarias para la conexión?
El proceso de credenciales tiene dos partes importantes:
- Credenciales OAuth [2:41]: se selecciona Google Sheets API, se elige la opción de datos del usuario, se asigna un nombre a la aplicación y se configura como aplicación web. Al finalizar, se descarga un archivo JSON con la configuración.
- Cuenta de servicio [3:32]: se crea una credencial de tipo cuenta de servicio con un nombre y un rol de propietario. Esto genera un correo electrónico único que será fundamental más adelante para dar permisos de acceso al documento.
Dentro de la cuenta de servicio recién creada, se debe generar una clave en formato JSON [4:07]. Este archivo se descarga automáticamente y contiene las credenciales que tu proyecto necesita para autenticarse contra la API.
¿Cómo agregar las credenciales al proyecto en Visual Studio Code?
En tu editor de código, crea una carpeta llamada credentials [4:28]. Dentro de ella, agrega un nuevo archivo con extensión .json y pega el contenido del archivo que descargaste desde Google Cloud Console. Esta es la configuración mínima que tu bot necesita para empezar a interactuar con Google Sheets.
¿Cómo preparar el documento de Google Sheets para recibir datos?
El último paso de configuración es crear un nuevo documento de Google Sheets [4:52] dentro de la organización o usuario vinculado a tu cuenta de Google Cloud. Puedes utilizar un template como base.
Lo más importante es compartir ese documento con la cuenta de servicio:
- Abre el documento y ve a la opción de compartir.
- Agrega el correo electrónico de la cuenta de servicio.
- Asígnale el rol de editor [5:16].
- Envía la invitación.
Con estos permisos configurados, tu bot tendrá la capacidad de insertar nuevos registros directamente en la hoja de cálculo cada vez que un usuario complete el flujo de reserva.
Un detalle crucial: si modificaste los datos que solicita tu bot durante el flujo de agendar cita, asegúrate de que las columnas del documento coincidan en orden y contenido [5:36] con los campos que estás recibiendo. Si no hay coincidencia entre lo que envías y lo que espera la hoja, la inserción de datos no funcionará correctamente.
¿Ya lograste conectar tu bot con Google Sheets o tienes dudas sobre algún paso de la configuración? Comparte tu experiencia en los comentarios.
