Demandez un accès anticipé

Indiquez votre prénom ainsi qu’une adresse e-mail ou un numéro de téléphone. Nous vous recontacterons pour vous communiquer les modalités d’accès à Tajo.

Sur cette page

Guide d’intégration WooCommerce

Ce guide connecte une boutique WooCommerce à Tajo. L’intégration repose sur deux moitiés qui fonctionnent ensemble :

Plugin Tajo for WooCommerce : il capte les événements d’engagement en temps réel (commandes, paniers, remboursements, avis, soumissions de formulaire) à l’intérieur de WordPress et les livre à Tajo via un outbox durable et signé.
Connexion WooCommerce REST : Tajo lit les clients, commandes, produits, codes promo, remboursements et avis de votre boutique pour l’import historique et la synchronisation continue. Consultez la référence du connecteur WooCommerce pour la configuration REST seule.

L’automation marketing elle-même (e-mail, SMS, WhatsApp via Brevo et d’autres fournisseurs) se configure dans Tajo, pas dans le plugin. Le rôle du plugin est de faire sortir de WordPress des événements dignes de confiance.

Prérequis

WordPress 6.3+ avec un accès administrateur
PHP 7.4+
WooCommerce 7.0+ (le plugin fonctionne aussi sur les sites WordPress sans WooCommerce, les adaptateurs commerce restent simplement inactifs)
Compte Tajo avec une connexion WordPress créée
HTTPS sur l’endpoint Tajo (toujours le cas avec Tajo hébergé)

Étape 1 : installer le plugin Tajo for WooCommerce

Installation manuelle

# 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

Activez-le ensuite depuis l’administration WordPress :

Allez dans Extensions → Extensions installées
Trouvez « Tajo for WooCommerce »
Cliquez sur Activer

Vous pouvez aussi téléverser le zip directement via Extensions → Ajouter → Téléverser une extension. Une somme de contrôle SHA-256 est publiée avec chaque version sur tajo.io/downloads/woocommerce/. Le plugin n’est pas encore référencé dans l’annuaire WordPress.org ; l’installation manuelle est aujourd’hui la voie prise en charge.

Étape 2 : configurer la connexion

Naviguez vers WooCommerce → Tajo (sur les sites sans WooCommerce : Réglages → Tajo) et saisissez les trois valeurs de votre connexion WordPress Tajo :

Champ	Valeur
Endpoint Tajo	L’URL de webhook HTTPS affichée dans Tajo, par exemple `https://alto.tajo.io/api/connectors/wordpress/webhooks/engagement`
Binding ID	Le binding ID de la connexion, fourni par Tajo
Secret de signature	Le secret partagé (32–256 caractères). Le plugin génère un secret local robuste à l’activation ; collez-le dans Tajo, ou collez ici le secret de Tajo

Il n’y a aucune constante de clé API à ajouter dans wp-config.php. Les événements restent en file d’attente en toute sécurité dans l’outbox local tant que les trois valeurs ne sont pas enregistrées.

Vérifiez ensuite la chaîne de bout en bout :

Cliquez sur Queue test event, puis sur Process now.
La table de l’outbox de livraison doit afficher l’événement comme livré.
Dans Tajo, vérifiez que l’événement connection.test est bien arrivé sur la connexion WordPress.

Ce que le plugin envoie

Chaque événement est une enveloppe compacte, réduite au minimum de données personnelles, signée en HMAC-SHA256. Seuls les champs d’identité d’engagement (e-mail, téléphone, identifiants locaux) et des métadonnées d’événement bornées quittent WordPress, jamais les noms, adresses postales, adresses IP, agents utilisateurs, corps de commentaires, champs de formulaire arbitraires, notes de commande ou détails de paiement.

Événements WooCommerce

Hook	Événement
`woocommerce_created_customer` / `woocommerce_update_customer`	`customer.created` / `customer.updated`
`woocommerce_new_product` / `woocommerce_update_product`	`product.created` / `product.updated`
`woocommerce_add_to_cart`, retrait d’un article, ajout ou retrait d’un code promo	`cart.updated` (avec un résumé du panier pour les scénarios d’abandon)
`woocommerce_cart_emptied`	`cart.emptied`
`woocommerce_new_order` / `woocommerce_update_order`	`order.placed` / `order.updated`
`woocommerce_order_status_changed`	`order.status_changed` (+ `order.fulfilled` à la finalisation)
`woocommerce_payment_complete`	`order.paid`
`woocommerce_order_refunded`	`refund.created`
Changements de statut WooCommerce Subscriptions	`subscription.status_changed`

Les événements de commande transportent le numéro de commande, le statut, la devise, les totaux, les lignes de commande et des URL d’avis et de nouvelle commande prêtes à l’emploi, de quoi alimenter les automations post-achat et de reconquête sans appel API supplémentaire.

Événements WordPress

contact.created / contact.updated / contact.deleted pour les comptes utilisateurs
content.published / content.updated / content.unpublished pour les contenus publics
comment.created / comment.status_changed pour les commentaires de visiteurs et les avis produits (les notes de commande internes de WooCommerce, les pingbacks et les trackbacks ne sont jamais émis)
form.submitted pour les soumissions réussies de Contact Form 7, WPForms, Gravity Forms et Fluent Forms. Seuls les champs d’identité typés e-mail ou téléphone et les métadonnées du formulaire sont extraits ; les champs soumis arbitraires sont écartés

Fiabilité : l’outbox de livraison

Le plugin n’envoie jamais les événements vers Tajo directement depuis un chargement de page. Chaque événement est d’abord écrit dans une table outbox locale, puis livré par WP-Cron avec :

Un backoff exponentiel borné (jusqu’à 8 tentatives, en respectant Retry-After)
Des dead letters avec un bouton Replay dead letters en un clic dans l’administration
Des limites de rétention pour qu’un endpoint injoignable ne puisse jamais accumuler de données personnelles (livrés : 7 jours ; en file d’attente : 30 jours ; dead letters : 30 jours après la dernière mise à jour)
Des identifiants d’événement idempotents, pour que les nouvelles tentatives et les rejeux ne créent jamais de doublon en aval

Si votre hébergeur désactive WP-Cron (DISABLE_WP_CRON), appelez wp-cron.php depuis un vrai planificateur au moins une fois par minute.

Le consentement n’est jamais déduit

La création de compte, le processus de paiement, l’achat et les soumissions de formulaire génériques ne sont pas traités comme un consentement marketing. Les événements intégrés portent une liste de consentements vide. Pour enregistrer un consentement explicite (par exemple une case newsletter cochée), émettez-le via le hook d’extension :

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

Le même hook permet à n’importe quel plugin ou thème d’émettre des événements personnalisés ; tout passe par le même sanitizer, le même outbox et la même signature.

Étape 3 : import historique

Les événements en temps réel couvrent tout ce qui suit l’installation. Pour l’historique antérieur au plugin, la connexion WooCommerce REST de Tajo importe les clients, commandes, produits, codes promo, remboursements et avis existants, entièrement configurée côté Tajo avec une clé d’API REST WooCommerce (WooCommerce → Réglages → Avancé → API REST, permission en lecture). Consultez la référence du connecteur WooCommerce pour le détail.

Confidentialité et RGPD

Le plugin s’enregistre auprès des outils WordPress Outils → Exporter les données personnelles et Outils → Effacer les données personnelles ; les événements conservés dans l’outbox pour une adresse e-mail correspondante sont exportés ou effacés localement.
L’effacement et la livraison partagent un mutex fail-closed, de sorte qu’un effacement ne peut jamais se déclarer terminé alors qu’une charge utile est en cours d’envoi.
L’effacement local ne couvre que l’outbox WordPress. Soumettez la demande correspondante dans Tajo pour les données en aval.
La désactivation met la livraison en pause mais conserve la configuration et les événements en file d’attente ; la suppression du plugin retire définitivement l’outbox, les paramètres, le secret et les tâches planifiées.

Compatibilité

HPOS : le plugin déclare la compatibilité avec le stockage haute performance des commandes de WooCommerce et n’utilise que des objets CRUD et des hooks publics.
WooCommerce Subscriptions : les changements de statut d’abonnement sont captés lorsque l’extension est active.
Multisite : la désinstallation nettoie chaque site du réseau.

Référence d’exploitation

La découverte serveur à serveur et le pilotage de l’outbox sont accessibles aux administrateurs via l’authentification par Application Password :

Méthode	Route	Rôle
`GET`	`/wp-json/tajo/v1/capabilities`	Version du plugin, adaptateurs détectés, inventaire des événements, santé de l’outbox
`GET`	`/wp-json/tajo/v1/outbox`	Compteurs de l’outbox (les charges utiles ne sont jamais exposées)
`POST`	`/wp-json/tajo/v1/outbox/process`	Traiter un lot immédiatement
`POST`	`/wp-json/tajo/v1/outbox/replay`	Rejouer les dead letters

Dépannage

Symptôme	Cause et solution
Les événements restent en « Queued »	L’endpoint, le binding ID ou le secret ne sont pas encore enregistrés. La livraison est en pause tant que les trois ne sont pas configurés
Les événements restent en « Retrying »	L’endpoint Tajo est injoignable depuis votre hébergement, ou WP-Cron ne tourne pas. Vérifiez la colonne d’erreur de la table outbox et votre configuration cron
Les dead letters s’accumulent	Une erreur non renouvelable, le plus souvent un binding ID ou un secret erroné. Corrigez la configuration, puis utilisez Replay dead letters
« Enter a valid HTTPS Tajo webhook endpoint »	L’endpoint doit être en HTTPS, sans identifiants intégrés
L’événement de test est livré mais rien n’arrive dans Tajo	Vérifiez que vous avez collé le binding ID du workspace et de la connexion Tajo auxquels appartient l’endpoint

Prochaines étapes

Référence du connecteur WooCommerce : synchronisation REST, détails de la signature des webhooks, clés de configuration
Synchronisation client : mapper les clients WooCommerce dans votre système de référence
Configurez dans Tajo les automations de panier abandonné, de post-achat et de reconquête à partir des événements cart.updated, order.placed et order.fulfilled