Paramètres WordPress et webhooks

Le guide de référence pour aller plus loin après la configuration de base : prérequis, champs de marque, suivi des commandes et solutions en cas de problème.

Prérequis

• WordPress 6.4+ et PHP 8.0+.
• WooCommerce est facultatif. Vous en avez besoin uniquement pour le suivi des achats, et le plugin est compatible HPOS.

Vous utilisez un sous-domaine ?

Si votre boutique fonctionne sur un sous-domaine (comme shop.your-store.com) différent du domaine que vous avez enregistré, ouvrez l’onglet Domaines autorisés dans votre tableau de bord pour l’ajouter avant l’installation. Sinon, le suivi ne pourra pas se connecter.

Champs de marque

Dans Réglages → Frak, sous la section Website Information, vous pouvez choisir ce que vos clients voient dans la fenêtre Frak :

• App Name (Nom de l’application) : correspond par défaut au nom de votre site. Cliquez sur Use Site Name pour le remplir automatiquement.
• Logo URL (URL du logo) : correspond par défaut à l’icône de votre site. Cliquez sur Use Site Icon ou importez votre propre image.

Le reste des textes et des traductions est géré directement depuis le tableau de bord Frak. La page WordPress ne concerne donc que ces deux champs. Cliquez sur Save Settings une fois terminé.

Suivi des commandes avec WooCommerce

Une fois votre clé collée et enregistrée, la section WooCommerce Webhook permet de signaler à Frak chaque nouvelle commande, afin d’attribuer les récompenses sur les ventes réelles.

1. Cliquez sur Set up webhook. (Ce bouton reste désactivé tant que votre compte marchand n’est pas connecté et que la clé n’est pas enregistrée.)
2. Vérifiez la présence du bandeau vert : WooCommerce webhook active. La ligne Secret in WooCommerce doit indiquer matches the secret saved above.

C’est tout. WooCommerce gère automatiquement les tentatives d’envoi et la distribution, vous n’avez donc rien à configurer de plus.

Où trouver ces éléments

• Le webhook lui-même : WooCommerce → Réglages → Avancé → Webhooks.
• Les journaux d’envoi (logs) : WooCommerce → État → Logs, source webhooks-delivery.

Si le bandeau est jaune au lieu de vert, le message vous indique précisément le problème et le bouton sur lequel cliquer (Re-enable webhook, Sync webhook, etc.).

Dépannage

• Le statut indique « Not resolved for this domain ». Ajoutez le domaine de votre site sous Domaines autorisés dans le tableau de bord Frak, puis cliquez sur Refresh Merchant dans la page de configuration du plugin. (Votre domaine principal fonctionne automatiquement, seuls les sous-domaines ont besoin d’être ajoutés.)
• Le suivi s’est arrêté après un changement de domaine. Même solution : ajoutez le nouveau domaine, puis cliquez sur Refresh Merchant. Le webhook se redirigera automatiquement.
• Message « Secret does not match ». Copiez à nouveau la clé depuis la section Purchase Tracker → WooCommerce de votre tableau de bord, collez-la dans Réglages → Frak, enregistrez, puis cliquez sur Sync webhook.
• Alerte « Vendor folder missing ». Vous avez décompressé une version de développement au lieu de la version prête à l’emploi. Téléchargez le fichier frak-integration.zip depuis la page des versions.

Pour les développeurs

Référence du webhook d'achatComment Frak reçoit et vérifie les mises à jour de commandes, pour les intégrations personnalisées.