Integrazione Notion

Organizza invii foto nel tuo workspace Notion.

Panoramica

Connetti Visiono a Notion per creare automaticamente voci database, aggiornare pagine e organizzare invii foto insieme alla tua altra documentazione.

Prerequisiti

• Account Visiono con accesso API
• Account Notion con workspace
• Chiave API da Visiono
• Integrazione Notion (interna o pubblica)

Metodi di Integrazione

Metodo	Migliore Per
Zapier	Setup rapido
Make	Workflow complessi
API Diretta	Integrazione personalizzata

Setup Zapier

1. Creare Webhook

1. Crea nuovo Zap in Zapier
2. Trigger: Webhooks by Zapier → Catch Hook
3. Copia l'URL webhook

2. Configurare Visiono

1. Aggiungi webhook in Impostazioni Workspace
2. Seleziona eventi da attivare
3. Salva configurazione

3. Connettere Notion

1. Aggiungi azione Notion
2. Connetti il tuo account Notion
3. Seleziona database o pagina

4. Mappare Proprietà

Scegli azione e configura:

Azione	Caso d'Uso
Create Database Item	Nuova voce per invio
Update Database Item	Modifica voce esistente
Append Block to Page	Aggiungi a pagina esistente

Struttura Database

Proprietà Raccomandate

Crea un database Notion con queste proprietà:

Proprietà	Tipo	Campo Visiono
Nome	Titolo	smart_link.name
Inviato	Data	submitted_at
Mittente	Testo	submitter_name
Identificatore	Testo	unique_field
Conteggio Foto	Numero	photos_count
Link Visualizza	URL	dashboard_url
Stato	Select	(fase workflow)
Tag	Multi-select	(da tag foto)

Template Database

📸 Invii Foto

| Nome | Inviato | Mittente | Foto | Stato | Link |
|------|---------|----------|------|-------|------|

Mapping Proprietà

Proprietà Titolo

{{smart_link.name}} - {{submitter_name}}

Proprietà Data

Usa formato ISO:

{{submitted_at}}

Proprietà URL

Link a dashboard Visiono:

{{dashboard_url}}

Proprietà Select

Mappa a stato invio:

{
  "Status": {
    "select": {
      "name": "Nuovo"
    }
  }
}

Multi-Select

Mappa tag foto:

{
  "Tags": {
    "multi_select": [
      {"name": "danno"},
      {"name": "vista-frontale"}
    ]
  }
}

Esempi Workflow

Database Log Foto

Traccia tutti gli invii:

Proprietà Database:

• Nome: Link Permanente + Mittente
• Data: Timestamp invio
• Foto: Conteggio numerico
• Stato: Nuovo → Revisionato → Archiviato
• Link: URL dashboard Visiono

Workflow:

1. Arriva invio
2. Crea voce database
3. Imposta stato a "Nuovo"
4. Aggiungi link foto al body pagina

Organizzazione Basata su Progetto

Collega foto a progetti:

Setup:

1. Database con relazioni progetti
2. Abbina per campo univoco
3. Collega invio a progetto
4. Aggiorna stato progetto

Relazione:

Invii → Progetti (relazione)

Workflow Revisione

Traccia processo revisione:

Stati:

• Inviato
• In Revisione
• Approvato
• Rifiutato
• Archiviato

Automazioni:

• Nuova voce → Notifica revisore
• Cambio stato → Aggiorna timestamp

Contenuto Pagina

Struttura Blocchi

Aggiungi contenuto al body pagina:

## Dettagli Invio

**Mittente:** {{submitter_name}}
**Data:** {{submitted_at}}
**Foto:** {{photos_count}}

## Foto

{{#each photos}}
- {{slot_name}}: [Visualizza]({{url}})
{{/each}}

---
[Visualizza in Visiono]({{dashboard_url}})

Incorporare Foto

Aggiungi embed foto:

{
  "type": "image",
  "image": {
    "type": "external",
    "external": {
      "url": "{{photo_url}}"
    }
  }
}

Blocchi Callout

Evidenzia info importanti:

{
  "type": "callout",
  "callout": {
    "icon": {"emoji": "📸"},
    "rich_text": [{
      "type": "text",
      "text": {"content": "{{photos_count}} foto inviate"}
    }]
  }
}

Workflow Avanzati

Selezione Database Condizionale

Instrada a database diversi:

IF smart_link.slug == "danno":
  → Database "Report Danni"
ELSE IF smart_link.slug == "ispezione":
  → Database "Ispezioni"
ELSE:
  → Database "Generale"

Aggiornare Pagine Esistenti

Trova e aggiorna:

1. Cerca per campo univoco
2. Se trovato → Aggiorna voce
3. Se non trovato → Crea nuovo

Database Collegati

Connetti database multipli:

Invii → Clienti (relazione)
Invii → Progetti (relazione)

Organizzazione Foto

Come Link Esterni

Metodo più affidabile:

[Vista Frontale](https://...)
[Vista Laterale](https://...)

Come Embed

Visualizza inline (potrebbe non funzionare per tutti gli URL):

{
  "type": "embed",
  "embed": {
    "url": "{{photo_url}}"
  }
}

In Vista Gallery

Usa layout gallery database:

• Imposta copertina a URL prima foto
• Abilita anteprima card
• Mostra proprietà chiave

Risoluzione Problemi

Voce Non Creata

1. Verifica ID database
2. Controlla permessi integrazione Notion
3. Assicura che database sia condiviso con integrazione
4. Rivedi proprietà obbligatorie

Proprietà Non Si Aggiornano

1. Verifica che tipi proprietà corrispondano
2. Controlla nomi proprietà (case-sensitive)
3. Rivedi nomi opzioni select

Foto Non Visualizzate

1. Controlla accessibilità URL
2. Prova formato URL esterno
3. Usa blocchi link invece di embed

Best Practice

Organizzazione Database

• Usa viste per esigenze diverse
• Filtra per stato/data
• Raggruppa per tipo Link Permanente
• Archivia voci completate

Tipi Proprietà

• Usa Data per timestamp (non testo)
• Usa URL per link
• Usa Numero per conteggi
• Usa Select per opzioni fisse

Template Pagina

Crea template per consistenza:

• Struttura pagina standard
• Proprietà obbligatorie
• Contenuto segnaposto

Risorse Correlate

• Webhook - Configurazione eventi
• Integrazione Zapier - Setup automazione
• Integrazione Make - Workflow visuali
• Riferimento API - API diretta