Démarrer un processus par e-mail
Tout processus Softyflow peut être démarré par un e-mail. Quand un message arrive à l'adresse d'un processus, Softyflow démarre une nouvelle instance de ce processus et lui transmet le contenu du message sous forme de variables : objet, expéditeur, corps en texte, corps en HTML et pièces jointes. La suite du flux les utilise comme n'importe quelle variable de processus.
Rien n'est à configurer dans le processus : il n'y a pas d'événement de début particulier à régler. Le processus doit seulement être publié dans l'environnement visé par l'e-mail.
1. L'adresse d'un processusLien direct vers 1. L'adresse d'un processus
Chaque processus a une adresse par environnement :
<instance>+<processId>.<mode>@m.softyflow.io
| Partie | Valeur |
|---|---|
<instance> | Le nom de votre instance Softyflow : acme pour https://acme.softyflow.io. |
<processId> | L'identifiant du processus : la dernière partie de son URL dans l'IDE (/ide/process/<processId>). |
<mode> | L'environnement de la nouvelle instance : test, uat ou prod. Sans .<mode>, l'instance démarre en prod. |
Par exemple, acme+6aeca4b1c2d3e4f5a6b7c8d9.test@m.softyflow.io démarre en TEST le processus 6aeca4b1c2d3e4f5a6b7c8d9 de l'instance acme.
Pour démarrer un processus depuis une boîte de votre entreprise (factures@votre-entreprise.com), transférez cette boîte vers l'adresse du processus avec une règle de votre serveur de messagerie.
Le démarrage par e-mail utilise le domaine de réception Softyflow m.softyflow.io. Il est disponible sur les instances hébergées à l'adresse <instance>.softyflow.io. Pour un autre hébergement, contactez Softyflow pour mettre en place le domaine de réception.
2. Les variables de l'instanceLien direct vers 2. Les variables de l'instance
La nouvelle instance reçoit ces variables :
| Variable | Type | Contenu |
|---|---|---|
subject | string | L'objet de l'e-mail. |
content | string | Le corps en texte, sans les réponses citées ni la signature. |
mailBodyPlain | string | Le corps complet en texte, réponses citées et signature comprises. |
contentHtml | string | Le corps en HTML, sans les réponses citées ni la signature. null si l'e-mail n'a pas de partie HTML. |
mailBodyHtml | string | Le corps complet en HTML. null si l'e-mail n'a pas de partie HTML. |
from | string | L'en-tête From tel que l'expéditeur l'a écrit, par exemple Jeanne Dupont <jeanne@client.com>. |
sender | string | L'adresse de l'expéditeur seule : jeanne@client.com. |
recipient | string | L'adresse à laquelle l'e-mail a été envoyé : l'adresse du processus. |
files | array | Les pièces jointes (voir Pièces jointes). Un tableau vide s'il n'y en a pas. |
startedAt | number | L'heure de réception, en millisecondes depuis 1970 (epoch). |
SF_mode | string | test, uat ou prod, d'après l'adresse. |
SF_initiator | object | { mail: 'Auto', firstName: 'Auto' } : une instance démarrée par e-mail n'a pas d'utilisateur comme initiateur. |
Les corps en texte et en HTML existent en deux versions. Utilisez content ou contentHtml pour travailler sur ce que l'expéditeur a écrit, et mailBodyPlain ou mailBodyHtml pour garder le message entier, par exemple pour l'archiver ou l'afficher tel qu'il a été reçu.
Le HTML est conservé tel que le logiciel de messagerie de l'expéditeur l'a écrit. Les images collées dans le message sont des références cid: dans le HTML ; les images elles-mêmes sont dans files.
Le HTML d'un e-mail vient de l'extérieur de votre entreprise. Ne l'insérez pas tel quel dans une page montrée à vos utilisateurs : affichez-le dans un cadre isolé, ou nettoyez-le d'abord.
3. Pièces jointesLien direct vers 3. Pièces jointes
Chaque pièce jointe est enregistrée dans les fichiers de votre instance Softyflow dès l'arrivée de l'e-mail. La variable files les liste :
[
{
_id: "6aecb0f1c2d3e4f5a6b7c8d9", // l'identifiant du fichier enregistré
filename: "facture-2026-11.pdf",
contentType: "application/pdf",
length: 48213, // taille en octets
chunkSize: 261120,
uploadDate: "2026-11-19T09:12:03.000Z"
}
]
Lisez une pièce jointe dans un script avec le SDK Fichiers :
const pdf = files.find(f => f.contentType === "application/pdf");
if (!pdf) return null;
const buffer = await SF.file.getFileBufferById(pdf._id);
4. Où l'e-mail est stockéLien direct vers 4. Où l'e-mail est stocké
Un e-mail qui démarre un processus est conservé à deux endroits :
- Dans l'instance : les variables de la section 2 sont des variables de l'instance, comme celles d'un formulaire. Elles sont visibles dans l'instance et restent avec elle.
- Dans les fichiers : les pièces jointes, comme décrit à la section 3.
Softyflow garde aussi une copie de chaque e-mail reçu (objet, adresses, corps en texte et en HTML, liste des pièces jointes) pour son propre suivi. Pour utiliser les e-mails dans votre application, par exemple dans un rapport ou un tableau, enregistrez ce dont vous avez besoin dans une collection de votre projet avec un script de la première étape :
await SF.collection.insertOne("emails-recus", {
subject,
sender,
receivedAt: new Date(startedAt),
text: content,
html: contentHtml,
attachments: files.map(f => ({ _id: f._id, filename: f.filename }))
});
return true;
5. Utiliser l'e-mail dans le fluxLien direct vers 5. Utiliser l'e-mail dans le flux
Les variables sont disponibles à chaque étape, comme toute variable de processus :
- Attribuer une tâche à l'expéditeur, ou à un rôle choisi d'après l'objet ou l'adresse.
- Répondre avec une tâche d'envoi : mettez
sendercomme destinataire etsubjectdans l'objet de l'e-mail. - Décider avec une passerelle, par exemple
subject.toLowerCase().includes("urgent"). - Extraire des données du corps dans un script, par exemple un numéro de facture depuis
content.
6. TesterLien direct vers 6. Tester
Envoyez un e-mail à l'adresse test du processus, puis ouvrez la nouvelle instance dans le suivi des instances pour vérifier ses variables.
En TEST, Softyflow envoie chaque e-mail d'une instance à son initiateur et ajoute l'initiateur à chaque tâche, pour qu'un testeur reçoive tout. Une instance démarrée par e-mail n'a pas d'initiateur (Auto) : ses e-mails et ses tâches de TEST n'arrivent à personne. Pour tester tout le flux, faites agir les exécutions de TEST au nom d'un vrai utilisateur : ajoutez sur la première étape une variable script nommée SF_initiator qui, en TEST uniquement, renvoie cet utilisateur :
// TEST uniquement : l'exécution agit au nom du testeur. UAT et PROD gardent 'Auto'.
if (SF_mode !== "test") return SF_initiator;
const user = await SF.user.getUserByMail("testeur@votre-entreprise.com");
if (!user) return SF_initiator;
const roles = [...(user.group_test || []).map(String), "public", "everybody"];
return {
_id: String(user._id),
fullName: [user.firstName, user.lastName].filter(Boolean).join(" "),
firstName: user.firstName || "",
lastName: user.lastName || "",
mail: user.email,
roles,
modeGroups: { test: roles }
};
En UAT et en PROD, les e-mails et les tâches de l'instance vont à leurs vrais destinataires.
7. DépannageLien direct vers 7. Dépannage
| Symptôme | Cause |
|---|---|
| Aucune instance ne démarre | L'adresse est fausse (nom de l'instance, identifiant du processus), ou le processus n'est pas publié dans l'environnement de l'adresse. |
contentHtml et mailBodyHtml valent null | L'e-mail a été envoyé en texte seul. Utilisez content ou mailBodyPlain. |
content est vide mais pas mailBodyPlain | Tout le message a été détecté comme une réponse citée ou une signature. Utilisez mailBodyPlain. |
| Des images manquent dans le HTML | Les images collées sont des références cid: : les images sont dans files. |
| Personne ne reçoit les e-mails de TEST | L'initiateur de l'instance est Auto : voir Tester. |