> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tess.im/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Sheets

> Conecta Google Sheets a Tess para leer, analizar y actualizar hojas de cálculo desde el chat y los agentes.

El conector de **Google Sheets** integra Tess con Google Sheets. Una vez conectado, la IA puede consultar datos de hojas, ayudar a estructurar reportes y apoyar actualizaciones operativas dentro de chats y agentes.

El conector **Google Sheets** forma parte del ecosistema de [Connectors](/es/connectors) de Tess y usa autenticación **OAuth** para conectores de Apps.

## Prerrequisitos

<Info>
  * Una cuenta de Google con acceso a las hojas que necesitas.
  * Permiso para autorizar scopes OAuth de Google Sheets.
</Info>

## Cómo conectar

<Tip>
  En algunos conectores de Apps, la pantalla de consentimiento OAuth puede mostrar el nombre de un puente de conexión de terceros en lugar de Tess. Es normal: revisa los permisos solicitados y continúa si coinciden con lo que esperas.
</Tip>

<Steps>
  <Step title="Abre el panel de Connectors">
    En el chat, haz clic en el **+** junto al cuadro de mensaje y selecciona **Connectors**.
    También puedes gestionar conectores al editar un agente en Agent Studio.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/google-sheets/01-connect-panel.png" alt="PRINT: (Panel de Connectors con Google Sheets destacado y el botón Connect visible)" />
    </Frame>
  </Step>

  <Step title="Localiza Google Sheets y haz clic en Connect">
    En **Apps**, encuentra **Google Sheets** y haz clic en **Connect** para iniciar la autenticación.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/google-sheets/02-oauth-consent.png" alt="PRINT: (Pantalla de autorización / consentimiento del proveedor para Google Sheets)" />
    </Frame>
  </Step>

  <Step title="Autoriza el acceso">
    Inicia sesión con la cuenta que quieras usar y revisa los permisos solicitados antes de confirmar.
  </Step>

  <Step title="Confirma que está activo">
    Al volver a Tess, **Google Sheets** debería aparecer en **Connected**, listo para chats y agentes.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/google-sheets/03-connected.png" alt="PRINT: (Callback de Tess o lista de Connectors mostrando Google Sheets como Connected con estado de éxito)" />
    </Frame>
  </Step>
</Steps>

## Qué puedes hacer

* **Leer datos de hojas** en archivos y pestañas accesibles
* **Analizar métricas y tendencias** para generar resúmenes
* **Actualizar celdas o añadir filas** cuando haya permiso de escritura
* **Apoyar reporting operativo** con datos vivos de la hoja
* **Ayudar a los equipos a convertir tablas en decisiones** más rápido

## Ejemplos de prompt

> 1. Analiza la hoja de leads y dime qué contactos no tuvieron follow-up en los últimos 7 días.
> 2. Lee la hoja de métricas mensuales y genera un resumen ejecutivo de las principales desviaciones.
> 3. Añade una fila con el total de ventas de hoy en la pestaña Cierre Diario.
> 4. ¿Qué columnas parecen incompletas en el tracker de onboarding?

## Buenas prácticas

* Indica el nombre de la hoja o el contexto del link cuando haya archivos parecidos.
* Pide una vista previa antes de escrituras masivas.
* En agentes, define si Sheets es para análisis, reporting o entrada de datos.

## Troubleshooting

<AccordionGroup>
  <Accordion icon="circle-question" title="App bloqueada / error de API">
    Vuelve a conectar y confirma que la cuenta de Google puede autorizar Sheets. Los admins de Workspace pueden necesitar permitir la app.
  </Accordion>

  <Accordion icon="circle-question" title="401 / conexión caída">
    Vuelve a conectar Google Sheets en Connectors tras cambios de credenciales o políticas.
  </Accordion>

  <Accordion icon="circle-question" title="No puedo editar la hoja">
    La cuenta conectada puede ser de solo lectura. Usa una cuenta con acceso de edición.
  </Accordion>
</AccordionGroup>

<Note>
  Tess usa los permisos de la cuenta conectada. No amplía el acceso más allá de lo que esa cuenta ya puede hacer.

  Los conectores implican acceso a sistemas externos. Conecta solo cuentas adecuadas al contexto de uso y revisa los permisos con cuidado.
</Note>