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.