Relier le CRM à Power Automate

Avec le connecteur personnalisé d’Illizeo, Power Automate lit et écrit dans le CRM (comptes, contacts, opportunités, activités) et démarre un flux dès qu’un événement du CRM se produit, par exemple une opportunité gagnée. Le connecteur se décrit dans un fichier OpenAPI que vous téléchargez depuis Illizeo et importez dans Power Automate. Cet article s’adresse aux administrateurs du CRM et aux personnes qui construisent les flux.

Avant de commencer #

• Le module CRM doit être activé, et votre abonnement Illizeo doit comprendre les webhooks pour que les déclencheurs reçoivent les événements.
• Un compte Power Automate qui permet les connecteurs personnalisés.
• Pour télécharger le fichier du connecteur : « Réglages du CRM : consulter ».
• Un jeton d’API, créé dans Paramètres › Gérer Illizeo › Jetons API (voir Créer et gérer les jetons API), avec sous Droits : Écrire pour « CRM — abonnements aux webhooks » (les déclencheurs) ; Lire pour les objets que vos flux lisent ou reçoivent ; Écrire pour ceux qu’ils créent ou modifient.
• Le jeton agit avec les droits et la portée de la personne qui l’a créé. Pour les déclencheurs, il lui faut « Réglages du CRM : créer » (s’abonner) et « Réglages du CRM : supprimer » (se désabonner) ; pour les actions, les droits de l’écran sur l’objet (« Comptes CRM : consulter », « créer », « modifier »…).

Télécharger le connecteur #

1. Ouvrez Paramètres › CRM › Webhooks et intégrations.
2. Dans la carte Intégrations, sous Power Automate, cliquez sur Télécharger le connecteur.

Vous obtenez le fichier illizeo-crm-power-automate.swagger.json, une description OpenAPI 2.0 de l’API v1 du CRM et de son déclencheur. Il ne contient ni secret ni jeton : la clé se saisit dans Power Automate.

Importer le connecteur dans Power Automate #

Les libellés ci-dessous sont ceux de Power Automate ; ils peuvent varier selon votre version.

1. Dans Power Automate, ouvrez Données › Connecteurs personnalisés, puis Nouveau connecteur personnalisé › Importer un fichier OpenAPI.
2. Nommez le connecteur (par exemple « Illizeo CRM ») et choisissez le fichier téléchargé.
3. Vérifiez l’onglet Sécurité : le fichier pose l’authentification par Clé API, nom du paramètre Authorization, emplacement En-tête. L’hôte et le chemin de base /v1 viennent aussi du fichier.
4. Cliquez sur Créer le connecteur.
5. Créez une connexion : quand Power Automate demande la clé, saisissez Bearer, une espace, puis votre jeton d’API.

Démarrer un flux sur un événement du CRM #

1. Créez un flux de cloud automatisé et choisissez le déclencheur When a CRM event occurs du connecteur.
2. Dans le champ Event, choisissez l’événement, par exemple crm.opportunity.won.
3. Ajoutez vos actions. Le contenu reçu est celui d’un webhook du CRM : id (l’identifiant de l’événement), event, occurred_at, tenant et data, qui porte object_type, object_id et, pour un compte, un contact, une opportunité ou une activité, object, la fiche sous la forme de l’API v1.
4. Enregistrez le flux.

À l’enregistrement, Power Automate s’abonne aux webhooks du CRM avec votre jeton : l’abonnement, nommé « Power Automate », apparaît dans Paramètres › CRM › Webhooks et intégrations. Quand le flux est supprimé, Power Automate se désabonne ; seul le jeton qui a créé l’abonnement peut le retirer ainsi. L’abonnement n’envoie que ce que le jeton peut lire, et suit les règles des webhooks du CRM : relances, suspension après cinq relances échouées d’affilée (voir Les webhooks du CRM).

Le déclencheur propose dix événements :

Pour un autre événement du CRM (compte archivé, devis envoyé, cotisation en retard…), créez un abonnement à la main vers un déclencheur HTTP de Power Automate (voir Les webhooks du CRM).

Les actions #

Le connecteur apporte, pour les comptes, les contacts, les opportunités et les activités, une action pour lister, lire une fiche, créer et modifier. Il n’apporte pas de suppression.

• Les listes acceptent une recherche plein texte (q), « modifié depuis » (modified_since), le propriétaire (owner_id ; pour les activités, la personne assignée), une étiquette (tag) et se paginent par curseur (cursor, limit : 50 par défaut, 200 au plus). La réponse porte items, next_cursor et has_more : bouclez tant que has_more est vrai, en passant next_cursor.
• Une création ou une modification suit les règles de l’écran : mêmes contrôles, mêmes droits, mêmes portées. Un compte ou un contact qui ressemble à une fiche existante répond 409 DUPLICATES_FOUND tant que le corps n’envoie pas confirmer_doublon à vrai.
• Si votre espace soumet une écriture à une validation humaine, l’action répond 202 sans rien écrire, avec l’identifiant de la demande (voir Faire valider les fiches et les envois).

Les corps et les réponses ont la forme de l’API v1, avec des clés en français : voir Importer, exporter et utiliser l’API.

À savoir #

• Révoquer le jeton coupe à la fois les actions et les déclencheurs de tous les flux qui l’utilisent.
• Un flux désactivé sans être supprimé garde son abonnement ; si ses livraisons échouent, l’abonnement finit suspendu. Supprimez le flux, ou l’abonnement dans la liste, quand vous n’en avez plus besoin.
• Les données de démonstration ne déclenchent aucun flux.

Questions fréquentes #

L’enregistrement du flux échoue. #

Vérifiez que le jeton porte Écrire pour « CRM — abonnements aux webhooks », que son créateur a « Réglages du CRM : créer », et que l’événement choisi est l’un des dix proposés.

Le flux ne démarre pas. #

Vérifiez que le jeton porte la lecture de l’objet (« CRM — opportunités » pour une opportunité gagnée) et que son créateur peut lire la fiche dans sa portée. Ouvrez ensuite l’abonnement « Power Automate » dans Paramètres › CRM › Webhooks et intégrations : son journal des livraisons dit si l’événement est parti et ce que Power Automate a répondu.