Integrazione Make

Costruisci workflow di automazione visuali con Make (precedentemente Integromat).

Panoramica

Make offre un'interfaccia visuale drag-and-drop per creare scenari di automazione complessi. Connetti gli invii foto Visiono ai tuoi strumenti business con potenti capacità di trasformazione dati.

Prerequisiti

• Account Visiono con accesso API
• Account Make (piano gratuito disponibile)
• Chiave API da Visiono

Passaggi di Setup

1. Creare un Nuovo Scenario

1. Accedi a Make
2. Clicca Create a new scenario
3. Clicca il pulsante + per aggiungere un modulo

2. Aggiungere Modulo Webhook

1. Cerca Webhooks
2. Seleziona Custom webhook
3. Clicca Add per creare un nuovo webhook
4. Dagli un nome (es. "Foto Visiono")
5. Copia l'URL generato

3. Configurare in Visiono

1. Vai a Impostazioni Workspace → Webhook
2. Clicca Aggiungi Webhook
3. Incolla l'URL webhook Make
4. Seleziona eventi:
   • photo_submission.created
   • photo_request.submitted
5. Salva

4. Determinare Struttura Dati

1. In Make, clicca Run once
2. Invia una foto di test in Visiono
3. Make cattura automaticamente la struttura dati
4. Ferma lo scenario

5. Aggiungere Moduli Azione

Connetti moduli aggiuntivi per elaborare le foto:

Modulo	Funzione
HTTP	Scarica file foto
Google Drive	Carica su cloud storage
Email	Invia notifiche
Slack	Messaggistica team
Airtable	Record database
Notion	Creazione pagine

Costruttore Workflow Visuale

L'interfaccia visuale di Make mostra il flusso dati:

[Webhook] → [Router] → [Google Drive] → [Email]
                    ↘ [Slack]
                    ↘ [Airtable]

Usare i Router

Dividi workflow in base a condizioni:

1. Aggiungi modulo Router dopo webhook
2. Crea percorsi multipli
3. Aggiungi filtri a ogni percorso:
   • Percorso 1: Foto > 5 → Revisione completa
   • Percorso 2: Ha tag "danno" → Notifica urgente
   • Percorso 3: Default → Elaborazione standard

Scenari di Esempio

Backup Foto su Cloud

Salva automaticamente foto su Google Drive:

Moduli:

1. Webhooks → Custom webhook
2. Iterator → Loop attraverso array foto
3. HTTP → Get file (scarica foto)
4. Google Drive → Upload file

Configurazione:

Iterator: {{data.photos}}
HTTP URL: {{item.url}}
Drive Folder: /Visiono/{{data.smart_link.slug}}/
Filename: {{item.slot_name}}_{{now}}.jpg

Aggiornamento CRM con Foto

Aggiungi foto ai record clienti:

Moduli:

1. Webhooks → Ricevi invio
2. HubSpot → Cerca contatto per email
3. HubSpot → Aggiungi nota con link foto
4. Slack → Notifica team vendite

Workflow Revisione Qualità

Instrada foto per revisione:

Moduli:

1. Webhooks → Ricevi invio
2. Router → Basato su conteggio foto
   • Percorso A (< 3 foto): Richiedi altre
   • Percorso B (3+ foto): Elabora normalmente
3. Email → Invia messaggio appropriato

Mapping Dati

Accedi ai dati webhook usando notazione dot di Make:

Campo	Percorso
Tipo evento	event
ID Link Permanente	data.smart_link.id
Nome Link Permanente	data.smart_link.name
URL prima foto	data.photos[1].url
Nome mittente	data.metadata.full_name
Campo univoco	data.metadata.unique_field
Ora invio	data.metadata.submitted_at

Iterator e Aggregator

Elaborare Ogni Foto

Usa Iterator per fare loop attraverso le foto:

1. Aggiungi modulo Iterator
2. Imposta array: {{data.photos}}
3. Accedi a ogni foto: {{item.url}}, {{item.slot_name}}

Combinare Risultati

Usa Aggregator per unire dati elaborati:

1. Aggiungi Array aggregator dopo iterator
2. Raccogli URL elaborati
3. Usa array aggregato nel modulo successivo

Gestione Errori

Impostazioni Retry

Configura per-modulo:

• Auto retry: 1-3 tentativi
• Intervallo retry: 1-5 minuti
• Continue on error: Opzionale

Route Errore

Aggiungi percorso gestione errori:

1. Click destro sul modulo
2. Seleziona Add error handler
3. Scegli tipo handler:
   • Resume - Continua con default
   • Rollback - Annulla scenario
   • Commit - Salva progresso, ferma

Schedulazione

Elaborazione Istantanea

I webhook si attivano immediatamente (nessuna schedulazione necessaria).

Elaborazione Batch

Per operazioni schedulate:

• Intervallo: Ogni 15 minuti
• Orario specifico: Ogni giorno alle 9
• On demand: Trigger manuale

Funzionalità Avanzate

Data Store

Crea database riutilizzabili:

• Archivia ID invii elaborati
• Traccia conteggi foto
• Mantieni record stato

Variabili

Imposta e usa variabili:

Set Variable: processed_count
Value: {{length(data.photos)}}

Funzioni

Trasforma dati:

{{formatDate(data.metadata.submitted_at; "YYYY-MM-DD")}}
{{upper(data.smart_link.name)}}
{{join(map(data.photos; "url"); ", ")}}

Risoluzione Problemi

Webhook Non Si Attiva

1. Verifica che URL sia copiato correttamente
2. Controlla che scenario Make sia ON
3. Assicura che webhook sia abilitato in Visiono
4. Testa con invio manuale

Problemi Struttura Dati

1. Ri-determina struttura in Make
2. Controlla formato payload webhook
3. Verifica percorsi campi nei mapping

Errori Scenario

1. Controlla storico esecuzioni
2. Rivedi messaggi errore
3. Verifica connessioni API
4. Controlla configurazioni moduli

Best Practice

Organizzazione

• Usa nomi scenario descrittivi
• Aggiungi note a moduli complessi
• Raggruppa moduli correlati
• Codifica colori per funzione

Performance

• Usa Filtri per limitare esecuzioni
• Raggruppa operazioni simili
• Monitora utilizzo operazioni
• Ottimizza trasformazioni dati

Manutenzione

• Testa dopo modifiche
• Documenta scenari personalizzati
• Verifica webhook regolarmente
• Aggiorna connessioni API

Risorse Correlate

• Webhook - Setup eventi
• Riferimento API - API diretta
• Integrazione Zapier - Piattaforma alternativa
• Integrazione n8n - Opzione self-hosted