Changes

userdoc=This page|}}

userdoc=This page|}}

= Introduction =

=Introduction=

This module is to manage links between Dolibarr and Zapier.

This module is to manage links between Dolibarr and Zapier.

= Installation =

=Installation=

{{NoInstallModuleEn}}

{{NoInstallModuleEn}}

= Configuration =

=Configuration=

{{ActivationModuleEn}}

{{ActivationModuleEn}}

== Create a Zapier developper account ==

==Create a Zapier developper account==

At first, you need to have a Zapier developper account, create it here: [https://developer.zapier.com Zapier Platform]

At first, you need to have a Zapier developper account, create it here: [https://developer.zapier.com Zapier Platform]

== Build and Deploy the "Zapier App" on Zapier platform ==

==Build and Deploy the "Zapier App" on Zapier platform==

The Zapier App is a small package in javascript you have to deploy on Zapier so Zapier will be able to speak the language of your Dolibarr application.

The Zapier App is a small package in javascript you have to deploy on Zapier so Zapier will be able to speak the language of your Dolibarr application.

=== Install Node.js ===

===Install Node.js===

An easy option to get set up with Node.js is to visit [https://nodejs.org/en/download/](https://nodejs.org/en/download/) and download the official installer for your OS. If you're installing with a package manager it's even easier.

An easy option to get set up with Node.js is to visit [https://nodejs.org/en/download/](https://nodejs.org/en/download/) and download the official installer for your OS. If you're installing with a package manager it's even easier.

After installation, confirm that Node.js is ready to use:

After installation, confirm that Node.js is ready to use:

<syntaxHighlight lang="bash">

<syntaxhighlight lang="bash">

node --version

node --version

</syntaxHighlight>

</syntaxhighlight>

=== Install the Zapier CLI ===

===Install the Zapier CLI===

Next let's install the '''zapier''' CLI tools. This CLI utility will allow you to build your app, deploy it to the Zapier platform, do local testing, manage users and testers, view remote logs, collaborate with your team, and more:

Next let's install the '''zapier''' CLI tools. This CLI utility will allow you to build your app, deploy it to the Zapier platform, do local testing, manage users and testers, view remote logs, collaborate with your team, and more:

<syntaxHighlight lang="bash">

<syntaxhighlight lang="bash">

cd dev/examples/zapier

cd dev/examples/zapier

npm install zapier-platform-cli

npm install zapier-platform-cli

zapier --version

zapier --version

</syntaxHighlight>

</syntaxhighlight>

=== Run Zapier Login ===

===Run Zapier Login===

Let's configure authentication between your dev environment and the Zapier platform. You'll use the email address and password you use to log in to the Zapier application.

Let's configure authentication between your dev environment and the Zapier platform. You'll use the email address and password you use to log in to the Zapier application.

<syntaxHighlight lang="bash">

<syntaxhighlight lang="bash">

zapier login

zapier login

</syntaxHighlight>

</syntaxhighlight>

This command will set up a '''.zapierrc''' file in your home directory.

This command will set up a '''.zapierrc''' file in your home directory.

=== Install the Project ===

===Install the Project===

In zapier examples directory, run:

In zapier examples directory, run:

<syntaxHighlight lang="bash">

<syntaxhighlight lang="bash">

cd dev/examples/zapier

cd dev/examples/zapier

npm install

npm install

</syntaxHighlight>

</syntaxhighlight>

=== Deploying your App ===

===Deploying your App===

Let's deploy it! When you're ready to try your code out on the Zapier platform use the push command. Only you will be able to see the app until you invite testers.

Let's deploy it! When you're ready to try your code out on the Zapier platform use the push command. Only you will be able to see the app until you invite testers.

<syntaxHighlight lang="bash">

<syntaxhighlight lang="bash">

zapier register  (the first time, choose name for example "My Dolibarr")

zapier register  (the first time, choose name for example "My Dolibarr")

zapier push

zapier push

</syntaxHighlight>

</syntaxhighlight>

After a push, the Application, with the name you defined during the register step, is available as a '''Private Application''' when creating a Zap.

After a push, the Application, with the name you defined during the register step, is available as a '''Private Application''' when creating a Zap.

You will find original tutorial here : [https://zapier.com/developer/start/introduction](https://zapier.com/developer/start/introduction)

You will find original tutorial here : [https://zapier.com/developer/start/introduction](https://zapier.com/developer/start/introduction)

= Usage =

=Usage=

=== Creating a connection for the App ===

===Creating a connection for the App===

Go into Zapier dashboard and create a Connection.

 

Go into Zapier dashboard and create a Connection.  

Enter the URL of your Dolibarr Login page and the login / pass of an existing account. For authentication, you must enter the login / pass of an existing account that will be used by Zapier to call APIs. Give the permission to this user according to the action that Zapier will ask to your Dolibarr.

Enter the URL of your Dolibarr Login page and the login / pass of an existing account. For authentication, you must enter the login / pass of an existing account that will be used by Zapier to call APIs. Give the permission to this user according to the action that Zapier will ask to your Dolibarr.

== Create a Zap ==

==Create a Zap==

Create a ZAP that use the application you registered from the Zapier interface https://www.zapier.com

Create a ZAP that use the application you registered from the Zapier interface https://www.zapier.com