> ## Documentation Index
> Fetch the complete documentation index at: https://www.twicecommerce.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Miten lähetät jokaisen uuden tilauksen CRM-järjestelmääsi

> Rekisteröi order.created-webhook, niin CRM-järjestelmäsi saa suoraan tai Maken tai Zapierin kautta jokaisen uuden tilauksen asiakkaineen ja kassalla annettuine vastauksineen.

> [card] [Avaa TWICE Adminissa](https://admin.twicecommerce.com/settings/connect/integrations)
>
> settings/connect/integrations

Rekisteröi `order.created`-webhook, niin TWICE lähettää jokaisen uuden tilauksen CRM-järjestelmääsi tai matkalla sinne Makeen tai Zapieriin, mukana asiakas ja hänen kassalla antamansa vastaukset. [Webhookit](https://www.twicecommerce.com/docs/fi/concepts/integrations/webhooks.md) selittää sisällön, uudelleenyritykset ja allekirjoituksen.

Pidä liidit CRM-järjestelmässä. TWICEssä ei ole rekisteröitymisvaihetta ennen tilausta, ja sen webhookit välittävät vain tilaustapahtumia, joten muuten luotu asiakas, esimerkiksi verkkokaupan alatunnisteen sähköpostitilauksella, ei lähetä mitään. Henkilön ensimmäinen tilaus on ensimmäinen asia, jonka CRM-järjestelmäsi hänestä kuulee.

## Edellytykset

> [!WARNING]
>
> **Vaaditut oikeudet:**
>
> * **Hallitse integraatioita ja API-avaimia** (`account_settings:webhooks`) webhookin luomiseen ja sen allekirjoitusavaimen lukemiseen. Se on Ownerilla ja Adminilla. Katso [Käyttäjät ja roolit](https://www.twicecommerce.com/docs/fi/settings/users-roles.md).

> [!NOTE]
>
> **Pidä valmiina ennen kuin aloitat:**
>
> * **HTTPS-osoite, joka vastaanottaa tapahtumat**, esimerkiksi Maken tai Zapierin webhook-käynnistimen osoite. TWICE lähettää vain `https://`-osoitteisiin.
> * **CRM-sääntö, joka yhdistää kontaktit sähköpostiosoitteen perusteella.** TWICE pitää yhden asiakkaan sähköpostiosoitetta kohden, joten sama avain pitää CRM-järjestelmässä yhden kontaktin henkilöä kohden.

## Vaiheittainen ohje

**1. Avaa Webhookit**

Avaa päävalikosta **Asetukset** ja valitse vasemman reunan asetusvalikosta **Integraatiot ja API** otsikon **Yhdistä** alta. Vieritä **API-avaimet**-osion ohi **Webhookit**-osioon.

![Asetusten Integraatiot ja API vieritettynä Webhookit-osioon, asetusvalikon Integraatiot ja API sekä Webhookit-osio korostettuina](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-send-new-orders-to-a-crm-01.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=03c7e94823812445dbe52f96a56ff50f)

**2. Aloita uusi webhook**

Klikkaa **Luo webhook** **Webhookit**-osion oikeasta yläkulmasta. **Luo webhook** -ikkuna aukeaa ensimmäiseen vaiheeseensa, **Valitse tapahtuma**.

![Webhookit-osio, oikean yläkulman Luo webhook korostettuna](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-send-new-orders-to-a-crm-02.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=83e00e78c4dafab111c7f7f59b88a267)

**3. Valitse order.created**

Avaa **Valitse tapahtuma** -lista ja valitse `order.created`, tapahtuma, joka käynnistyy, kun uusi tilaus luodaan. Klikkaa **Seuraava**. Ikkuna siirtyy toiseen vaiheeseensa, **Päätepisteen URL**.

![Luo webhook -ikkuna Valitse tapahtuma -vaiheessa, tapahtumaluettelo auki ja order.created korostettuna](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-send-new-orders-to-a-crm-03.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=23400faaa6769b2968b075712ea1d0ba)

**4. Syötä vastaanottava osoite**

Liitä HTTPS-osoitteesi kenttään **Syötä URL-osoite**. Osoite, joka ei ala `https://`, näyttää virheen kentän alla, ja **Luo webhook** pysyy harmaana.

![Luo webhook -ikkuna Päätepisteen URL -vaiheessa, HTTPS-osoite Syötä URL-osoite -kentässä eikä virhettä sen alla](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-send-new-orders-to-a-crm-04.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=475376f8573782f5373765db442894a3)

**5. Luo webhook**

Klikkaa **Luo webhook** ikkunan alareunassa. **Webhook luotu** vahvistaa sen, ja **Webhookit**-osion taulukossa näkyy uusi webhook: `order.created` sarakkeessa **Tapahtuma** ja **Aktiivinen** sarakkeessa **Tila**.

![Webhookit-taulukko, uuden order.created-webhookin rivi ja sen Aktiivinen-merkki korostettuina](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-send-new-orders-to-a-crm-05.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=a8330fc612e8498f5f81ab3fb01589a9)

**6. Kopioi allekirjoitusavain**

Avaa webhookin rivin oikean reunan valikko ja valitse **Näytä allekirjoitusavain**. Klikkaa avaimen vieressä olevaa kopiointipainiketta ja anna avain sille, joka rakentaa vastaanottavan puolen. Se tarkistaa avaimella jokaisen toimituksen `X-Twice-Signature`-otsakkeen.

![Webhookin allekirjoitusavain -ikkuna, avain sumennettuna ja sen vieressä oleva kopiointipainike korostettuna](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-send-new-orders-to-a-crm-06.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=78569a61e0a4e4ec4fce5d61d4c88744)

**7. Tarkista ensimmäinen toimitus**

Kun seuraava tilaus on tehty, klikkaa webhookin riviä. Sen sivulla näkyy `order.created`-tapahtuma, ja sarakkeessa **Tulos** lukee **Toimitettu**, kun päätepisteesi on vastannut. Klikkaa toimitusta, niin näet sen mukana lähteneen sisällön kohdassa **Payload**.

## Mistä tiedän, että se onnistui?

* **Webhook näkyy listassa** kohdassa **Webhookit**: `order.created` sarakkeessa **Tapahtuma** ja **Aktiivinen** sarakkeessa **Tila**.
* **Jokainen uusi tilaus lisää toimituksen** webhookin sivulle, ja sarakkeessa **Tulos** lukee **Toimitettu**.
* **Sisältö kantaa asiakkaan.** Jokaisella `data.customers`-kohdalla on asiakkaan sähköpostiosoite, nimi, puhelinnumero, markkinointilupa ja kassasi kysymät vakiokentät, ja `attributes` sisältää hänen asiakasattribuuttivastauksensa. Vastaukset listauksen omiin kysymyksiin ovat sen rivillä kohdassa `data.lineItems`.
* **CRM-järjestelmässäsi on yksi kontakti sähköpostiosoitetta kohden**, ja jokainen tilaus päivittää sitä.

## Vianetsintä ja yleiset sudenkuopat

> [accordion] Luo webhook pysyy harmaana
>
> Käytä HTTPS-osoitetta, jonka vastaanottava puoli antaa sinulle. Syöttämäsi osoite ei ala `https://`, ja TWICE lähettää vain HTTPS-osoitteisiin. Katso [Webhookit](https://www.twicecommerce.com/docs/fi/concepts/integrations/webhooks.md#webhookien-hallinta).

> [accordion] Toimituksissa lukee Epäonnistui tai webhookissa Poistettu käytöstä
>
> Päätepisteesi ei vastannut 2xx-tilakoodilla. Kun kolme tapahtumaa peräkkäin epäonnistuu kaikilla yrityksillä, TWICE poistaa webhookin käytöstä. Korjaa päätepiste, valitse rivin valikosta **Ota käyttöön** ja lähetä epäonnistunut toimitus uudelleen sen tiedoista painikkeella **Lähetä uudelleen**. Katso [Webhookit](https://www.twicecommerce.com/docs/fi/concepts/integrations/webhooks.md#toimitus-ja-uudelleenyritykset).

> [accordion] CRM-järjestelmässäsi on kaksi kontaktia yhdelle henkilölle
>
> Yhdistä kontaktit CRM-järjestelmässä sähköpostiosoitteen perusteella, samalla avaimella, jolla TWICE tunnistaa palaavan asiakkaan. Muulla perusteella yhdistävä CRM luo toisen kontaktin, ja niin luo myös henkilö, joka tilaa toisella osoitteella. Katso [Kerää asiakastietoja kassalla](https://www.twicecommerce.com/docs/fi/guides/customers/collect-customer-data-at-checkout.md).

## Aiheeseen liittyvät artikkelit

> [card] [Webhookit](https://www.twicecommerce.com/docs/fi/concepts/integrations/webhooks.md)
>
> Tapahtumat, sisältö, uudelleenyritykset, toimitusloki ja allekirjoituksen tarkistus.

> [card] [Integraatiot ja API](https://www.twicecommerce.com/docs/fi/settings/integrations.md)
>
> API-avaimet, webhookit ja liittimet osio kerrallaan.

> [card] [Kerää asiakastietoja kassalla](https://www.twicecommerce.com/docs/fi/guides/customers/collect-customer-data-at-checkout.md)
>
> Päätä, mitä kassa kysyy ja minne kukin vastaus päätyy.

> [card] [API-avaimet](https://www.twicecommerce.com/docs/fi/concepts/integrations/api-keys.md)
>
> Anna TWICEä lukevalle integraatiolle oma avain ja oikeudet.

> [card] [Omat skriptit](https://www.twicecommerce.com/docs/fi/sales-channels/online-store/custom-scripts.md)
>
> Miksi ostojen seuranta kulkee tämän webhookin kautta eikä selaimessa.

> [card] [Vie asiakkaat](https://www.twicecommerce.com/docs/fi/guides/customers/export-customers.md)
>
> Siirrä asiakassegmentti sähköpostityökaluun tiedostona.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.