Webhooks & Intégrations

Connectez Boost Conciergerie à vos outils externes grâce aux webhooks et notifications automatiques.

Connectez vos outils grâce aux webhooks

Les webhooks permettent à Boost Conciergerie d'envoyer automatiquement des notifications en temps réel vers vos outils externes lorsque des événements se produisent dans votre espace de travail. Chaque fois qu'un contact est créé, qu'une réservation est confirmée ou qu'un formulaire est soumis, un message est envoyé à l'URL de votre choix.

ℹ️Information

Les webhooks sont accessibles depuis Intégrations > Webhooks dans la barre latérale. Seuls les utilisateurs avec le rôle Propriétaire peuvent créer et gérer les webhooks.


Qu'est-ce qu'un webhook ?

Un webhook est un mécanisme qui envoie automatiquement des données à une URL externe lorsqu'un événement spécifique se produit. Contrairement à une API classique où vous interrogez régulièrement le serveur pour vérifier les changements, le webhook pousse l'information vers votre système dès qu'elle est disponible.

Exemple concret : un nouveau propriétaire remplit votre formulaire de capture → Boost Conciergerie envoie instantanément les coordonnées du contact vers votre canal Slack → votre équipe commerciale est notifiée en temps réel.


Créer un webhook

Étape par étape

  1. Accédez à Intégrations > Webhooks
  2. Cliquez sur Créer un webhook
  3. Renseignez les informations suivantes :
ChampDescription
NomUn nom descriptif pour identifier le webhook (ex. : « Notification Slack — Nouveaux contacts »)
URL du endpointL'URL vers laquelle les données seront envoyées (ex. : https://hooks.slack.com/services/...)
ÉvénementsSélectionnez un ou plusieurs événements déclencheurs
  1. Cliquez sur Enregistrer

Le webhook est immédiatement actif et commencera à envoyer des données dès le prochain événement correspondant.

💡Astuce

Donnez un nom clair et précis à chaque webhook pour faciliter leur gestion lorsque vous en aurez plusieurs. Par exemple : « Zapier — Sync CRM HubSpot » ou « Make — Google Sheets leads ».


Événements disponibles

Vous pouvez configurer vos webhooks pour écouter les événements suivants :

CatégorieÉvénementDescription
ContactsCréation de contactUn nouveau contact est ajouté au CRM
ContactsMise à jour de contactLes informations d'un contact sont modifiées
ContactsChangement d'étapeUn contact est déplacé dans le pipeline
RéservationNouvelle réservationUn rendez-vous est confirmé via le module de réservation
FormulairesSoumission de formulaireUn visiteur soumet un formulaire de capture
RecrutementNouvelle candidatureUn candidat postule à une offre d'emploi
ℹ️Information

Vous pouvez sélectionner plusieurs événements pour un même webhook. Par exemple, un seul webhook peut écouter les créations de contacts ET les soumissions de formulaires.


Format des données (payload)

Lorsqu'un événement se produit, Boost Conciergerie envoie une requête HTTP POST à l'URL configurée avec un corps JSON structuré comme suit :

{
  "event": "contact.created",
  "timestamp": "2026-04-05T14:32:00Z",
  "account_id": "abc123-def456",
  "data": {
    "id": "contact_789",
    "first_name": "Jean",
    "last_name": "Dupont",
    "email": "jean.dupont@example.com",
    "phone": "+33 6 12 34 56 78",
    "source": "form",
    "created_at": "2026-04-05T14:32:00Z"
  }
}

Chaque payload contient :

  • event — Le type d'événement déclenché
  • timestamp — La date et l'heure exactes de l'événement (format ISO 8601)
  • account_id — L'identifiant de votre espace de travail
  • data — Les données complètes de l'objet concerné (contact, réservation, candidature, etc.)

Sécurité des webhooks

Chaque webhook dispose d'un secret unique généré automatiquement. Ce secret est utilisé pour signer les requêtes envoyées, vous permettant de vérifier que les données proviennent bien de Boost Conciergerie et n'ont pas été falsifiées.

Le secret est inclus dans l'en-tête HTTP de chaque requête sous la forme d'une signature que vous pouvez valider côté serveur.

⚠️Attention

Ne partagez jamais votre secret de webhook publiquement. Si vous pensez qu'il a été compromis, supprimez le webhook et recréez-en un nouveau.


Tester un webhook

Avant de l'utiliser en production, testez votre webhook pour vérifier que votre endpoint reçoit correctement les données :

  1. Accédez au webhook créé dans Intégrations > Webhooks
  2. Cliquez sur Tester
  3. Un payload d'exemple sera envoyé à votre URL
  4. Vérifiez que votre système reçoit et traite correctement les données
💡Astuce

Utilisez un outil comme webhook.site ou RequestBin pour inspecter les payloads reçus lors de vos tests, avant de connecter votre endpoint de production.


Logique de réessai automatique

Si votre endpoint ne répond pas ou renvoie une erreur (code HTTP 4xx ou 5xx), Boost Conciergerie réessaie automatiquement l'envoi :

TentativeDélai après l'échec
1re tentativeImmédiate
2e tentative5 minutes après
3e tentative30 minutes après

Après 3 tentatives échouées, le webhook est marqué comme en erreur. Vous pouvez consulter le statut et la date du dernier déclenchement dans la liste de vos webhooks.

⚠️Attention

Si un webhook échoue de manière répétée, vérifiez que votre URL est toujours accessible et que votre serveur répond avec un code HTTP 200. Le webhook reste actif mais les événements manqués ne seront pas renvoyés après les 3 tentatives.


Cas d'usage courants

Synchronisation avec un CRM externe

Envoyez automatiquement vos nouveaux contacts vers HubSpot, Pipedrive ou tout autre CRM. Configurez un webhook sur l'événement « Création de contact » pointant vers l'API de votre CRM ou une plateforme d'automatisation intermédiaire.

Notifications Slack ou Microsoft Teams

Recevez une notification instantanée dans un canal Slack ou Teams lorsqu'un nouveau lead arrive. Utilisez l'URL d'un webhook entrant Slack comme endpoint.

Automatisation avec Zapier ou Make

Créez des scénarios d'automatisation avancés :

  • Zapier — Utilisez le trigger « Webhook » de Zapier pour déclencher des actions dans plus de 5 000 applications
  • Make (ex-Integromat) — Créez un scénario avec le module « Webhooks » pour des flux de travail complexes

Export vers Google Sheets

Alimentez automatiquement un tableau Google Sheets avec vos nouveaux contacts ou réservations via Zapier ou Make. Idéal pour le reporting ou le partage d'informations avec des collaborateurs externes.


Gérer vos webhooks

Depuis la page Intégrations > Webhooks, vous pouvez :

  • Activer/Désactiver un webhook sans le supprimer (pratique pour la maintenance)
  • Modifier l'URL ou les événements écoutés
  • Consulter le statut : dernier déclenchement, dernier code de réponse
  • Supprimer un webhook définitivement

Voir aussi