Guide til WooCommerce-integration

Denne guide forbinder en WooCommerce-butik til Tajo. Integrationen har to halvdele, der arbejder sammen:

• Pluginnet Tajo for WooCommerce fanger engagementhændelser i realtid (ordrer, kurve, refusioner, anmeldelser, formularindsendelser) inde i WordPress og leverer dem til Tajo gennem en robust, signeret outbox.
• WooCommerce REST-forbindelsen lader Tajo læse din butiks kunder, ordrer, produkter, rabatkoder, refusioner og anmeldelser til historisk import og løbende synkronisering. Se referencen for WooCommerce-connectoren for opsætningen med REST alene.

Selve marketingautomatiseringen (e-mail, SMS, WhatsApp via Brevo og andre udbydere) sættes op i Tajo, ikke i pluginnet. Pluginnets opgave er at få pålidelige hændelser ud af WordPress.

Forudsætninger

• WordPress 6.3+ med admin-adgang
• PHP 7.4+
• WooCommerce 7.0+ (pluginnet virker også på WordPress-sites uden WooCommerce, hvor commerce-adapterne blot forbliver inaktive)
• Tajo-konto med en oprettet WordPress-forbindelse
• HTTPS på Tajo-endpointet (altid opfyldt for hostet Tajo)

Trin 1: Installer pluginnet Tajo for WooCommerce

Manuel installation

# 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

Aktivér det derefter fra WordPress-administrationen:

1. Gå til Plugins → Installed Plugins
2. Find “Tajo for WooCommerce”
3. Klik på Activate

Du kan også uploade zip-filen direkte via Plugins → Add New → Upload Plugin. Der offentliggøres en SHA-256-kontrolsum sammen med hver udgivelse på tajo.io/downloads/woocommerce/. Pluginnet er endnu ikke opført i kataloget på WordPress.org; manuel installation er den understøttede vej i dag.

Trin 2: Konfigurer forbindelsen

Gå til WooCommerce → Tajo (på sites uden WooCommerce: Settings → Tajo), og indtast de tre værdier fra din Tajo-WordPress-forbindelse:

Der er ingen API-nøglekonstanter, du skal tilføje i wp-config.php. Hændelser står trygt i kø i den lokale outbox, indtil alle tre værdier er gemt.

Kontrollér derefter hele kæden fra ende til anden:

1. Klik på Queue test event og derefter på Process now.
2. Tabellen over leverings-outboxen bør vise hændelsen som leveret.
3. Bekræft i Tajo, at hændelsen connection.test er ankommet på WordPress-forbindelsen.

Hvad pluginnet sender

Hver hændelse er en kompakt konvolut med minimeret persondata, signeret med HMAC-SHA256. Kun identitetsfelter til engagement (e-mail, telefon, lokale ID’er) plus afgrænsede hændelsesmetadata forlader WordPress, aldrig navne, postadresser, IP-adresser, user agents, kommentartekster, vilkårlige formularfelter, ordrenoter eller betalingsoplysninger.

WooCommerce-hændelser

Ordrehændelser indeholder ordrenummer, status, valuta, totaler, ordrelinjer og klar-til-brug-URL’er til anmeldelse og genbestilling, nok til automatiseringer efter køb og til win-back uden et opfølgende API-kald.

WordPress-hændelser

• contact.created / contact.updated / contact.deleted for brugerkonti
• content.published / content.updated / content.unpublished for offentligt indhold
• comment.created / comment.status_changed for besøgendes kommentarer og produktanmeldelser (interne WooCommerce-ordrenoter, pingbacks og trackbacks udsendes aldrig)
• form.submitted for gennemførte indsendelser fra Contact Form 7, WPForms, Gravity Forms og Fluent Forms, hvor kun typede identitetsfelter med e-mail og telefon samt formularmetadata udtrækkes; vilkårlige indsendte felter kasseres

Pålidelighed: leverings-outboxen

Pluginnet sender aldrig hændelser til Tajo direkte fra en sideindlæsning. Hver hændelse skrives først til en lokal outbox-tabel og leveres derefter af WP-Cron med:

• Afgrænset eksponentiel backoff (op til 8 forsøg, med respekt for Retry-After)
• Dead letters med Replay dead letters i administrationen med ét klik
• Opbevaringsgrænser, så et endpoint, der ikke kan nås, aldrig kan hobe persondata op (leveret: 7 dage; i kø: 30 dage; dead letters: 30 dage efter seneste opdatering)
• Idempotente hændelses-ID’er, så nye forsøg og replays aldrig giver dubletter længere nede i kæden

Hvis din hostingudbyder slår WP-Cron fra (DISABLE_WP_CRON), skal du kalde wp-cron.php fra en rigtig scheduler mindst én gang i minuttet.

Samtykke udledes aldrig

Oprettelse af konto, checkout, køb og almindelige formularindsendelser behandles ikke som marketingsamtykke. Indbyggede hændelser bærer en tom samtykkeliste. Vil du registrere udtrykkeligt samtykke (for eksempel fra et afkrydset felt om nyhedsbrev), skal du sende det via udvidelses-hooket:

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' )
);

Det samme hook lader ethvert plugin eller tema udsende egne hændelser; alt passerer gennem den samme sanitizer, den samme outbox og den samme signatur.

Trin 3: Historisk import

Hændelser i realtid dækker alt fra installationen og frem. Historikken fra før pluginnet henter Tajos WooCommerce REST-forbindelse ind: eksisterende kunder, ordrer, produkter, rabatkoder, refusioner og anmeldelser, sat op udelukkende på Tajo-siden med en WooCommerce REST API-nøgle (WooCommerce → Settings → Advanced → REST API, læserettighed). Se referencen for WooCommerce-connectoren for detaljer.

Privatliv og GDPR

• Pluginnet registrerer sig i WordPress under Tools → Export Personal Data og Tools → Erase Personal Data; gemte outbox-hændelser for en matchende e-mail eksporteres eller slettes lokalt.
• Sletning og levering deler en fail-closed-mutex, så en sletning aldrig kan meldes gennemført, mens en payload er undervejs.
• Lokal sletning dækker kun WordPress-outboxen, indsend den tilsvarende anmodning i Tajo for data længere nede i kæden.
• Deaktivering sætter leveringen på pause, men bevarer konfiguration og hændelser i kø; sletter du pluginnet, fjernes outbox, indstillinger, nøgle og planlagte kørsler permanent.

Kompatibilitet

• HPOS: pluginnet erklærer kompatibilitet med WooCommerce High-Performance Order Storage og bruger kun CRUD-objekter og offentlige hooks.
• WooCommerce Subscriptions: ændringer i abonnementsstatus opfanges, når udvidelsen er aktiv.
• Multisite: afinstallation rydder op på alle sites i netværket.

Driftsreference

Server-til-server-opdagelse og styring af outboxen er tilgængelig for administratorer via godkendelse med Application Password:

Fejlfinding

Næste trin

• Reference for WooCommerce-connectoren, REST-synkronisering, detaljer om webhook-signatur, konfigurationsnøgler
• Kundesynkronisering, sådan mapper du WooCommerce-kunder ind i dit primære datasystem
• Sæt automatiseringer for forladte kurve, efter køb og win-back op i Tajo ud fra hændelserne cart.updated, order.placed og order.fulfilled