Guide pratique

Connectez votre site WooCommerce à Casa Signals

Installez le connecteur WordPress Casa Signals, générez la clé API de votre site, activez le suivi et confirmez que les événements WooCommerce atteignent votre tableau de bord.

10 à 20 minutesMis à jour Propriétaires de boutique WooCommerce, administrateurs WordPress et agents d'assistance aidant un client à connecter sa boutique.

Avant de commencer

  • Un compte Casa Signals.
  • Une boutique WooCommerce où vous pouvez vous connecter en tant qu'administrateur WordPress.

Ce que vous aurez à la fin

  • Une connexion au plugin WordPress existe dans Casa Signals pour le bon site.
  • La clé API Casa Signals est enregistrée dans WordPress.
  • Le suivi des événements est activé dans le plugin WordPress.
  • Les nouveaux événements WooCommerce commencent à apparaître dans les analyses Casa Signals, les calendriers des clients, les rapports sur les produits et les déclencheurs de flux.
  • Les produits, utilisateurs et commandes historiques facultatifs peuvent être importés sans déclencher d'automatisations en direct.

Comment fonctionne la connexion

Casa Signals se connecte à WooCommerce via le plugin WordPress Customer Event Sync for Casa Signals. Le plugin suit les activités importantes de WordPress et WooCommerce, met en file d'attente les événements dans WordPress et les envoie à Casa Signals par lots en arrière-plan.

La connexion est authentifiée avec une clé API spécifique au site. Chaque site Casa Signals possède sa propre clé, la clé doit donc provenir du même enregistrement de site que le domaine WooCommerce auquel vous vous connectez.

Le suivi est facultatif. L'installation du plugin ne suffit pas en soi. La clé API doit être enregistrée, le domaine du site doit être correct et Activer le suivi des événements doit être activé.

  • Casa Signals existe.
  • Le plugin WordPress est installé et actif.
  • est collée dans le plugin.
  • Le suivi des événements est activé.
  • L'activité récente apparaît dans Casa Signals.

1. Ajoutez le site WooCommerce dans Casa Signals

  1. Ouvrez le tableau de bord Casa Signals

    Connectez-vous à Casa Signals et ouvrez le tableau de bord. S'il s'agit de la première boutique du compte, le tableau de bord affichera le formulaire Ajouter un domaine.

  2. Entrez le nom du magasin

    Utilisez un nom que votre équipe reconnaîtra, par exemple Sample Store. Ce nom est utilisé dans tout le tableau de bord et peut apparaître dans les aperçus SMS lorsqu'aucun identifiant d'expéditeur approuvé n'est actif.

  3. Entrez le domaine Web

    Saisissez le domaine en direct destiné aux clients, par exemple example.com. N'incluez pas de chemin de paiement, de chemin de produit, de chemin wp-admin ou de paramètres de suivi.

    Utilisez le même domaine que celui que les clients utilisent pour parcourir et acheter. Si le magasin redirige de www vers non-www, ou inversement, utilisez le domaine public final que vous souhaitez que Casa Signals traite comme magasin.

  4. Enregistrez le domaine

    Cliquez sur Ajouter un domaine. La carte du site apparaîtra dans le tableau de bord avec des liens vers Analytics, Clients, Produits, Diffusions, Flux et Paramètres.

2. Générez la clé API du plugin WordPress

  1. Ouvrir les paramètres du site

    Depuis le tableau de bord Casa Signals, ouvrez la carte du site de la boutique WooCommerce et cliquez sur Paramètres.

  2. Trouvez le panneau du plugin WordPress

    Dans Paramètres, recherchez la section Connexion nommée WordPress Plugin. Ce panneau indique si la boutique est connectée, vous permet de générer ou de régénérer la clé API et inclut le téléchargement du plugin.

  3. Générer la clé

    Cliquez sur Générer une clé. Casa Signals crée une nouvelle clé API pour ce site. Si une clé existe déjà et que vous cliquez sur Régénérer la clé, l'ancienne clé active de ce site est remplacée.

  4. Copiez la clé

    Cliquez sur Copier et gardez la clé prête pour WordPress. Traitez-le comme un mot de passe. Toute personne possédant la clé peut soumettre des événements pour ce site Casa Signals.

    • La clé copiée provenait du même site Casa Signals que la boutique WooCommerce.
    • L'état du site indique Connecté ou une clé API est visible.
    • L'utilisateur n'a pas copié de clé d'un autre domaine.

3. Téléchargez et installez le plugin WordPress

  1. Téléchargez le connecteur

    Dans le même panneau du plugin WordPress, cliquez sur Télécharger le plugin. Le fichier est nommé customer-event-sync-casa-signals.zip.

  2. Téléchargez-le sur WordPress

    Dans WordPress, accédez à Plugins -> Ajouter un nouveau plugin -> Télécharger un plugin. Choisissez customer-event-sync-casa-signals.zip, puis cliquez sur Installer maintenant.

  3. Activer le plugin

    Une fois que WordPress a installé le plugin, cliquez sur Activer le plugin. Le nom du plugin est Customer Event Sync for Casa Signals.

  4. Ouvrez les paramètres du plugin

    Depuis l'écran des plugins WordPress, cliquez sur le lien Paramètres sous Customer Event Sync for Casa Signals.

4. Configurez le plugin dans WordPress

  1. Collez la clé API

    Dans le champ Clé API, collez la clé copiée depuis Casa Signals. Si une clé est déjà enregistrée, WordPress affiche un espace réservé masqué afin que la vraie clé ne soit pas exposée dans le formulaire des paramètres.

  2. Confirmez le domaine du site

    Dans Domaine du site, entrez le même domaine que celui enregistré dans Casa Signals. C'est ainsi que les événements entrants sont liés au bon site.

  3. Activer le suivi des événements

    Cochez Activer le suivi des événements. Le plugin ne suit ni n'envoie les événements clients tant que cette option n'est pas activée.

  4. Enregistrer les modifications

    Cliquez sur Enregistrer les modifications. À partir de ce moment, le plugin peut définir des cookies de visiteur et de session propriétaires, mettre en file d'attente les événements des clients et du magasin localement et les envoyer à Casa Signals en arrière-plan.

    • Activer le suivi des événements est coché.
    • est présente.
    • Le domaine du site correspond au site Casa Signals.
    • WooCommerce est actif.

5. Testez la connexion

  1. Créer un nouvel événement client

    Ouvrez la vitrine dans une fenêtre de navigateur privée ou dans un autre navigateur. Affichez un produit, ajoutez-le au panier, affichez le panier, puis lancez le paiement.

    Si possible, entrez une adresse e-mail et un numéro de téléphone lors du paiement. Les flux SMS clients ont besoin d’un numéro de téléphone sur l’événement, et les flux email ont besoin d’une adresse email.

  2. Retour aux Casa Signals

    Ouvrez le tableau de bord du site dans Casa Signals. Une nouvelle activité peut apparaître dans les analyses, les délais des clients, les analyses de produits et l'activité du site en direct.

  3. Attendre la livraison en arrière-plan

    Le plugin met les événements en file d'attente localement et les envoie en utilisant le traitement en arrière-plan de WordPress. Un court délai est normal, surtout si le site a un faible trafic ou si WP-Cron ne s'exécute que lorsque les pages sont visitées.

  4. Vérifiez le panneau de débogage WordPress si nécessaire

    Si les événements n'apparaissent pas, revenez aux paramètres du plugin WordPress, activez le mode Débogage, enregistrez, effectuez une autre action de vitrine, puis inspectez la file d'attente de suivi et la dernière réponse de l'API en arrière-plan sur la page des paramètres.

6. Facultatif : importer des données historiques

Une fois la connexion en direct opérationnelle, les administrateurs WordPress peuvent ouvrir Outils -> Casa Signals Import pour importer les données de catalogue, d'utilisateur et de commande existantes.

Les importations sont conçues pour être idempotentes, donc la réexécution d'une importation ne doit pas dupliquer les mêmes enregistrements historiques. Les événements de commande historiques sont marqués comme remplissage et ne déclenchent pas de flux SMS ou e-mail.

  • Configurez d'abord la clé API.
  • Activez d'abord le suivi des événements.
  • Exécutez les importations de produits, d'utilisateurs et de commandes lorsque le magasin dispose de suffisamment de temps pour les traiter.
  • N'utilisez pas l'outil d'importation comme test d'événement en direct, car les événements importés ignorent intentionnellement les automatisations.

Ce que Casa Signals commence à suivre

Une fois activé, le plugin peut suivre les vues de produits, les recherches de produits, les vues de panier, les événements d'ajout au panier, les événements de suppression du panier, les modifications de quantité de panier, les démarrages de paiement, la capture des contacts de paiement, les mises à jour de l'adresse de paiement, les méthodes de paiement et d'expédition sélectionnées, le placement de commande, les paiements réussis, les paiements échoués, les remboursements, les annulations, l'activité des coupons, les enregistrements de compte, les connexions, les déconnexions, les réinitialisations de mot de passe, les mises à jour de compte, les abonnements, les soumissions de formulaires, l'attribution et la santé du site.

Casa Signals utilise ces événements à des fins d'analyse, de chronologie des clients, de reporting sur les produits, de diffusions, de déclencheurs de flux, de contrôles de suppression et d'attribution de récupération des revenus.

Bonnes pratiques après la connexion

  • Effectuez un véritable test d'achat ou de paiement dans votre mode de test normal de passerelle de paiement WooCommerce, si disponible.
  • Gardez la clé API privée et régénérez-la si elle a été partagée en dehors de votre équipe.
  • Vérifiez Analytics après le premier jour pour confirmer que les événements relatifs au produit, au panier, au paiement et à la commande arrivent.
  • Ajoutez une adresse e-mail de domaine principal dans Paramètres avant d'utiliser les flux de courrier électronique ou les diffusions.
  • Demandez un identifiant d'expéditeur de SMS si vous souhaitez que les messages SMS des clients indiquent le nom de votre marque au lieu de l'expéditeur par défaut.
  • Créez un flux d'abandon de panier uniquement une fois que les événements d'ajout au panier ou de paiement sont visibles.

Dépannage

Aucun événement n'apparaît dans Casa Signals après la configuration.

  • Confirmez que l'option Activer le suivi des événements est cochée dans WordPress.
  • Confirmez que la clé API est enregistrée dans WordPress et provient du bon site Casa Signals.
  • Confirmez que le champ Domaine du site dans WordPress correspond au domaine enregistré dans Casa Signals.
  • Visitez la vitrine et créez un nouvel événement après avoir enregistré les paramètres. L’activité historique antérieure à l’installation n’apparaîtra que si elle est importée.
  • Assurez-vous que WP-Cron est en cours d'exécution. Le connecteur envoie les événements en file d'attente par lots en arrière-plan.

Le plugin est installé mais il n'y a aucune donnée.

  • L'installation du plugin seule ne permet pas le suivi. Ouvrez les paramètres du plugin depuis l'écran des plugins WordPress, collez la clé API, entrez le domaine du site, cochez Activer le suivi des événements et enregistrez.
  • Si le magasin utilise des plugins de sécurité agressive, de mise en cache ou de désactivation du cron, autorisez les requêtes cron et HTTPS sortantes de WordPress vers casasignals.com.

Les événements sont retardés.

  • Un court délai est attendu car le plugin met les événements en file d'attente localement et envoie des lots en arrière-plan.
  • Si les événements restent bloqués, activez le mode débogage et vérifiez le nombre de files d'attente de suivi et la dernière réponse de l'API en arrière-plan.
  • Si DISABLE_WP_CRON est activé, configurez une véritable tâche cron de serveur pour WordPress cron.

Les événements s'affichent sous le mauvais site.

  • La clé API WordPress provient probablement d'un autre site Casa Signals, ou la valeur du domaine du site ne correspond pas au site prévu.
  • Générez une nouvelle clé à partir du bon site dans les paramètres de Casa Signals, collez-la dans WordPress, confirmez le domaine du site et enregistrez.

Les flux SMS clients ne sont pas envoyés après la connexion.

  • La connexion fonctionne peut-être, mais les flux SMS clients nécessitent également un numéro de téléphone client sur l'événement déclencheur.
  • Vérifiez que le flux est actif, dispose de crédits disponibles et n'est pas supprimé car le paiement a réussi pendant le retard.
  • N'oubliez pas qu'un destinataire qui s'est désabonné des SMS pour la boutique sera ignoré.

L'importation est terminée mais aucune automatisation n'a été déclenchée.

  • C'est prévu. L'outil d'importation marque les événements historiques comme remplissage, et Casa Signals ignore l'exécution du flux et le marquage de récupération pour ces événements importés.
  • Utilisez une nouvelle action de vitrine en direct pour tester les automatisations.

FAQ pour les agents d'assistance

Où puis-je trouver la clé API Casa Signals ?

Dans Casa Signals, ouvrez la boutique, accédez à Paramètres, puis recherchez le panneau de connexion du plugin WordPress. Cliquez sur Générer la clé ou Régénérer la clé, puis Copier.

Où sont les paramètres du plugin WordPress ?

Dans WordPress, accédez à Plugins, recherchez Customer Event Sync for Casa Signals et cliquez sur Paramètres.

Le plugin envoie-t-il automatiquement les anciennes commandes ?

Non. Le connecteur en direct envoie de nouveaux événements une fois le suivi activé. Les produits historiques, les utilisateurs et les commandes peuvent être importés depuis Outils -> Casa Signals Import.

L'importation d'anciennes commandes déclenchera-t-elle des flux SMS ou email ?

Non. Les événements d'importation sont marqués comme remplissage. Casa Signals ignore l’automatisation des flux et l’attribution de récupération pour les événements remplis.