Sources
Traitement
Distribution

Boîte partagée E-mail Intégrations / Power Automate

Boxflow et Power Automate

Vous travaillez dans Microsoft 365 ? Laissez Boxflow démarrer un flux Power Automate pour chaque nouveau message eBox ou MyMinfin, puis archivez les documents dans SharePoint, publiez-les dans Teams ou lancez une approbation.

Ce dont vous avez besoin

Un compte Boxflow avec au moins une entreprise connectée, et un rôle d’administrateur dans Boxflow.
Une licence Power Automate incluant les connecteurs premium : le déclencheur « When an HTTP request is received » et l’action HTTP sont premium.
Un jeton d’API, à créer dans votre profil Boxflow.

Comment ça marche

1
Webhook Boxflow

Une automatisation dans Boxflow envoie les détails de chaque message correspondant vers votre flux.
2
API Boxflow

Le flux télécharge les pièces jointes du message via l’API REST Boxflow.
3
Microsoft 365

Le flux enregistre les documents dans SharePoint ou OneDrive, publie dans Teams ou lance une approbation.

Pas à pas

1
Créez le flux et son déclencheur

Dans Power Automate, créez un flux cloud instantané avec le déclencheur « When an HTTP request is received ». Réglez « Who can trigger the flow? » sur « Anyone » (Boxflow ne peut pas se connecter avec un compte Microsoft ; la signature secrète dans l’URL protège le flux) et collez le schéma JSON du corps de la requête ci-dessous. Enregistrez le flux pour générer l’URL HTTP.
2
Ajoutez une action webhook dans Boxflow

Dans Boxflow, créez une automatisation avec les conditions dont vous avez besoin (par exemple une entreprise ou un expéditeur) et ajoutez une action webhook : méthode POST, format JSON, l’URL HTTP de Power Automate et le payload ci-dessous.
3
Listez les pièces jointes

Dans votre flux, ajoutez une action HTTP avec la méthode GET sur l’endpoint des pièces jointes du message, avec l’en-tête « Authorization: Bearer » suivi de votre jeton d’API Boxflow.
4
Téléchargez chaque pièce jointe

Ajoutez un « Apply to each » sur le tableau data de la réponse. À l’intérieur, ajoutez une deuxième action HTTP qui télécharge la pièce jointe par son ID. Le corps de la réponse est le fichier lui-même.
5
Enregistrez le fichier

Ajoutez l’action SharePoint ou OneDrive « Create file ». Utilisez le nom de la pièce jointe comme nom de fichier et le corps de l’action de téléchargement comme contenu, par exemple dans un dossier par entreprise.
6
Testez et activez

Enregistrez le flux et retraitez les automatisations d’un message existant dans Boxflow. Vérifiez l’historique des exécutions dans Power Automate et la piste d’audit du message dans Boxflow.

Copier-coller

Payload du webhook dans Boxflow json

{
  "message_uuid": "{{ message.uuid }}",
  "tenant_uuid": "{{ tenant.uuid }}",
  "subject": "{{ message.subject }}",
  "sender": "{{ sender.name }}",
  "company": "{{ company.name }}",
  "date": "{{ message.message_date }}"
}

Boxflow remplace les placeholders par les valeurs de chaque message.

Schéma JSON du corps de la requête pour le déclencheur json

{
  "type": "object",
  "properties": {
    "message_uuid": { "type": "string" },
    "tenant_uuid": { "type": "string" },
    "subject": { "type": "string" },
    "sender": { "type": "string" },
    "company": { "type": "string" },
    "date": { "type": "string" }
  }
}

Actions HTTP dans le flux http

# List the attachments
GET https://boxflow.be/api/external/v2/tenants/@{triggerBody()?['tenant_uuid']}/messages/@{triggerBody()?['message_uuid']}/attachments
Authorization: Bearer <your Boxflow API token>
Accept: application/json

# Download one attachment (inside "Apply to each" on body('List_attachments')?['data'])
GET https://boxflow.be/api/external/v2/tenants/@{triggerBody()?['tenant_uuid']}/messages/@{triggerBody()?['message_uuid']}/attachments/@{items('Apply_to_each')?['id']}
Authorization: Bearer <your Boxflow API token>

Chaque pièce jointe de la liste a un id et un name. Utilisez le name comme nom de fichier dans « Create file ».

Restez en sécurité

Traitez l’URL HTTP du déclencheur comme un mot de passe : elle contient une signature qui permet à quiconque de démarrer le flux. Régénérez-la si elle fuite.
Ajoutez un en-tête personnalisé avec une valeur secrète au webhook Boxflow et vérifiez-le avec une condition au début de votre flux.
Activez « Secure inputs » et « Secure outputs » sur les actions HTTP, pour que votre jeton d’API et les documents n’apparaissent pas dans l’historique des exécutions.
Le jeton d’API donne accès aux messages de votre compte Boxflow : conservez-le comme un secret, par exemple dans Azure Key Vault.

Des idées pour votre flux

Enregistrez les documents dans une bibliothèque SharePoint avec un dossier par entreprise et par année.
Publiez un message dans un canal Teams pour chaque nouveau courrier du SPF Finances.
Lancez une approbation pour les demandes de paiement avant qu’elles ne partent à la comptabilité.
Ajoutez une ligne à une liste Excel ou SharePoint pour tenir un registre de tous les courriers officiels.

Astuces

Si votre flux est temporairement indisponible, Boxflow réessaie le webhook automatiquement, jusqu’à 10 fois sur environ 3 jours.
Utilisez plusieurs automatisations avec des conditions différentes pour démarrer des flux différents.
La référence complète de l’API est disponible dans la documentation de l’API Boxflow.

Sources: Microsoft Learn – Request trigger (“When an HTTP request is received”)

Questions fréquentes

Faut-il une licence Power Automate premium ?

Oui. Le déclencheur « When an HTTP request is received » et l’action HTTP sont des connecteurs premium dans Power Automate.

Pourquoi choisir « Anyone » pour « Who can trigger the flow? »

Les autres options exigent un jeton Microsoft Entra ID, que Boxflow ne peut pas fournir. Avec « Anyone », le flux est protégé par la signature secrète de son URL ; vous pouvez ajouter un en-tête secret pour une protection supplémentaire.

Puis-je enregistrer les documents dans Teams ?

Oui. Les fichiers des canaux Teams sont stockés dans SharePoint : vous utilisez donc l’action SharePoint « Create file » sur la bibliothèque de documents de l’équipe.

Existe-t-il un connecteur Boxflow prêt à l’emploi pour Power Automate ?

Pas encore. L’approche par webhook et API de ce guide fonctionne dès aujourd’hui avec n’importe quel environnement Power Automate.

Prêt à mettre votre eBox en pilote automatique ?

Connectez gratuitement votre première entreprise et recevez vos messages officiels là où vous en avez besoin.

Commencer gratuitement

Boxflow et Power Automate

Ce dont vous avez besoin

Comment ça marche

Webhook Boxflow

API Boxflow

Microsoft 365

Pas à pas

Créez le flux et son déclencheur

Ajoutez une action webhook dans Boxflow

Listez les pièces jointes

Téléchargez chaque pièce jointe

Enregistrez le fichier

Testez et activez

Copier-coller

Restez en sécurité

Des idées pour votre flux

Astuces

Questions fréquentes

Faut-il une licence Power Automate premium ?

Pourquoi choisir « Anyone » pour « Who can trigger the flow? »

Puis-je enregistrer les documents dans Teams ?

Existe-t-il un connecteur Boxflow prêt à l’emploi pour Power Automate ?

À lire aussi

API et webhooks

Billit

Exact Online

Make.com

Odoo

Single sign-on

Zapier

Prêt à mettre votre eBox en pilote automatique ?