Veiledning for WooCommerce-integrasjon

Denne veiledningen kobler en WooCommerce-butikk til Tajo. Integrasjonen består av to halvdeler som jobber sammen:

• Tillegget Tajo for WooCommerce: fanger opp engasjementshendelser (ordrer, handlekurver, refusjoner, anmeldelser, skjemainnsendinger) inne i WordPress etter hvert som de skjer, og leverer dem til Tajo gjennom en holdbar, signert utboks. Tillegget ble testet på et lokalt nettsted 14. oktober 2026, og 24. oktober 2026 gikk de signerte leveringene gjennom Tajos kobling i et lokalt sandkassemiljø; nettverksturen fra et ekte nettsted til Tajo er ikke verifisert ennå.
• WooCommerce REST-tilkobling: Tajo leser butikkens kunder, ordrer, produkter, rabattkoder, refusjoner og anmeldelser for historisk import og løpende synkronisering. Se referansen for WooCommerce-koblingen for oppsett med kun REST.

Selve markedsautomatiseringen (e-post, SMS, WhatsApp via Brevo og andre leverandører) settes opp i Tajo, ikke i tillegget. Tilleggets oppgave er å få troverdige hendelser ut av WordPress.

Forutsetninger

• WordPress 6.3+ med administratortilgang
• PHP 7.4+
• WooCommerce 7.0+ (tillegget fungerer også på WordPress-nettsteder uten WooCommerce; handelsadapterne holder seg da bare inaktive)
• Tajo-konto med en opprettet WordPress-tilkobling
• HTTPS på Tajo-endepunktet (alltid tilfellet for Tajo som vi drifter)

Trinn 1: Installer tillegget Tajo for WooCommerce

Manuell installasjon

# Download the plugin
cd wp-content/plugins
wget https://tajo.io/downloads/woocommerce/tajo-woocommerce-latest.zip

# Verify and unzip
unzip tajo-woocommerce-latest.zip

Aktiver deretter fra WordPress-administrasjonen:

1. Gå til Plugins → Installed Plugins
2. Finn «Tajo for WooCommerce»
3. Klikk Activate

Du kan også laste opp zip-filen direkte via Plugins → Add New → Upload Plugin. En SHA-256-kontrollsum publiseres sammen med hver utgivelse på tajo.io/downloads/woocommerce/. Tillegget er ennå ikke oppført i katalogen på WordPress.org; manuell installasjon er den støttede veien i dag.

Trinn 2: Konfigurer tilkoblingen

Gå til WooCommerce → Tajo (på nettsteder uten WooCommerce: Settings → Tajo) og fyll inn de tre verdiene fra WordPress-tilkoblingen din i Tajo:

Det finnes ingen API-nøkkelkonstanter å legge til i wp-config.php. Hendelsene ligger trygt i kø i den lokale utboksen til alle tre verdiene er lagret.

Verifiser deretter hele røret fra ende til ende:

1. Klikk Queue test event, og deretter Process now.
2. Leveringstabellen for utboksen skal vise hendelsen som levert.
3. I Tajo bekrefter du at hendelsen connection.test kom frem på WordPress-tilkoblingen.

Hva tillegget sender

Hver hendelse er en kompakt, personvernminimert konvolutt signert med HMAC-SHA256. Bare identitetsfelter for engasjement (e-post, telefon, lokale ID-er) pluss avgrensede hendelsesmetadata forlater WordPress, aldri navn, postadresser, IP-adresser, user agents, kommentartekster, vilkårlige skjemafelter, ordrenotater eller betalingsdetaljer.

WooCommerce-hendelser

Ordrehendelser bærer ordrenummer, status, valuta, totaler, ordrelinjer og ferdige URL-er for anmeldelse og gjenbestilling, nok til automatiseringer etter kjøp og win-back uten et oppfølgende API-kall.

WordPress-hendelser

• contact.created / contact.updated / contact.deleted for brukerkontoer
• content.published / content.updated / content.unpublished for offentlig innhold
• comment.created / comment.status_changed for kommentarer fra besøkende og produktanmeldelser (interne ordrenotater i WooCommerce, pingbacks og trackbacks sendes aldri)
• form.submitted for vellykkede innsendinger fra Contact Form 7, WPForms, Gravity Forms og Fluent Forms: bare typede identitetsfelter for e-post og telefon samt skjemametadata hentes ut; vilkårlige innsendte felter forkastes

Pålitelighet: leveringsutboksen

Tillegget fyrer aldri hendelser mot Tajo direkte fra en sidevisning. Hver hendelse skrives først til en lokal utbokstabell, og leveres deretter av WP-Cron med:

• Avgrenset eksponentiell backoff (opptil 8 forsøk, med respekt for Retry-After)
• Dead letters med ett klikk på Replay dead letters i administrasjonen
• Oppbevaringsgrenser, slik at et utilgjengelig endepunkt aldri kan hamstre persondata (levert: 7 dager; i kø: 30 dager; dead letters: 30 dager etter siste oppdatering)
• Idempotente hendelses-ID-er, slik at nye forsøk og replays aldri dupliserer nedstrøms

Hvis leverandøren din slår av WP-Cron (DISABLE_WP_CRON), må du kalle wp-cron.php fra en ekte planlegger minst én gang i minuttet.

Samtykke utledes aldri

Kontoopprettelse, checkout, kjøp og vanlige skjemainnsendinger regnes ikke som markedsføringssamtykke. Innebygde hendelser bærer en tom samtykkeliste. For å registrere uttrykkelig samtykke (for eksempel fra en avkrysset nyhetsbrevboks) sender du det gjennom utvidelseshooken:

do_action(
    'tajo_engagement_emit',
    'consent.updated',
    array( 'email' => $email ),
    array( 'policyVersion' => '2026-07' ),
    array(
        array(
            'channel'  => 'email',
            'status'   => 'opt_in',        // or 'opt_out'
            'purpose'  => 'marketing',
            'source'   => 'newsletter_checkbox',
            'evidence' => array( 'formId' => 'newsletter-footer', 'field' => 'marketing_email' ),
        ),
    ),
    gmdate( 'c' )
);

Den samme hooken lar hvilket som helst tillegg eller tema sende egendefinerte hendelser; alt går gjennom den samme saneringen, den samme utboksen og den samme signaturen.

Trinn 3: Historisk import

Hendelser fra tillegget dekker alt fra installasjonen og fremover. For historikken som ligger før tillegget, importerer Tajos WooCommerce REST-tilkobling eksisterende kunder, ordrer, produkter, rabattkoder, refusjoner og anmeldelser, konfigurert utelukkende på Tajo-siden med en WooCommerce REST API-nøkkel (WooCommerce → Settings → Advanced → REST API, lesetillatelse). Se referansen for WooCommerce-koblingen for detaljer.

Personvern og GDPR

• Tillegget registrerer seg hos WordPress under Tools → Export Personal Data og Tools → Erase Personal Data; lagrede utbokshendelser for en e-postadresse som treffer, eksporteres eller slettes lokalt.
• Sletting og levering deler en fail-closed mutex, slik at en sletting aldri kan melde seg ferdig mens en payload er midt i sendingen.
• Lokal sletting dekker bare utboksen i WordPress: send den tilsvarende forespørselen i Tajo for data nedstrøms.
• Deaktivering setter leveringen på pause, men beholder konfigurasjon og hendelser i kø; å slette tillegget fjerner utboksen, innstillingene, hemmeligheten og planleggingene permanent.

Kompatibilitet

• HPOS: tillegget erklærer kompatibilitet med WooCommerce High-Performance Order Storage og bruker bare CRUD-objekter og offentlige hooks.
• WooCommerce Subscriptions: statusendringer på abonnementer fanges opp når utvidelsen er aktiv.
• Multisite: avinstallering rydder opp på hvert eneste nettsted i nettverket.

Operasjonsreferanse

Oppdagelse fra server til server og styring av utboksen er tilgjengelig for administratorer via autentisering med Application Password:

Feilsøking

Neste steg

• Referanse for WooCommerce-koblingen: REST-synkronisering, detaljer om webhook-signatur, konfigurasjonsnøkler
• Kundesynkronisering: hvordan WooCommerce-kunder kartlegges inn i kildesystemet ditt
• Sett opp automatiseringer for forlatte handlekurver, etter kjøp og win-back i Tajo ved hjelp av hendelsene cart.updated, order.placed og order.fulfilled