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.

Automatisations

Actions d'automatisation

Les actions d'un flux d'automatisation : modifier un champ, créer un document, notifier, assigner, appeler un webhook ou exécuter un script.

Une action est une étape de type « Action » dans la table Actions d'un flux d'automatisation. Vous la choisissez dans Action Type. Ses réglages vont dans le champ Parameters.

Actions disponibles

Action Type	Effet	Paramètres
Set Field Value	Modifie un ou plusieurs champs du document, puis l'enregistre.	Field et Value, ou Field Values pour plusieurs champs
Increment Field Value	Ajoute un nombre à un champ numérique.	Field, Amount
Create Document	Crée un nouveau document.	Document Type, Field Values
Send Notification	Envoie un email ou une notification dans Dokos.	Channel (Email ou System), Recipients, Email Template ou Subject et Message
Assign to User	Assigne le document à un ou plusieurs utilisateurs.	Assign To, Description
Call Webhook	Envoie une requête HTTP à une URL externe.	URL, Method, Headers, Payload, Timeout (seconds)
Run Script	Exécute du code Python.	Server Script ou Script

Une application peut ajouter ses propres actions avec le hook automation_actions.

Utiliser les valeurs du document

Les paramètres texte acceptent la syntaxe Jinja. Exemple : Relance pour {{ doc.customer_name }}. Les variables disponibles sont :

doc : le document visé par l'étape.
trigger : le document qui a démarré le flux.
payload : les données d'un événement personnalisé.

Précisions par action

Send Notification

Dans Recipients, saisissez des utilisateurs ou des adresses. Deux jetons sont aussi acceptés :

@owner : le propriétaire du document.
@assignees : les personnes assignées au document.

Avec le canal « System », chaque destinataire reçoit une notification dans la cloche de Dokos.

Call Webhook

La méthode par défaut est POST. GET, PUT, PATCH et DELETE sont aussi acceptés.
L'URL doit commencer par http ou https. Une adresse qui pointe vers un réseau privé est refusée.
Le délai par défaut est de 30 secondes. Le maximum est de 120 secondes.
Une réponse avec un code 400 ou plus fait échouer l'étape.

Run Script

Choisissez un Server Script existant ou écrivez le code dans Script, pas les deux. Les deux champs s'excluent l'un l'autre.

Un script lié doit être un script serveur actif de type « API ».
Seul un Responsable système peut écrire un script directement dans l'étape.
Les scripts serveur doivent être activés dans la configuration du serveur.

Un webhook ou un script peut agir hors de la base de données. Ces effets ne sont pas annulés si une étape suivante échoue.

Exemple

Exemple fictif : assigner chaque nouvelle piste à l'équipe commerciale, puis prévenir le propriétaire.

Ligne	Action Type	Parameters
1	Assign to User	`{"assign_to": ["commercial@exemple.fr"], "description": "Qualifier la piste"}`
2	Send Notification	`{"channel": "System", "recipients": ["@owner"], "subject": "Piste {{ doc.name }} assignée"}`