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.
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
- Accédez à Intégrations > Webhooks
- Cliquez sur Créer un webhook
- Renseignez les informations suivantes :
| Champ | Description |
|---|---|
| Nom | Un nom descriptif pour identifier le webhook (ex. : « Notification Slack — Nouveaux contacts ») |
| URL du endpoint | L'URL vers laquelle les données seront envoyées (ex. : https://hooks.slack.com/services/...) |
| Événements | Sélectionnez un ou plusieurs événements déclencheurs |
- Cliquez sur Enregistrer
Le webhook est immédiatement actif et commencera à envoyer des données dès le prochain événement correspondant.
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énement | Description |
|---|---|---|
| Contacts | Création de contact | Un nouveau contact est ajouté au CRM |
| Contacts | Mise à jour de contact | Les informations d'un contact sont modifiées |
| Contacts | Changement d'étape | Un contact est déplacé dans le pipeline |
| Réservation | Nouvelle réservation | Un rendez-vous est confirmé via le module de réservation |
| Formulaires | Soumission de formulaire | Un visiteur soumet un formulaire de capture |
| Recrutement | Nouvelle candidature | Un candidat postule à une offre d'emploi |
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.
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 :
- Accédez au webhook créé dans Intégrations > Webhooks
- Cliquez sur Tester
- Un payload d'exemple sera envoyé à votre URL
- Vérifiez que votre système reçoit et traite correctement les données
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 :
| Tentative | Délai après l'échec |
|---|---|
| 1re tentative | Immédiate |
| 2e tentative | 5 minutes après |
| 3e tentative | 30 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.
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
- Formulaires de capture — Capturer des leads automatiquement via des formulaires
- Gestion des contacts — Comprendre la structure des données contacts
- Paramètres du compte — Configuration générale de l'espace de travail