Power Automate

Pour les entreprises équipées de Microsoft 365, Power Automate relie Hela à Outlook, Teams, SharePoint, Excel et Dynamics.

Connecteur personnalisé

Hela publie son schéma OpenAPI (GET /openapi.json). Power Automate sait créer un connecteur personnalisé à partir d'un tel schéma :

1. Power Automate → Données → Connecteurs personnalisés → Nouveau → Importer un fichier OpenAPI. Téléchargez d'abord https://<votre-serveur>/v1/openapi.json. Le connecteur accepte la version 3.0 ; si l'import se plaint de la 3.1, convertissez avec npx openapi-down-convert.
2. Sécurité : Clé API, nom du paramètre Authorization, emplacement En-tête. Au moment de créer la connexion, collez Bearer hela_live_… — avec le mot Bearer et l'espace.
3. Définition : les opérations sont déjà nommées et décrites. Masquez celles qui ne vous servent pas pour alléger le choix dans l'éditeur.
4. Tester avec GET /companies/{companyId}/sales.

Déclencheurs

Power Automate déclenche un flux sur une requête HTTP entrante : Lorsqu'une requête HTTP est reçue. Créez le flux, copiez l'adresse générée, puis créez dans Hela un webhook vers cette adresse avec les événements voulus. Collez le corps d'exemple du catalogue dans Utiliser un exemple de charge utile pour que les champs soient typés.

Le flux doit répondre 200 rapidement (action Réponse en premier) et vérifier l'en-tête Hela-Signature si l'adresse est devinable — une action Composer avec hmacSHA256 fait l'affaire.

Exemples

• Facture émise → e-mail Outlook au client avec le PDF (GET /sales/{id}/invoice.pdf) en pièce jointe.
• Clôture de caisse → message Teams dans le canal de la direction, avec les totaux de data.
• Nouvelle ligne Excel → vente Hela pour une équipe qui saisit ses commandes dans un classeur partagé.

Connecteur certifié

Un connecteur certifié Hela, prêt à l'emploi dans l'annuaire Microsoft, est en cours de publication. Le connecteur personnalisé décrit ici donne le même résultat en attendant.