Setup

Arricchimento dati (connettore generico)

Punta al tuo provider di arricchimento (Clearbit, Apollo, Hunter, People Data Labs, quello che preferisci) e compila automaticamente i campi vuoti di aziende e contatti.

L'arricchimento dati è un connettore generico e neutro: usi l'account del provider di arricchimento che preferisci (Clearbit, Apollo, Hunter, People Data Labs, tra gli altri). Fornisci l'indirizzo del provider, come autenticarti e una mappatura dei campi; il CRM interroga il provider e compila solo i campi vuoti del record. Non c'è alcun costo da parte nostra, e l'account e la fatturazione appartengono al provider che scegli.

Il connettore parte inattivo: non succede nulla finché non lo configuri. La chiave API che fornisci viene memorizzata cifrata e non viene mai più mostrata.

Prerequisiti

Un account con un provider di arricchimento (Clearbit, Apollo, Hunter, People Data Labs o un altro) con una chiave API attiva e crediti/piano sufficienti.
La documentazione API di quel provider a portata di mano: l'endpoint, l'header di autenticazione (es. Authorization: Bearer, o X-Api-Key) e la struttura del JSON di risposta (per costruire la mappatura).
In Sellio, accesso da amministratore per salvare il connettore in Impostazioni → Integrazioni.

Passo dopo passo dal provider

Accedi alla dashboard del tuo provider di arricchimento e trova l'area API/Sviluppatori.
Genera (o copia) una chiave API.
Annota l'endpoint di interrogazione per dominio e/o email e il formato esatto dell'header di autenticazione richiesto. Ogni provider ha il suo.

Come configurare

Apri Impostazioni → Integrazioni e vai alla scheda "Arricchimento dati".
Endpoint (URL): incolla l'indirizzo del provider usando i segnaposto {domain} e/o {email}. Il CRM sostituisce {domain} con il dominio del record (dal sito web/dominio o dal dominio dell'email) ed {email} con l'email del record.
Header di autenticazione e Prefisso: inserisci il nome dell'header (es. Authorization) e il prefisso del valore (es. "Bearer " con uno spazio). Alcuni provider usano un header proprio, come X-Api-Key, senza prefisso.
Chiave API: incolla la chiave del tuo provider. Viene memorizzata cifrata.
Mappatura dei campi: ogni riga collega un percorso nella risposta del provider (a sinistra) a un campo del CRM (a destra). Aggiungi tutte le righe che ti servono.
Salva il connettore. Poi, nel dettaglio di un'Azienda o un Contatto, usa il pulsante "Arricchisci".

Come costruire la mappatura

Il lato sinistro è il percorso del valore all'interno della risposta JSON del provider, usando i punti per scendere di livello (e numeri per le posizioni negli elenchi). Il lato destro è l'api_name del campo del CRM che riceverà il valore. Vengono compilati solo i campi VUOTI: i dati già presenti nel record non vengono mai sovrascritti.

Example: Endpoint: https://api.provider.com/v1/company?domain={domain} • Header: Authorization • Prefisso: "Bearer " • Mappatura: company.name → name, company.metrics.employees → employee_count, company.location.country → country

💡 Se la risposta restituisce un elenco, usa l'indice: contacts.0.email prende l'email del primo elemento. I valori che sono interi oggetti o elenchi vengono ignorati; solo i valori semplici (testo, numero) entrano in un campo.

Per essere arricchito, il record deve avere almeno un sito web/dominio o un'email, poiché è da lì che provengono {domain}/{email} dell'interrogazione. Le aziende hanno di solito un sito web; contatti e lead, un'email.

Nessun provider proprio: modalità di sistema e modalità simulata

Se non configuri un tuo provider, il pulsante "Arricchisci" resta comunque disponibile. Quando Sellio ha un provider di sistema abilitato, ogni arricchimento compila i campi firmografici standard (dipendenti, fatturato, settore, tecnologie, LinkedIn, paese) e usa 1 credito per record, addebitato in modo trasparente sulla tua fattura. Senza alcun provider, il CRM usa dati campione simulati (senza costo), utili per provare il flusso. La scheda Integrazioni mostra quale modalità è attiva.

Arricchimento massivo e automatico

Massivo: seleziona più record nell'elenco Aziende, Contatti o Lead e clicca su "Arricchisci" nella barra delle azioni. Il CRM li arricchisce tutti insieme, compilando solo i campi vuoti.
Automatico alla creazione: in Impostazioni → Integrazioni, attiva "Arricchisci automaticamente alla creazione del record". Ogni nuova azienda, contatto o lead ha i campi vuoti compilati non appena viene creata.
Recupero giornaliero: una routine automatica esamina i record recenti dei tenant con l'opzione attiva e completa ciò che è in sospeso, entro un limite giornaliero. Rielaborare lo stesso record non addebita mai due volte.

Come testare

Apri un'Azienda che ha un sito web/dominio (o un Contatto con un'email) i cui campi sono parzialmente vuoti.
Clicca su "Arricchisci".
Verifica che i campi vuoti siano stati compilati secondo la tua mappatura. Confronta con la risposta attesa del provider per convalidare i percorsi JSON.

Risoluzione dei problemi

401/403 dal provider: chiave API errata/scaduta o header di autenticazione errato. Controlla il nome dell'header e il prefisso (es. "Bearer " con uno spazio) e incolla di nuovo la chiave.
Nulla viene compilato: verifica che i percorsi della mappatura corrispondano al JSON effettivo del provider (usa i punti per scendere di livello e gli indici per gli elenchi, es. contacts.0.email). Solo i valori semplici (testo/numero) entrano in un campo; interi oggetti/elenchi vengono ignorati.
Alcuni campi non vengono aggiornati anche quando il provider restituisce dati: l'arricchimento scrive solo nei campi VUOTI. Se un campo ha già un valore, viene preservato per progettazione.
Il pulsante "Arricchisci" non fa nulla: verifica che il record abbia un sito web/dominio o un'email (l'interrogazione usa {domain}/{email}) e che l'endpoint usi quei segnaposto.
404/endpoint non valido: rivedi l'URL dell'endpoint e se il provider si aspetta un dominio o un'email nell'interrogazione.

Open this article inside the system →