Vai al contenuto

Zapier

Cosa fa

Un trigger avvia uno Zap quando succede qualcosa in Dotwick. Un’azione cambia qualcosa nel tuo spazio di lavoro. Una ricerca cerca qualcosa e lo passa al passo successivo. I trigger sono webhook che l’app imposta e rimuove per te, quindi non registri mai un endpoint a mano.

Richiede una chiave API, quindi il tuo piano deve includere l’accesso API e i webhook (vedi la pagina dei prezzi). L’app usa gli stessi ambiti, limiti di ruolo, restrizione di cartella e limiti di richieste di qualsiasi altra chiave.

Collega il tuo spazio di lavoro

In Dotwick apri Settings → API e crea una chiave con il preset For Zapier / Make. Chiede questi ambiti: codes:read, codes:write, analytics:read, submissions:read, folders:read, folders:write, tags:read, tags:write, webhooks:read, webhooks:write. Poi, in Zapier, aggiungi la connessione Dotwick e incolla la chiave. Zapier la prova con GET /v1/workspaces/current.

I trigger richiedono una chiave creata da un amministratore o dal proprietario, perché ognuno registra un webhook. Azioni e ricerche funzionano con gli ambiti qui sopra.

Trigger

New Scan, New Code, Code Updated, New Form Submission e Scan Alert possono seguire un codice, una cartella (con le sue sottocartelle) o un tag. Dotwick applica il filtro prima di registrare una consegna, quindi uno Zap che osserva una cartella non viene svegliato dal resto.

  • New Scan: una persona scansiona un codice. Bot e anteprime dei link non lo attivano mai.
  • New Code: viene creato un codice nell’app o tramite l’API.
  • Code Updated: cambiano destinazione, contenuto, nome, design o regole di un codice.
  • New Form Submission: qualcuno risponde a un codice modulo o a un blocco modulo.
  • Scan Alert: scatta un avviso di scansione, che sia ogni scansione, N scansioni in M minuti o nessuna scansione per D giorni.
  • Bulk Run Finished: termina un’esecuzione in blocco, con i suoi conteggi.

Azioni e ricerche

  • Create Code: un codice URL dinamico con nome, destinazione, cartella e tag.
  • Update Destination: punta un codice a un nuovo indirizzo.
  • Pause or Resume Code.
  • Add or Remove Tags su uno o più codici.
  • Create Folder.
  • Create Report: genera un report di statistiche in PDF o CSV e ottieni il suo link.
  • Find Code, Find Tag, Find Folder e Find Scan Alert.
  • Get Code Scans: i totali di scansione di un codice per un intervallo.

N scansioni in M minuti

Crea una regola di avviso di scansione nell’app (per esempio 50 scansioni in 10 minuti su una cartella), poi usa il trigger Scan Alert. Ogni volta che la regola scatta, il trigger riceve un evento alert.fired con la regola, l’ambito, il numero di scansioni e la finestra. Vedi Tipi di evento per i suoi campi.

Cosa registra l’app

Quando uno Zap con un trigger viene attivato, l’app chiama POST /v1/hooks. Elimina l’hook con DELETE /v1/hooks/{id} quando lo Zap viene disattivato. Ogni hook è un webhook con un solo evento, firmato e riprovato come tutti gli altri, e lo spazio di lavoro può averne fino a 100. GET /v1/hooks/samples/{event} restituisce fino a 3 eventi recenti così puoi mappare i campi mentre costruisci.

POST /v1/hooks
{  "event": "scan.created",  "targetUrl": "https://hooks.example.com/catch/12345/abcdef/",  "app": "zapier",  "filter": {    "folderId": "fld_7c2d9e41a05b3f68"  }}

Zap pronti

Google Sheets, HubSpot e Slack passano da Zapier. Non esiste un componente aggiuntivo Dotwick separato per loro; se te ne serve uno nativo, faccelo sapere.

  • Aggiungi le nuove scansioni Dotwick come righe di Google Sheets
  • Salva le risposte dei moduli Dotwick in Google Sheets
  • Registra i nuovi codici Dotwick in Google Sheets
  • Crea contatti HubSpot dalle risposte dei moduli Dotwick
  • Pubblica gli avvisi di scansione Dotwick in un canale Slack