Module Zapier FR

Zapier
Numéro/ID du module	50330
Doc utilisateur du module	This page
Doc développeur du module	Module Zapier (developer)

Présentation

Ce module sert à gérer les liens entre Dolibarr et Zapier.

Plus d'information et du code example est également disponible sur cette page.

Installation

Ce module nécessite de mettre la variable MAIN_FEATURES_LEVEL à 2. Pour l'ajouter, aller dans Configuration --> Divers et mettez la valeur à 2. Enfin, activez le module dans la gestion des modules classique.

Configuration

Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, aller sur la page "Accueil - Configuration - Modules".

Choisissez l'onglet dans lequel apparaît le module puis cliquez sur "Activer".

Le module est alors activé.

Si un pictogramme apparaît sur la vignette ou à la fin de la ligne du module, cliquez dessus pour accéder à la page de paramétrage spécifique à ce module.

Créer un compte développeur Zapier

Dans un premier temps, vous devez avoir un compte développeur Zapier, créez-le ici : Zapier Platform

Créer et déployer « l'application Zapier » sur la plateforme Zapier

L'App Zapier est un petit package en javascript que vous devez déployer sur Zapier pour que Zapier puisse communiquer avec votre application Dolibarr.

Installer Node.js

Une option simple pour configurer Node.js consiste à visiter [1](https://nodejs.org/en/download/) et à télécharger le programme d'installation officiel de votre système d'exploitation. . Si vous installez avec un gestionnaire de packages, c'est encore plus simple.

Après l'installation, confirmez que Node.js est prêt à être utilisé :

node --version

Installer la CLI Zapier

Ensuite, installons les outils CLI zapier. Cet utilitaire CLI vous permettra de créer votre application, de la déployer sur la plateforme Zapier, d'effectuer des tests locaux, de gérer les utilisateurs et les testeurs, d'afficher les journaux à distance, de collaborer avec votre équipe, et bien plus encore :

cd dev/examples/zapier
npm install zapier-platform-cli
zapier --version

Exécuter la connexion Zapier

Configurons l'authentification entre votre environnement de développement et la plateforme Zapier. Vous utiliserez l'adresse e-mail et le mot de passe que vous utilisez pour vous connecter à l'application Zapier.

zapier login

Cette commande créera un fichier .zapierrc dans votre répertoire personnel.

Installer le projet

Dans le répertoire d'exemples Zapier, exécutez :

cd dev/examples/zapier
npm install

Déploiement de votre application

Lorsque vous êtes prêt à essayer votre code sur la plateforme Zapier, utilisez la commande push. Vous seul pourrez voir l'application jusqu'à ce que vous invitiez des testeurs.

zapier register   (la première fois, choisir le nom par exemple "Mon Dolibarr")
zapier push

Après un push, l'Application, portant le nom que vous avez défini lors de l'étape d'inscription, est disponible en Application Privée lors de la création d'un Zap.

Vous trouverez un tutoriel ici : [2](https://zapier.com/developer/start/introduction)

Utilisation

Création d'une connexion pour l'application

Activez l'API REST dans Dolibarr. Ils sont utilisés par Zapier, à commencer par l'API de connexion.

Allez dans le tableau de bord Zapier et créez une connexion : Allez dans « Mes applications – Intégration personnalisée », puis « Ajouter une connexion ».

Si l'App n'apparaît pas dans la liste pour ajouter une connexion, oubliez cette étape et pour créer directement un Zap, la création de connexion pourra être demandée ultérieurement). Si la Connexion peut être créée, saisissez l'URL de votre page de connexion Dolibarr.

L'URL ne doit pas se terminer par /. Par exemple : https://mondomaine ou https://mondomaine/mydoli/htdocs

Saisissez le login/pass d'un compte existant.

Pour l'authentification, vous devez saisir le login/pass d'un compte existant qui sera utilisé par Zapier pour appeler les API. Donnez la permission à cet utilisateur selon l'action que Zapier demandera à votre Dolibarr.
Si vous rencontrez une erreur de certificat SSL lors de l'accès à votre site Web en raison d'un certificat signé automatiquement, vous pouvez désactiver la vérification du certificat SSL dans Paramètres Zapier - Paramètres avancés.
Si votre instance Web est protégée par une protection HTTP Basic, vous devez conserver les URL publiques ouvertes pour les outils externes. Ceci est un exemple de directive à utiliser pour exclure certaines pages de la protection HTTP Basic

        #leaving /public and /api and /dav accessible to everyone
        <Directory /homedirofproject/htdocs/public/>
        AuthType None
        Require all granted
        Satisfy any
        </Directory>
        <Directory /homedirofproject/htdocs/api/>
        AuthType None
        Require all granted
        Satisfy any
        </Directory>
        <Directory /homedirofproject/htdocs/dav/>
        AuthType None
        Require all granted
        Satisfy any
        </Directory>
        <Directory /homedirofproject/htdocs/.well-known/>
        AuthType None
        Require all granted
        Satisfy any
        </Directory>
        <Files ~ "(document\.php|viewimage\.php|\.js\.php|\.json\.php|\.js|\.css\.php|\.css|\.gif|\.png|\.svg|\.woff2|favicon\.ico)$">
        AuthType None
        Require all granted
        Satisfy any
        </Files>

Créer un Zap

Créez un ZAP qui utilise l'application que vous avez enregistrée depuis l'interface Zapier https://www.zapier.com