Webhook-integraation opas

Webhookit mahdollistavat reaaliaikaiset ilmoitukset kun tapahtumia sattuu tililläsi.

Asennusvaiheet

1. Luo Webhook-päätepiste

Päätepisteen täytyy:

  • Hyväksyä POST-pyynnöt
  • Palauttaa HTTP 200 tila onnistuneesta käsittelystä
  • Vastata 10 sekunnin sisällä
  • Käyttää HTTPS:ää (pakollinen tuotannossa)

2. Konfiguroi Webhook

  1. Siirry Asetukset > Webhooks
  2. Klikkaa "Lisää Webhook"
  3. Syötä päätepisteen URL
  4. Valitse seurattavat tapahtumat
  5. Aseta tunnistautuminen (valinnainen)

3. Varmista asennus

  • Käytä "Testaa"-painiketta lähettääksesi näytedata
  • Tarkista päätepisteen lokit
  • Varmista oikea payload-käsittely

Vianmääritys

Webhookit eivät laukea

  • Tarkista että päätepiste-URL on saavutettavissa
  • Varmista SSL-sertifikaatti on voimassa
  • Varmista että päätepiste palauttaa 200-tilan
  • Tarkista webhook-konfiguraatio on käytössä

Epäjohdonmukainen toimitus

  • Toteuta kunnollinen virheenkäsittely
  • Palauta 200-tila onnistuneesta käsittelystä
  • Tarkista verkon aikakatkaisut
  • Tarkista palvelimen kapasiteetti

Payload-käsittely

  • Validoi webhook-allekirjoitus (jos konfiguroitu)
  • Jäsennä JSON-payload oikein
  • Käsittele eri tapahtumatyypit asianmukaisesti

Esimerkkipayload

json
{
  "event": "ticket.created",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "ticket": {
      "id": 12345,
      "subject": "Tukipyyntö",
      "status": "avoin"
    }
  }
}

Ota yhteyttä tukeen webhook-asennusapua varten.