Zapier

Ce qu’elle fait

Un déclencheur lance un Zap quand quelque chose se passe dans Dotwick. Une action modifie quelque chose dans votre espace de travail. Une recherche trouve une information et la transmet à l’étape suivante. Les déclencheurs sont des webhooks que l’application crée et supprime pour vous : vous n’enregistrez jamais d’endpoint à la main.

Elle nécessite une clé d’API : votre offre doit donc inclure l’accès à l’API et les webhooks (voir la page des tarifs). L’application utilise les mêmes scopes, limites de rôle, restriction de dossiers et limites de débit que toute autre clé.

Connecter votre espace de travail

Dans Dotwick, ouvrez Settings → API et créez une clé avec le préréglage For Zapier / Make. Elle demande ces scopes : codes:read, codes:write, analytics:read, submissions:read, folders:read, folders:write, tags:read, tags:write, webhooks:read, webhooks:write. Puis, dans Zapier, ajoutez la connexion Dotwick et collez la clé. Zapier la teste avec GET /v1/workspaces/current.

Les déclencheurs exigent une clé créée par un administrateur ou le propriétaire, car chacun enregistre un webhook. Les actions et les recherches fonctionnent avec les scopes ci-dessus.

Déclencheurs

New Scan, New Code, Code Updated, New Form Submission et Scan Alert peuvent suivre un code, un dossier (avec ses sous-dossiers) ou une étiquette. Dotwick applique le filtre avant d’enregistrer une livraison : un Zap qui surveille un dossier n’est donc pas réveillé par le reste.

• New Scan : une personne scanne un code. Les robots et les aperçus de liens ne le déclenchent jamais.
• New Code : un code est créé dans l’application ou par l’API.
• Code Updated : la destination, le contenu, le nom, le design ou les règles d’un code changent.
• New Form Submission : quelqu’un répond à un code formulaire ou à un bloc formulaire.
• Scan Alert : une alerte de scans se déclenche, que ce soit à chaque scan, pour N scans en M minutes ou sans scan pendant D jours.
• Bulk Run Finished : un traitement en masse se termine, avec ses totaux.

Actions et recherches

• Create Code : un code URL dynamique avec un nom, une destination, un dossier et des étiquettes.
• Update Destination : faire pointer un code vers une nouvelle adresse.
• Pause or Resume Code.
• Add or Remove Tags sur un ou plusieurs codes.
• Create Folder.
• Create Report : générer un rapport statistique en PDF ou CSV et obtenir son lien.
• Find Code, Find Tag, Find Folder et Find Scan Alert.
• Get Code Scans : les totaux de scans d’un code sur une période.

N scans en M minutes

Créez une règle d’alerte de scans dans l’application (par exemple 50 scans en 10 minutes sur un dossier), puis utilisez le déclencheur Scan Alert. Chaque fois que la règle se déclenche, le déclencheur reçoit un événement alert.fired avec la règle, le périmètre, le nombre de scans et la fenêtre. Ses champs figurent dans Types d’événements.

Ce que l’application enregistre

Quand vous activez un Zap avec déclencheur, l’application appelle POST /v1/hooks. Elle supprime le hook avec DELETE /v1/hooks/{id} quand vous désactivez le Zap. Chaque hook est un webhook à un seul événement, signé et relancé comme tout autre, et l’espace de travail peut en avoir jusqu’à 100. GET /v1/hooks/samples/{event} renvoie jusqu’à 3 événements récents pour associer les champs pendant la construction.

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

Zaps prêts à l’emploi

Google Sheets, HubSpot et Slack passent par Zapier. Il n’existe pas de module Dotwick distinct pour eux ; si vous en voulez un natif, dites-le-nous.

• 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