Zapier est une plateforme permettant à des personnes sans connaissances techniques de connecter différentes applications entre elles.
Cette application est en version beta sur invitation en cliquant sur ce lien.
Pour les utilisateurs d'ERPNext, cette application est également compatible avec la version 12.x.x.
Allez sur zapier.com et connectez-vous ou créez-vous un compte
Dans la section My Apps
cliquez dans Connect a new account
et cherchez dokos
Dans la fenêtre qui s'ouvre, copiez l'adresse de redirection (Redirect URI) affichée au dessus des champs Client ID et Client Secret.
Il s'agit de la même adresse, donc vous pouvez n'en copier qu'une seule.
Gardez cette fenête ouverte pour terminer la connexion après l'étape 1.2.
Ouvrez dokos et allez dans le module
Intégrations
Client OAuth
, donnez un nom à l'application cliente (Ex. Zapier) et collez l'URI de redirection copiée plus haut dans les champs URIs de redirection
et URI de redirection par défaut
.Pour permettre les intégrations de type OAuth2, il faut avoir au moins une clé de connexion sociale Dodock.
Intégrations > Clé de connexion sociale
Dodock
https://demo.dokos.io
, entrez https://dokos.io
Retournez sur Zapier et ouvrez à nouveau la fenêtre de la section 1.1.
https://demo.dokos.io
Yes, Continue
Autoriser
Votre application Zapier est désormais connectée à votre site dokos.
Vous pouvez créer votre premier Zap.
L'application Zapier dokos permet de créer deux types d'interactions:
Pour générer un nouveau Zap, séléctionnez l'application dokos dans l'éditeur de Zap.
On update
ou On submit
)L'intégration avec Zapier crée des nouveaux Webhooks dans dokos.
Vous pouvez les retrouver en allant dansIntégrations > Webhooks
.
Vous pouvez ensuite enregistrer et créer votre action avec une autre application Zapier ou avec l'application dokos si vous le souhaitez.
Il existe deux types d'actions disponibles sur dokos: Créer un document (Create Document) ou Rechercher un document (Find Document)
Un fois que vous avez sélectionné le type de document à créer, choisissez des valeurs pour les champs obligatoires et testez votre Zap.
Un nouveau document devrait être créé sur votre site dokos.
Si vous sélectionnez la recherche de documents, vous pouvez définir 3 paramètres:
1. Le nombre de document maximum à récupérer
2. Le nom des champs à récupérer
3. Un filtre pour trouver votre/vos documents
Si vous cherchez un document en particulier, pensez à filtrer par identifiant (Nom dans dokos).
En cochant la case Create dokos Document if it doesn't exist yet?
vous autorisez Zapier à créer un nouveau document s'il ne trouve pas de document correspondant à vos filtres.
Une fois votre document trouvé ou créé, vous pouvez passer à l'étape suivante et le réutiliser dans un autre Zap.
Lorsque vous envoyez un champ de type Date ou Date/Heure(Datetime), vous devez utiliser les formats suivants:
YYYY-MM-DD
YYYY-MM-DD HH:mm:ss
Vous pouvez utiliser les outils Zapier Formatter pour cela si besoin.
Pour le format Date/Heure, vous pouvez sélectionner l'option "Use a Custom Value":
L'application n'autorise pas encore l'envoi de listes dans les objects composant les documents.
Veuillez envoyer un mail à help@dokos.io si cette limitation vous pose des problèmes d'intégrations.