Artikkelit aiheesta: Integraatiot
Tämä artikkeli on saatavana myös seuraavilla kielillä:

WooCommerce-integraatio Trustmaryyn

Pikaohje


  1. Siirry WordPressissä kohtaan Lisäosat → Lisää uusi, hae Trustmary Integration for WooCommerce ja klikkaa Asenna nyt ja Ota käyttöön.
  2. Siirry Trustmaryssa kohtaan Asetukset → Kehittäjät ja klikkaa Lisää uusi kohdassa API-avaimet. Kopioi avain.
  3. Siirry WordPressissä kohtaan WooCommerce → Asetukset → Trustmary, liitä avain kenttään API Key ja klikkaa Test API connection.
  4. Klikkaa Add trigger, valitse tilauksen tilat ja Trustmaryn listat ja klikkaa Tallenna muutokset.
  5. Tee testitilaus ja siirrä se johonkin valituista tiloista. Asiakas ilmestyy listalle Trustmaryssa.


Lisäosa lähettää WooCommerce-tilauksen yhteystiedot Trustmaryyn, kun tilaus siirtyy valittuun tilaan. Kyselyyn kytketty lista lähettää sen jälkeen kyselyn, joten arvostelupyynnöt lähtevät ilman käsin tehtävää vientiä. Käyttöönotto vie noin kymmenen minuuttia.


Vaatimukset: WordPress 5.8 tai uudempi, WooCommerce 5.0 tai uudempi, PHP 7.4 tai uudempi sekä Trustmary-tili.


Lisäosan oma asetussivu on englanninkielinen. Sen painikkeet ja kentät on nimetty tässä ohjeessa niin kuin ne näkyvät ruudulla.


Vaihe 1 – Asenna lisäosa


Siirry WordPressin hallinnassa kohtaan Lisäosat → Lisää uusi ja hae Trustmary Integration for WooCommerce. Klikkaa Asenna nyt ja sitten Ota käyttöön. Kohtaan WooCommerce → Asetukset ilmestyy Trustmary-välilehti.


Vaihe 2 – Luo API-avain Trustmaryssa


Siirry Trustmaryssa kohtaan Asetukset → Kehittäjät. Klikkaa kohdassa API-avaimet painiketta Lisää uusi, anna avaimelle nimi ja kopioi avain.


Kehittäjät-sivun API-avaimet-osio, oikealla Lisää uusi.


Avain näytetään vain kerran. Käsittele sitä kuten salasanaa: sillä pääsee kirjoittamaan tilin kontakteja.


Vaihe 3 – Yhdistä lisäosa


Siirry WordPressissä kohtaan WooCommerce → Asetukset → Trustmary. Liitä avain kenttään API Key ja klikkaa Test API connection. Onnistunut testi näyttää Trustmary-organisaation nimen Connection-kortissa ja tallentaa avaimen, joten tällä sivulla ei tarvitse vielä tallentaa mitään muuta.


Connection-kortti onnistuneen testin jälkeen: Connected ja organisaation nimi.


Vaihe 4 – Luo laukaisin


Klikkaa Add trigger. Laukaisin päättää, milloin tilaus lähetetään, mitkä tilaukset kelpaavat, mille listoille kontakti menee ja mitkä tiedot lähetetään. Editori käy nämä neljä osaa läpi järjestyksessä.


Laukaisimen editori: When, Filter, Action ja Field mapping.


  1. When – yksi tai useampi tilauksen tila, esimerkiksi Completed. Laukaisin ajetaan, kun tilaus siirtyy johonkin niistä.
  2. Filter (valinnainen) – tuotteet, laskutusmaa, tilauksen summa ja vain ensimmäinen tilaus. Kaikkien ehtojen on täytyttävä; joko-tai-tilanteeseen luodaan toinen laukaisin.
  3. Action – Trustmaryn listat, joille kontakti lisätään. Klikkaa Refresh, niin listat haetaan tililtä. Kyselyyn kytketty lista lähettää kyselyn listan omien asetusten mukaan. Send again on oletuksena pois päältä, joten laukaisin lähettää tilauksen vain kerran.
  4. Field mapping – mikä tilauksen tieto menee mihinkin kontaktikenttään. Sähköposti, etunimi, sukunimi, tilausnumero, tilauksen tila ja tuotteiden nimet on yhdistetty valmiiksi. Create default fields luo lisäosan omat kentät Trustmary-tilille yhdellä klikkauksella.


Anna laukaisimelle nimi, jätä Run this trigger valituksi ja klikkaa Tallenna muutokset. Laukaisin näkyy listassa tilassa Active.


Kun jokaiselle tuotteelle halutaan oma kysely, luodaan yksi laukaisin tuotetta kohden: tuotesuodattimeen tuote ja listaksi sen kyselyn lista. Kaikki aktiiviset laukaisimet toimivat rinnakkain, ja sama tilaus voi osua useampaan.


Vaihe 5 – Testaa tilauksella


Tee testitilaus ja siirrä se laukaisimessa valittuun tilaan. Lähetys tapahtuu taustalla, joten kassa ei odota Trustmarya, ja asiakas ilmestyy valitulle listalle yleensä minuutin sisällä.


Jos lista on kytketty kyselyyn, kysely lähetetään myös testikontaktille.


Vianmääritys


Kontakti ei ilmesty Trustmaryyn. Siirry kohtaan WooCommerce → Tila → Lokit ja valitse lähteeksi woocommerce-trustmary. Jokaisesta tilan muutoksesta kirjataan, mitkä laukaisimet osuivat ja miksi muut eivät.


WooCommercen lokilista suodatettuna lähteeseen woocommerce-trustmary.


Laukaisimen kohdalla lukee Needs attention. Suodattimen tuote on poistettu tai listaa ei enää ole Trustmaryssa. Laukaisin on tauolla, kunnes suodatin tai lista on korjattu editorissa.


Sama asiakas lähetetään useita kertoja. Laukaisin lähettää tilauksen vain kerran, ellei sille ole otettu käyttöön Send again -asetusta. Kontaktit yhdistetään sähköpostiosoitteen perusteella, joten sama asiakas päivittyy eikä monistu.


Asetussivu näyttää päivityksen jälkeen erilaiselta. Versio 2.0 korvasi yhden asetuslomakkeen laukaisimilla. Aiemmat asetukset on siirretty laukaisimeen Default, joka toimii täsmälleen kuten ennen; sitä voi muokata tai sen rinnalle voi lisätä uusia laukaisimia.


Kehittäjille lähetettävän tiedon muokkaamiseen on lisäosan omat suodattimet, jotka on kuvattu lisäosan WordPress.org-sivulla.

Päivitetty: 11/11/2026

Oliko tämä artikkeli hyödyllinen?

Jaa palautteesi

Peruuttaa

Kiitos!