Zum Inhalt springen

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.