Cómo configurar un bot de consultas de Google Sheets en Discord

Antes de empezar

• Activa el módulo Pro Sheet Lookup en un bot de un servidor de Discord que gestiones. Elige un servidor o canal de prueba antes de compartir el comando.
• Prepara una pestaña con encabezados no vacíos y al menos dos columnas. Elige una columna de claves únicas y una o más columnas que puedas mostrar en Discord.
• No incluyas datos privados, sensibles ni restringidos. El módulo acepta un enlace CSV publicado, no una hoja privada; cualquiera con el enlace puede acceder a la pestaña publicada.

1. Prepara una pestaña pequeña con claves únicas

   Usa la primera fila como encabezados y añade filas de prueba inocuas. Por ejemplo, Item puede ser la columna de clave y Answer la de salida. Cada clave debe aparecer una sola vez. La consulta elimina espacios al principio y al final e ignora mayúsculas, pero no busca texto parcial ni elige entre duplicados.

   Necesitas al menos dos columnas, encabezados no vacíos y filas con el mismo número de campos que los encabezados. El módulo rechaza CSV mal formado, columnas seleccionadas inexistentes y claves duplicadas.

2. Publica esa pestaña como enlace CSV

   En Google Sheets, publica en la web la pestaña preparada como valores separados por comas (.csv) y copia el enlace HTTPS resultante. Sheet Lookup valida una URL de hoja publicada de docs.google.com con la ruta de publicación y el parámetro output=csv. Puede conservar gid y single=true si forman parte de esa URL.

   No uses el enlace de edición, una exportación de archivo, una URL de API ni un enlace que requiera iniciar sesión: la validación los rechaza. Comprueba en una sesión privada del navegador que el enlace corresponde a la pestaña que querías compartir.

3. Configura el enlace y las columnas de respuesta

   Abre la pestaña de módulos de tu bot, selecciona Sheet Lookup y el servidor, y pega el enlace CSV publicado. Selecciona la columna de clave única y los campos que quieres mostrar. El módulo admite una columna de clave y de una a diez columnas de salida; internamente las posiciones empiezan en cero.

   Mantén lookup como nombre para la primera prueba o elige un nombre en minúsculas con letras, dígitos, guiones o guiones bajos. Debe tener entre uno y 32 caracteres y no sustituir un comando reservado. Guarda y activa las consultas para el servidor solo después de revisar los datos públicos.

4. Prueba una clave exacta en Discord

   Ejecuta /lookup con un valor de la columna de clave. En el ejemplo Item y Answer, /lookup key:rules coincide con una celda Rules aunque cambien las mayúsculas o los espacios alrededor. Los campos elegidos aparecen en una respuesta efímera, visible solo para quien ejecutó el comando.

   Prueba una clave conocida y otra desconocida. La desconocida devuelve una respuesta sin coincidencia, no una búsqueda parcial. Si la clave aparece en varias filas, el módulo informa del duplicado. Corrige los datos y repite la prueba.

5. Entiende la actualización y los errores

   El módulo obtiene la pestaña al recibir una consulta. Puede conservar datos correctos en memoria hasta cinco minutos, o menos si lo indica la política de caché de la fuente. La respuesta incluye la hora de la última actualización correcta; un cambio reciente puede no aparecer en la siguiente consulta.

   Si el enlace falla, vuelve a publicar la pestaña como CSV y comprueba la dirección HTTPS de docs.google.com. Si faltan columnas, revisa sus posiciones y los encabezados. Los límites son 1 MiB, 5.000 filas de datos no vacías y 100 columnas. Tras un fallo, evita reintentos continuos: hay una espera de 30 segundos entre actualizaciones.

6. Mantén una referencia clara y pequeña

   Explica a los miembros el nombre del comando y qué clave deben introducir: una etiqueta de regla, un código de artículo u otro identificador exacto. No lo presentes como un buscador de chat: no admite búsquedas aproximadas o parciales, varias pestañas, evaluación de fórmulas ni escritura.

   Revisa la pestaña si cambias encabezados o campos visibles. Cambiar la URL o desactivar el módulo borra la caché en memoria. El módulo no guarda el historial de consultas en disco; una respuesta no demuestra que la hoja sea privada ni permanente.