🔌 Webhooks — créer des commandes depuis n'importe quelle source

À quoi sert le webhook ?

Le webhook est une adresse privée qui appartient à votre compte. Dès qu'un outil externe lui envoie une commande, Polen la crée dans vos Commandes, crée ou met à jour le client, déduit le stock et déclenche vos automatisations d'emails — exactement comme une commande passée sur votre vitrine.

Vous pouvez donc centraliser dans Polen les ventes venant de votre site WordPress, d'une place de marché, d'un fichier tableur automatisé, d'une caisse de marché ou de n'importe quel outil capable d'envoyer une requête.

1. Générer votre clé secrète

Rendez-vous dans Paramètres → Webhook personnalisé et cliquez sur « Générer ». Cette clé identifie votre compte : elle est indispensable pour que Polen accepte les commandes entrantes.

2. Copier votre URL

Une fois la clé générée, Polen affiche l'URL complète à coller dans votre outil externe. C'est la seule information à transmettre : votre outil envoie ses commandes à cette adresse.

Si votre outil préfère une authentification par en-tête, la clé peut aussi être transmise dans un en-tête d'autorisation plutôt que dans l'URL.

3. Tester la connexion

Le bouton « Envoyer une commande test » crée une commande d'exemple sur votre compte et affiche la réponse du serveur. C'est le moyen le plus rapide de vérifier que tout fonctionne avant de brancher votre vrai site.

Pensez à supprimer la commande de test depuis la page Commandes une fois la vérification faite.

Format des commandes envoyées

Chaque commande envoyée contient les informations suivantes :

• •Référence de commande (obligatoire) : l'identifiant côté outil externe
• •Date et statut : payée, en attente ou annulée
• •Client : email (obligatoire), nom, téléphone, particulier ou entreprise, adresse de livraison
• •Lignes de commande : nom du produit, quantité, prix TTC et référence produit éventuelle
• •Montants : total TTC, frais de livraison, TVA, réduction appliquée
• •Notes : commentaire libre repris dans la fiche commande

Le format exact, prêt à copier, est affiché dans la section « Format JSON attendu » de la carte Webhook, dans vos Paramètres.

Comment Polen rapproche les données

• •Commandes : rapprochées par référence. Renvoyer la même référence met à jour la commande existante au lieu d'en créer un doublon — pratique pour synchroniser un changement de statut.
• •Produits : rapprochés d'abord par référence produit Polen, puis par nom. Sans correspondance, la ligne est créée en ligne libre.
• •Clients : rapprochés par email. Un nouveau client est créé automatiquement, un client connu est simplement mis à jour.

Catalogue, générateur & prompt IA

Pour vous éviter tout travail technique, la carte Webhook propose trois aides :

• •Export du catalogue : la liste de vos produits, déclinaisons et réductions avec leurs références Polen, à donner à votre développeur ou à votre outil.
• •Générateur de commande : composez une commande depuis vos vraies données et envoyez-la pour valider le branchement.
• •Prompt IA prêt à coller : un texte à donner à un assistant IA pour qu'il écrive à votre place le code de connexion depuis votre site.

Cas particulier WooCommerce

Si votre boutique tourne sous WooCommerce, une connexion dédiée existe dans vos Paramètres : elle récupère vos commandes et vos clients sans configuration manuelle. Le webhook personnalisé reste utile pour tous les autres outils.