Der “Webhook (Outgoing)"-Konnektor ermöglicht es, aus niotix Daten per HTTP an externe Systeme zu senden. Er wird als Konnektorschritt in einem Integrationsflow verwendet. Zum Testen der Verbindung können – sofern keine eigene Lösung zur Verfügung steht – kostenlose und offene Plattformen wie webhook.site verwendet werden.

Details zur Funktion:

• HTTP-Methoden: POST (Standard), PUT, GET, PATCH
• Authentifizierung: None (Standard), Basic Auth, Bearer Token, X-API-Key, API-Key — konfiguriert über Header Auth Type und Header Auth Value
• Custom Headers: Beliebige zusätzliche HTTP-Header als JSON-Objekt konfigurierbar (z. B. {"X-Custom-Header": "wert"})
• Nachrichtenformat: Standard application/json; alternativ application/x-www-form-urlencoded; der Payload wird als JSON-String übergeben und vor dem Senden geparst
• Immer gesendete Header: User-Agent: webhook connector, Content-Type gemäß Encoding-Einstellung
• Timeout: Standard 2.000 ms (auswählbar: 1.000 / 2.000 / 3.000 / 5.000 / 10.000 ms); gilt für den gesamten Request (kein separater Connect/Read-Timeout)
• Retry: Kein automatischer Retry bei HTTP-Fehlern — ein Versuch pro Nachricht
• Fehlerbehandlung: Non-2xx-Antworten und Antwort-Bodies mit error-Feld werden als Fehler behandelt und ins Konnektor-Log geschrieben
• TLS: Standard rejectUnauthorized: true — selbstsignierte Zertifikate werden abgelehnt (deaktivierbar)

Einstellungen

• Instanz Name: Individueller, einfach zu erschließender Name des Konnektors.
• Beschreibung: Kurze Beschreibung.
• Header Auth Type: Authentifizierungsmethode: None (Standard), Basic Auth, Bearer Token, X-API-Key, API-Key.
• Header Auth Value: Wert für die Authentifizierung (bei Basic Auth: Base64-codierter String user:password; leer lassen bei None).
• Custom Header Key-Values: Optionale zusätzliche HTTP-Header als JSON-Objekt, z. B. {"X-Tenant-ID": "42"}.
• Method: HTTP-Methode: POST (Standard), PUT, GET, PATCH.
• Connection timeout(ms): Maximale Wartezeit für den gesamten Request (Standard: 2.000 ms). Ein höherer Wert sollte nur gewählt werden, wenn das Zielsystem regelmäßig länger braucht um zu antworten, da dies zu einer hohen Anzahl offener Verbindungen führen kann.
• Reject invalid SSL certs: Standard true — lehnt ungültige oder selbstsignierte TLS-Zertifikate ab. Auf false setzen, wenn das Zielsystem ein selbstsigniertes Zertifikat verwendet.
• WebhookURL: Vollständige URL des Zielsystems (inkl. https://...).
• Rate limit (per hour): Maximale Anzahl Requests pro Stunde. Bei Überschreitung verwirft niotix weitere Requests und schreibt einen Eintrag ins Konnektor-Log. Ohne Angabe gilt kein Limit.