Integrations

Collega Bling ERP e sincronizza clienti, prodotti, ordini e fatture

Collega il tuo account Bling (un ERP brasiliano) al CRM tramite OAuth e sincronizza clienti, prodotti, ordini di vendita e fatture in entrambe le direzioni, senza creare duplicati.

Puoi collegare il tuo account Bling al CRM. Una volta collegato, il CRM importa da Bling clienti (come Contatto o Azienda), prodotti, ordini di vendita e fatture, mantenendo tutto collegato tramite l'id Bling. Una nuova sincronizzazione non crea mai duplicati: aggiorna il record già esistente.

Il modello è BYO ("porta il tuo account"): usi il tuo account Bling e la tua app OAuth. Non vediamo mai le tue credenziali e non c'è alcun costo da parte nostra. L'integrazione parte inerte: non succede nulla finché non configuri le credenziali e la attivi.

Requisiti

Un account Bling con accesso all'API v3.
Un'app creata in Bling (area sviluppatori), da cui ottieni il Client ID e il Client Secret, autorizzata a ottenere il refresh token OAuth.
In Sellio, essere amministratore (permesso di gestione impostazioni) per salvare le credenziali in Impostazioni → Integrazioni.

Passo 1: crea l'app in Bling

In Bling, apri l'area app/sviluppatori e crea una nuova app usando l'API v3.
Copia il Client ID e il Client Secret dell'app.
Esegui l'autorizzazione OAuth dell'app per il tuo account e conserva il refresh token generato. Il CRM usa il refresh token per rinnovare l'accesso in autonomia.

Passo 2: incolla le credenziali nel CRM

Apri Impostazioni → Integrazioni e trova la scheda "ERP Bling".
Incolla il Client ID, il Client Secret e il refresh token. Le credenziali vengono memorizzate cifrate e non vengono mai più mostrate.
In "Entità e direzione", scegli per clienti, prodotti, ordini e fatture se importare da Bling, esportare verso Bling, entrambe le direzioni o non sincronizzare.
Clicca su "Salva connessione" e poi su "Attiva".

Passo 3: sincronizza e ricevi aggiornamenti

Clicca su "Sincronizza ora" per importare subito i dati da Bling. Viene eseguita anche una sincronizzazione automatica giornaliera.
Per ricevere le modifiche quasi in tempo reale, punta le notifiche Bling (webhook) all'URL mostrato sulla scheda. Contiene un token segreto: tienilo privato.
Raccomandiamo fortemente di compilare il "Segreto webhook" sulla scheda e di usare lo stesso valore in Bling. Poiché questo webhook SCRIVE record nel tuo CRM (contatti, ordini, fatture), il segreto garantisce l'autenticità di ogni chiamata tramite una firma (HMAC).

I clienti privati diventano Contatti e le aziende diventano Aziende. Ogni prodotto diventa un Prodotto, ogni ordine di vendita diventa un Ordine di vendita (collegato al cliente) e ogni fattura diventa un'attività con numero, importo e link alla DANFE.

Sicurezza e privacy

Il Client Secret e il refresh token vengono memorizzati cifrati e non vengono mai mostrati. Il token di accesso viene rinnovato automaticamente alla scadenza, senza dover riautorizzare. La connessione parte inerte e sincronizza solo dopo essere stata configurata e attivata.

💡 Consiglio di sicurezza: imposta il "Segreto webhook". Il webhook Bling SCRIVE record nel tuo CRM (contatti, ordini, fatture), quindi trattalo come un punto di ingresso dati. Con il segreto, ogni chiamata viene validata da una firma (HMAC) e passa solo chi conosce il segreto. Senza di esso, l'unica protezione è il token nell'URL: se quel token trapela, qualcuno potrebbe iniettare dati nel tuo account. Non è obbligatorio, ma è fortemente consigliato.

Example: URL webhook da registrare in Bling: https://app.yourcompany.com/api/inbound/bling/YOUR-TOKEN (copia il valore esatto mostrato sulla scheda).

Come testare

Dopo aver salvato e attivato, clicca su "Sincronizza ora" e attendi la conferma.
Apri gli elenchi Contatti, Prodotti e Ordini di vendita e verifica che i record di Bling siano comparsi.
Sulla scheda, osserva crescere il contatore "Collegamenti per entità" man mano che i dati vengono sincronizzati.

Risoluzione dei problemi

Non sincronizza nulla: conferma che l'integrazione sia "Attiva" e che almeno un'entità sia impostata su "Importa da Bling" o "Entrambe le direzioni".
Errore di credenziali durante la sincronizzazione: reinserisci il Client ID, il Client Secret e il refresh token (il Secret e il token non vengono mai restituiti dal server, quindi incollali per intero).
I record non compaiono: verifica che gli oggetti Contatto, Azienda, Prodotto e Ordine di vendita esistano nel tuo account (sono standard).
Il webhook non arriva: verifica che l'URL registrato in Bling corrisponda a quello mostrato sulla scheda e, se hai usato un segreto webhook, che sia lo stesso su entrambi i lati.

Open this article inside the system →