Verkkokäyttöliittymä/Ilmoitukset, webhooks ja aikataulut
Ilmoitukset, webhooks ja aikataulut
v1.3.x · päivitetty 2026-09-15
Tämä sivu kattaa kolme verkkokäyttöliittymän näyttöä, jotka käsittelevät ulospäin suuntautuvaa automaatiota ja ylläpitäjän hälytyksiä: Ilmoitukset, Webhookit ja Aikataulut.
Ilmoitukset
Se Ilmoitukset näytöllä on kolme osaa:
Saapuneet — tapahtumasyöte, jossa suodattimet kategorian, vakavuuden (info / varoitus /
kriittinen) ja “vain lukemattomat”. Kohteen napsauttaminen merkitsee sen luetuksi ja avaa syvälinkin kohtaan
sen välilehti; siellä on “Merkitse kaikki luetuiksi”.
Toimitusmatriisi — rivit: tapahtumakategoriat (ryhmät laajennettavilla tapahtumilla),
sarakkeet: kanavat (Web-käyttöliittymä, sähköposti, Telegram, push-ilmoitukset). Jokainen solu on valintaruutu; sinä
voi asettaa säännön per ryhmä tai per tapahtuma. “Tärkeät” ryhmät ovat aina päällä
Verkkokäyttöliittymä. Ei-aktiiviset kanavat on poistettu käytöstä asennusvinkillä.
Telegramin linkittäminen — lista linkitetyistä chatteista (tunniste, estetty merkki, “Poista linkitys”)
ja a “Linkki” painike syvän linkin kautta. Sähköpostikanava tarvitsee osoitteen
varmistus.
Webhookit
Se Verkkokoukut Näyttö on lähtevät HTTP-ilmoitukset. “+ Create”: URL ja tapahtuman valintaruudut (monivalinta; tyhjä valinta hylätään, turn.completed on esivalittu). Rivit näyttävät URL-osoitteen ja tilatut tapahtumat, sisältäen haun ja lajittelun. Tapahtumatyyppi lähetetään X-AIHummer-Event otsikko.
Se Aikataulut Näyttö on tehtävien aikataulutin: taulukko (tehtävä, agentti, kanava, kron, seuraava suoritus, tila) jossa on tauko/jatka, muokkaa ja poista. “+ Luo”:
Kiltti: repeating (cron-lauseke, esim. 0 9 * * *), once (a
päivämäärä/aika) tai reminder.
Näin rakennat aikataulutettuja toimintoja: “joka arkipäivä klo 9:00 agentti X julkaisee kehotteen Z tuloksen kanavaan Y”.
Ajon lisäparametrit
Tyyppien repeating, once ja reminder lisäksi hallinta-API
(/v1/admin/schedules) hyväksyy tyypin interval — ajo interval_ms
millisekunnin välein viitepisteestä anchor_at alkaen. Kenttään
”Lisäasetukset (raaka JSON hyötykuorma)” voi tavallisen prompt-kentän
rinnalle lisätä runtime-lohkon (pakollisia ovat "version": 1,
session_mode ja "wake_mode": "now"), joka asettaa suoritusehdot:
session_mode — isolated (jokainen ajo uudessa keskustelussa) tai
existing ja conversation_id (jatka annettua keskustelua);
timeout_seconds — yhden ajon aikaraja (oletuksena 48 tuntia; 0 poistaa
ajastimen käytöstä);
Tällainen ajo vaatii kohdeagentin ja kehotteen. Toisesta järjestelmästä tuodut
ajastukset luodaan pysäytettyinä, ja omistaja ottaa ne käyttöön erikseen; niin
kauan kuin niillä on ratkaisemattomia riippuvuuksia, niitä ei voi ottaa
käyttöön.
Tämä sivu kattaa kolme verkkokäyttöliittymän näyttöä, jotka käsittelevät ulospäin suuntautuvaa automaatiota ja ylläpitäjän hälytyksiä: **Ilmoitukset**, **Webhookit** ja **Aikataulut**.
## Ilmoitukset
Se **Ilmoitukset** näytöllä on kolme osaa:
- **Saapuneet** — tapahtumasyöte, jossa suodattimet kategorian, vakavuuden (info / varoitus /
kriittinen) ja "vain lukemattomat". Kohteen napsauttaminen merkitsee sen luetuksi ja avaa syvälinkin kohtaan
sen välilehti; siellä on "Merkitse kaikki luetuiksi".
- **Toimitusmatriisi** — rivit: tapahtumakategoriat (ryhmät laajennettavilla tapahtumilla),
sarakkeet: kanavat (Web-käyttöliittymä, sähköposti, Telegram, push-ilmoitukset). Jokainen solu on valintaruutu; sinä
voi asettaa säännön per ryhmä tai per tapahtuma. "Tärkeät" ryhmät ovat aina päällä
Verkkokäyttöliittymä. Ei-aktiiviset kanavat on poistettu käytöstä asennusvinkillä.
- **Telegramin linkittäminen** — lista linkitetyistä chatteista (tunniste, estetty merkki, "Poista linkitys")
ja a **"Linkki"** painike syvän linkin kautta. Sähköpostikanava tarvitsee osoitteen
varmistus.
## Webhookit
Se **Verkkokoukut** Näyttö on lähtevät HTTP-ilmoitukset. "+ Create": URL ja **tapahtuman valintaruudut** (monivalinta; tyhjä valinta hylätään, `turn.completed` on esivalittu). Rivit näyttävät URL-osoitteen ja tilatut tapahtumat, sisältäen haun ja lajittelun. Tapahtumatyyppi lähetetään `X-AIHummer-Event` otsikko.
**20 tapahtumatyyppiä** ovat saatavilla:
| Ryhmä | Tapahtumat |
|---|---|
| Vuorot ja viestit | `turn.completed`, `turn.failed`, `message.created`, `conversation.created` |
| Agentit | `agent.created`, `agent.updated`, `agent.deleted` |
| Laajennukset ja kanavat | `plugin.installed`, `plugin.removed`, `channel.added`, `channel.removed` |
| Työtilat | `workspace.created` |
| Aikataulut | `schedule.created`, `schedule.updated`, `schedule.deleted`, `schedule.fired` |
| Hyväksynnät | `approval.requested`, `approval.resolved` |
| Muisti | `memory.stored`, `memory.captured` |
## Aikataulut
Se **Aikataulut** Näyttö on tehtävien aikataulutin: taulukko (tehtävä, agentti, kanava, kron, seuraava suoritus, tila) jossa on tauko/jatka, muokkaa ja poista. "+ Luo":
- **Kiltti**: `repeating` (cron-lauseke, esim. `0 9 * * *`), `once` (a
päivämäärä/aika) tai `reminder`.
- **Kohdeagentti** ja **kehotus** (mitä tarkalleen lähetetään), **kohdekanava**
(mihin vastaus menee). Edistynyt: raaka JSON-payloadin korvaus.
Näin rakennat aikataulutettuja toimintoja: "joka arkipäivä klo 9:00 agentti X julkaisee kehotteen Z tuloksen kanavaan Y".
### Ajon lisäparametrit
Tyyppien `repeating`, `once` ja `reminder` lisäksi hallinta-API
(`/v1/admin/schedules`) hyväksyy tyypin **`interval`** — ajo `interval_ms`
millisekunnin välein viitepisteestä `anchor_at` alkaen. Kenttään
**”Lisäasetukset (raaka JSON hyötykuorma)”** voi tavallisen `prompt`-kentän
rinnalle lisätä `runtime`-lohkon (pakollisia ovat `"version": 1`,
`session_mode` ja `"wake_mode": "now"`), joka asettaa suoritusehdot:
- `session_mode` — `isolated` (jokainen ajo uudessa keskustelussa) tai
`existing` ja `conversation_id` (jatka annettua keskustelua);
- `timeout_seconds` — yhden ajon aikaraja (oletuksena 48 tuntia; `0` poistaa
ajastimen käytöstä);
- `thinking` — päättelyn taso (`off` … `xhigh`), `light_context` —
kevennetty konteksti, `tools_allow` — sallittujen työkalujen tarkat nimet;
- `failure_alert` — hälytys kanavaan (`channel`, `target_ref.chat_id`)
`after` peräkkäisen epäonnistuneen ajon jälkeen tauolla `cooldown_ms`;
- `delete_after_run` — poista määritys ajon jälkeen (ajoloki säilyy);
`best_effort` — älä laske vahvistamatonta toimitusta virheeksi.
Tällainen ajo vaatii kohdeagentin ja kehotteen. Toisesta järjestelmästä tuodut
ajastukset luodaan pysäytettyinä, ja omistaja ottaa ne käyttöön erikseen; niin
kauan kuin niillä on ratkaisemattomia riippuvuuksia, niitä ei voi ottaa
käyttöön.
## Seuraava
- [Kanavat](/fi/v1.0/webui/channels) — johon viestit ja ilmoitukset menevät.
- [Saapuvat laukaisijat](/fi/v1.0/api/inbound-triggers) — webhooks API-yhteydessä.
- [Havaittavuus](/fi/v1.0/operations/observability) — mitkä tapahtumat ovat tärkeitä.