Points de terminaison entrants et webhooks sortants

Vous ne savez pas si vous avez besoin de quelque chose qui permet à un autre outil de déclencher InfraNest, ou de quelque chose qui permet à InfraNest de notifier un autre outil ? Cet article vous aide à choisir la bonne solution et vous indique où configurer chacune d’elles. Il s’adresse à toute personne connectant InfraNest à d’autres outils qu’elle utilise.

Vue d’ensemble

• Un point de terminaison entrant permet à un autre outil de démarrer une automatisation dans InfraNest.
• Un webhook sortant permet à InfraNest d’indiquer à un autre outil qu’un événement s’est produit.
• En bref : l’entrant est une sonnette que quelqu’un d’autre appuie. Le sortant, c’est nous qui sonnons chez eux.

De quoi avez-vous besoin ?

Configurer un point de terminaison entrant

1. Allez dans Integrations et ouvrez l’outil que vous voulez connecter, ou ouvrez la règle correspondante dans Automations.
2. Créez un point de terminaison entrant — InfraNest génère une URL privée pour vous.
3. Donnez au point de terminaison un nom clair afin de repérer facilement à quel outil il appartient.
4. Copiez l’URL et collez-la dans les paramètres de l’autre système, à l’endroit où celui-ci demande où envoyer ses requêtes.
5. Lorsque ce système envoie une requête à l’URL, votre automatisation s’exécute, en utilisant les informations envoyées.

Vous pouvez désactiver n’importe quel point de terminaison individuellement sans affecter les autres.

WarningL’URL fait office d’identifiant. Toute personne qui la possède peut déclencher cette automatisation ; traitez-la donc comme un mot de passe, et régénérez-la si elle fuite.

Configurer un webhook sortant

1. Allez dans Integrations et choisissez Custom webhook (ou Zapier, Make ou n8n).
2. Ouvrez Where events go et ajoutez l’URL fournie par l’autre outil.
3. Créez ou modifiez une automatisation pour décider quels événements sont envoyés à cette destination.
4. Enregistrez vos modifications — à partir de ce moment, les événements correspondants (un moniteur qui tombe en panne, un domaine qui se renouvelle, un domaine surveillé qui devient disponible) sont envoyés automatiquement à cette URL.

Chaque envoi est signé et enregistré, ce qui vous permet de vérifier ce qui a été envoyé et s’il est bien arrivé. Consultez Connect a custom webhook pour le guide complet.

Toujours pas sûr ?

Demandez-vous quel côté démarre la conversation :

• « Quand X se produit dans mon autre outil, faire quelque chose dans InfraNest » → configurez un point de terminaison entrant.
• « Quand X se produit dans InfraNest, avertir mon autre outil » → configurez un webhook sortant.
• « Les deux » → vous avez besoin d’un de chaque ; ils sont indépendants l’un de l’autre.

Astuces

TipSi vous construisez une intégration bidirectionnelle, configurez le point de terminaison entrant et le webhook sortant séparément — ils ne partagent pas de configuration, chacun nécessite donc sa propre mise en place et son propre nom.