---
title: "Lähetä tietoja järjestelmiisi webhookeilla"
description: "Saat pyynnön omaan URL-osoitteeseesi, kun joku ilmoittautuu tai voittaa, allekirjoitetulla sisällöllä ja lokilla jokaisesta toimituksesta."
url: https://scratcher.io/fi/help/developers/webhooks
language: fi
---

1. [Ohjekeskus](https://scratcher.io/fi/help)
2. [API, webhookit ja MCP](https://scratcher.io/fi/help/developers)
3. Lähetä tietoja järjestelmiisi webhookeilla

# Lähetä tietoja järjestelmiisi webhookeilla

Saat pyynnön omaan URL-osoitteeseesi, kun joku ilmoittautuu tai voittaa, allekirjoitetulla sisällöllä ja lokilla jokaisesta toimituksesta.

Webhook lähettää tietoja valitsemaasi URL-osoitteeseen heti, kun jotain tapahtuu, esimerkiksi kun joku ilmoittautuu tai voittaa palkinnon. Kehittäjäsi rakentaa järjestelmän, joka vastaanottaa ne. Webhookit sisältyvät Basic-pakettiin ja sitä ylempiin.

## Lisää webhook

Voit lisätä webhookeja kampanjaan editorissa kohdassa **Yhdistä** > **Webhookit** tai koko tilillesi kohdassa **Asetukset** > **Webhookit**.

1. Klikkaa **Lisää webhook**.
2. Syötä **Payload-URL**. Sen on käytettävä HTTPS:ää.
3. Valitse **Sisältötyyppi**: application/json tai application/x-www-form-urlencoded.
4. Valitse **Menetelmä**: **POST** tai **GET**. Käytä POSTia, ellei järjestelmäsi tarvitse GETiä, joka lähettää tiedot URL-osoitteessa.
5. Syötä **Salaisuus** pyyntöjen allekirjoittamista varten (suositellaan).
6. Valitse tapahtumat kohdassa **Mitkä tapahtumat käynnistävät webhookin?**:
    - ”Kun uusi liidi luodaan” (tilitasolla)
    - ”Aina kun liidi osallistuu kampanjaan”
    - ”Kun liidi voittaa palkinnon”
7. Varmista, että **Aktiivinen** on päällä, ja tallenna.

Kampanjaeditorissa voit myös valita kohdassa **Tunnistautuminen** **Basic Auth** -vaihtoehdon ja käyttää **Mukautettu payload** -asetusta, jos haluat päättää kenttien nimet itse.

## Mitä lähetetään

Rungossa on `event` ja `data`-objekti, jossa ovat kampanja (id ja nimi), liidin kentät, kanava, suostumukset tekstin, ajankohdan ja IP-osoitteen kanssa, tietovisan vastaukset ja voittajille palkinto koodeineen. Tyhjät arvot jätetään pois.

## Tarkista allekirjoitus

Jos asetat salaisuuden, jokaisessa pyynnössä on `X-Hub-Signature`-otsake: `sha1=` ja sen perässä JSON-koodatun datan HMAC-SHA1, jonka avaimena on salaisuutesi. Laske sama omalla puolellasi ja vertaa, niin voit olla varma, että pyyntö tuli Scratcherilta.

## Toimitukset ja uudelleenyritykset

Jos URL-osoitteesi ei vastaa tai palauttaa virheen, Scratcher yrittää uudelleen kahdesti: 5 sekunnin ja minuutin kuluttua. Klikkaa **Näytä toimitukset**, niin näet jokaisen pyynnön ja vastauksen, voit näyttää vain epäonnistuneet ja valita toimitukselle **Yritä uudelleen**. Toimituksia säilytetään 60 päivää.

Ota käyttöön **Kirjaa vastauksen sisältö lokiin**, jos haluat tallentaa myös järjestelmäsi vastauksen, mikä auttaa vianmäärityksessä.

API, webhookit ja MCP

- [Aloita REST API:n käyttö](https://scratcher.io/fi/help/developers/rest-api)
- [Lähetä tietoja järjestelmiisi webhookeilla](https://scratcher.io/fi/help/developers/webhooks)
- [Scratcher MCP omille tekoälytyökaluillesi](https://scratcher.io/fi/help/developers/mcp)

## Aiheeseen liittyvät artikkelit

- [Aloita REST API:n käyttö](https://scratcher.io/fi/help/developers/rest-api): Luo käyttötunnus, valitse käyttöoikeusalueet ja lue kampanjoita, liidejä ja listoja omista järjestelmistäsi.
- [Tarkista toimituksen tila ja lähetä liidit uudelleen](https://scratcher.io/fi/help/integrations/delivery-status): Näe, mitkä liidit lähetettiin työkaluihisi, selvitä miksi toimitus epäonnistui ja lähetä se uudelleen.
- [Yhdistä yli 8 000 sovellusta Zapierilla](https://scratcher.io/fi/help/integrations/zapier): Lähetä uudet ilmoittautujat Scratcherista Google Sheetsiin, Slackiin, CRM:ääsi tai tuhansiin muihin sovelluksiin Zapierilla.

## Tarvitsetko vielä apua?

Oikeat ihmiset auttavat sinua mielellään. Jos käytät jo Scratcheria, nopein tapa on alustan sisäinen chat.

- **[Chattaa kanssamme](https://platform.scratcher.io/login)**

    Kirjaudu sisään ja klikkaa chat-painiketta oikeassa alakulmassa. Rex vastaa heti, ja tiimimme on vain yhden klikkauksen päässä.
- **[Varaa tapaaminen](https://scratcher.io/fi/book-a-meeting)**

    Maksuton 30 minuutin videopuhelu tiimimme kanssa: esittely, kampanjaideoita tai apua käyttöönottoon.
- **[Lähetä meille sähköpostia](mailto:contact@scratcher.io)**

    Kirjoita osoitteeseen contact@scratcher.io, niin palaamme asiaan.