Guide d’intégration Power Automate

Le connecteur Adjulo pour Power Automate (et Power Apps, Logic Apps) amène vos opportunités InsightsVibe et votre pipeline dans vos flux Microsoft : les appels d’offres ouverts classés selon votre marché et votre historique de soumissions, la fiche de chacun, et les actions pour les suivre, les faire avancer ou les retirer de votre pipeline. Vous composez le reste : un résumé quotidien dans Teams, une ligne dans Excel ou SharePoint, une approbation qui fait passer un avis à « Go ».

Type
Connecteur personnalisé
Power Platform
Licence qui permet les connecteurs personnalisés (Premium)
Forfait Adjulo
Pro ou Entreprise
Branchement
Votre clé API Adjulo

Avant de commencer

  • Un compte Adjulo au forfait Pro ou Entreprise.
  • Votre clé API Adjulo (portail, Développeurs → API). ⚠️ Votre organisation n’a qu’une clé active : en générer une nouvelle remplace l’ancienne et coupe les intégrations qui s’en servent. Reprenez la clé existante si vous en avez déjà une.
  • Un environnement Power Platform où vous pouvez créer des connecteurs personnalisés, avec une licence qui les permet (Power Automate Premium ou équivalent).
  • Les deux fichiers du connecteur : la définition et l’icône.

Importer le connecteur

  1. Ouvrez les connecteurs personnalisés

    Dans Power Automate (make.powerautomate.com), menu Plus → Connecteurs personnalisés. Dans Power Apps, la tuile est sous Plus → Découvrir tout, section Données.

  2. Importez la définition

    Nouveau connecteur personnalisé → Importer un fichier OpenAPI, nommez-le « Adjulo » et choisissez le fichier de définition. L’hôte (api.adjulo.io) et les opérations sont repris du fichier.

  3. Général et Sécurité

    Onglet Général : chargez l’icône, couleur d’arrière-plan #2B2825. Onglet Sécurité : authentification Clé API, paramètre X-API-Key, dans l’en-tête — normalement déjà rempli.

  4. Ajoutez la stratégie User-Agent

    Onglet Définition, section Stratégies : Définir l’en-tête HTTP, nom User-Agent, valeur adjulo-powerautomate/1.0, action override, sur la requête. Indispensable : sans elle, les appels partis des serveurs de Microsoft sont refusés par la protection de l’API.

  5. Créez et essayez

    Créer un connecteur, puis onglet Tester : Nouvelle connexion avec votre clé API, et lancez ObtenirMonProfil. Un statut 200 avec votre profil : le connecteur est prêt.

Les actions

OpérationCe qu’elle fait
Lister mes opportunitésLes appels d’offres ouverts classés par InsightsVibe selon votre marché et votre historique — une pertinence, pas une probabilité.
Obtenir un appel d’offresLa fiche d’un avis, avec le nombre de soumissionnaires et de contrats. Elle attend le champ « Identifiant public » d’une opportunité.
Lister mon pipelineLes avis suivis, avec leur étape et leur état, filtrables par étape, état ou membre assigné.
Suivre un appel d’offres dans mon pipelineAjoute un avis ouvert à votre pipeline, à l’étape Repéré. Sans effet s’il y est déjà.
Faire avancer un appel d’offres dans mon pipelineChange l’étape (À évaluer, Go, No-go, Documents, En préparation, Soumis…), l’état ou le membre assigné. No-go et Non soumis closent l’avis.
Retirer un appel d’offres de mon pipelineRetire un avis suivi, avec son fil de suivi. Irréversible.
Obtenir mon profilLe compte de la connexion : utile pour vérifier qu’elle fonctionne.

Composer un flux

  • Un déclencheur de Power Automate. Le connecteur n’a que des actions : partez d’une Récurrence (par exemple chaque matin en semaine) ou d’un déclencheur manuel.
  • Vos opportunités, puis le détail. Ajoutez Lister mes opportunités, puis, dans une boucle sur la liste, Obtenir un appel d’offres avec le champ « Identifiant public ».
  • Deux identifiants pour un même avis. « Obtenir un appel d’offres » attend l’identifiant public (texte) ; les quatre actions du pipeline attendent l’identifiant interne (nombre). Les opportunités, la fiche et le pipeline donnent les deux : choisissez le bon champ dans le concepteur.
  • Comme dans le portail. Un avis ajouté ou avancé par un flux part vers vos CRM reliés (GoHighLevel, HubSpot), comme depuis le portail. Réservez « Retirer » aux flux que vous lancez vous-même : il efface le fil de suivi.

Mettre à jour le connecteur

Quand Adjulo publie une nouvelle définition, ouvrez le connecteur, activez l’Éditeur Swagger ou réimportez le fichier, puis Mettre à jour le connecteur. Vérifiez que la stratégie User-Agent est toujours là. Si le portail affiche « Échec du téléchargement de l’icône d’origine », rechargez l’icône dans l’onglet Général et recommencez.

Débrancher

Supprimez vos flux Adjulo, puis la connexion et le connecteur dans Power Automate. Pour couper tout accès d’un coup, révoquez la clé API dans le portail : toutes les intégrations qui s’en servent s’arrêtent.

Les autres guides

Découvrir les connecteurs CRM en un coup d’œil