Make
Was sie tut
Ein Watch-Modul startet ein Szenario in dem Moment, in dem in Dotwick etwas passiert. Die übrigen Module erstellen oder ändern Dinge in Ihrem Arbeitsbereich oder schlagen sie nach. Die Watch-Module reagieren sofort: Make registriert beim Einschalten des Szenarios einen Webhook bei Dotwick und entfernt ihn beim Ausschalten.
Sie braucht einen API-Schlüssel, Ihr Tarif muss also API-Zugriff und Webhooks enthalten (siehe die Preisseite). Die App nutzt dieselben Scopes, Rollenbegrenzungen, Ordnerbeschränkungen und Ratenbegrenzungen wie jeder andere Schlüssel.
Verbinden Sie Ihren Arbeitsbereich
Öffnen Sie in Dotwick Settings → API und erstellen Sie einen Schlüssel mit dem Preset For Zapier / Make. Er verlangt diese Scopes: codes:read, codes:write, analytics:read, submissions:read, folders:read, folders:write, tags:read, tags:write, webhooks:read, webhooks:write. Fügen Sie in Make eine Dotwick-Verbindung hinzu und geben Sie den Schlüssel ein. Make prüft ihn mit GET /v1/workspaces/current.
Watch-Module brauchen einen Schlüssel von einem Admin oder dem Owner, weil jedes einen Webhook registriert.
Watch-Module
Die ersten fünf können einem Code, einem Ordner (mit Unterordnern) oder einem Tag folgen. Um einer einzelnen Scan-Alarmregel zu folgen, fügen Sie im Szenario einen Filter auf die Regel-ID hinzu.
- Watch Scans: Eine Person scannt einen Code. Bots und Link-Vorschauen lösen nie aus.
- Watch New Codes: Ein Code wird in der App oder über die API erstellt.
- Watch Code Updates: Ziel, Inhalt, Name, Design oder Regeln eines Codes ändern sich.
- Watch Form Submissions: Jemand beantwortet einen Formular-Code oder einen Formularblock.
- Watch Scan Alerts: Ein Scan-Alarm löst aus: bei jedem Scan, bei N Scans in M Minuten oder bei keinem Scan seit D Tagen.
- Watch Bulk Runs: Ein Massenlauf endet, mit seinen Zahlen.
Aktionen und Suchen
- Create a Code, Update a Destination, Pause or Resume a Code und Add or Remove Tags.
- Create a Folder.
- Create a Report: einen Statistikbericht als PDF oder CSV erstellen und seinen Link erhalten.
- Search Codes, Search Tags, Search Folders und List Scan Alerts.
- Get Code Scans: die Scan-Summen eines Codes für einen Zeitraum.
Wie die Webhooks gehandhabt werden
Jedes Watch-Modul registriert einen Hook mit POST /v1/hooks und entfernt ihn mit DELETE /v1/hooks/{id}. Ein Hook ist ein Webhook mit genau einem Ereignis, signiert und wiederholt wie jeder andere. Ein Arbeitsbereich kann bis zu 100 Hooks haben, und die Developers-Ansicht listet sie getrennt von Ihren eigenen Endpunkten.
Das Modul Watch Scan Alerts erhält ein alert.fired-Ereignis. Seine Felder stehen unter Ereignistypen.