Documentation
Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
Intégrations

Make

Connecter Dokos à vos scénarios Make avec le module Dokos et la clé API d'un utilisateur dédié.

Intégration Make

Make est une plateforme qui connecte des applications entre elles sans code. Un scénario Make peut lire, créer ou modifier des documents Dokos. Un webhook Dokos peut aussi déclencher un scénario Make.

Prérequis

  • Un compte Make.
  • Un utilisateur Dokos qui a les droits sur les documents que le scénario utilise.
  • Le droit de modifier cet utilisateur pour générer ses clés API (rôle System Manager).

1. Ajouter le module Dokos à Make

Le module Dokos n'est pas listé publiquement dans Make. Ouvrez ce lien d'invitation pour l'ajouter à votre compte : https://www.make.com/en/hq/app-invitation/da0cc23461714dc01f33812bf6a5d808

2. Générer les clés API de l'utilisateur

Make agit sous l'identité d'un utilisateur Dokos. Toutes ses actions apparaissent au nom de cet utilisateur dans l'historique des documents.

  1. Créez un utilisateur dédié, par exemple make@votre-domaine.fr, ou réutilisez un utilisateur existant.
  2. Ouvrez la fiche de l'utilisateur.
  3. Allez dans l'onglet Informations complémentaires, section Accès API.
  4. Cliquez sur Générer des clés.
  5. Copiez la Clé API et le Secret API affichés dans la fenêtre.
Le secret API ne s'affiche qu'une fois. Si vous le perdez, cliquez à nouveau sur Générer des clés. Le nouveau secret remplace l'ancien, et vous devez mettre à jour la connexion dans Make.
Un utilisateur dédié limite les droits de Make au strict nécessaire. Donnez-lui seulement les rôles utiles au scénario.

3. Créer la connexion dans Make

  1. Dans votre scénario, ajoutez un module de l'application Dokos.
  2. Créez une nouvelle connexion.
  3. Remplissez les champs :
Champ MakeValeur
Nom de domaine DokosLe nom de domaine de votre site, sans https://. Exemple : demo.dokos.cloud.
Clé API de l'UtilisateurLa Clé API copiée à l'étape 2.
Secret API de l'UtilisateurLe Secret API copié à l'étape 2.
  1. Enregistrez la connexion.

4. Déclencher un scénario depuis Dokos

Un webhook Dokos envoie une requête HTTP à Make quand un événement se produit sur un document.

  1. Dans Make, ajoutez le module Webhooks en déclencheur du scénario, puis copiez l'URL qu'il fournit.
  2. Dans Dokos, créez un document Webhook.
  3. Dans DocType, choisissez le type de document surveillé, par exemple Sales Invoice.
  4. Dans Événement Doc, choisissez l'événement, par exemple on_submit pour une facture validée.
  5. Collez l'URL de Make dans URL de Demande.
  6. Dans Structure de la requête, choisissez JSON, puis décrivez les données à envoyer dans Corps de requête JSON.
  7. Enregistrez.

Exemple fictif : un webhook sur Sales Invoice, événement on_submit, avec le corps {"facture": "{{ doc.name }}", "client": "{{ doc.customer }}", "total": "{{ doc.grand_total }}"}. À chaque validation de facture, Make reçoit ces trois valeurs et peut, par exemple, envoyer un message dans un canal d'équipe.

Pour le détail des champs (conditions, en-têtes, sécurité), consultez la page Webhooks.