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

# Google Sheet

> Integra Keplero AI con Google Sheet

Con Keplero AI puoi integrare facilmente Google Sheet per:

* *Aggiungere dati* alle tue tabelle con l’azione **Append Row**
* *Leggere dati* già presenti utilizzando l’azione **Read Row**

<Tabs>
  <Tab title="Append Row" icon="pencil">
    ## Creazione dell'azione Append Row

    Per aggiungere dati ai tuoi Google Sheet con l’azione **Append Row** segui questi passaggi:

    1. Vai nella sezione **Addestramento**
    2. Clicca su **Integrazioni**
    3. Clicca su **+ Nuova integrazione**
    4. Seleziona **Altro**
    5. Clicca su **Google Sheet: Append Row**

    <Frame>
      <img src="https://mintcdn.com/kepleroai-5b702e55/FO14W-G6hNM8l9db/images/integrazioni/google-sheet/gs-1.png?fit=max&auto=format&n=FO14W-G6hNM8l9db&q=85&s=8df89f63f694d52398aa903b70c7d697" alt="Google Sheet: Append Row" width="1890" height="1278" data-path="images/integrazioni/google-sheet/gs-1.png" />
    </Frame>

    ## Impostazioni dell'azione Append Row

    1. Nel pannello della nuova azione, dovrai inserire il nome dell'azione (ad esempio *"salva\_info\_lead"*).
    2. Successivamente dovrai collegare l'account Google con cui hai accesso al Google Sheet.
    3. Una volta collegato, apparirà un pulsante con scritto **"Scegli Google Sheet"**: al click, potrai selezionare il Google Sheet in cui vuoi salvare i dati.

    <Frame caption="Una volta collegato l'account, apparirà il pulsante per scegliere il Google Sheet">
      <img src="https://mintcdn.com/kepleroai-5b702e55/FO14W-G6hNM8l9db/images/integrazioni/google-sheet/gs-2.png?fit=max&auto=format&n=FO14W-G6hNM8l9db&q=85&s=4f07703588a6a8a8a9f5ce29a1b90c49" alt="Google Sheet: Scegli Google Sheet" width="1890" height="1278" data-path="images/integrazioni/google-sheet/gs-2.png" />
    </Frame>

    4. Spiega a Keplero quando utilizzare quest'azione (ad esempio *"Usa questa azione quando l'utente chiede qualsiasi cosa sui prodotti o servizi"*).
    5. Automaticamente, Keplero vedrà le colonne del Google Sheet. Spiega brevemente a Keplero, in ogni casella, cosa è contenuto in quella colonna, impostando il tipo di contenuto (Testo, Numero, Booleano o Data) e scrivendo una breve descrizione. Puoi marcare come **Opzionale** una colonna.

    <Frame caption="Keplero vedrà le colonne del Google Sheet e ti chiederà di spiegare cosa è contenuto in ogni colonna">
      <img src="https://mintcdn.com/kepleroai-5b702e55/FO14W-G6hNM8l9db/images/integrazioni/google-sheet/gs-3.png?fit=max&auto=format&n=FO14W-G6hNM8l9db&q=85&s=a3be596b80d9d39664f7fa7b991a9f3f" alt="Google Sheet: Colonne del Google Sheet" width="1584" height="328" data-path="images/integrazioni/google-sheet/gs-3.png" />
    </Frame>

    6. Salva l'azione con il tasto **Salva**.
    7. Abilita l'azione con il tasto dedicato in alto a destra.

    <Frame caption="Una volta salvata l'azione, abilitala con il tasto dedicato">
      <img src="https://mintcdn.com/kepleroai-5b702e55/FO14W-G6hNM8l9db/images/integrazioni/google-sheet/gs-4.png?fit=max&auto=format&n=FO14W-G6hNM8l9db&q=85&s=1c54ac91ccbafa21c1f74952e0c648dd" alt="Google Sheet: Abilita azione" width="1881" height="1278" data-path="images/integrazioni/google-sheet/gs-4.png" />
    </Frame>
  </Tab>

  <Tab title="Read Row" icon="eye">
    ## Creazione dell'azione Read Row

    Per aggiungere dati ai tuoi Google Sheet con l’azione **Read Row** segui questi passaggi:

    1. Vai nella sezione **Addestramento**
    2. Clicca su **Integrazioni**
    3. Clicca su **+ Nuova integrazione**
    4. Seleziona **Altro**
    5. Clicca su **Google Sheet: Read Row**

    <Frame>
      <img src="https://mintcdn.com/kepleroai-5b702e55/FO14W-G6hNM8l9db/images/integrazioni/google-sheet/gs-5.png?fit=max&auto=format&n=FO14W-G6hNM8l9db&q=85&s=f893d215261b3866047d0d25af0f3bc0" alt="Google Sheet: Read Row" width="1881" height="1278" data-path="images/integrazioni/google-sheet/gs-5.png" />
    </Frame>

    ## Impostazioni dell'azione Read Row

    1. Nel pannello della nuova azione, dovrai inserire il nome dell'azione (ad esempio *"leggi\_stato\_spedizione"*).
    2. Successivamente dovrai collegare l'account Google con cui hai accesso al Google Sheet.
    3. Una volta collegato, apparirà un pulsante con scritto **"Scegli Google Sheet"**: al click, potrai selezionare il Google Sheet in cui vuoi salvare i dati.
    4. Spiega a Keplero quando utilizzare quest'azione (ad esempio *"Usa questa azione quando un cliente ti chiede informazioni sulle spedizioni"*).
    5. Imposta le regole di filtro. Scegli quali colonne del foglio può cercare l’assistente. Puoi impostare **AND** o **OR** per le condizioni.

    <Frame>
      <img src="https://mintcdn.com/kepleroai-5b702e55/FO14W-G6hNM8l9db/images/integrazioni/google-sheet/gs-6.png?fit=max&auto=format&n=FO14W-G6hNM8l9db&q=85&s=cd4475d86cd1bb15eb196de46aa4f5be" alt="Regole di filtro" width="1640" height="1276" data-path="images/integrazioni/google-sheet/gs-6.png" />
    </Frame>

    <Tip>
      Se selezioni **AND**, ogni filtro che configuri viene applicato insieme: una riga viene restituita solo quando tutti corrispondono contemporaneamente a quella riga. Ideale quando l’assistente deve restringere i risultati con più dettagli insieme — ad esempio, la città e il cognome del cliente devono corrispondere entrambi.<br />
    </Tip>

    <Tip>
      Se selezioni **OR**, ogni filtro che configuri viene applicato come opzione: una riga viene restituita quando almeno uno di essi corrisponde — a seconda dei valori di ricerca dell’utente. Ideale quando la stessa entità può trovarsi in colonne diverse — ad esempio, l’utente può conoscere un numero di telefono o solo un indirizzo email, e in entrambi i casi la riga deve essere trovata.
    </Tip>

    6. Automaticamente, Keplero vedrà le colonne del Google Sheet. Spiega brevemente a Keplero, in ogni casella, cosa è contenuto in quella colonna, impostando il tipo di contenuto (Testo, Numero, Booleano o Data) e scrivendo una breve descrizione.

    <Tip>
      Puoi impostare la distinzione **Case Sensitive** o **Case Insensitive** per fare in modo che Keplero distingua tra maiuscole e minuscole nella ricerca o meno.
    </Tip>

    <Note>
      Puoi aggiungere ulteriori filtri cliccando sul pulsante **+ Aggiungi filtro**.
    </Note>

    <Frame caption="Keplero vedrà le colonne del Google Sheet e ti chiederà di spiegare cosa è contenuto in ogni colonna">
      <img src="https://mintcdn.com/kepleroai-5b702e55/FO14W-G6hNM8l9db/images/integrazioni/google-sheet/gs-7.png?fit=max&auto=format&n=FO14W-G6hNM8l9db&q=85&s=e70ddfab6e1e19ede48c4fffa05db9ac" alt="Google Sheet: Colonne del Google Sheet" width="1640" height="1276" data-path="images/integrazioni/google-sheet/gs-7.png" />
    </Frame>

    7. Salva l'azione con il tasto **Salva**.
    8. Abilita l'azione con il tasto dedicato in alto a destra.

    <Frame caption="Una volta salvata l'azione, abilitala con il tasto dedicato">
      <img src="https://mintcdn.com/kepleroai-5b702e55/FO14W-G6hNM8l9db/images/integrazioni/google-sheet/gs-8.png?fit=max&auto=format&n=FO14W-G6hNM8l9db&q=85&s=30db24e18c5db3a12cdb42005ea100dd" alt="Google Sheet: Abilita azione" width="1640" height="1276" data-path="images/integrazioni/google-sheet/gs-8.png" />
    </Frame>
  </Tab>
</Tabs>
