Guide étape par étape pour configurer les Webhooks Quire

Dernière mise à jour : 24 juillet 2026

Avez-vous déjà rêvé que vos applications puissent se parler automatiquement entre elles ? C'est exactement ce que font les webhooks ! Voyez-les comme des messagers qui préviennent votre serveur dès que quelque chose se passe dans vos projets Quire, qu'il s'agisse d'une nouvelle tâche créée, d'une réassignation ou d'une tâche marquée comme terminée.

Dans ce guide, nous allons vous montrer comment configurer les webhooks pour que vos applications restent synchronisées avec Quire, sans que vous ayez à lever le petit doigt.

Comment démarrer avec les webhooks Quire ?

Étape 1 : créez votre application Quire

Avant toute chose, vous aurez besoin d'une application Quire. Si vous n'en avez pas encore configuré une, consultez notre guide Créer une application Quire avec l'API Quire, nous vous accompagnons pas à pas.

Étape 2 : indiquez à Quire où envoyer les mises à jour

Il est maintenant temps de configurer votre point de terminaison webhook dans le portail Développeur d'apps pour Quire. Il s'agit simplement de l'adresse web vers laquelle vous souhaitez que Quire envoie les notifications, quelque chose comme http://myserver/hookhandler.

Voyez cela comme le fait de donner votre adresse postale à Quire pour qu'il sache où livrer les nouvelles.

Étape 3 : abonnez-vous aux mises à jour

La dernière étape de configuration consiste à indiquer à Quire quels projets ou tâches vous souhaitez suivre. Pour cela, ajoutez votre application comme « suiveur » via l'API Quire :

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app"]}' \
  https://quire.io/api/project/projectAOid

Remarque importante : assurez-vous d'avoir déjà configuré votre URL de webhook avant cette étape. Sans cela, l'ajout de votre application comme suiveur ne fonctionnera pas.

Lorsque vous n'avez plus besoin de mises à jour, retirez simplement votre application de la liste des suiveurs. C'est aussi simple que ça !

Pour plus de détails, consultez Mettre à jour un projet par OID dans notre référence API.

Comment fonctionnent les webhooks en coulisses ?

Ce que vous recevrez

Une fois tout configuré, Quire commence à vous envoyer des notifications dès que quelque chose se produit dans vos projets suivis. Elles arrivent sous forme de requêtes POST contenant tous les détails dans un joli paquet JSON :

{
  "type": "notification",
  "secret": "your-app-secret",
  "data": {
    "type": 0, 
    "when": "2019-09-30T08:20:12.000Z",
    "what": {
      "oid": "YxjapXXRCOYxoaiCT4tT3OQm", 
      "id": 101,
      "name": "Brand new start"
    },
    "user": {
      "oid": "1AbDEFed2A5031BEDDweqmde",
      "id": "john.doer",
      "name": "John Doer"
    },
    "message": "<a href=\"https://quire.io/u/john.doer\">John Doer</a> added <a href=\"https://quire.io/w/MyProjects/101\">Brand new start</a>",
    "text": "John Doer added Brand new start",
    "url": "https://quire.io/w/MyProjects/101"
  } 
}

La sécurité avant tout : vérifiez la source

Chaque webhook inclut la clé secrète de votre application. C'est votre moyen de confirmer que le message provient bien de Quire, et non de quelqu'un qui cherche à se faire passer pour nous. Vérifiez toujours ce point avant de traiter la moindre donnée !

Réagir aux différents événements

Différentes choses se produisent dans vos projets, et vous voudrez les traiter différemment. Voici un exemple simple de réponse selon l'événement survenu :

switch(json["data"]["type"]) {
  case 0:
    // new task added
    log("New task: " + json["data"]["what"]["name"]);
    break;
  case 1:
    // task removed
    log(json["data"]["user"]["name"] + " deleted " + json["data"]["what"]["name"]);
    break;
}

Quels types d'événements Quire envoie-t-il ?

Quire peut vous notifier de toutes sortes d'activités. Voici quelques-unes des plus courantes :

Vous voulez la liste complète ? Consultez notre documentation des types d'activité pour découvrir tout ce que Quire peut vous dire.

Faire savoir à Quire que vous avez bien reçu le message

Lorsque votre webhook reçoit une notification, renvoyez simplement un code de statut de réussite (n'importe quelle valeur entre 200 et 299). Cela indique à Quire : « C'est bon, reçu, merci ! »

Si quelque chose ne va pas et que vous renvoyez un code de statut différent, pas d'inquiétude, Quire réessaiera d'envoyer la notification après 15 minutes, puis après 1 heure, et enfin après 1 jour.

Pour plus de détails, consultez « Réponses et tentatives de renvoi » dans notre documentation API.

Comment gérer les webhooks sur plusieurs projets ?

Vous travaillez avec plusieurs projets Quire sur le même serveur ? Nous avons ce qu'il vous faut, avec deux approches flexibles :

Option 1 : utiliser des étiquettes personnalisées

Vous pouvez ajouter une étiquette personnalisée lors de l'abonnement aux mises à jour d'un projet :

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app|handleProjectA"]}' \
  https://quire.io/api/project/projectAOid

Quire inclura cette étiquette dans chaque notification webhook, ce qui vous permet d'identifier facilement quel projet l'a envoyée :

{
  "type": "notification",
  "team": "handleProjectA",
  "data": {
    // event details...
  }
}

Ensuite, dans votre code, vous pouvez router les notifications en conséquence :

switch(json["data"]["type"]) {
  case 0:
    // new task added
    if (json["team"] == "handleProjectA") {
      log("ProjectA has a new task: " + json["data"]["what"]["name"]);
    }
    break;
}

Option 2 : utiliser des chemins différents

Vous préférez tout séparer ? Configurez un chemin unique pour chaque projet :

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app|/projectAUpdate"]}' \
  https://quire.io/api/project/projectAOid

Ainsi, Quire envoie les notifications vers différents sous-chemins de votre point de terminaison principal (comme http://myserver/hookhandler/projectAUpdate), et vous pouvez traiter chaque projet avec son propre gestionnaire dédié.

Quel est le chemin le plus rapide vers votre premier webhook ?

Voilà, c'est tout ! Vous savez maintenant comment configurer des webhooks et garder vos applications parfaitement synchronisées avec Quire. Pour la documentation technique complète, consultez la section Webhook de notre référence API.

Vous développez pour un assistant IA plutôt que pour un serveur personnalisé ? Consultez Configurer Quire MCP en 5 minutes pour connecter directement Claude, ChatGPT ou n'importe quel client IA.

Bonne construction !

Questions fréquemment posées

Qu'est-ce qu'un webhook Quire ?

Une notification HTTP automatisée que Quire envoie vers une URL que vous contrôlez dès que quelque chose se produit dans un projet suivi, pour que votre application reste synchronisée sans avoir à interroger l'API.

Comment configurer un webhook dans Quire ?

Créez une application Quire, enregistrez l'URL de votre point de terminaison dans le portail Développeur d'apps pour Quire, puis ajoutez votre application comme suiveur d'un projet via l'API. Configurez l'URL avant de vous abonner, sinon l'appel échouera.

Comment vérifier qu'une requête webhook provient bien de Quire ?

Chaque charge utile inclut le champ secret de votre application : comparez-le à votre secret stocké et rejetez toute requête qui ne correspond pas.

Que se passe-t-il si mon serveur est hors service au moment où un webhook se déclenche ?

Quire réessaie trois fois : après 15 minutes, 1 heure, puis 1 jour. Renvoyez un statut 2xx dès que vous recevez la charge utile pour arrêter les nouvelles tentatives.

Comment gérer les webhooks pour plusieurs projets Quire sur un seul serveur ?

Vous pouvez soit joindre une étiquette personnalisée lors de l'abonnement (par exemple app|handleProjectA) et router selon le champ team, soit attribuer à chaque projet son propre sous-chemin sur l'URL de votre webhook.