Webhookit
Webhookit-välilehti palvelee webhookien hallintaan, jotka mahdollistavat Siesta AI:n yhdistämisen ulkoisiin järjestelmiin ja sovelluksiin. Webhook tarjoaa ainutlaatuisen URL-osoitteen, johon ulkoinen palvelu voi lähettää HTTP-pyyntöjä ja siten käynnistää tai vaikuttaa järjestelmän käyttäytymiseen.
Jokaisella webhookilla:
- on oma nimi,
- se on sidottu tiettyyn API-avaimeen,
- se voi olla aktiivinen tai ei-aktiivinen,
- sillä on ainutlaatuinen URL-osoite.
Webhookeja käytetään usein laukaisevina tekijöinä Työnkuluissa, joita voidaan käynnistää ulkoisista järjestelmistä.
Webhookien yleiskatsaus
Webhookit-välilehden pääsivulla näkyy luettelo kaikista luoduista webhookeista taulukossa.
Näytettävät sarakkeet:
- Nimi – käyttäjän antama webhookin nimi
- URL – automaattisesti luotu webhookin URL-osoite
- Tila – webhookin nykyinen tila (Aktiivinen / Ei-aktiivinen)
- Toiminnot – muita webhookin hallintavaihtoehtoja (esim. muokkaus)
Sivun yläosassa on saatavilla:
- webhookien haku,
- painike Lisää webhook.

Uuden webhookin luominen
Klikkaamalla Lisää webhook avautuu dialogi uuden webhookin luomiseksi.
Lomakkeen kentät
- Nimi – pakollinen kenttä webhookin nimen antamiseksi (esim. Webhook)
- Aktiivinen – kytkin, jolla webhook voidaan aktivoida heti luomisen yhteydessä tai jättää ei-aktiiviseksi
- API-avain – API-avaimen valinta, jonka avulla webhook valtuutetaan (esim. API key for my python script)
Toiminnot
- Peruuta – sulkee dialogin ilman webhookin luomista
- Luo – luo uuden webhookin ja generoi sen URL-osoitteen

Webhookin yksityiskohdat
Kun avaat tietyn webhookin, sen yksityiskohtainen sivu näkyy.
Näytettävät tiedot:
- webhookin nimi,
- tila (aktiivinen / ei-aktiivinen),
- webhookin URL – ainutlaatuinen osoite, joka voidaan kopioida yhdellä napsautuksella.
Webhookin yksityiskohdista on mahdollista:
- muokata webhookin asetuksia,
- vaihtaa sen aktiivista tilaa,
- käyttää webhookin URL-osoitetta ulkoisissa sovelluksissa tai Työnkuluissa.

Webhookin tila
Webhookin tila määrittää, onko webhook valmis vastaanottamaan pyyntöjä:
- Aktiivinen – webhook on päällä ja saatavilla
- Ei-aktiivinen – webhook on pois päältä eikä pyyntöjä käsitellä
Tila näkyy sekä webhookien yleiskatsauksessa että webhookin yksityiskohdissa.
Tyypillinen webhookien käyttö
Webhookeja käytetään erityisesti:
- Siesta AI:n integroimiseen ulkoisiin sovelluksiin,
- automatisoitujen prosessien käynnistämiseen,
- omien skriptien (esim. Python) liittämiseen,
- tietojen siirtämiseen järjestelmien välillä reaaliajassa.
Yhteenveto
Webhookit Siesta AI:ssa tarjoavat yksinkertaisen ja turvallisen tavan yhdistää alusta ulkoisiin järjestelmiin. Selkeän hallinnan, API-avaimiin liittymisen ja aktivointi- tai deaktivointimahdollisuuden ansiosta webhookeja voidaan helposti valvoa ja hallita. Jos käytät webhookia laukaisijana, suosittelemme sen käytön liittämistä Työnkulkuihin.