Integrations

Connecter l'ERP Bling et synchroniser clients, produits, commandes et factures

Connectez votre compte Bling (un ERP brésilien) au CRM via OAuth et synchronisez clients, produits, commandes de vente et factures dans les deux sens, sans créer de doublons.

Vous pouvez connecter votre compte Bling au CRM. Une fois connecté, le CRM récupère les clients (en tant que Contact ou Entreprise), les produits, les commandes de vente et les factures depuis Bling, en gardant tout lié par l'identifiant Bling. Une nouvelle synchronisation ne crée jamais de doublons : elle met à jour l'enregistrement déjà existant.

Le modèle est « apportez votre propre compte » (BYO) : vous utilisez votre propre compte Bling et votre propre application OAuth. Nous ne voyons jamais vos identifiants et cela n'engendre aucun coût de notre part. L'intégration démarre inerte : rien ne se passe tant que vous n'avez pas configuré les identifiants et activé la connexion.

Prérequis

Un compte Bling avec accès à l'API v3.
Une application créée dans Bling (espace développeur), depuis laquelle vous obtenez le Client ID et le Client Secret, et que vous autorisez pour obtenir le jeton de rafraîchissement OAuth.
Dans Sellio, être administrateur (permission de gérer les paramètres) pour enregistrer les identifiants sous Paramètres → Intégrations.

Étape 1 : créer l'application dans Bling

Dans Bling, ouvrez l'espace applications/développeur et créez une nouvelle application utilisant l'API v3.
Copiez le Client ID et le Client Secret de l'application.
Effectuez l'autorisation OAuth de l'application pour votre compte et conservez le jeton de rafraîchissement généré. Le CRM utilise ce jeton pour renouveler l'accès automatiquement.

Étape 2 : coller les identifiants dans le CRM

Ouvrez Paramètres → Intégrations et trouvez la carte « ERP Bling ».
Collez le Client ID, le Client Secret et le jeton de rafraîchissement. Les identifiants sont stockés chiffrés et ne sont jamais réaffichés.
Sous « Entités et direction », choisissez pour les clients, produits, commandes et factures s'il faut récupérer depuis Bling, envoyer vers Bling, faire les deux sens, ou ne pas synchroniser.
Cliquez sur « Enregistrer la connexion » puis sur « Activer ».

Étape 3 : synchroniser et recevoir les mises à jour

Cliquez sur « Synchroniser maintenant » pour récupérer immédiatement les données depuis Bling. Une synchronisation automatique s'exécute aussi chaque jour.
Pour recevoir les changements quasiment en temps réel, pointez les notifications Bling (webhook) vers l'URL indiquée sur la carte. Elle contient un jeton secret : gardez-le confidentiel.
Nous recommandons vivement de remplir le « Secret du webhook » sur la carte et d'utiliser la même valeur dans Bling. Comme ce webhook ÉCRIT des enregistrements dans votre CRM (contacts, commandes, factures), le secret garantit l'authenticité de chaque appel via une signature (HMAC).

Les clients particuliers deviennent des Contacts et les entreprises deviennent des Entreprises. Chaque produit devient un Produit, chaque commande de vente devient une Commande de vente (liée au client) et chaque facture devient une activité avec le numéro, le montant et le lien DANFE.

Sécurité et confidentialité

Le Client Secret et le jeton de rafraîchissement sont stockés chiffrés et ne sont jamais réaffichés. Le jeton d'accès est renouvelé automatiquement à l'expiration, sans nouvelle autorisation. La connexion démarre inerte et ne se synchronise qu'après avoir été configurée et activée.

💡 Recommandation de sécurité : définissez le « Secret du webhook ». Le webhook Bling ÉCRIT des enregistrements dans votre CRM (contacts, commandes, factures), traitez-le donc comme un point d'entrée de données. Avec le secret, chaque appel est validé par une signature (HMAC) et seul celui qui connaît le secret peut passer. Sans lui, la seule protection est le jeton dans l'URL : si ce jeton fuit, quelqu'un pourrait injecter des données dans votre compte. Ce n'est pas obligatoire, mais fortement recommandé.

Example: URL du webhook à enregistrer dans Bling : https://app.yourcompany.com/api/inbound/bling/YOUR-TOKEN (copiez la valeur exacte indiquée sur la carte).

Comment tester

Après avoir enregistré et activé, cliquez sur « Synchroniser maintenant » et attendez la confirmation.
Ouvrez les listes Contacts, Produits et Commandes de vente et vérifiez que les enregistrements Bling sont apparus.
Sur la carte, observez le compteur « Liens par entité » augmenter au fur et à mesure de la synchronisation.

Dépannage

Rien ne se synchronise : vérifiez que l'intégration est « Activée » et qu'au moins une entité est réglée sur « Récupérer depuis Bling » ou « Deux sens ».
Erreur d'identifiants lors de la synchronisation : ressaisissez le Client ID, le Client Secret et le jeton de rafraîchissement (le Secret et le jeton ne sont jamais renvoyés par le serveur, collez-les donc en entier).
Les enregistrements n'apparaissent pas : vérifiez que les objets Contact, Entreprise, Produit et Commande de vente existent dans votre compte (ce sont des objets standards).
Le webhook n'arrive pas : vérifiez que l'URL enregistrée dans Bling correspond à celle indiquée sur la carte et, si vous avez utilisé un secret de webhook, qu'il est identique des deux côtés.

Open this article inside the system →