Social Commerce

Connecter TikTok Shop à WooCommerce : plugin ou API

Découvrez comment connecter TikTok Shop à WooCommerce avec le plugin officiel, ses limites et les cas où une intégration API sur mesure est préférable.

Photo de profil de Long Nguyen

Long Nguyen

Développeur fullstack · Ingénieur IA · Chercheur

• • 5 min de lecture •

Peut-on connecter TikTok Shop à WooCommerce nativement ?

Oui, mais avec certaines limites. WooCommerce propose une extension officielle TikTok qui synchronise votre catalogue de produits avec TikTok Shop et importe les commandes TikTok dans votre tableau de bord WooCommerce. C’est la manière la plus rapide de connecter TikTok Shop à WooCommerce et, pour un catalogue de petite taille vendu sur un marché pris en charge, c’est souvent tout ce dont vous avez besoin.

Les limites sont plus importantes que la configuration elle-même. Selon la documentation TikTok de WooCommerce, les commandes TikTok Shop sont accessibles en lecture seule dans WooCommerce et doivent être traitées dans TikTok Seller Center. Si votre entrepôt s’appuie sur les statuts de commande WooCommerce, ou si vous vendez sur un marché non couvert par le plugin, il vous faudra plutôt une intégration personnalisée ou tierce.

Trois façons de connecter TikTok Shop à WooCommerce

Toutes les intégrations reposent sur l’une de ces trois approches. Le bon choix dépend de la personne ou du système qui gère l’expédition et du niveau de contrôle dont vous avez besoin sur les données.

Approche Idéale pour Principal compromis
Plugin officiel TikTok for WooCommerce Petits et moyens catalogues, vendeurs prêts à traiter les commandes depuis TikTok Seller Center Les commandes sont en lecture seule dans WooCommerce ; les règles du catalogue sont strictes et la disponibilité régionale est limitée
Application tierce de synchronisation multicanale Vendeurs déjà présents sur plusieurs marketplaces et souhaitant centraliser la gestion Abonnement mensuel et mappage des champs limité à ce que propose le fournisseur
Intégration API personnalisée Sites e-commerce personnalisés, flux de commandes spécifiques, ERP/WMS impliqué, grand nombre de SKU Vous devez la développer et la maintenir, notamment pour le renouvellement des jetons et les changements de version de l’API

Un site personnalisé relève de la même logique que la troisième option. TikTok Shop ne fait pas de différence entre WooCommerce, Django ou une boutique développée sur mesure : la plateforme expose une API, et un système de votre côté doit l’appeler. WooCommerce vous fournit simplement une API REST prête à l’emploi pour cette moitié de la connexion.

Comment connecter TikTok Shop à WooCommerce avec le plugin officiel

Selon la documentation de WooCommerce, la configuration du plugin se déroule dans l’ordre suivant :

  1. Installez et activez l’extension TikTok dans WooCommerce.
  2. Connectez et autorisez votre compte TikTok.
  3. Sélectionnez la fonctionnalité TikTok Shop.
  4. Synchronisez ou créez votre compte TikTok.
  5. Autorisez TikTok For Business.
  6. Créez ou connectez un compte TikTok For Business.
  7. Importez vos documents de vérification KYC.
  8. Renseignez les informations relatives à l’entrepôt.
  9. Attendez l’approbation de TikTok.

La synchronisation de votre catalogue ne commence qu’après la validation du KYC et de l’entrepôt. Les étapes 7 à 9 sont donc celles qui peuvent rallonger le calendrier. Effectuez-les en priorité si vous avez une date de lancement à respecter.

Règles du catalogue pouvant entraîner le rejet des produits

Voici les exigences de catalogue indiquées par WooCommerce. Vérifiez vos données avant la connexion, car elles déterminent quels produits seront réellement visibles.

Champ Exigence
Nom du produit Ne peut pas contenir de caractères non anglais
Images Fond blanc ; au moins 1 et au maximum 9
Description Obligatoire ; limitée à 10 000 caractères

La règle concernant le nom est celle qui surprend le plus les boutiques non anglophones. Si les titres WooCommerce contiennent des accents ou du texte localisé, prévoyez une phase de nettoyage ou un champ distinct pour les titres en anglais.

Où le plugin est-il disponible ?

L’annonce de lancement de WooCommerce datée du indique que l’intégration TikTok Shop était disponible pour les marchands aux États-Unis et au Royaume-Uni. La documentation reste principalement centrée sur les États-Unis. La disponibilité régionale évolue : vérifiez donc que votre marché est pris en charge dans le parcours de configuration du plugin avant de bâtir votre projet autour de cette solution.

Ce qui est synchronisé entre TikTok Shop et WooCommerce — et ce qui ne l’est pas

Données Direction Remarques
Catalogue de produits De WooCommerce vers TikTok Shop Commence après la validation du KYC et de l’entrepôt
Commandes De TikTok Shop vers WooCommerce Lecture seule dans WooCommerce : les détails, actions, articles et champs personnalisés de la commande ne peuvent pas être modifiés
Expédition Effectuée dans TikTok Seller Center Les commandes sont expédiées via la solution d’expédition de TikTok et traitées depuis l’onglet Orders

Relisez attentivement les deux dernières lignes. Tout processus qui dépend de la modification du statut d’une commande WooCommerce pour déclencher l’expédition, la facturation ou l’export vers un entrepôt ne fonctionnera pas pour les commandes TikTok comme pour celles de votre site.

Quand le plugin ne suffit-il pas ?

Optez pour une intégration personnalisée ou tierce dans les cas suivants :

  • Votre entrepôt, votre 3PL ou votre ERP doit recevoir les commandes TikTok et renvoyer les numéros de suivi.
  • Vous vendez dans un pays non pris en charge par le plugin.
  • Vos données produits ne respectent pas les règles du catalogue sans réécriture, notamment lorsque vos titres sont localisés.
  • Vous utilisez un site personnalisé plutôt que WooCommerce, ou vous souhaitez centraliser les commandes de TikTok Shop, de votre boutique et d’autres marketplaces dans un seul flux.

Développer cette solution en interne signifie que vous devrez gérer le renouvellement des jetons, les nouvelles tentatives et le mappage des champs pendant toute la durée de vie de l’intégration. Si vous préférez déléguer cette responsabilité, Netalith développe et maintient des intégrations API TikTok Shop pour WooCommerce et les boutiques personnalisées.

Comment connecter TikTok Shop à WooCommerce ou à un site personnalisé via une API

Une intégration personnalisée comporte deux parties. Toutes deux doivent être fiables, mais une seule est entièrement sous votre contrôle.

Le côté WooCommerce

WooCommerce expose une API REST à l’adresse /wp-json/wc/v3. Selon la documentation de l’API REST WooCommerce, l’authentification s’effectue via HTTPS avec la clé client comme nom d’utilisateur et le secret client comme mot de passe (HTTP Basic Auth). L’ancien mécanisme OAuth 1.0a est requis lorsque vous n’utilisez pas HTTPS. Générez les clés dans WooCommerce, Réglages, Avancé, API REST, et accordez uniquement les permissions nécessaires : lecture pour un processus de reporting, lecture/écriture pour un service de synchronisation.

Deux fonctionnalités assurent l’essentiel du travail :

  • Les webhooks transmettent des événements tels que order.created à votre endpoint, et chaque envoi contient un en-tête X-WC-Webhook-Signature que vous devez vérifier.
  • Les endpoints batch à l’adresse /wc/v3/{resource}/batch acceptent plusieurs opérations dans une seule requête. C’est ainsi que vous pouvez mettre à jour le stock de centaines de SKU sans surcharger le serveur. Les appels de liste simples renvoient 10 éléments par défaut : transmettez donc per_page lorsque vous parcourez les produits par pages.

Le côté TikTok Shop

L’Open API de TikTok Shop est documentée dans TikTok Shop Partner Center. Dans les grandes lignes, vous y enregistrez une application, chaque vendeur l’autorise, puis votre serveur appelle en son nom les endpoints relatifs aux produits, aux commandes et à l’expédition. La signature des requêtes, la durée de vie des jetons et les versions des endpoints sont les éléments susceptibles de changer. Considérez donc la documentation actuelle de Partner Center comme la référence contractuelle et ne réutilisez pas des valeurs issues d’anciens tutoriels.

Un service de synchronisation minimal

L’exemple ci-dessous montre la structure générale de la boucle : vérifier le webhook WooCommerce, puis transmettre une modification de stock à TikTok. La fonction push_stock_to_tiktok est un placeholder pour l’appel à Partner Center que vous devez implémenter à partir de la documentation actuelle.

import base64, hashlib, hmac, requests

WC_BASE = 'https://shop.example.com/wp-json/wc/v3'
WC_AUTH = ('ck_your_consumer_key', 'cs_your_consumer_secret')
WEBHOOK_SECRET = b'your-webhook-secret'


def signature_is_valid(raw_body: bytes, header_value: str) -> bool:
    digest = hmac.new(WEBHOOK_SECRET, raw_body, hashlib.sha256).digest()
    expected = base64.b64encode(digest).decode()
    return hmac.compare_digest(expected, header_value)


def set_woo_stock(updates):
    # updates: [{'id': 123, 'stock_quantity': 8}, ...]
    r = requests.post(f'{WC_BASE}/products/batch', auth=WC_AUTH,
                      json={'update': updates}, timeout=30)
    r.raise_for_status()
    return r.json()


def push_stock_to_tiktok(sku: str, qty: int):
    # Call TikTok Shop's inventory endpoint here (Partner Center docs).
    raise NotImplementedError

Vérifiez la signature à partir du corps brut de la requête avant de l’analyser. Si vous l’analysez d’abord puis le sérialisez à nouveau, les octets seront modifiés et la vérification échouera.

Règles de conception pour éviter les erreurs de synchronisation

La plupart des échecs d’intégration sont dus à des erreurs de modélisation des données plutôt qu’à des problèmes d’API. Voici les règles à définir avant d’écrire le premier appel à un endpoint.

Règle Pourquoi c’est important
Faites le mappage sur le SKU, jamais sur le titre Les titres changent et la règle des noms exclusivement en anglais de TikTok peut imposer un titre différent de celui affiché dans votre boutique
Un seul système doit gérer le stock Si les deux systèmes acceptent des modifications, une vente sur un canal peut écraser silencieusement les données de l’autre et provoquer une survente
Importez les commandes de manière idempotente, en utilisant l’ID de commande TikTok Les webhooks sont renvoyés en cas d’échec et une nouvelle tentative ne doit jamais créer une seconde commande
Conservez une table explicite des statuts TikTok, WooCommerce et votre entrepôt utilisent des vocabulaires différents : documentez le mappage au lieu de le déduire
Placez chaque appel sortant dans une file et utilisez des nouvelles tentatives avec backoff Les limites de débit et les interruptions momentanées sont normales, et un appel échoué ne doit pas faire perdre une modification de stock
Traitez les annulations et les remboursements comme des événements à part entière Ils inversent les mouvements de stock : les ignorer crée des écarts qui peuvent ne devenir visibles que plusieurs semaines plus tard

Dans la pratique, procédez dans cet ordre : mappage des SKU, définition du système responsable du stock, import des commandes, puis répercussion de l’expédition. Les équipes qui commencent par la répercussion de l’expédition finissent par la déboguer sur un catalogue qui ne correspond pas.

Problèmes fréquents après la connexion de TikTok Shop à WooCommerce

Symptôme Cause probable Solution
Les produits n’apparaissent jamais sur TikTok Shop La validation du KYC ou de l’entrepôt est toujours en attente Terminez les étapes 7 à 9 de la configuration et attendez l’approbation de TikTok
Certains produits sont rejetés Caractères non anglais dans le nom, fonds d’image non blancs, image ou description manquante Corrigez les données conformément aux règles du catalogue ci-dessus
Vous ne pouvez pas modifier ou expédier une commande TikTok dans WooCommerce Les commandes y sont accessibles en lecture seule Traitez la commande depuis l’onglet Orders de TikTok Seller Center ou développez une intégration qui répercute les informations d’expédition
L’extension n’est pas proposée dans votre pays Disponibilité régionale Vérifiez la disponibilité pour votre marché dans le parcours de configuration ; sinon, utilisez une synchronisation tierce ou développez une intégration API personnalisée

Choisir la prochaine étape

Si vous vendez un catalogue modeste sur un marché pris en charge et pouvez traiter les commandes depuis Seller Center, installez le plugin officiel et validez d’abord le KYC ainsi que l’entrepôt. Si vos commandes doivent passer par votre propre entrepôt, votre ERP ou votre site personnalisé, prévoyez une intégration sur mesure et définissez les règles de données ci-dessus avant d’écrire du code.

Vous ne savez pas quelle solution choisir ? Demandez un devis gratuit en décrivant votre boutique, votre marché et votre processus de traitement des commandes.

FAQ

Questions fréquentes

Puis-je connecter TikTok Shop à WooCommerce sans plugin ?

Oui. Vous pouvez développer une intégration personnalisée qui appelle l’Open API de TikTok Shop depuis votre serveur et utilise l’API REST ainsi que les webhooks de WooCommerce côté boutique. Vous bénéficiez d’un contrôle total sur la gestion des commandes et la répercussion des informations d’expédition, mais vous devez gérer vous-même le renouvellement des jetons, les nouvelles tentatives et les changements de version de l’API.

Le plugin TikTok for WooCommerce synchronise-t-il les commandes avec WooCommerce ?

Oui, les commandes TikTok Shop sont synchronisées avec votre tableau de bord WooCommerce, mais elles y sont accessibles en lecture seule. Le traitement des commandes s’effectue dans TikTok Seller Center, depuis l’onglet Orders, avec la solution d’expédition de TikTok.

Pourquoi mon produit WooCommerce n’apparaît-il pas sur TikTok Shop ?

Vérifiez que la validation du KYC et de l’entrepôt est terminée, puis contrôlez les règles du catalogue : aucun caractère non anglais dans le nom du produit, images sur fond blanc (de 1 à 9) et description de 10 000 caractères maximum.

Puis-je connecter TikTok Shop à un site personnalisé qui n’utilise pas WooCommerce ?

Oui. TikTok Shop s’intègre via son API : toute boutique qui possède ses propres données produits, de stock et de commandes peut donc être connectée. Vous devez mettre en place la même boucle de synchronisation : mapper les produits par SKU, désigner un seul système comme responsable du stock, importer les commandes de manière idempotente et répercuter les informations d’expédition.

L’intégration TikTok Shop pour WooCommerce est-elle disponible dans tous les pays ?

Non. L’annonce de lancement de WooCommerce indiquait une disponibilité pour les marchands aux États-Unis et au Royaume-Uni, tandis que sa documentation reste principalement centrée sur les États-Unis. La disponibilité évolue : vérifiez donc que votre marché est pris en charge dans le parcours de configuration du plugin avant de planifier votre projet.

Restez informé avec Netalith

Recevez des ressources de développement, des mises à jour produit et des offres spéciales directement dans votre boîte mail.