Integrazioni Zapier & Make

Casi d'uso

Cosa puoi automatizzare

Esempi pronti da copiare per i workflow più comuni nei settori legale, bancario e assicurativo.

🔔

Alert Slack per documenti ad alto rischio

Quando un documento supera score 50, ricevi un messaggio Slack con il nome del file, il risk score e il link al certificato.

TRIGGER: risk score > soglia

📊

Log automatico su Google Sheets

Ogni documento validato viene aggiunto automaticamente a un foglio Google con data, score, livello di rischio e certificato.

TRIGGER: documento validato

🏢

Aggiorna il CRM dopo la validazione

Quando un contratto viene validato, aggiorna automaticamente il record Salesforce o HubSpot con il risk score.

TRIGGER: documento validato

📧

Email al cliente con il certificato

Invia automaticamente una email al cliente con il link al certificato vrt: non appena il documento viene validato.

ACTION: recupera certificato

📝

Valida documenti da Notion o SharePoint

Quando un nuovo documento viene caricato su Notion o SharePoint, avvia automaticamente la validazione VeritasOS.

ACTION: valida documento

📋

Task su Jira per ogni anomalia critica

Crea automaticamente un ticket Jira o Asana per ogni documento CRITICAL, assegnato al team legale.

TRIGGER: risk score > 75

⚡

Guida Zapier

Connetti Google Drive, Gmail, Slack, Notion e 5.000+ app senza codice.
Supporta account Gmail personali. Webhooks richiede piano Starter (~€20/mese).

⚠ PREREQUISITO

Prima di tutto: genera la tua API Key in Dashboard → API Keys

Poi testa che funzioni aprendo nel browser:
https://veritas-os.it/api/v1/zapier.php?action=poll_validated&api_key=vrt_live_sk_TUA_CHIAVE
Se vedi un array JSON (anche []) funziona. Se vedi errore, controlla la chiave.

Crea un nuovo Zap — Trigger Google Drive

Su zapier.com → Create Zap. Nel Trigger cerca Google Drive → evento New File in Folder. Connetti il tuo account Google e seleziona la cartella da monitorare. Zapier supporta sia account Gmail che Google Workspace.

Action: Webhooks by Zapier → POST

Clicca "+ Action" → cerca Webhooks by Zapier → evento POST. Configura così:

          URL: https://veritas-os.it/api/v1/validate

          Payload type: form

          Data → Key: document  Value: {{File (Exists but not shown)}} dal trigger

          Headers → Key: Authorization  Value: Bearer vrt_live_sk_TUA_API_KEY

⚠️ Zapier Webhooks non supporta upload binari di file. Usa il flusso testo (vedi sotto) oppure Zapier con HTTP by Zapier su piano a pagamento.

Flusso alternativo: invia il testo del documento

Se il documento è un Google Doc o file di testo, usa Google Drive → Get File Contents per estrarre il testo, poi invialo come JSON:

          URL: https://veritas-os.it/api/v1/validate

          Payload type: json

          Data: {"text": "{{File Contents}}", "filename": "{{File Name}}"}

          Headers → Authorization: Bearer vrt_live_sk_TUA_API_KEY

Usa i dati della risposta

La risposta VeritasOS contiene questi campi mappabili nei passi successivi:

          cert_id — codice certificato (es. vrt:a1b2c3d4)

          cert_url — link pagina verifica pubblica

          risk_score — punteggio 0-100

          risk_level — LOW / MEDIUM / HIGH / CRITICAL

          flag_count — numero anomalie rilevate

          recommendation — testo raccomandazione AI

Aggiungi azione finale: Email, Slack, Notion, Sheets…

Aggiungi una nuova Action con l'app che preferisci. Esempi:

Gmail: invia email con risk_level e cert_url quando risk_score ≥ 75
Slack: messaggio nel canale #compliance con anomalie rilevate
Google Sheets: aggiungi riga con filename, risk_score, cert_url, data
Notion: crea pagina nel database Compliance con tutti i dettagli

Pubblica il Zap — si attiva automaticamente ogni volta che carichi un file nella cartella.

🔧

Guida Make (Integromat)

Automazioni visive con logica avanzata. Per Google Drive richiede Google Workspace.
Alternativa consigliata: Dropbox (funziona con account personali).

⚠️

Nota su Make + Google Drive: Make richiede un account Google Workspace (es. @tuaazienda.it) per collegare Google Drive con tutti i permessi. Gli account Gmail personali (@gmail.com) non sono supportati per gli scope richiesti. In alternativa usa Dropbox o il flusso Webhook descritto sotto.

📁 SCENARIO 1 — NUOVO FILE → VALIDA → SALVA CERTIFICATO

Ogni volta che carichi un file in Dropbox, viene validato da VeritasOS e il certificato PDF viene salvato in una sottocartella.

      Modulo 1: Dropbox → Watch Files · cartella: /Documenti

      Modulo 2: Dropbox → Download a File · File path: {{1.path_lower}}

      Modulo 3: HTTP → Make a request (vedi config sotto)

      Modulo 4: HTTP → Get a File · scarica PDF certificato

      Modulo 5: Dropbox → Upload a File · cartella: /Certificati/{{1.name}}

Crea scenario → aggiungi Dropbox "Watch Files"

Su make.com → Create a new scenario. Il primo modulo è sempre il trigger. Cerca Dropbox → seleziona Watch Files. Connetti il tuo account Dropbox e seleziona la cartella da monitorare.

Aggiungi Dropbox "Download a File"

Aggiungi un secondo modulo Dropbox → Download a File. Nel campo File path clicca e seleziona Path Lower dal modulo Watch Files precedente.

Aggiungi HTTP "Make a request" — validazione VeritasOS

Aggiungi modulo HTTP → Make a request e configura così:

          URL: https://veritas-os.it/api/v1/validate

          Method: POST

          Headers → Add a header:

            Name: Authorization

            Value: Bearer vrt_live_sk_TUA_API_KEY

          Body content type: multipart/form-data

          Body → Field 1:

            Name: document

            Field type: File

            Data: {{2.data}} (dal modulo Dropbox Download)

            File name: {{1.name}} (dal modulo Watch Files)

          Parse response: Yes

La risposta contiene: cert_id, risk_score, risk_level, cert_url, flag_count

Scarica il PDF del certificato

Aggiungi un secondo modulo HTTP → Make a request:

          URL: https://veritas-os.it/dashboard/download_cert_pdf_api.php?cert_id={{3.cert_id}}&api_key=vrt_live_sk_TUA_API_KEY

          Method: GET

          Parse response: No (è un file binario PDF)

Salva il certificato su Dropbox

Aggiungi Dropbox → Upload a File:

          Folder path: /Certificati

          File name: certificato_{{1.name}}.pdf

          Data: {{4.data}} (dal modulo HTTP download)

Imposta scheduling e attiva

In basso a sinistra clicca l'icona orologio → imposta ogni 15 minuti. Clicca Save poi Activate. Da questo momento ogni file caricato in Dropbox viene validato automaticamente.

HTTP → Make a request (polling documenti validati)

          URL: https://veritas-os.it/api/v1/validate?action=poll

          Method: GET

          Headers → Name: Authorization  Value: Bearer vrt_live_sk_...

          Parse response: Yes

Flow Control → Array Iterator

Aggiungi Tools → Array Iterator. Nel campo Array seleziona il dato restituito dall'HTTP. Questo crea un'esecuzione separata per ogni documento.

Filter: solo documenti ad alto rischio

Tra Iterator e azione aggiungi un Filter. Condizione: risk_score Greater than or equal to 75.

Azione finale: Email, Slack, Notion…

Usa le variabili disponibili: filename, risk_score, risk_level, cert_url, flag_count. Scheduling: ogni 15 minuti.

Riferimento API

Tutti gli endpoint disponibili

GET

/api/v1/zapier.php?action=poll_validated

Restituisce documenti validati di recente. Parametro opzionale: min_risk=50 per filtrare per soglia.

GET

/api/v1/zapier.php?action=poll_high_risk

Restituisce solo documenti HIGH e CRITICAL. Ideale per alert immediati.

POST

/api/v1/zapier.php?action=validate

Valida un testo. Body JSON: {"text":"...","filename":"contratto.txt"}

GET

/api/v1/zapier.php?action=get_certificate&cert_id=vrt:xxx

Recupera i dettagli di un certificato esistente per ID.

Esempio risposta

poll_validated — risposta JSON

[
  {
    "id": 42,
    "filename": "Contratto_Fornitura_2026.pdf",
    "risk_score": 65,
    "risk_level": "HIGH",
    "cert_id": "vrt:a1b2c3d4",
    "verify_url": "https://veritas-os.it/verify.php?id=vrt:a1b2c3d4",
    "company": "Acme Legal S.p.A.",
    "validated_at": "2026-03-22 03:45:10",
    "is_high_risk": true
  }
]

Pronto a connettere VeritasOS?

Genera la tua API Key dalla dashboard e inizia a costruire automazioni in pochi minuti.

🔑 Genera API Key 📖 Documentazione completa

Connetti VeritasOS a 5.000+ app senza scrivere codice