# Manage Google Sheet

**Manage Google Sheet** legge o scrive una scheda in Drive. Autorizzi prima Google o il selettore è vuoto e il runtime fallisce.

  <ShotPlaceholder
    src="/assets/workflow-nodes/manage-google-sheet.png"
    name="wn-sheet"
    alt="Manage Google Sheet — operazione e selettore"
    capture="Nodo Google Sheet. 1600×900. Operation + sheet/tab. Nessuna email personale nell'anteprima del foglio."
  />

## Perché questo nodo

Una scheda lead, un semplice archivio di SKU, aggiunga una riga dopo la chiamata. Un vero CRM è ancora [HubSpot](https://docs.voicelogica.ai/it/workflow-nodes/hubspot/) o [Connect To External Service](https://docs.voicelogica.ai/it/workflow-nodes/api/).

Conceda **Use spreadsheets** (e Drive per sfogliare) nelle [autorizzazioni Google](https://docs.voicelogica.ai/it/integrations/google/). Invio Calendar / Gmail sono ambiti diversi.

## Cosa si configura

- **Operation** (required) — **Get Data**, **Get Row**, **Get Rows**, **Update Row**, **Append Row**, **Delete Row**. Seed è Get Data (nessun filtro).
- **Spreadsheet ID** (required) — Dal selettore, o l'id nell'URL del foglio.
- **Sheet / Tab Name** (required) — La scheda, non il nome del file.
- **Filter By** — Su Get/Update/Delete Row: **Row Index** o **Column Name** + **Match Value** (`{{call.phone_number}}`).
- **Values** — Colonna → valore su Update / Append.

Porte: **Sheet updated**, **Sheet error**, **No wait**. I campi a valle provengono dalla riga che ha recuperato.

## Prima configurazione — aggiunga il chiamante dopo aver riagganciato

1. Un foglio con una colonna `phone`. Google Scopes concessi.

2. [On Call End](https://docs.voicelogica.ai/it/workflows/on-call-end/) → **Manage Google Sheet**. **Append Row**. Scelga il file e la scheda. `phone` = **Call Parameters**.

     <ShotPlaceholder
       src="/assets/workflow-nodes/manage-google-sheet-filled.png"
       name="manage-google-sheet-filled"
       alt="Manage Google Sheet compilato"
       capture="Builder workflow → Manage Google Sheet selezionato. Append Row, foglio di calcolo, scheda, colonna phone mappata. 1600×900. Oscuri numeri/email/PIN."
     />

3. **Save & go live**, colleghi, riagganci una chiamata di test. Aggiorni il foglio.

Get Row + [AI Response](https://docs.voicelogica.ai/it/workflow-nodes/ai-response/) è il percorso durante la chiamata (stato ordine per telefono). Mantenga quel GET veloce.

## Come appare "rotto"

- **Needs setup** — nessun file, nessuna scheda, o nessuna operazione.
- Selettore vuoto / 403 — ambiti non concessi su *questa* azienda.
- Update colpisce la riga sbagliata — **Match Value** non è uguale alla cella (spazi, `+` mancante).

## Risoluzione dei problemi

**Get Data vs Get Row**

**Get Data** è l'intera scheda (o la lettura del nodo di essa). **Get Row** è una corrispondenza. Utilizzi Get Row quando il nodo successivo necessita di un record.

## Prossimi passi

[Create Google Document](https://docs.voicelogica.ai/it/workflow-nodes/google-document/).  
[On Call End](https://docs.voicelogica.ai/it/workflows/on-call-end/).  
[Google authorizations](https://docs.voicelogica.ai/it/integrations/google/).