Aller au contenu

Make

Ce qu’elle fait

Un module Watch lance un scénario à l’instant où quelque chose se passe dans Dotwick. Les autres modules créent ou modifient des éléments de votre espace de travail, ou les recherchent. Les modules Watch sont instantanés : Make enregistre un webhook auprès de Dotwick quand vous activez le scénario et le supprime quand vous le désactivez.

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. Dans Make, ajoutez une connexion Dotwick et collez la clé. Make la teste avec GET /v1/workspaces/current.

Les modules Watch exigent une clé créée par un administrateur ou le propriétaire, car chacun enregistre un webhook.

Modules Watch

Les cinq premiers peuvent suivre un code, un dossier (avec ses sous-dossiers) ou une étiquette. Pour suivre une seule règle d’alerte de scans, ajoutez dans le scénario un filtre sur l’identifiant de la règle.

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

Actions et recherches

  • Create a Code, Update a Destination, Pause or Resume a Code et Add or Remove Tags.
  • Create a Folder.
  • Create a Report : générer un rapport statistique en PDF ou CSV et obtenir son lien.
  • Search Codes, Search Tags, Search Folders et List Scan Alerts.
  • Get Code Scans : les totaux de scans d’un code sur une période.

Comment les webhooks sont gérés

Chaque module Watch enregistre un hook avec POST /v1/hooks et le supprime avec DELETE /v1/hooks/{id}. Un hook est un webhook à un seul événement, signé et relancé comme tout autre. Un espace de travail peut avoir jusqu’à 100 hooks, et l’écran Developers les liste à part de vos propres endpoints.

Le module Watch Scan Alerts reçoit un événement alert.fired. Ses champs figurent dans Types d’événements.