← Xoolink

Recettes d’intégration Xoolink beta

Quatre parcours relient Xoolink à la stack courante d’une organisation. Slack et Yousign sont des connexions natives. HubSpot et Notion utilisent une recette contrôlée : API Xoolink en lecture, webhook signé, puis relais serveur ou outil d’automatisation.

Une recette n’est pas un accès direct à votre compte cible. Ne collez jamais une clé HubSpot ou Notion dans Xoolink. Conservez les secrets de chaque plateforme dans le coffre de votre relais serveur ou d’automatisation.

Slack · connexion native

  1. Dans le tableau de bord admin de l’organisation, cliquez sur Voir la connexion.
  2. Choisissez Connecter Slack, autorisez Xoolink et sélectionnez un canal.
  3. Utilisez Tester dans la liste des destinations pour confirmer la livraison.

Xoolink ne conserve pas le jeton OAuth Slack. Seule la destination du canal est chiffrée. Consulter le guide Slack et webhooks.

HubSpot · recette CRM

  1. Cliquez sur Préparer la recette. Xoolink présélectionne les trois permissions de lecture et les six cycles publics.
  2. Créez la clé Xoolink et placez-la dans le coffre de votre relais. Elle sert à relire l’état public courant après un signal.
  3. Exposez une URL HTTPS qui vérifie la signature Xoolink, déduplique sur X-Xoolink-Event-Id, puis écrit dans HubSpot avec les propres autorisations de votre intégration HubSpot.
  4. Collez uniquement cette URL HTTPS dans Xoolink. Conservez le format JSON standard.
Clé de rapprochementdata.id

Conservez cet identifiant Xoolink dans une propriété dédiée pour mettre à jour le même enregistrement au lieu de le dupliquer.

Champs conseilléstype · title · status · url

Ajoutez le résumé, les expertises, la date, le lieu et la dernière mise à jour selon l’objet CRM retenu.

Création / mise à journeed.created · need.updated · event.created · event.updated

Faites un upsert par identifiant externe, puis relisez la ressource par l’API si votre mapping exige tout l’état courant.

Retrait / annulationneed.withdrawn · event.cancelled

Passez l’enregistrement en retiré ou annulé. Ne recréez pas le contenu qui n’est plus public.

Notion · recette base de veille

  1. Cliquez sur Préparer la recette, puis créez une clé Xoolink à durée limitée.
  2. Préparez dans Notion une base partagée avec votre intégration, contenant au minimum un identifiant Xoolink unique.
  3. Votre relais vérifie le webhook, recherche une ligne par identifiant externe, puis crée ou met à jour cette ligne.
  4. Collez l’URL HTTPS du relais dans le formulaire webhook Xoolink et envoyez un test.
Propriétés minimalesID Xoolink · Nom · Type · Statut · URL

L’identifiant empêche les doublons; l’URL garde la fiche Xoolink comme source de vérité.

Propriétés utilesExpertises · Date · Lieu · Mis à jour

Ces champs permettent une base de veille filtrable sans recopier de données privées.

Yousign · connexion native

Yousign intervient après le consentement et le scellement d’un pacte Xoolink. L’admin connecte le compte de l’organisation; les signataires reçoivent ensuite leur lien personnel. Consulter le guide de signature électronique.

Ordre de mise en production

  1. Commencez avec un environnement de test et une clé Xoolink de 30 ou 90 jours.
  2. Vérifiez la signature avant de parser ou d’écrire les données.
  3. Répondez rapidement en 2xx, traitez ensuite en file et rendez chaque écriture idempotente.
  4. Testez création, mise à jour, retrait ou annulation avant d’activer le flux réel.
  5. Surveillez le journal de livraisons Xoolink et faites tourner les secrets exposés.

English summary

Slack and Yousign are native connections. HubSpot and Notion use a controlled recipe: a scoped read-only Xoolink API key, a signed standard-JSON webhook, and your own server-side or automation relay. Keep target-platform credentials outside Xoolink, verify the raw-body signature, deduplicate with X-Xoolink-Event-Id, and upsert records with data.id.