Webhooki i automatyzacje

Hypris rozmawia z innymi systemami w obie strony. Zewnętrzny system uruchamia automatyzację webhookiem albo zapytaniem do API, a automatyzacja wywołuje dowolne API krokiem Żądanie HTTP.

Webhook przychodzący

Nasłuch webhooka to adres, pod który inny system wysyła dane. Każde żądanie uruchamia automatyzację z wyzwalaczem Webhook, a treść żądania trafia do niej jako dane wejściowe. Nasłuchy tworzysz i przeglądasz w workspace, w sekcji Nasłuchy webhooków.

curl -X POST "https://api.staging.hypris.com/v1/webhook-listener/$LISTENER_ID/trigger" \
  -H "Content-Type: application/json" \
  -H "x-webhook-secret: $WEBHOOK_SECRET" \
  -d '{"orderId": "ZAM-2026-0042", "total": 1250.5}'

• Ten adres nie wymaga klucza API. Chroni go sekret nasłuchu, jeśli go ustawisz, a zalecamy to zawsze.

• Sekret wysyłasz w nagłówku x-webhook-secret. Gdy system nadawcy nie pozwala ustawić nagłówka, podaj go jako parametr secret w treści albo w adresie. Hypris usuwa go z danych, zanim trafią do automatyzacji.

• Brak sekretu albo zły sekret kończy się błędem 401.

• Metoda GET też działa. Dane wejściowe to wtedy parametry z adresu, co przydaje się w prostych integracjach.

• Przyjęte żądanie dostaje odpowiedź {"success": true, "data": {}}, a automatyzacja działa dalej sama.

Uruchomienie automatyzacji przez API

Gdy masz klucz API albo token, uruchomisz automatyzację bezpośrednio i od razu dostaniesz jej wynik:

{
  "triggerKey": "<klucz wyzwalacza, opcjonalnie>",
  "payload": {"orderId": "ZAM-2026-0042"}
}

W polu output jest to, co automatyzacja ustawiła krokiem Wynik.

Wywołania wychodzące

Automatyzacja wywołuje zewnętrzne API krokiem Żądanie HTTP: wybierasz metodę, adres, nagłówki i treść, a odpowiedź trafia do kolejnych kroków. Tak wyślesz dane do CRM, systemu księgowego albo na Slacka, gdy w Hypris coś się zmieni.