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

# Conectar Google Sheets

> Conecta tus hojas de Google para que tu agente consulte datos reales y deje asentado el resultado de cada conversación.

Google Sheets es la integración para quien todavía lleva su operación en hojas de cálculo, y funciona sorprendentemente bien: tu agente busca el folio de un pedido, lee el estado de un trámite y responde con el dato real en vez de una respuesta genérica.

También sirve al revés: dejar cada conversación como una fila al final de la hoja, sin que nadie capture nada.

## Qué necesitas antes de empezar

* Una cuenta de **Google** con acceso de edición a la hoja que quieres usar.
* La hoja ya creada, con **encabezados en la primera fila**. Tu agente busca por columna, así que una hoja sin encabezados le complica el trabajo.
* Plan **Starter** o superior en Ryvo, con el módulo Engine activo.

## Cómo conectarla

<Steps>
  <Step title="Abre Configuración › Integraciones">
    En el portal, entra a **Configuración** y después a **Integraciones**. Busca la tarjeta de **Google Sheets**.
  </Step>

  <Step title="Da clic en Conectar app">
    Se abre la pantalla de autorización de Google en una ventana nueva. La tarjeta queda mientras tanto en **En curso**.
  </Step>

  <Step title="Elige la cuenta y acepta los permisos">
    Selecciona la cuenta de Google dueña de la hoja y acepta.
  </Step>

  <Step title="Vuelve a Ryvo">
    Regresas solo a la pantalla de Integraciones y la tarjeta pasa a **Conectada**. Google Sheets no te pide nada más.
  </Step>
</Steps>

## Lo que tu agente puede hacer ya conectada

| Acción           | Qué hace en la conversación                                                                                     |
| ---------------- | --------------------------------------------------------------------------------------------------------------- |
| **Buscar fila**  | Busca un dato en la hoja, por ejemplo el estado de un pedido por su folio, para responder con información real. |
| **Agregar fila** | Agrega un registro al final de la hoja, para dejar asentado el resultado de la conversación.                    |
| **Leer rango**   | Lee un rango de celdas cuando necesita varios datos de golpe.                                                   |

Las acciones se encienden una por una desde **Ver acciones** y la sección [**Tools**](/es/guides/agents/tools) del constructor, con un tope de **10 acciones de integración por agente**.

<Note>
  Tu agente necesita saber **en qué hoja** trabajar. Eso se le dice en las instrucciones del agente, en el constructor: pon ahí el id de la hoja (la parte larga de su URL) y el nombre de la pestaña.
</Note>

## Qué hacer si algo falla

| Lo que ves                                            | Qué pasó                                                                            | Qué hacer                                                                 |
| ----------------------------------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| El agente dice que no encontró la hoja                | La cuenta que autorizaste no tiene acceso a esa hoja, o el id que le diste está mal | Comparte la hoja con la cuenta conectada y revisa el id en la URL         |
| **Agregar fila** escribe en la pestaña equivocada     | El agente no tiene el nombre de la pestaña en sus instrucciones                     | Escríbelo en las instrucciones del agente, en el constructor              |
| **La cuenta dejó de responder. Vuelve a conectarla.** | Le quitaste el acceso a Ryvo desde tu cuenta de Google                              | Da **Reconectar**: Ryvo revoca lo viejo y abre la autorización desde cero |