Zum Inhalt springen
DOTWICK

Zapier

Was sie tut

Ein Trigger startet einen Zap, wenn in Dotwick etwas passiert. Eine Aktion ändert etwas in Ihrem Arbeitsbereich. Eine Suche schlägt etwas nach und gibt es an den nächsten Schritt weiter. Trigger sind Webhooks, die die App für Sie anlegt und wieder entfernt, Sie registrieren also nie von Hand einen Endpunkt.

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 dann in Zapier die Dotwick-Verbindung hinzu und geben Sie den Schlüssel ein. Zapier prüft ihn mit GET /v1/workspaces/current.

Trigger brauchen einen Schlüssel von einem Admin oder dem Owner, weil jeder einen Webhook registriert. Aktionen und Suchen funktionieren mit den oben genannten Scopes.

Trigger

New Scan, New Code, Code Updated, New Form Submission und Scan Alert können einem Code, einem Ordner (mit Unterordnern) oder einem Tag folgen. Dotwick wendet den Filter an, bevor es eine Zustellung aufzeichnet, ein Zap für einen Ordner wird also nicht vom Rest geweckt.

  • New Scan: Eine Person scannt einen Code. Bots und Link-Vorschauen lösen nie aus.
  • New Code: Ein Code wird in der App oder über die API erstellt.
  • Code Updated: Ziel, Inhalt, Name, Design oder Regeln eines Codes ändern sich.
  • New Form Submission: Jemand beantwortet einen Formular-Code oder einen Formularblock.
  • Scan Alert: Ein Scan-Alarm löst aus, ob bei jedem Scan, bei N Scans in M Minuten oder bei keinem Scan seit D Tagen.
  • Bulk Run Finished: Ein Massenlauf endet, mit seinen Zahlen.

Aktionen und Suchen

  • Create Code: ein dynamischer URL-Code mit Namen, Ziel, Ordner und Tags.
  • Update Destination: einen Code auf eine neue Adresse verweisen.
  • Pause or Resume Code.
  • Add or Remove Tags bei einem oder mehreren Codes.
  • Create Folder.
  • Create Report: einen Statistikbericht als PDF oder CSV erstellen und seinen Link erhalten.
  • Find Code, Find Tag, Find Folder und Find Scan Alert.
  • Get Code Scans: die Scan-Summen eines Codes für einen Zeitraum.

N Scans in M Minuten

Legen Sie in der App eine Scan-Alarmregel an (zum Beispiel 50 Scans in 10 Minuten auf einem Ordner) und nutzen Sie den Trigger Scan Alert. Jedes Mal, wenn die Regel auslöst, erhält der Trigger ein alert.fired-Ereignis mit der Regel, dem Geltungsbereich, der Zahl der Scans und dem Zeitfenster. Seine Felder stehen unter Ereignistypen.

Was die App registriert

Wenn Sie einen Zap mit Trigger einschalten, ruft die App POST /v1/hooks auf. Beim Ausschalten löscht sie den Hook mit DELETE /v1/hooks/{id}. Jeder Hook ist ein Webhook mit genau einem Ereignis, signiert und wiederholt wie jeder andere, und der Arbeitsbereich kann bis zu 100 haben. GET /v1/hooks/samples/{event} liefert bis zu 3 aktuelle Ereignisse, damit Sie beim Erstellen Felder zuordnen können.

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

Fertige Zaps

Google Sheets, HubSpot und Slack laufen über Zapier. Dafür gibt es kein eigenes Dotwick-Add-on; wenn Sie ein natives benötigen, sagen Sie uns Bescheid.

  • Add new Dotwick scans to Google Sheets rows
  • Save Dotwick form answers to Google Sheets
  • Log new Dotwick codes in Google Sheets
  • Create HubSpot contacts from Dotwick form answers
  • Post Dotwick scan alerts to a Slack channel