Importer depuis un fichier

Vous pouvez ajouter des leads en masse depuis le tableau de bord sans écrire de code : importez un fichier CSV ou collez une liste JSON. Un import passe par le même chemin que POST /leads/batch, les doublons sont donc fusionnés exactement comme avec l’API.

Ouvrir l’import

1. Allez dans Leads dans le tableau de bord.
2. Cliquez sur Import, à côté de Filter et Export au-dessus du tableau des leads.
3. Choisissez JSON ou CSV, ajoutez vos leads, puis cliquez sur Import.

Les propriétaires et les éditeurs peuvent importer. L’import d’un lecteur est refusé avec Viewer role cannot modify data (voir Team Access).

Limites

La boîte de dialogue affiche votre limite : Max N leads per import.

Plan	Leads par import
Free	100
Pro	500
Scale	500

Pour importer davantage, découpez votre fichier et importez chaque partie. Chaque nouveau lead compte dans la limite de leads de votre plan ; un lead fusionné dans un lead existant ne compte pas.

CSV

Cliquez sur la zone d’import et choisissez un fichier .csv. La boîte de dialogue le lit dans votre navigateur et affiche le nombre de leads valides détectés (N valid leads ready to import) avant tout envoi.

• La première ligne est l’en-tête. Les noms de colonnes ne tiennent pas compte de la casse et les espaces autour sont ignorés.
• Les colonnes sont séparées par des virgules. Entourez une valeur de guillemets doubles pour inclure une virgule ou un saut de ligne, et écrivez un guillemet à l’intérieur d’une valeur entre guillemets sous la forme "".
• Les lignes vides sont ignorées. Les colonnes non listées ci-dessous sont ignorées.
• Si le fichier contient plus de leads valides que votre limite (les lignes sans name ou source ne sont pas comptées), le bouton Import reste désactivé.

Colonnes standard

name et source sont obligatoires. Une ligne sans les deux est ignorée.

Colonne	Remarques
name, source	Obligatoires
email, phone, website, description, category
address, city, state, postal_code, country
latitude, longitude, rating, review_count	Nombres. Une valeur vide, 0 ou non numérique n’est pas reprise.
source_id	Votre propre identifiant, utilisé pour fusionner les doublons
logo_url
tags	Séparés par |, par exemple vip|q3-campaign

name,source,email,city,tags
Acme Corp,trade-show,[email protected],Lyon,vip|q3-campaign
"Beta, Ltd",referral,,Paris,

Les attributs personnalisés, le SIREN et do not contact ne peuvent pas être définis depuis un fichier CSV. Utilisez JSON pour cela.

Exports de scraper Google Maps

Un fichier contenant une colonne title est lu comme un export de scraper Google Maps. Chaque ligne doit avoir un title, qui devient le nom du lead, et source prend la valeur google_maps.

Colonne d’export	Champ du lead
title	name
input_id	source_id
descriptions	description
phone, website, category	même nom
thumbnail	logo_url
review_rating, review_count	rating, review_count
latitude, longitude	même nom
complete_address	address, city, postal_code, state, country, avec les colonnes address, city, postal_code, state et country comme repli
emails	email : la première adresse d’une liste séparée par des virgules ou des points-virgules

JSON

Collez un tableau JSON de leads, ou un seul objet lead, dans la zone de texte. Chaque lead utilise les mêmes champs que Create Lead, JSON peut donc aussi porter tags, des attributes personnalisés, siren et do_not_contact. Donnez à chaque lead un name et un source.

[
  { "name": "Acme Corp", "source": "google", "email": "[email protected]" },
  {
    "name": "Beta Ltd",
    "source": "referral",
    "tags": ["partner"],
    "attributes": [{ "name": "segment", "type": "text", "value": "enterprise" }]
  }
]

Doublons

Chaque lead est comparé à vos leads existants, comme avec l’API (email, SIREN, source_id, puis téléphone avec un nom similaire). En cas de correspondance, le lead existant est mis à jour au lieu d’en créer un nouveau :

• Les valeurs entrantes non vides écrasent les valeurs existantes, sauf le nom, le statut et les coordonnées sur la carte (latitude, longitude), qu’une fusion ne modifie jamais ; les champs que vous omettez restent inchangés.
• Les tags s’ajoutent aux tags existants, ils ne sont jamais remplacés.
• Les attributs personnalisés fusionnent par nom.
• Les champs verrouillés ne sont jamais écrits.
• Un import ne lève jamais do not contact. Un lead marqué "do_not_contact": true en JSON reçoit l’opposition ajoutée.

Les règles complètes sont dans Dédoublonnage.

Résultat

Quand l’import se termine, la boîte de dialogue se ferme, le tableau des leads se recharge et un message affiche Imported X/Y leads. X compte les leads nouveaux et fusionnés. Le message est rouge quand au moins un lead a échoué ; les autres sont enregistrés. Le tableau de bord n’indique pas quelles lignes ont échoué ni pourquoi. Pour voir le résultat lead par lead, envoyez les mêmes leads à POST /leads/batch, qui renvoie une entrée errors pour chaque lead en échec.

Un lead peut échouer quand la limite de leads de votre plan est atteinte, ou quand ses données sont refusées, par exemple un SIREN invalide.

Les règles de scoring s’appliquent à chaque lead importé, et vos webhooks reçoivent leads.created pour les nouveaux leads et leads.updated pour les leads fusionnés.

Erreurs

Message	Cause
No valid rows found	Le CSV n’a aucune ligne avec name et source, ou aucun title pour un export Google Maps.
Max N leads per import	La liste JSON dépasse la limite de votre plan. Rien n’est importé.
Import error	Rien n’est importé. Le détail donne la raison : le JSON n’est pas valide, un website ou un logo_url n’est pas une URL http(s) absolue, l’import dépasse 10 Mo, ou vous êtes lecteur.