Mokapenguiden

WooCommerce

Anslut din WooCommerce (WordPress) butik till Mokapen att ta med kunder (kontakter), produkter (med variationer och lager), och lagra order in i CRM, och att exportera produkter skapade eller uppdaterade i Mokapen till WooCommerce när synkroniseringsriktningen tillåter. Samma mål som Shopify: förena e-handel och försäljningshantering i samma arbetsyta.

Allmän översikt: Integrationer. Importerade beställningar blir försäljningsorder i Mokapen (Ordermodul), inte pipelinemöjligheter.

Krav

• WordPress-sajt med aktiv WooCommerce, nås över HTTPS.
• Tillstånd att auktorisera Mokapen via WC Auth flöde (WordPress / WooCommerce administratör).
• En lämplig Premium Mokapen plan för e-handelsintegrationer. Utan en plan öppnar anslut-knappen uppgraderingsskärmen.
• Mokapen-behörigheter för kontakter, produkter och beställningar i din organisation (se Roller och behörigheter).
• Tillgång till integrationer (medlem/admin beroende på white-label och organisationsroll).

Anslut WooCommerce-butiken

1. Användarmeny → Integrationer → WooCommerce.
2. Ange lagra webbadress (webbplatsens URL, t.ex. https://dindomän.com). Du hittar det i adressfältet när du är i WordPress-backend / WooCommerce-butiksfronten.
3. Starta auktorisering: du omdirigeras till WordPress/WooCommerce till WC Auth sida (/wc-auth/v1/authorize) med läsa_skriva omfattning.
4. Acceptera generering av API-nycklar för Mokapen (konsumentnyckel/hemlighet lagras krypterad i Mokapen — det finns ingen manuell «klistra in API-nyckel»-formulär).
5. Återgå till Mokapen: butiken är ansluten. Mokapen registrerar WooCommerce webhooks (/wp-json/wc/v3/webhooks) för att ta emot uppdateringar i realtid.

Om du inte accepterar auktorisering, ingen data synkroniseras. URL:en måste vara giltig och HTTPS: annars misslyckas valideringen.

Vad Mokapen begär från WooCommerce

WC Auth-flödet ger Mokapen läs-/skrivåtkomst till WooCommerce REST API:er som behövs för kunder, produkter (och varianter), beställningar och webhooks. Mokapen ersätter inte WooCommerce/WordPress-panelen för teman, betalningar eller plugins: den anpassar data mot (och, för produkter, från) CRM.

Om du återkallar nycklar eller tar bort behörighet på WordPress-sidan, koppla från och återanslut från Mokapen.

Det som synkroniseras

Mot Mokapen (import / webhook)

• Kunder → Kontakter — WooCommerce-kunder i adressboken (och företag om data tillåter). Uppdateringar även via webhook.
• Produkter och varianter → Produkter — katalog med variationer; WooCommerce stock (stock_quantity) är mappad till Mokapen variant kvantitet.
• Beställningar → Beställningar — WooCommerce-order blir försäljningsorder i Mokapen (med artiklar), inte pipelineaffärer. Webhooks på uppdateringar.
• Övergivna vagnar/rapporter — marknadsföringsomnämnanden eller «Kommer snart»-poster i användargränssnittet motsvarar inte en aktiv kundvagnsrapporteringsimport som andra flöden: räkna dem inte som en komplett funktion om de fortfarande visas som kommer snart på sidan.

Mot WooCommerce (export)

• Produkter — med synkriktning «mot WooCommerce» eller «båda» kan Mokapen exportera/uppdatera produkter i butiken (bulksynkronisering och synka ut på produktsparning, om integrationen är aktiv).
• Utgående kontakter och beställningar — som med Shopify gäller den automatiska «sync out»-exporten som implementeras idag i praktiken produkter. Kunderna kommer främst från WooCommerce till Mokapen (import + webhook). Anta inte fullständig dubbelriktad kontaktexport bara för att kommersiell text föreslår det: verifiera efter anslutning.

Config visas också tjänster, men det finns inga dedikerade tjänster sync: use Produkter för butikskatalogen.

Inställningar efter anslutning

På WooCommerce-sidan, med butiken ansluten:

Synkroniseringsriktning

• Endast mot Mokapen — WooCommerce → CRM.
• Både — Import + export (där stöds; idag huvudsakligen utgående produkter).
• Endast mot WooCommerce — Mokapen → butik (produkter).

Entiteter

Kontakter, beställningar och produkter är synkroniseringsomfång (ofta förvalda och inte redigerbara från användargränssnittet).

Dela synk

Den som är ansluten kan dela anslutningen med hela organisationen eller utvalda användare.

Dubletter och konflikter

• Undvik dubbletter — vanligtvis kontaktigenkänning via e-post.
• Vid konflikt — WooCommerce eller Mokapen vinner.

Sekretess (WooCommerce)

Till skillnad från Shopify, på WooCommerce-sidan kan du också hitta privatliv och samarbetspartners/intressenter kontroller relaterade till hur synkroniserad data är synlig i organisationen. Ställ in dem om teamet inte ska se alla importerade kataloger/kunder på samma sätt.

Automatisk vs manuell synkronisering

Aktivera automatisk synkronisering för pågående uppdateringar (tillsammans med webhooks); använd manuell synkronisering för den historiska laddningen. Kontrollera uppgifterna tillstånd på sidan innan synkronisering.

Rekommenderat flöde

1. Verifiera HTTPS och uppdaterad WooCommerce på webbplatsen.
2. Anslut butiken från Integrations → WooCommerce och slutför WC Auth.
3. Ställ in synkroniseringsriktning, dubbletter, konflikter, sekretess (om sådan finns) och delning.
4. Auktorisera och starta första synkroniseringen.
5. Kontrollera Kontakter, Produkter (varianter/lager), Beställningar i Mokapen.
6. Håll webhooks aktiva för nya evenemang utan att starta om allt varje gång.

Koppla från

Från integrationer → WooCommerce → koppla bort. I modal väljer du om du vill hålla kontakter, beställningar och produkter som redan importerats i Mokapen. Efter frånkoppling uppdateras inte längre webhooks; data som redan finns i CRM finns kvar om du behåller den. Du kan också återkalla nycklar/auktoriseringar från WordPress-panelen.

Vanliga frågor

• Ogiltig URL / inte HTTPS — använd hela webbplatsadressen med https://.
• Auktorisering misslyckades — en WordPress-administratör krävs; verifiera WooCommerce och REST permalänkar fungerar (brandvägg/säkerhetsplugin kan blockera WC Auth eller webhooks).
• Knapp blockerad/uppgradera — En lämplig Premium-plan för e-handel krävs.
• Beställningar som inte finns i Opportunities — det stämmer: de går in Order (Försäljning → Order).
• Lager / kvantitet — kommer från variation stock_quantity; inte ett fullständigt WMS.
• Webhooks kommer inte fram — Webbplatsen måste vara tillgänglig från internet. lokala eller grundläggande auth-miljöer tar ofta inte emot WooCommerce-aviseringar.

Vanliga frågor

F: Behöver jag generera API-nycklar manuellt i WooCommerce?

S: Nej. Använd WC Auth flöde från Mokapen Integrations-sidan: nycklar skapas och sparas när du kommer tillbaka från auktorisering.

F: Blir WooCommerce-order möjligheter?

S: Nej. I Mokapen blir de försäljningsorder. Varje text som hänvisar till "möjligheter" är felaktig i förhållande till nuvarande beteende.

F: Kan jag uppdatera WooCommerce-produkter från Mokapen?

S: Ja, med en synkroniseringsriktning som inkluderar export och integrationen aktiv.

F: Skillnad från Shopify?

S: Samma datamodell (kontakter, produkter, beställningar) och samma Premium-logik för e-handel. Anslutningen skiljer sig: Shopify använder OAuth på Shopify-appen; WooCommerce använder WC Auth på din WordPress-webbadress. Se även Shopify guide.

F: Krävs HTTPS?

A: Ja. Utan HTTPS är anslutningen och webhooks inte tillförlitliga (och URL-validering kan misslyckas).