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
-
Ouvrez le projet → Intégrations → Nouveau webhook.
-
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é. -
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
- Cliquez sur Nouveau jeton dans Jetons de webhook entrants.
- Nom (obligatoire, jusqu'à 160 caractères) et Fournisseur : Personnalisé (par défaut) ou GitHub.
- 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
-
Cliquez sur Nouveau jeton dans API publique.
-
Nom (requis, jusqu'à 120 caractères) et Capacités (au moins une ;
projects:read,tasks:readettime:readsont pré-cochées) :Capacité Autorise projects:readLire ce projet. tasks:read/tasks:writeLire / créer et mettre à jour des tâches. time:read/time:writeLire / créer des entrées de temps. -
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
- Sur la tuile du fournisseur, choisissez le canal (par ex. #projets pour Slack) et cliquez sur Connecter → {Provider} connexion démarrée.
- Terminez la boîte de dialogue d'autorisation {Provider} autorisation avec Terminer le rappel (ou Plus tard) → Intégration native connectée.
- 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.
- Nouveau jeton → Nom Demandes de site web, Fournisseur Personnalisé → Créer ; elle donne le jeton au développeur web.
- Le site web comptabilise
{"title": "Quote request – reception desk", "priority": "high"}. - 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. |