Mokapenin opas

WooCommerce

Yhdistä WooCommerce (WordPress) -verkkokauppasi Mokapeniin, jotta asiakkaat (yhteystiedot), tuotteet (variaatiot ja varasto) ja kaupan tilaukset tulevat CRM:ään, ja voit viedä Mokapenissa luodut tai päivitetyt tuotteet WooCommerceen, kun synkronointisuunta sen sallii. Sama tavoite kuin Shopifylla: yhdistää verkkokauppa ja myynnin hallinta samaan työtilaan.

Yleiskatsaus: Integraatiot. Tuodut tilaukset ovat Mokapenissa myyntitilauksia (Tilaukset-moduuli), eivät putken diilejä.

Vaatimukset

• WordPress-sivusto aktiivisella WooCommercella, tavoitettavissa HTTPS:llä.
• Oikeus valtuuttaa Mokapen WC Auth -virran kautta (WordPress / WooCommerce -ylläpitäjä).
• Sopiva Premium -Mokapen-suunnitelma verkkokauppa-integraatioille. Ilman suunnitelmaa yhdistä-painike avaa päivitysnäkymän.
• Mokapen-oikeudet yhteystietoihin, tuotteisiin ja tilauksiin organisaatiossasi (ks. Roolit ja oikeudet).
• Pääsy Integraatioihin (jäsen/ylläpitäjä riippuen whitelabelista ja org-roolista).

WooCommerce-kaupan yhdistäminen

1. Käyttäjävalikko → Integraatiot → WooCommerce.
2. Syötä kaupan verkko-osoite (sivuston URL, esim. https://yourdomain.com). Löydät sen osoitepalkista, kun olet WordPressin / WooCommercen hallinnassa tai kaupan etusivulla.
3. Käynnistä valtuutus: sinut ohjataan WordPress/WooCommerceen WC Auth -sivulle (/wc-auth/v1/authorize) read_write -oikeudella.
4. Hyväksy Mokapenille API-avainten luonti (consumer key / secret tallennetaan salattuna Mokapeniin — ei manuaalista «liitä API-avain» -lomaketta).
5. Palaa Mokapeniin: kauppa on yhdistetty. Mokapen rekisteröi WooCommercen webhookit (/wp-json/wc/v3/webhooks) reaaliaikaisten päivitysten vastaanottamiseen.

Jos et hyväksy valtuutusta, dataa ei synkronoida. URL:n on oltava kelvollinen ja HTTPS: muuten validointi epäonnistuu.

Mitä Mokapen pyytää WooCommercelta

WC Auth -virta antaa Mokapenille read/write-pääsyn WooCommercen REST API -rajapintoihin, joita tarvitaan asiakkaille, tuotteille (ja variaatioille), tilauksille ja webhookille. Mokapen ei korvaa WooCommerce/WordPress -hallintaa teemoille, maksuille tai lisäosille: se linjaa dataa kohti (ja tuotteille myös takaisin) CRM:ää.

Jos peruutat avaimet tai poistat valtuutuksen WordPress-puolella, katkaise ja yhdistä uudelleen Mokapenista.

Mitä synkronoidaan

Kohti Mokapenia (tuonti / webhook)

• Asiakkaat → Yhteystiedot — WooCommercen asiakkaat osoitekirjaan (ja yritys, jos data sen sallii). Päivitykset myös webhookin kautta.
• Tuotteet ja variaatiot → Tuotteet — katalogi variaatioineen; WooCommercen varasto (stock_quantity) kartoitetaan Mokapenin variaatiomäärään.
• Tilaukset → Tilaukset — WooCommercen tilaukset tulevat Mokapeniin myyntitilauksina (rivillä), eivät putkidiileinä. Webhookit päivityksissä.
• Hylätyt ostoskorit / raportit — markkinointitekstit tai «Coming soon» -merkinnät käyttöliittymässä eivät vastaa aktiivista ostoskoriraportointia kuten muissa virroissa: älä luota niihin täydellisenä ominaisuutena, jos sivulla näkyy vielä «tulossa pian».

Kohti WooCommercea (vienti)

• Tuotteet — kun synkronointisuunta on «kohti WooCommercea» tai «molemmat», Mokapen voi viedä/päivittää tuotteita kaupassa (massasynkronointi ja synkronointi ulos tuotteen tallennuksessa, jos integraatio on aktiivinen).
• Yhteystiedot ja tilaukset ulos — kuten Shopifyssa, automaattinen «sync out» -vienti koskee käytännössä tuotteita. Asiakkaat tulevat pääasiassa WooCommercesta Mokapeniin (tuonti + webhook). Älä oleta täyttä kaksisuuntaista yhteystietojen vientiä pelkän kaupallisen tekstin perusteella: tarkista yhdistämisen jälkeen.

Asetuksissa näkyy myös palvelut, mutta erillistä palvelusynkronointia ei ole: käytä Tuotteita kaupan katalogiin.

Asetukset yhdistämisen jälkeen

WooCommerce-sivulla, kun kauppa on yhdistetty:

Synkronointisuunta

• Vain kohti Mokapenia — WooCommerce → CRM.
• Molemmat — tuonti + vienti (missä tuettu; tänään pääasiassa tuotteet ulos).
• Vain kohti WooCommercea — Mokapen → kauppa (tuotteet).

Entiteetit

Yhteystiedot, tilaukset ja tuotteet ovat synkronointialueita (usein esivalittuina eikä muokattavissa käyttöliittymästä).

Synkronoinnin jakaminen

Yhdistänyt voi jakaa yhteyden koko organisaatiolle tai valituille käyttäjille.

Kaksoiskappaleet ja ristiriidat

• Vältä kaksoiskappaleita — tyypillisesti yhteystiedon tunnistus sähköpostilla.
• Ristiriitatilanteessa — WooCommerce tai Mokapen voittaa.

Yksityisyys (WooCommerce)

Toisin kuin Shopifyssa, WooCommerce-sivulla voi olla myös yksityisyys- ja yhteistyökumppani/stakeholder -asetukset synkronoidun datan näkyvyydestä orgissa. Aseta ne, jos tiimin ei pitäisi nähdä kaikkea tuotua katalogia/asiakasta samalla tavalla.

Automaattinen vs manuaalinen synkronointi

Ota automaattinen synkronointi käyttöön jatkuvia päivityksiä varten (webhookien ohella); käytä manuaalista synkronointia historialliseen lataukseen. Tarkista sivun valtuutus ennen synkronointia.

Suositeltu virtaus

1. Varmista HTTPS ja ajantasainen WooCommerce sivustolla.
2. Yhdistä kauppa Integraatiot → WooCommerce ja viimeistele WC Auth.
3. Aseta synkronointisuunta, kaksoiskappaleet, ristiriidat, yksityisyys (jos tarjolla) ja jakaminen.
4. Valtuuta ja käynnistä ensimmäinen synkronointi.
5. Tarkista Yhteystiedot, Tuotteet (variaatiot/varasto), Tilaukset Mokapenissa.
6. Pidä webhookit aktiivisina uusille tapahtumille ilman koko uudelleenkäynnistystä.

Yhteyden katkaisu

Integraatiot → WooCommerce → katkaise. Modaalissa valitse, säilytetäänkö jo tuodut yhteystiedot, tilaukset ja tuotteet Mokapenissa. Katkaisun jälkeen webhookit eivät enää päivitä; CRM:ssä oleva data jää, jos valitsit säilytyksen. Voit myös peruuttaa avaimet/valtuutukset WordPress-hallinnasta.

Yleisiä ongelmia

• Virheellinen URL / ei HTTPS — käytä täyttä sivuston osoitetta https://-etuliitteellä.
• Valtuutus epäonnistui — tarvitaan WordPress-ylläpitäjä; varmista WooCommerce ja REST-permalinkit (palomuurit/turvalisäosat voivat estää WC Authin tai webhookit).
• Painike estetty / päivitys — tarvitaan sopiva Premium-suunnitelma verkkokauppaan.
• Tilaukset eivät ole Diileissä — se on oikein: ne ovat Tilauksissa (Myynti → Tilaukset).
• Varasto / määrä — tulee variaation stock_quantity -kentästä; ei täyttä WMS:ää.
• Webhookit eivät saavu — sivuston on oltava internetistä tavoitettavissa; paikalliset tai basic-auth -ympäristöt eivät usein vastaanota WooCommercen ilmoituksia.

Usein kysytyt kysymykset

K: Pitääkö API-avaimet luoda manuaalisesti WooCommercessa?

V: Ei. Käytä WC Auth -virtaa Mokapenin Integraatiot-sivulta: avaimet luodaan ja tallennetaan, kun palaat valtuutuksesta.

K: Muuttuvatko WooCommercen tilaukset diileiksi?

V: Ei. Mokapenissa ne ovat myyntitilauksia. Teksti, joka viittaa «diileihin», ei vastaa nykyistä käyttäytymistä.

K: Voinko päivittää WooCommercen tuotteita Mokapenista?

V: Kyllä, kun synkronointisuunta sisältää viennin ja integraatio on aktiivinen.

K: Ero Shopifysta?

V: Sama datamalli (yhteystiedot, tuotteet, tilaukset) ja sama verkkokaupan Premium-logiikka. Yhteys eroaa: Shopify käyttää OAuthia Shopify-sovelluksessa; WooCommerce WC Authia WordPress-sivuston URL:llä. Katso myös Shopify-opas.

K: Vaaditaanko HTTPS?

V: Kyllä. Ilman HTTPS yhteys ja webhookit eivät ole luotettavia (ja URL-validointi voi epäonnistua).