Naar de inhoud
DOTWICK

Zapier

Wat het doet

Een trigger start een Zap als er iets gebeurt in Dotwick. Een actie wijzigt iets in je werkruimte. Een zoekopdracht zoekt iets op en geeft het door aan de volgende stap. Triggers zijn webhooks die de app voor je instelt en verwijdert, dus je registreert nooit zelf een endpoint.

Het vereist een API-sleutel, dus je abonnement moet API-toegang en webhooks bevatten (zie de prijzenpagina). De app gebruikt dezelfde scopes, rolgrenzen, maprestrictie en aanvraaglimieten als elke andere sleutel.

Koppel je werkruimte

Open in Dotwick Settings → API en maak een sleutel met de preset For Zapier / Make. Die vraagt om deze scopes: codes:read, codes:write, analytics:read, submissions:read, folders:read, folders:write, tags:read, tags:write, webhooks:read, webhooks:write. Voeg daarna in Zapier de Dotwick-verbinding toe en plak de sleutel. Zapier test hem met GET /v1/workspaces/current.

Triggers vereisen een sleutel van een beheerder of de eigenaar, omdat elke trigger een webhook registreert. Acties en zoekopdrachten werken met de scopes hierboven.

Triggers

New Scan, New Code, Code Updated, New Form Submission en Scan Alert kunnen één code, één map (met submappen) of één tag volgen. Dotwick past het filter toe voordat het een levering vastlegt, dus een Zap die één map in de gaten houdt, wordt niet wakker door de rest.

  • New Scan: iemand scant een code. Bots en linkvoorbeelden activeren nooit.
  • New Code: er wordt een code gemaakt in de app of via de API.
  • Code Updated: de bestemming, inhoud, naam, ontwerp of regels van een code veranderen.
  • New Form Submission: iemand beantwoordt een formuliercode of een formulierblok.
  • Scan Alert: een scanmelding gaat af, of dat nu elke scan is, N scans in M minuten of geen scans gedurende D dagen.
  • Bulk Run Finished: een bulkrun eindigt, met zijn aantallen.

Acties en zoekopdrachten

  • Create Code: een dynamische URL-code met een naam, een bestemming, een map en tags.
  • Update Destination: laat een code naar een nieuw adres wijzen.
  • Pause or Resume Code.
  • Add or Remove Tags bij één of meer codes.
  • Create Folder.
  • Create Report: maak een PDF- of CSV-statistiekenrapport en krijg de link.
  • Find Code, Find Tag, Find Folder en Find Scan Alert.
  • Get Code Scans: de scantotalen van één code over een periode.

N scans in M minuten

Maak in de app een scanmeldingsregel (bijvoorbeeld 50 scans in 10 minuten op een map) en gebruik dan de trigger Scan Alert. Telkens als de regel afgaat, krijgt de trigger een alert.fired-gebeurtenis met de regel, de scope, het aantal scans en het venster. Zie Gebeurtenistypen voor de velden.

Wat de app registreert

Als een Zap met een trigger wordt aangezet, roept de app POST /v1/hooks aan. Hij verwijdert de hook met DELETE /v1/hooks/{id} als de Zap wordt uitgezet. Elke hook is een webhook met één gebeurtenis, ondertekend en opnieuw geprobeerd zoals elke andere, en de werkruimte kan er tot 100 hebben. GET /v1/hooks/samples/{event} geeft tot 3 recente gebeurtenissen terug, zodat je velden kunt koppelen terwijl je bouwt.

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

Kant-en-klare Zaps

Google Sheets, HubSpot en Slack lopen via Zapier. Er is geen aparte Dotwick-invoegtoepassing voor; als je een native nodig hebt, laat het ons weten.

  • Voeg nieuwe Dotwick-scans toe aan rijen in Google Sheets
  • Sla Dotwick-formulierantwoorden op in Google Sheets
  • Log nieuwe Dotwick-codes in Google Sheets
  • Maak HubSpot-contacten van Dotwick-formulierantwoorden
  • Plaats Dotwick-scanmeldingen in een Slack-kanaal