Aller au contenu

🔌 Intégrations

Tout se règle dans Paramètres → Intégrations, qui compte cinq onglets : E-mail, Modèles d'emails, Services, Automatisations et SSO.

E-mail (SMTP)

Le serveur qui envoie vos devis, factures et notifications, magasin par magasin.

Champ Exemple
Nom d'expéditeur Garage du Centre
Hôte SMTP smtp.hostinger.com
Port 587
Utilisateur noreply@mongarage.fr
Mot de passe Mot de passe du compte d'envoi

Enregistrez avec le bouton Enregistrer de la barre d'onglets.

Sans serveur SMTP, les documents restent téléchargeables en PDF et s'envoient depuis votre messagerie habituelle.

L'onglet Modèles d'emails règle, lui, le texte des messages envoyés — deux réglages voisins mais distincts.

Services : la galerie de connecteurs

L'onglet Services présente les connecteurs par catégorie, chacun avec une pastille d'état : Connecté, Non configuré, Bientôt ou Configurer.

Catégorie Connecteur Rôle
E-commerce WooCommerce Synchro commandes & stocks
E-commerce Boutique E-Commerce Clés de l'API publique pour votre site de vente
E-commerce Shopify, PrestaShop Bientôt disponible
Paiements Stripe Paiement par carte
Paiements Alma Paiement en 3x / 4x
Logistique Sendcloud Étiquettes et suivi (Colissimo, Chronopost, Mondial Relay, DPD)
Email & SMS Brevo Email & SMS par magasin
Email & SMS SMS Marketing Campagnes SMS via Brevo
Comptabilité Regate Export des factures vers le cabinet
Comptabilité Atrium Notifications Epsylon envoyées dans vos salons d'équipe

Toutes les clés secrètes sont chiffrées avant enregistrement et ne ressortent jamais de l'application.

WooCommerce

  1. Activez l'interrupteur en haut du panneau
  2. Créez une clé API (bouton + Créer une clé) et reportez-la dans l'extension Epsylon installée sur WordPress
  3. Choisissez le vendeur par défaut associé aux commandes — le bouton Créer WordPress Bot crée au besoin un utilisateur dédié
  4. Choisissez le type de document par défaut : Brouillon, Bon de commande ou Facture
  5. Renseignez éventuellement un email de notification

La synchronisation des stocks et des prix ne se règle pas ici mais dans l'extension WordPress (WooCommerce → Epsylon Sync) : c'est elle qui interroge Epsylon, et non l'inverse. Les commandes web arrivent en brouillon, à contrôler puis valider comme n'importe quel document.

Stripe

  1. Créez un compte sur stripe.com
  2. Renseignez la clé publique (pk_live_…) et la clé secrète (sk_live_…)
  3. Ajoutez le secret webhook (whsec_…) et choisissez la devise
  4. Cliquez sur Configurer Stripe

Dans Stripe, déclarez l'URL de webhook affichée dans le panneau et activez les événements checkout.session.completed et checkout.session.async_payment_failed.

Utilisez les clés de test (pk_test_… / sk_test_…) pendant la mise au point.

Alma

Renseignez votre clé API Alma puis Configurer Alma. L'URL IPN à déclarer chez Alma est affichée dans le panneau. Le paiement fractionné est proposé à partir de 200 € de transaction.

Sendcloud

Le connecteur se règle à deux niveaux : l'enseigne ou ce magasin, avec un sélecteur de portée. Chaque réglage indique s'il est hérité de l'enseigne ou propre au magasin, et un magasin peut choisir Hérite, Oui ou Non.

On y règle : Expédition activée, Mode simulation (aucune étiquette réellement achetée), la clé publique et la clé secrète Sendcloud (leur accès API demande au minimum l'offre Lite), l'adresse expéditeur (son identifiant Sendcloud), le poids par défaut appliqué aux articles sans poids, et le poids d'emballage ajouté une fois par colis.

Brevo et SMS

Brevo utilise votre propre compte : clé API v3, email expéditeur (vérifié chez Brevo) et nom d'expéditeur. Un bouton Tester valide la configuration.

SMS Marketing s'active séparément et demande un nom d'expéditeur affiché sur le téléphone du destinataire.

Regate

L'intégration est temporairement suspendue : Regate n'ouvre pas son API publiquement pour le moment. Les champs sont visibles mais désactivés. En attendant, exportez vos écritures depuis Comptabilité → Exports.

Atrium

Atrium envoie les notifications Epsylon dans vos salons d'équipe. Dans Atrium, créez un webhook (Réglages du salon → Intégrations → Créer un webhook) et collez son URL ici. Chaque destination peut être filtrée par type d'événement (réparations, SAV, documents, paiements, alertes stock, nouveaux clients, marketing, planning) ; aucun événement coché = tous les types.

Automatisations

Réservé au rôle Admin système. Des messages partent tout seuls sur un événement, par email ou SMS :

Déclencheur Quand
Facture payée La facture passe au statut Payé
Réparation terminée La PEC passe au statut Terminé
Client inactif Chaque jour, aux clients sans achat depuis N jours
Anniversaire Le jour de l'anniversaire du client
Relance impayé Facture impayée depuis N jours (inactif par défaut)

Le texte accepte des variables reprises du client, du magasin et du document : {{prenom}}, {{magasin}}, {{numero_doc}}, {{montant_ttc}}, {{reste_a_payer}}…

SSO — Authentification unique (OIDC)

Réservé à la formule Enterprise et au rôle Admin système. Vos collaborateurs se connectent alors avec leur compte d'entreprise (Microsoft, Google, Okta…) plutôt qu'avec un mot de passe Epsylon.

Réglage Description
URL de l'émetteur (Issuer) L'adresse de découverte OIDC de votre fournisseur d'identité. Le bouton Tester vérifie qu'elle répond avant d'enregistrer
Client ID L'identifiant de l'application déclarée chez votre fournisseur
Client Secret Le secret de cette application — chiffré côté serveur, jamais réaffiché ensuite (laissez le champ vide pour le conserver tel quel)
Nom affiché Le nom présenté au moment de se connecter
Domaines email autorisés Séparés par des virgules : seules ces adresses peuvent passer par le SSO. Laissé vide, aucun domaine n'est exclu
Rediriger automatiquement les utilisateurs vers le SSO La connexion part directement chez le fournisseur, sans passer par le formulaire de connexion

L'URL de l'émetteur et le Client ID sont obligatoires ; le secret l'est aussi à la première configuration.

Une fois la configuration enregistrée, elle peut être basculée entre Actif et Désactivé, ou supprimée — dans ce dernier cas, les utilisateurs se reconnectent avec leur mot de passe. Un guide de configuration rapide rappelle les étapes côté Microsoft et Google, ainsi que l'URL de retour à déclarer chez votre fournisseur.

API publique Epsylon

Le connecteur Boutique E-Commerce ouvre l'API REST (base https://app-epsylon.fr/api/public/v1/shop, réponses JSON) qui permet à votre site de vente ou à un outil tiers de lire votre catalogue, vos occasions et votre flotte de location, et de créer des commandes.

Créer une clé

Depuis le panneau, + Créer une clé, puis nommez-la. La clé est rattachée à un magasin et ne voit que son catalogue. Elle est créée avec les permissions de lecture du catalogue, d'écriture des produits et des stocks, et de création de commandes. Une clé peut ensuite être révoquée ou supprimée.

Le secret n'est affiché qu'une seule fois, à la création. Copiez-le immédiatement.

Chaque requête envoie deux en-têtes : X-API-Key et X-API-Secret.

Principaux appels

Méthode Chemin Description
GET /products Lister le catalogue
GET /products/:id Détail d'un produit
GET /products/:id/availability Disponibilité et stock
GET /stores Lister les magasins
POST /orders Créer une commande
GET /orders/:id Suivi d'une commande

Une clé absente ou invalide renvoie 401, une permission insuffisante 403.

Exports comptables

Voir Exports comptables.