Solavel Documents
Français

Intégrations

Dernière mise à jour

L'onglet du projet Intégrations connecte un projet à d'autres systèmes :

  • Webhooks sortants envoient des événements de projet (tâche créée, sprint commencé, document créé...) vers un point de terminaison HTTPS dont vous êtes propriétaire, signé pour que le destinataire puisse leur faire confiance.
  • Les jetons de webhook entrants permettent à un système externe (un outil de formulaire, GitHub, un script) de créer des tâches ou des commentaires dans le projet.
  • Les jetons d'API publique donnent à un autre système un accès limité, en lecture ou en écriture, aux tâches et au temps du projet via l'API SolaProjects.
  • Disponibilité des intégrations natives présente les connexions prêtes à l’emploi (Slack, Microsoft Teams, GitHub, GitLab, Google Calendar, Google Drive, OneDrive, Zapier / IFTTT) et indique si chacune peut être connectée.

Utilisez cette fonction lorsqu'un projet doit communiquer avec un autre outil, par exemple transmettre les modifications des tâches au tableau de bord d'un client ou transformer les demandes du site web en tâches. Les chefs de projet et administrateurs la configurent, généralement une fois par projet avec votre interlocuteur informatique.

Deux pages sont nommées Intégrations. Cette page couvre l'onglet projet. L'élément Intégrations dans la section Espace de travail de la barre latérale (/projects/settings/integrations) correspond à la connexion SolaCount de l'organisation — voir Organisation SolaCountconnexion ci-dessous et Budget et finance.

#Où le trouver

Barre latérale Projet → Intégrations (entre Automatisations et IA)
URL /projects/{project}/integrations
Palette de commandes Intégrations · {project name} sous Projet actuel

Qui peut le voir :

  • Plan : les intégrations sont une fonctionnalité du forfait Premium (également Enterprise). Sur les forfaits inférieurs, l'onglet est masqué. Si un forfait payant expire, l'onglet disparaît et les webhooks ne sont plus proposés jusqu'à votre renouvellement.
  • Rôle : seules les personnes pouvant modifier le projet peuvent charger l'onglet (voir Autorisations). Les autres voient "Nous n'avons pas pu charger les intégrations." avec Réessayer.

#Visite guidée de l'écran

#Carte d'en-tête

Intégrations — Webhooks sortants, jetons entrants et historique de livraison.

Tuile Signification
Sortant Webhooks sortants actifs.
Jetons entrants Jetons entrants actifs et non révoqués.
Livraisons récentes Tentatives de livraison répertoriées dans Livraisons récentes.
Livraisons échouées Tentatives échouées parmi celles-ci (en rouge lorsque le nombre est supérieur à zéro).

#Carte des webhooks sortants

Envoyez des événements de projet par POST vers un point de terminaison HTTPS externe, signé avec HMAC-SHA256. Nouveau webhook en haut à droite.

Chaque carte de webhook affiche le nom, l’URL du point de terminaison, un badge d’état (Actif, Désactivé ou Archivé), une pastille par événement suivi et {n} livraisons · {n} échecs. Actions de ligne (absentes des webhooks archivés) : Modifier, Tester, Renouveler le secret, Archiver.

État vide : Aucun webhook sortant — Créez-en un pour envoyer des événements vers un système externe.

#Carte des jetons de webhook entrants

Permettez aux systèmes externes de créer des tâches/commentaires en effectuant un POST avec un jeton secret. Nouveau jeton en haut à droite.

Chaque carte de jeton : nom, fournisseur (Personnalisé ou GitHub) · dernière utilisation {date} ou jamais utilisé, indicateurActif, Inactif ou Révoqué. Actions (non disponibles pour les jetons révoqués) : Rotation, Révoquer.

État vide : Aucun jeton entrant — Créez un jeton pour accepter les webhooks entrants.

#Carte de l'API publique

Créez des jetons porteurs (bearer tokens) avec portée pour les points de terminaison documentés de projets, de tâches et de saisies de temps. Boutons : Documentation (ouvre la référence OpenAPI dans un nouvel onglet) et Nouveau jeton.

Chaque carte de jeton : nom, dernière utilisation {date} / jamais utilisé, badge de statut, une puce par capacité. Actions : Rotation, Révoquer.

État vide : Aucun jeton API — Créez un jeton pour l'API publique.

#Carte des livraisons récentes

Tentatives de livraison sortantes et leur résultat. Badge avec le décompte.

Colonne Signification
Quand Date de la livraison.
Webhook Nom du webhook, ou Webhook archivé.
Événement Type d'événement, ex. task.status_changed.
Statut Livré (vert), En attente (ambre, en attente ou en cours de nouvel essai), Échoué (rouge), Ignoré.
Tentatives Nombre de tentatives de SolaProjects.
Réponse Le code d'état HTTP renvoyé par votre point de terminaison, erreur lorsqu'aucune réponse n'a été reçue, ou —.
(bouton) Réessayer sur toute livraison non effectuée.

État vide : Aucune livraison pour le moment — Les tentatives de livraison apparaîtront ici dès qu'un événement se déclenchera ou que vous enverrez un test.

#Carte de disponibilité du fournisseur natif

État de la connexion et prérequis de configuration pour les intégrations spécifiques au fournisseur. Un bloc par fournisseur :

Fournisseur Ce que ça fait
Slack Envoyez les notifications de projet à Slack et recevez des commandes de tâches de Slack.
Microsoft Teams Envoyez les notifications de projet aux canaux Teams et prenez en charge les actions Teams.
GitHub Liez les événements de dépôt, les tickets, les pull requests et les commits aux tâches du projet.
GitLab Liez les merge requests, les tickets et les événements de pipeline GitLab aux tâches du projet.
Google Calendar Synchronisez les jalons du projet et les dates de tâches avec Google Calendar.
Google Drive Joignez ou synchronisez les documents du projet avec les dossiers Google Drive.
OneDrive Joignez ou synchronisez les documents du projet avec les dossiers OneDrive.
Zapier / IFTTT Exposez des SolaProjectsdéclencheurs et des actions aux plateformes no-code.

Chaque vignette affiche un statut (Disponible, En attente, Actif, Échec), la fonctionnalité et soit Configuration du fournisseur en production détectée., soit Le simulateur local est disponible ; les identifiants de production sont des paramètres d'activation. (le fournisseur n'est pas encore actif pour votre organisation). Elle peut aussi afficher Bloqué par une configuration manquante : …, Notes d'activation : …, Retour OAuth en attente., Dernière erreur : …, le dernier message ou le dernier événement reçu.

#Événements que vous pouvez envoyer

Cochez un ou plusieurs éléments dans le formulaire de webhook :

Événement Envoyé quand
task.created Une tâche est créée (y compris à partir d'un webhook entrant).
task.updated Une tâche est modifiée.
task.status_changed Le statut d'une tâche change.
task.completed Une tâche est marquée comme terminée.
task.blocked Une tâche est marquée comme bloquée.
comment.created Un commentaire de tâche est ajouté.
doc.created Un document de projet est créé.
time_entry.created Le temps est enregistré.
milestone.completed Une étape est terminée.
sprint.started / sprint.completed Un sprint commence / se termine.
share_link.created Un lien de partage invité est créé.
automation.run_failed / automation.rule_failed Une exécution d'automatisation échoue.
ai.suggestion_applied Une suggestion IA est appliquée.

Chaque requête est un POST JSON avec les en-têtes X-SolaProjects-Event (type d’événement), X-SolaProjects-Delivery (identifiant de livraison), X-SolaProjects-Signature (HMAC-SHA256 du corps brut avec votre secret de signature) et User-Agent: SolaProjects-Webhooks/1.0. Vérifiez la signature avant de faire confiance à une requête.

Réessais. Une livraison échouée est réessayée automatiquement après environ 1, 5, 15 et 60 minutes ; après la cinquième tentative, elle reste en statut Échoué. Utilisez Réessayer pour tenter à nouveau manuellement.

#Tâches

#Créer un webhook sortant

  1. Ouvrez le projet → Intégrations → Nouveau webhook.

  2. Remplissez Nouveau webhook sortant :

    Champ Obligatoire Règles / valeurs par défaut Remarques
    Nom Oui Jusqu'à 160 caractères. par ex. Tableau de bord client.
    URL du point de terminaison (HTTPS) Oui URL valide, jusqu'à 2 048 caractères, HTTPS public. Espace réservé https://example.com/hooks/solaprojects. Les adresses locales et de réseau privé sont refusées : "Utilisez un point de terminaison HTTPS public. Les URL de réseaux locaux et privés sont bloquées."
    Événements Oui Au moins un. Voir le tableau ci-dessus.
    Actif — Coché par défaut. Décochez pour enregistrer en tant que Désactivé.
  3. Cliquez sur Créer. Vous verrez le message Webhook sortant créé. et la boîte de dialogue Secret de signature : "Enregistrez ceci dès maintenant — il n'est affiché qu'une seule fois et ne peut pas être récupéré ultérieurement." Cliquez sur Copier (Copié dans le presse-papiers.), enregistrez le secret dans le système récepteur, puis cliquez sur Terminé.

#Modifier, tester, faire pivoter et archiver un webhook

Action Étapes Résultat
Modifier Modifier le Nom, l'URL, les événements ou Actif → Enregistrer. Webhook sortant mis à jour.
Tester Cliquez sur Tester. Envoi de test mis en file d'attente. Une ligne apparaît dans Livraisons récentes.
Faire pivoter le secret Confirmer Rotation du secret — "Le secret actuel cessera de fonctionner. Mettez à jour les services connectés avec le nouveau secret." Secret renouvelé. et le nouveau secret est affiché une seule fois.
Archiver Confirmer Archiver le webhook — "Ce webhook sortant cessera de transmettre les événements du projet." Webhook archivé. Badge Archivé ; plus d'envois ; historique conservé.

#Créer un jeton de webhook entrant

  1. Cliquez sur Nouveau jeton dans Jetons de webhook entrants.
  2. Nom (obligatoire, jusqu'à 160 caractères) et Fournisseur : Personnalisé (par défaut) ou GitHub.
  3. Cliquez sur Créer → Jeton entrant créé. Copiez le jeton de webhook entrant affiché une seule fois : "Utilisez ceci comme jeton dans votre URL de webhook entrant. Affiché une seule fois."

Le système externe envoie ensuite POST /api/projects/webhooks/incoming/{token} avec un corps JSON (limite de 60 requêtes par minute par expéditeur) :

Fournisseur Corps Que se passe-t-il
Personnalisé {"title": "...", "description": "...", "priority": "high"} Crée une tâche privée dans À faire (la priorité prend par défaut la valeur medium ; le titre est limité à 180 caractères). La réponse contient le nouveau task_key.
Personnalisé {"task_key": "ALN-14", "comment": "..."} Ajoute un commentaire interne à cette tâche.
GitHub Événement de ticket ou de commentaire sur un ticket Un ticket devient une tâche ; un commentaire sur un ticket dont le titre contient une clé de tâche (par exemple ALN-14) devient un commentaire sur cette tâche.

Tout le reste est refusé avec "Webhook rejeté." ; un jeton révoqué ou erroné reçoit la même réponse. Les tâches et les commentaires sont rédigés par la personne qui a créé le jeton.

Rotation émet un nouveau jeton et révoque immédiatement l’ancien (Jeton renouvelé.). Révoquer demande Révoquer le jeton — « Les requêtes utilisant ce jeton n’auront plus accès. » → Jeton révoqué.

#Créer un jeton API public

  1. Cliquez sur Nouveau jeton dans API publique.

  2. Nom (requis, jusqu'à 120 caractères) et Capacités (au moins une ; projects:read, tasks:read et time:read sont pré-cochées) :

    Capacité Autorise
    projects:read Lire ce projet.
    tasks:read / tasks:write Lire / créer et mettre à jour des tâches.
    time:read / time:write Lire / créer des entrées de temps.
  3. Créer → Jeton d'API créé. Copiez le Jeton d'API du projet : "Utilisez ceci comme jeton Bearer pour /api/v1. Affiché une seule fois uniquement."

Les tâches créées par l’API déclenchent les mêmes automatisations et webhooks que celles créées dans l’application. Rotation → confirmer Renouveler le jeton (« Le jeton actuel cessera de fonctionner. Mettez à jour les services connectés avec le nouveau jeton. ») → Jeton API renouvelé. Révoquer → Jeton API révoqué.

#Réessayer un envoi ayant échoué

Dans Livraisons récentes, cliquez sur Réessayer sur la ligne → Envoi réessayé. Vérifiez le Statut et la Réponse après un instant.

#Connecter un fournisseur natif

  1. Sur la tuile du fournisseur, choisissez le canal (par ex. #projets pour Slack) et cliquez sur Connecter → {Provider} connexion démarrée.
  2. Terminez la boîte de dialogue d'autorisation {Provider} autorisation avec Terminer le rappel (ou Plus tard) → Intégration native connectée.
  3. Une fois connecté, utilisez Envoyer un test ({Provider} message de test envoyé.), Actualiser ({Provider} actualisé.) ou Déconnecter ({Provider} déconnecté.).

Les tuiles en mode simulateur affichent également Simuler un événement et Erreur pour vérifier la configuration avant que le fournisseur ne soit mis en ligne ; elles ne contactent pas le service réel.

#Statuts

Objet Statuts
Webhook sortant Actif, Désactivé (enregistré avec Actif décoché), Archivé
Livraison En attente, Livré, Échoué, Sauté
Jeton entrant / API Actif, Inactif, Révoqué
Fournisseur natif Disponible, En attente, Actif, Échoué

#Autorisations

Rôle Ouvrir l'onglet Créer / modifier des webhooks, des jetons, des fournisseurs
Propriétaire de l'organisation Oui Oui
Administrateur de projets Oui Oui
Gestionnaire de projets qui est un Gestionnaire de projet ici Oui Oui
Membre du projet, projet Lecteur, invités Non Non

Si la modification des intégrations est désactivée pour votre organisation, l’onglet est en lecture seule : aucun bouton Nouveau, aucune action de ligne ni Réessayer. Une modification refusée affiche « Les modifications d’intégration sont désactivées ou non autorisées. » ; une page obsolète affiche « Veuillez recharger et réessayer. » Les secrets et jetons ne sont jamais réaffichés après la fenêtre initiale, même aux propriétaires.

#Connexion à l'organisation SolaCount

L'entrée Intégrations de la barre latérale de l'espace de travail (/projects/settings/integrations) est une autre page. Elle indique si SolaProjects est connecté à SolaCount (Connecté, Prêt à connecter, Intégration suspendue, Déconnecté — historique conservé, etc.) et permet au propriétaire ou à un administrateur financier de connecter, suspendre, déconnecter ou vérifier la connexion. Un projet peut s'en exclure dans l'onglet Paramètres (carte Intégrations → Projet interne / finances désactivées). Voir Budget et finances et la Présentation de SolaProjects.

#Exemples travaillés

#Exemple 1 — Les demandes deviennent des tâches (quotidien)

{User 1 name} souhaite que les demandes de renseignements du site web pour {Showroom project name} (DEMO-FIT) arrivent sous forme de tâches.

  1. Nouveau jeton → Nom Demandes de site web, Fournisseur Personnalisé → Créer ; elle donne le jeton au développeur web.
  2. Le site web comptabilise {"title": "Quote request – reception desk", "priority": "high"}.
  3. La tâche ALN-31 Quote request – reception desk apparaît dans À faire, privée, avec la priorité Élevé. La carte du jeton affiche dernière utilisation le 6 octobre.

#Exemple 2 — Flux du tableau de bord client avec un échec (scénario complet)

{User 2 name} connecte le tableau de bord du site d'{Organization name}.

Étape Action Résultat
1 Nouveau webhook : Tableau de bord du site, https://hooks.company.example.com/projects, événements task.status_changed, task.completed, milestone.completed. Webhook sortant créé. ; secret de signature copié dans le tableau de bord.
2 Tester. Envoi de test mis en file d'attente. ; ligne Livré, Réponse 200.
3 {User 1 name} déplace ALN-12 vers Terminé. Deux envois : task.status_changed et task.completed, tous deux Livrés.
4 Le tableau de bord est en maintenance. La prochaine livraison affiche En attente, puis Échoué avec la réponse 503 ; en-tête Livraisons échouées 1 en rouge ; une nouvelle tentative est effectuée à ~1, 5, 15, 60 minutes.
5 Tableau de bord rétabli ; {User 2 name} clique sur Réessayer. Envoi réessayé. → Livré.
6 L'informatique soupçonne une fuite du secret. {User 2 name} clique sur Faire pivoter le secret et confirme. Secret renouvelé. ; nouveau secret affiché une fois ; le service informatique met à jour le tableau de bord.

#Comment il se connecte

Où Lien
Tâches Les jetons entrants et l'API créent des tâches et des commentaires ; les modifications de tâches envoient des événements.
Planification L'achèvement des jalons et le début/la fin des sprints envoient des événements.
Automatisations Agir dans SolaProjects ; les exécutions échouées peuvent être envoyées en tant qu'événements.
Liens de partage invités Événement share_link.created.
IA Événement ai.suggestion_applied.
Suivi du temps événement time_entry.created ; capacités de l'API temporelles.
Paramètres Commutateur financier par projet SolaCount.

#Conseils et problèmes courants

Problème Parce que Corriger
Onglet manquant. Forfait inférieur à Premium ou expiré. Mettre à niveau ou renouveler.
Utilisez un point de terminaison HTTPS public… L'URL est http, localhost ou une adresse privée. Utilisez une URL HTTPS publique.
Perte d'un secret ou d'un jeton. Affiché une seule fois. Renouveler et mettre à jour l'autre système.
Livraisons Échoué avec un code 4xx. Votre point de terminaison rejette la requête (souvent un contrôle de signature). Vérifiez que le point de terminaison utilise le secret actuel.
Webhook rejeté. sur les appels entrants. Jeton révoqué/incorrect, ou le corps ne contient pas title ou task_key + comment. Vérifiez le jeton et le corps.
Commentaire non ajouté depuis GitHub. Le titre du ticket ne contient pas de clé de tâche. Mettez la clé (par ex. ALN-14) dans le titre du ticket.
L'API renvoie un accès refusé. Le jeton manque de capacités ou est révoqué. Créez un jeton avec les capacités appropriées.
Le fournisseur indique que le simulateur local est disponible… Pas encore actif pour votre organisation. Demandez au support Solavel concernant l'activation.