Connecter Zapier

Connectez Zapier à InfraNest pour que les deux outils puissent se déclencher mutuellement — aucun code ni installation requis, juste quelques URL à copier entre eux. Ceci s’adresse à toute personne souhaitant que les événements InfraNest démarrent un Zap, ou qu’un Zap déclenche une action dans InfraNest.

#Aperçu

• Démarrez un Zap quand un domaine expire, qu’un moniteur tombe en panne, ou qu’un certificat est sur le point d’expirer.
• Laissez un Zap ouvrir une fenêtre de maintenance, mettre en pause un moniteur, ou résoudre un incident dans InfraNest.
• Les deux sens fonctionnent en copiant une URL entre InfraNest et Zapier — rien d’autre à installer.

#Avant de commencer

Obtenez une URL Catch Hook depuis Zapier :

1. Dans Zapier, créez un Zap et choisissez le déclencheur Webhooks by Zapier.
2. Choisissez l’événement Catch Hook.
3. Copiez l’URL affichée par Zapier — elle ressemble à https://hooks.zapier.com/hooks/catch/123456/abcdef.

#Envoyer les événements InfraNest vers Zapier

1. Allez dans Integrations → Zapier et sélectionnez Add endpoint. Avant toute configuration, cela se trouve sur la carte Set up Zapier ; ensuite, c’est sous Where events go dans l’onglet Connections & settings.

2. Collez l’URL Catch Hook dans Endpoint URL. Laissez Send every event here coché, afin que chaque événement soit envoyé dès le départ, puis sélectionnez Create.

3. Copiez le signing secret affiché une seule fois après l’enregistrement, si vous souhaitez vérifier que les envois proviennent bien de nous.

4. Sur la page de l’endpoint, choisissez un événement dans la liste à côté de Send test event, puis sélectionnez Send test event. Zapier ne peut mapper aucun champ tant qu’il n’a rien reçu, faites donc cela avant de continuer dans Zapier.

5. Choisissez ce qui est envoyé : sous Automations that post here, la page de l’endpoint liste l’automatisation qu’il a démarrée. Ouvrez-la pour la restreindre aux événements qui vous intéressent — ou, si vous avez décoché la case, choisissez un point de départ sous Or start from a ready-made automation : ou créez votre propre règle.

#Laisser Zapier déclencher InfraNest

1. Allez dans Integrations → Custom webhook et sélectionnez Add incoming URL (sous URLs we give you dans l’onglet Connections & settings, une fois que quelque chose y est configuré). Les URL entrantes n’appartiennent à aucun outil en particulier, elles se trouvent donc là : sur la page Zapier, Open incoming URLs vous y amène.
2. Donnez-lui un Name que vous reconnaîtrez plus tard — vous le choisissez par son nom en écrivant la règle.
3. Définissez éventuellement un Shared secret (optional), afin qu’une URL divulguée seule ne suffise pas à déclencher quoi que ce soit.

4. Copiez Your URL dans une action Webhooks by Zapier de votre Zap, avec l’événement POST et le Payload Type réglé sur json. Si vous avez défini un secret, ajoutez-le en tant qu’en-tête X-InfraNest-Secret.
5. De retour dans InfraNest, démarrez une automatisation depuis Let another tool trigger an automation (ou avec le déclencheur Incoming webhook) et ajoutez ce qui doit se produire — ouvrir une fenêtre de maintenance, mettre en pause un moniteur, résoudre un incident. Ce que le Zap a envoyé est disponible dans la règle sous la forme {{payload.your_field}}.

WarningVotre URL entrante fonctionne comme un mot de passe. Quiconque la détient peut déclencher les automatisations de votre espace de travail, définissez donc un secret partagé et utilisez Regenerate URL si elle venait à fuiter.

#Bon à savoir

• Le signing secret n’est affiché qu’une seule fois et jamais plus. Rotate signing secret sur la page de l’endpoint vous en fournit un nouveau ; l’ancien cesse de fonctionner immédiatement.
• What went out est listé sous Recent deliveries, sur la page de l’endpoint et dans l’onglet Activity de la page Zapier, avec la réponse de Zapier. Un envoi échoué dispose d’un bouton Retry.
• What came in est listé sous What has arrived sur la page de l’URL entrante, y compris les appels que nous avons refusés et pourquoi.
• Vous pouvez ajouter plusieurs endpoints — par exemple un Zap pour les incidents et un autre pour les domaines.
• Pour savoir ce que contient un envoi et comment vérifier sa signature, consultez Connecter un webhook personnalisé.

#Dépannage

Zapier n’affiche aucun champ à mapper. Son Catch Hook n’apprend la structure qu’une fois qu’il a réellement reçu quelque chose. Sélectionnez Send test event dans InfraNest, puis poursuivez la configuration du Zap.

Rien n’arrive dans Zapier. Si vous avez décoché Send every event here, vérifiez qu’une automatisation publie bien vers l’endpoint — l’endpoint seul n’est qu’une destination. Le journal des envois sur la page Zapier indique si nous avons envoyé quoi que ce soit.

Votre Zap ne déclenche pas InfraNest. Vérifiez que le Zap publie bien vers l’URL entrante exacte, et que le secret partagé — si vous en avez défini un — est envoyé dans l’en-tête X-InfraNest-Secret. Ouvrez ensuite la page de l’URL entrante : What has arrived liste chaque appel, et un appel refusé en indique la raison. Envoyez le corps en JSON — tout autre format arrive vide.

TipConfigurez l’événement de test dans InfraNest avant de toucher à l’étape de mapping de Zapier — cela évite un aller-retour, puisque Zapier ne peut suggérer de champs tant qu’il n’a pas vu un envoi réel.