Webhook Slack, Discord és Teams

A webhook (üzenet automatikus elküldése egy megadott címre) univerzális módja annak, hogy értesítést küldjünk bármilyen alkalmazásba - a Slackbe, a Discordba, a Microsoft Teamsbe vagy a saját rendszeredbe. A bekötés néhány percet vesz igénybe, és az ePulz.io automatikusan a célszolgáltatáshoz formázza az üzenetet.

Az ePulz.io a webhook címe alapján automatikusan felismeri a célszolgáltatás típusát. Felismerjük a következőket: Slack (hooks.slack.com/services/...), Discord (discord.com/api/webhooks/... és discordapp.com/api/webhooks/...), Microsoft Teams a Power Automate / Workflows szolgáltatással együtt (*.webhook.office.com, outlook.office.com/webhook/..., *.logic.azure.com/workflows/...). A többi címnél generikus JSON payloadot használunk.

A Slack bekötése

1. A Slackben nyisd meg az api.slack.com/apps oldalt, és kattints a Create New App → From scratch gombra.
2. Nevezd el az alkalmazást (például "ePulz Alerts"), és válaszd ki a workspace-t, amelyhez tartoznia kell.
3. A bal oldali menüben válaszd az Incoming Webhooks lehetőséget, és kapcsold On állásba.
4. Kattints az Add New Webhook to Workspace gombra, és válaszd ki a csatornát, ahol értesítéseket szeretnél kapni.
5. Másold ki a generált webhook címet (a https://hooks.slack.com/services/... címmel kezdődik).
6. Az ePulz.io-ban nyisd meg a Beállítások → Értesítések → Webhook menüt, illeszd be a címet, és mentsd el.

Az ePulz.io automatikusan felismeri, hogy ez Slack, és szépen formázott üzeneteket küld színes sávval (piros kiesésnél, zöld helyreállásnál) és egy visszamutató linkkel a vezérlőpultra.

A Discord bekötése

1. A Discord szerveren kattints jobb gombbal a csatornára, és válaszd a Csatorna szerkesztése → Integrációk → Webhookok lehetőséget.
2. Kattints az Új webhook gombra, szükség esetén nevezd el a botot, és állíts be avatart.
3. Kattints a Webhook URL másolása gombra. A cím https://discord.com/api/webhooks/... alakú.
4. Az ePulz.io-ban nyisd meg a Beállítások → Értesítések → Webhook menüt, illeszd be a címet, és mentsd el.

A Discordnál is igaz, hogy az üzenet formátumát automatikusan elkészítjük - Discord embedet használunk (kiemelt, kerettel ellátott üzenet) a monitor nevével, a probléma leírásával és az időponttal.

A webhook tesztelése

A cím mentése után kattints a beállításokban a Tesztelés gombra. A célcsatornára tesztüzenetet küldünk, hogy rögtön lásd, hogyan fog kinézni az értesítés. Ha semmi nem érkezik, ellenőrizd, hogy a teljes címet helyesen másoltad-e be, és hogy a botnak van-e hozzáférése a csatornához.

Microsoft Teams (Adaptive Card)

A Microsoft Teamshez (a Power Automate / Workflow URL logic.azure.com/workflows/... címekkel együtt) az üzenetet Adaptive Card v1.4 formátumban, üzenetbe csomagolva küldjük:

{
  "type": "message",
  "attachments": [{
    "contentType": "application/vnd.microsoft.card.adaptive",
    "content": {
      "type": "AdaptiveCard",
      "version": "1.4",
      "body": [
        {"type": "TextBlock", "text": "Monitor DOWN: Éles webhely", "weight": "bolder", "size": "large"},
        {"type": "TextBlock", "text": "Nem elérhető: HTTP 503", "wrap": true}
      ],
      "actions": [
        {"type": "Action.OpenUrl", "title": "Megnyitás az ePulz.io-ban", "url": "https://epulz.io/dashboard/monitor/42"}
      ]
    }
  }]
}

A Teamsben a webhook címét a csatorna Incoming Webhook konnektorából, vagy a Power Automate "Post to Teams when a HTTP request is received" sablonjából kapod meg.

Saját webhook (generikus végpont)

Ha a saját alkalmazásodba szeretnél értesítéseket küldeni, írd be a beállításokba a végpontod címét (a célcímet). Az ePulz.io oda POST metódusú kérést küld JSON formátumú törzzsel:

{
  "event": "down",
  "monitor": {
    "name": "Éles webhely",
    "target": "https://example.com",
    "url": "https://epulz.io/dashboard/monitor/42"
  },
  "message": "Nem elérhető: HTTP 503",
  "timestamp": "2026-05-31T14:23:45+00:00",
  "source": "epulzio"
}

Az event mező a következő értékeket veheti fel: down (kiesés), up (helyreállás), ssl (közelgő SSL-tanúsítvány-lejárat), domain (közelgő domain-lejárat), anomaly (válaszidő-anomália) vagy test (tesztküldés). A monitor.name mező a monitor neve, a monitor.target a figyelt cím, a monitor.url pedig a visszamutató link az ePulz.io vezérlőpultjára.

Aláírás-ellenőrzés (HMAC)

A beállításokban opcionálisan bekapcsolhatod az aláírást - ekkor minden kérést titkos kulccsal írunk alá (HMAC SHA-256), és két fejlécet adunk hozzá:

• X-ePulzio-Signature - aláírás sha256=<hex digest> formátumban a kérés törzséből
• X-ePulzio-Event - az esemény típusa (ugyanaz az érték, mint a törzs event mezője)

A végpontodon csak ki kell számítanod a kapott törzs HMAC SHA-256 értékét ugyanazzal a titkos kulccsal, és összehasonlítani a fejléccel. Ha megegyeznek, a kérés valódi, és az átvitel során nem módosult.