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. Les rôles Propriétaire et Membre peuvent créer et gérer les webhooks ; le rôle Commercial n'y a pas accès. Les événements déclenchés par vos commerciaux sont tout de même envoyés à vos 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.

💡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é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

ℹ️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 :

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

💡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 :

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.

⚠️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

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

Webhooks & Intégrations

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

Connectez vos outils grâce aux webhooks

ℹ️Information

Qu'est-ce qu'un webhook ?

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.

💡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é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

ℹ️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

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 :

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

💡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 :

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.

⚠️Attention

Cas d'usage courants

Synchronisation avec un CRM externe

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

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