Integrazione Zapier

Connetti Visiono a 5.000+ app con la piattaforma di automazione no-code Zapier.

Panoramica

Zapier ti permette di creare workflow automatizzati (Zap) che si attivano quando le foto vengono inviate a Visiono. Connetti con CRM, strumenti di project management, piattaforme di comunicazione e altro.

Prerequisiti

• Account Visiono con accesso API
• Account Zapier (gratuito o a pagamento)
• Chiave API da Visiono

Passaggi di Setup

1. Creare un Nuovo Zap

1. Accedi a Zapier
2. Clicca Create Zap
3. Cerca Webhooks by Zapier
4. Seleziona Catch Hook come trigger

2. Configurare il Webhook

1. Zapier genererà un URL webhook univoco
2. Copia questo URL (simile a https://hooks.zapier.com/hooks/catch/...)
3. Mantieni aperta la scheda Zapier

3. Aggiungere Webhook a Visiono

1. Vai a Impostazioni Workspace → Webhook
2. Clicca Aggiungi Webhook
3. Incolla l'URL webhook Zapier
4. Seleziona eventi da attivare:
   • photo_request.submitted - Quando tutte le foto sono inviate
   • photo_submission.created - Quando arriva un nuovo invio
5. Salva il webhook

4. Testare la Connessione

1. In Zapier, clicca Test trigger
2. Invia una foto di test in Visiono
3. Zapier dovrebbe ricevere i dati webhook
4. Clicca Continue una volta ricevuti i dati

5. Aggiungere Azioni

Ora aggiungi cosa succede quando arrivano le foto:

Azioni Popolari	Caso d'Uso
Gmail	Invia email con link foto
Slack	Notifica canale team
Google Sheets	Registra invii su foglio di calcolo
Trello	Crea scheda con foto
Salesforce	Aggiorna record contatto
HubSpot	Aggiungi a timeline contatto

Zap di Esempio

Foto su Google Sheets

Registra ogni invio su un foglio di calcolo:

1. Trigger: Webhooks by Zapier (Catch Hook)
2. Action: Google Sheets → Create Spreadsheet Row

Mappa campi:

Colonna Foglio	Dati Webhook
Data	{{submitted_at}}
Link Permanente	{{smart_link_slug}}
Conteggio Foto	{{photos_count}}
URL Prima Foto	{{photos__1__url}}

Notifica Slack su Invio

Invia notifica al team:

1. Trigger: Webhooks by Zapier
2. Action: Slack → Send Channel Message

Template messaggio:

📸 Nuove foto ricevute!
Link Permanente: {{smart_link_name}}
Foto: {{photos_count}}
Visualizza: {{dashboard_url}}

Creare Scheda Trello

Aggiungi invio alla board di progetto:

1. Trigger: Webhooks by Zapier
2. Action: Trello → Create Card

Impostazioni scheda:

• Nome: Foto da {{submitter_name}}
• Descrizione: URL foto e metadati
• Etichette: Basate sui tag

Payload Webhook

Zapier riceve questa struttura dati:

{
  "event": "submission.created",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "submission_id": "sub_abc123",
    "smart_link": {
      "id": "pl_xyz789",
      "slug": "ispezione-veicolo",
      "name": "Ispezione Veicolo"
    },
    "photos": [
      {
        "id": "photo_001",
        "url": "https://...",
        "slot": 1,
        "slot_name": "Vista Frontale"
      }
    ],
    "metadata": {
      "unique_field": "ABC-123",
      "full_name": "Mario Rossi",
      "submitted_at": "2024-01-15T10:30:00Z"
    }
  }
}

Zap Multi-Step

Concatena azioni multiple:

1. Step 1: Ricevi webhook
2. Step 2: Scarica foto (Formatter)
3. Step 3: Carica su Google Drive
4. Step 4: Invia email con link Drive
5. Step 5: Aggiorna record CRM

Filtraggio

Aggiungi filtri per eseguire azioni condizionalmente:

Filtro	Condizione	Esempio
Conteggio foto	Maggiore di	Solo se 5+ foto
Link Permanente	Contiene	Solo richieste "danno"
Tag	Uguale	Solo taggati "urgente"

Risoluzione Problemi

Webhook Non Riceve Dati

1. Verifica che URL webhook sia corretto in Visiono
2. Controlla che webhook sia abilitato (stato verde)
3. Testa con un nuovo invio
4. Controlla Cronologia Task Zapier per errori

Campi Dati Mancanti

1. Assicurati di aver testato con dati reali
2. Ri-testa il trigger in Zapier
3. Controlla che mapping campi usi percorsi corretti

Zap Non in Esecuzione

1. Verifica che Zap sia acceso (ON)
2. Controlla limiti piano Zapier
3. Rivedi Cronologia Task per errori
4. Assicura che eventi webhook corrispondano al trigger

Best Practice

Convenzione Naming

Nomina Zap in modo descrittivo:

• ✓ Visiono → Slack: Nuove Foto Danni
• ✓ Foto Veicoli → Google Drive + Email
• ✗ Il Mio Zap 1

Gestione Errori

1. Abilita notifiche errori Zapier
2. Aggiungi step Formatter per pulizia dati
3. Usa Paths per logica condizionale
4. Testa con casi limite

Performance

• Usa Filtri per ridurre esecuzioni non necessarie
• Raggruppa azioni dove possibile
• Considera limiti task piano Zapier

Risorse Correlate

• Webhook - Configurazione eventi
• Riferimento API - Accesso API diretto
• Integrazione Make - Automazione alternativa
• Integrazione n8n - Opzione self-hosted