Zapier verbinden

Verbinde Zapier mit InfraNest, damit beide Tools sich gegenseitig auslösen können – keine Programmierung oder Installation nötig, nur ein paar URLs, die zwischen ihnen kopiert werden. Das ist für alle gedacht, die InfraNest-Ereignisse einen Zap starten lassen wollen oder einen Zap eine Aktion in InfraNest auslösen lassen wollen.

#Überblick

• Starte einen Zap, wenn eine Domain abläuft, ein Monitor ausfällt oder ein Zertifikat bald ungültig wird.
• Lass einen Zap ein Wartungsfenster öffnen, einen Monitor pausieren oder einen Vorfall in InfraNest beheben.
• Beide Richtungen funktionieren, indem eine URL zwischen InfraNest und Zapier kopiert wird – sonst ist nichts zu installieren.

#Bevor du beginnst

Hole dir eine Catch-Hook-URL von Zapier:

1. Erstelle in Zapier einen Zap und wähle den Trigger Webhooks by Zapier.
2. Wähle das Ereignis Catch Hook.
3. Kopiere die von Zapier angezeigte URL – sie sieht etwa so aus: https://hooks.zapier.com/hooks/catch/123456/abcdef.

#InfraNest-Ereignisse an Zapier senden

1. Gehe zu Integrationen → Zapier und wähle Add endpoint. Bevor etwas eingerichtet ist, findest du das auf der Karte Set up Zapier; danach unter Where events go im Tab Connections & settings.

2. Füge die Catch-Hook-URL in Endpoint URL ein. Lass Send every event here aktiviert, damit von Anfang an jedes Ereignis gesendet wird, und wähle Create.

3. Kopiere das Signing Secret, das nach dem Speichern einmalig angezeigt wird, falls du prüfen willst, dass Zustellungen wirklich von uns stammen.

4. Wähle auf der Seite des Endpoints ein Ereignis in der Liste neben Send test event aus und wähle dann Send test event. Zapier kann keine Felder zuordnen, bevor es etwas empfangen hat – erledige das also, bevor du in Zapier weitermachst.

5. Lege fest, was gesendet wird: Unter Automations that post here zeigt die Seite des Endpoints die Automatisierung an, die er gestartet hat. Öffne sie, um sie auf die Ereignisse einzugrenzen, die dich interessieren – oder wähle, falls du das Kästchen deaktiviert hast, einen Ausgangspunkt unter Or start from a ready-made automation: oder erstelle deine eigene Regel.

#Zapier InfraNest auslösen lassen

1. Gehe zu Integrationen → Custom webhook und wähle Add incoming URL (unter URLs we give you im Tab Connections & settings, sobald dort etwas eingerichtet ist). Eingehende URLs gehören zu keinem einzelnen Tool und sind deshalb dort zu finden: Auf der Zapier-Seite führt dich Open incoming URLs dorthin.
2. Gib ihr einen Name, den du später wiedererkennst – du wählst sie beim Schreiben der Regel nach dem Namen aus.
3. Lege optional ein Shared secret (optional) fest, damit eine geleakte URL allein nicht ausreicht, um etwas auszulösen.

4. Kopiere Your URL in eine Webhooks by Zapier-Aktion in deinem Zap, mit dem Ereignis POST und Payload Type auf json gesetzt. Falls du ein Secret festgelegt hast, füge es als Header X-InfraNest-Secret hinzu.
5. Starte in InfraNest eine Automatisierung über Let another tool trigger an automation (oder mit dem Trigger Incoming webhook) und füge hinzu, was passieren soll – ein Wartungsfenster öffnen, einen Monitor pausieren, einen Vorfall beheben. Was der Zap gesendet hat, steht in der Regel als {{payload.your_field}} zur Verfügung.

WarningDeine eingehende URL funktioniert wie ein Passwort. Jeder, der sie besitzt, kann die Automatisierungen deines Workspaces auslösen – lege deshalb ein Shared Secret fest und nutze Regenerate URL, falls sie jemals durchsickert.

#Gut zu wissen

• Das Signing Secret wird einmalig angezeigt und danach nie wieder. Rotate signing secret auf der Seite des Endpoints liefert dir ein neues; das alte funktioniert sofort nicht mehr.
• What went out wird unter Recent deliveries aufgelistet, auf der Seite des Endpoints und im Tab Activity der Zapier-Seite, zusammen mit der Antwort von Zapier. Eine fehlgeschlagene Zustellung hat eine Retry-Schaltfläche.
• What came in wird unter What has arrived auf der Seite der eingehenden URL aufgelistet, einschließlich abgewiesener Aufrufe und deren Gründe.
• Du kannst mehr als einen Endpoint hinzufügen – zum Beispiel einen Zap für Vorfälle und einen anderen für Domains.
• Was eine Zustellung enthält und wie du ihre Signatur prüfst, erfährst du unter „Connect a custom webhook“.

#Fehlerbehebung

Zapier zeigt keine Felder zum Zuordnen. Der Catch Hook lernt die Struktur erst, nachdem er tatsächlich etwas empfangen hat. Wähle Send test event in InfraNest und mache dann mit der Einrichtung des Zaps weiter.

In Zapier kommt nichts an. Wenn du Send every event here deaktiviert hast, prüfe, ob eine Automatisierung an den Endpoint sendet – der Endpoint allein ist nur ein Ziel. Das Zustellungsprotokoll auf der Zapier-Seite zeigt, ob überhaupt etwas gesendet wurde.

Dein Zap löst InfraNest nicht aus. Stelle sicher, dass der Zap genau an die eingehende URL sendet und dass das Shared Secret – falls festgelegt – als Header X-InfraNest-Secret gesendet wird. Öffne dann die Seite der eingehenden URL: What has arrived listet jeden Aufruf auf, und ein abgewiesener Aufruf nennt den Grund. Sende den Body als JSON – alles andere kommt leer an.

TipRichte das Testereignis in InfraNest ein, bevor du Zapiers Zuordnungsschritt anfasst – das erspart dir einen zusätzlichen Durchlauf, da Zapier erst nach einer echten Zustellung Felder vorschlagen kann.