🔌 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 |
| Paiements | PayPlug | Paiement par carte |
| Paiements | Terminal de paiement | Envoyer le montant au terminal du comptoir — voir Terminal de paiement |
| 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 |
| Logiciels partenaires | Iryséon | Ventes de cartes à collectionner, encaissées par Epsylon — voir Iryséon |
| Automatisation | API et notifications | Relier Epsylon à vos autres logiciels (Make, Zapier, n8n…) — voir API et notifications |
ℹ️ PrestaShop. La carte affiche encore « Bientôt », mais le module existe : il se télécharge sur epsylon-cie.fr/prestashop et se branche avec une clé de l'API publique (carte Boutique E-Commerce), comme l'extension WooCommerce.
Toutes les clés secrètes sont chiffrées avant enregistrement et ne ressortent jamais de l'application.
WooCommerce
- Activez l'interrupteur en haut du panneau
- Créez une clé API (bouton + Créer une clé) et reportez-la dans l'extension Epsylon installée sur WordPress
- Choisissez le vendeur par défaut associé aux commandes — le bouton Créer WordPress Bot crée au besoin un utilisateur dédié
- Choisissez le type de document par défaut : Brouillon, Bon de commande ou Facture
- 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
- Créez un compte sur stripe.com
- Renseignez la clé publique (
pk_live_…) et la clé secrète (sk_live_…) - Ajoutez le secret webhook (
whsec_…) et choisissez la devise - 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.
Iryséon
Le logiciel de vente Iryséon (boutiques de cartes à collectionner) a son propre bloc : on y coche ce qu'il a le droit de faire (Encaisser les ventes, Ouvrir et clôturer la caisse), puis on crée un accès dont la clé et le secret se collent dans Iryséon. Les ventes sont numérotées, signées et encaissées par Epsylon. Tout est expliqué dans Iryséon.
API et notifications (Make, Zapier, n8n…)
Pour relier Epsylon à vos autres logiciels (suivi commercial, assistance client…) à travers un outil d'automatisation. Deux blocs :
- Une clé d'API : votre outil peut lire les clients, devis, factures, règlements et réparations du magasin, créer ou modifier une fiche client, et créer un devis brouillon. Il ne peut jamais émettre une facture ni encaisser.
- Des adresses de notification : Epsylon prévient votre outil à chaque événement coché (client créé, devis accepté, facture payée…).
Mode d'emploi complet et exemples de scénarios : API et notifications.
ℹ️ À ne pas confondre avec l'onglet Automatisations ci-dessous, qui envoie des e-mails et SMS à vos clients.
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 et cochez ses permissions. La clé est rattachée à un magasin et ne voit que son catalogue. Une clé peut ensuite être révoquée ou supprimée.
| Permission | Donne accès à |
|---|---|
| Lecture du catalogue | Articles, occasions, magasins, suivi d'une commande par son client |
| Création de commandes | Commandes et paiements de la boutique, retours, locations |
| Modification des articles | Fiches, visuels et documents des articles |
| Modification du stock | Quantités en stock envoyées par un site ou un connecteur |
| Lecture de toutes les commandes | Liste et détail des commandes, avec nom et e-mail des clients (administration du site) |
| Accès complet boutique | Toutes les permissions ci-dessus |
⚠️ Accès complet boutique n'ouvre pas les clients, devis, factures ni réparations. Ces permissions-là servent à relier Epsylon à un CRM et se cochent une par une : voir API et notifications.
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.