Integraatiot

Integraatiot-sivulla yhdistät sivustosi muihin järjestelmiin. Sivun löydät sivuston sivupalkista kohdasta Asetukset → Integraatiot.

Lomakesäännöt

Lomakesäännöllä sivustosi lomakkeiden vastaukset lähetetään automaattisesti eteenpäin omaan järjestelmääsi, esimerkiksi CRM:ään tai tikettijärjestelmään. Kun valitun lomakkeen kautta tulee uusi yhteydenotto, lähetämme sen tiedot antamaasi osoitteeseen HTTP POST -kutsuna (webhook).

Säännön luominen

1. Paina Uusi sääntö.
2. Anna säännölle nimi (esim. "Tilaukset CRM:ään").
3. Valitse mitä lomaketta sääntö koskee: yksittäinen lomake tai Kaikki lomakkeet. Voit myös kirjoittaa lomakkeen tunnisteen käsin, jos lomake ei ole vielä lähettänyt yhtään viestiä.
4. Anna osoite, johon tiedot lähetetään. Osoitteen on oltava julkinen https-osoite.
5. Tallenna. Saat allekirjoitussalaisuuden — kopioi se heti talteen, sillä sitä ei näytetä uudelleen.

Säännön voi kytkeä päälle ja pois kytkimestä, muokata kynäkuvakkeesta ja poistaa roskakorikuvakkeesta.

Allekirjoitus

Jokainen lähetys allekirjoitetaan säännön salaisuudella, jotta vastaanottava järjestelmäsi voi varmistaa viestin aitouden. Allekirjoitus kulkee X-Kamu-Signature-otsakkeessa muodossa t=<aikaleima>,v1=<hmac>, missä v1 on HMAC-SHA256-tiiviste merkkijonosta <aikaleima>.<pyynnön runko>.

Jos salaisuus katoaa, luo uusi avainkuvakkeesta. Vanha salaisuus lakkaa silloin toimimasta heti, joten päivitä uusi salaisuus vastaanottavaan järjestelmään samalla.

Lähetettävät tiedot

Lähetys on JSON-muotoinen ja sisältää lomakkeen kentät sellaisenaan:

{
  "event": "form.submission",
  "submission_id": "…",
  "site_id": "…",
  "form_key": "yhteydenotto",
  "form_label": "Yhteydenottolomake",
  "page": "/yhteystiedot",
  "created_at": "2026-08-07T12:00:00.000Z",
  "fields": [
    { "label": "Nimi", "value": "Matti Meikäläinen" },
    { "label": "Sähköposti", "value": "matti@example.com" }
  ]
}

Palvelimesi tulee vastata 2xx-statuskoodilla. Jos lähetys epäonnistuu, yritämme uudelleen kasvavalla viiveellä, yhteensä enintään viisi kertaa.

Lähetysloki

Jokaisen säännön alta löytyy Viimeisimmät lähetykset -loki. Siitä näet lähetyksen tilan (toimitettu, odottaa tai epäonnistui), vastaanottajan HTTP-vastauskoodin, yritysten määrän ja mahdollisen virheilmoituksen. Loki on paras ensimmäinen paikka tarkistaa, jos viestit eivät näytä saapuvan järjestelmääsi.

Muut ilmoituskanavat

Jos haluat yhteydenotot sähköpostiin, push-ilmoituksena tai WhatsAppiin, katso Ilmoitukset.