Lancer une automatisation vous-même

Certaines automatisations démarrent quand quelqu’un le demande : Envoyer ce devis, Calculer le prix de livraison, Clôturer le mois. Leur colonne Démarre, sur Automatisations, indique Quand on la lance. Chacune a un nom par lequel on la lance, dit ce qu’il faut lui donner, et peut renvoyer une réponse.

Une telle automatisation agit au nom de la personne ou du système qui la lance, avec ses accès : elle ne peut faire que ce qu’ils peuvent faire eux-mêmes.

D’où on peut la lancer

Quand l’assistant la crée, vous dites d’où on peut la lancer, et qui :

• le tableau de bord, avec un bouton ;
• vos applications ;
• l’assistant ;
• d’autres systèmes, avec une clé d’API.

Seules les personnes qui ont l’un des rôles de données que vous choisissez peuvent la lancer. Personne ne le peut tant que vous n’en avez pas choisi au moins un.

Avec un bouton du tableau de bord

Une automatisation qui appartient à une entité apparaît comme un bouton sous Automatisations sur la liste des enregistrements de cette entité et sur chacun de ses enregistrements. Choisissez-la, remplissez ce qu’elle demande (un bouton sur un enregistrement remplit cet enregistrement pour vous), et choisissez Exécuter. La fenêtre indique d’abord qu’elle agit en votre nom, dans le stage que vous consultez.

Si elle donne une réponse, la fenêtre l’affiche : … a répondu. Une automatisation qui prend plus de temps continue d’elle-même ; son exécution figure sous Exécutions.

Depuis la page de l’automatisation

La page de l’automatisation sous Automatisations a une partie Lancer à la main, en Preview et en Live. Si vous pouvez la lancer, choisissez Exécuter : la même fenêtre demande ce dont elle a besoin et affiche sa réponse. Sinon, elle dit pourquoi à la place du bouton : le tableau de bord ne fait pas partie des endroits d’où elle peut être lancée, aucun rôle de données n’est encore choisi, elle est désactivée en Live, ou vous n’avez aucun des rôles de données qui peuvent la lancer. Si elle appartient à une entité, elle indique aussi qu’elle apparaît sur la liste de cette entité et sur chacun de ses enregistrements.

Pendant que vous la créez ou la modifiez à la main, le panneau de son déclencheur avertit Personne ne peut lancer ceci tant que vous n’avez pas choisi qui le peut. tant qu’aucun rôle de données n’est choisi sous Qui peut la lancer. Vous pouvez quand même l’enregistrer.

Depuis une application

Quand vous créez une application avec l’assistant, demandez-lui d’utiliser l’automatisation, par exemple Ajoute un bouton qui exécute Calculer le prix de livraison et affiche sa réponse. L’application la lance avec kvyk.run, en donnant son nom et ce dont elle a besoin :

const { runId, status, output } = await kvyk.run("delivery_price", { postcode: "1012AB" });

Elle agit au nom de la personne connectée à l’application, dans le stage où l’application s’exécute : la version de Preview dans l’aperçu de l’application, celle de Live dans l’application publiée.

Depuis un autre système

Un autre système, comme votre boutique en ligne, lance une automatisation dans Live ou Preview avec une clé d’API de ce stage, en appelant son adresse avec ce dont elle a besoin en JSON. L’adresse se trouve sous celle indiquée en haut de la Référence de l’API de votre organisation :

POST /v1/functions/delivery_price
Authorization: Bearer <votre clé d'API>
Content-Type: application/json

{ "postcode": "1012AB" }

La réponse contient le numéro de l’exécution, son statut et la réponse de l’automatisation. La Référence de l’API de votre organisation liste sous Automations chaque automatisation qu’on peut lancer ainsi, avec ce dont elle a besoin et ce qu’elle répond.

Ce qu’elle répond

Une automatisation qui répond le fait en 10 secondes. Si elle n’a pas répondu d’ici là, la réponse indique son statut, par exemple En cours, et son exécution continue.

Chaque personne ou système peut lancer des automatisations 60 fois par minute, et l’organisation dans son ensemble 600 fois par minute. Au-delà, un lancement est refusé : attendez un instant et réessayez.