Connectez vos propres logiciels via l’API et les webhooks
Vous voulez traiter automatiquement les messages eBox et MyMinfin dans votre ERP, votre GED ou votre propre application ? Voici comment fonctionne l’intégration avec Boxflow.
Ce dont vous avez besoin
- Un compte Boxflow avec au moins une entreprise connectée.
- Un endpoint HTTPS dans votre logiciel, capable de recevoir des requêtes.
- Un jeton d’API, à créer dans votre profil Boxflow.
Comment fonctionne l’intégration
-
1
Nouveau message
Boxflow récupère un nouveau message dans l’eBox Enterprise ou MyMinfin.
-
2
Automatisation
Une automatisation selon vos conditions envoie un webhook vers votre endpoint.
-
3
Votre logiciel
Votre endpoint reçoit les données et récupère au besoin les détails et pièces jointes via l’API REST.
Pas à pas
-
1
Créez un jeton d’API
Créez un jeton d’API dans votre profil Boxflow. Conservez-le en lieu sûr : vous l’utiliserez comme jeton Bearer pour l’API REST.
-
2
Prévoyez un endpoint
Prévoyez dans votre logiciel un endpoint HTTPS qui reçoit les webhooks et renvoie rapidement une réponse 2xx. Traitez de préférence le message de manière asynchrone.
-
3
Ajoutez une action webhook
Créez dans Boxflow une automatisation avec les conditions souhaitées et ajoutez une action webhook. Choisissez la méthode HTTP (p. ex. POST), le format (JSON ou XML) et l’authentification.
-
4
Composez le contenu
Définissez vous-même le contenu du webhook avec des placeholders comme {{ message.uuid }}, {{ message.subject }}, {{ sender.name }} et {{ company.name }}. Votre logiciel reçoit ainsi exactement les champs dont il a besoin.
-
5
Récupérez détails et pièces jointes
Utilisez l’ID du message reçu dans le webhook pour récupérer les détails et pièces jointes via l’API REST.
Authentification des webhooks
- Aucune authentification (à réserver aux tests).
- Authentification Basic avec nom d’utilisateur et mot de passe.
- Jeton Bearer dans l’en-tête Authorization.
- Clé d’API dans l’en-tête de votre choix.
- Vous pouvez en outre ajouter vos propres en-têtes.
Nouvelles tentatives
- En cas d’erreur temporaire (timeout, 408, 429 ou 5xx), Boxflow réessaie automatiquement.
- Jusqu’à 10 tentatives, avec des délais croissants répartis sur environ 3 jours.
- Chaque tentative est consignée dans la piste d’audit du message.
- Astuce : rendez votre endpoint idempotent sur la base de l’ID du message, afin qu’une livraison répétée ne crée pas de doublons.
API REST
- Liste des workspaces et des utilisateurs.
- Liste des messages d’un workspace et détails d’un message.
- Liste et téléchargement des pièces jointes d’un message.
- Authentification par jeton Bearer ; la documentation complète est disponible sur /apidocs.
Questions fréquentes
Quelles données contient un webhook Boxflow ?
C’est vous qui décidez. Vous composez le contenu avec des placeholders pour le message, l’expéditeur, l’entreprise, le statut et le workspace.
Que se passe-t-il si mon serveur est momentanément injoignable ?
Boxflow réessaie automatiquement, jusqu’à 10 fois sur environ 3 jours.
Comment télécharger les pièces jointes via l’API ?
Avec l’ID du message reçu dans le webhook, vous listez les pièces jointes du message et téléchargez chacune d’elles via l’API REST, avec votre jeton d’API comme jeton Bearer.
À lire aussi
Billit
Le courrier officiel directement dans Billit, par e-mail
En savoir plusExact Online
Le courrier officiel directement dans Exact Online, par e-mail
En savoir plusMake.com
Les messages eBox automatiquement dans SharePoint
En savoir plusOdoo
Le courrier officiel directement dans Odoo, par e-mail
En savoir plusPower Automate
Les messages eBox dans SharePoint ou Teams avec Power Automate
En savoir plusSingle sign-on
Connectez-vous avec Microsoft Entra ID ou Google Workspace
En savoir plusZapier
Bientôt disponible : connectez Boxflow à des milliers d’apps
En savoir plusPrêt à mettre votre eBox en pilote automatique ?
Connectez gratuitement votre première entreprise et recevez vos messages officiels là où vous en avez besoin.