Importer ou enrichir des leads
leads_importImportez de nouveaux leads ou enrichissez des contacts existants (jusqu’à 1000 par appel). Utilisez cet outil pour ajouter une adresse e-mail à un lead LinkedIn existant : fournissez son linkedin_url et son email. La recherche porte d’abord sur les adresses e-mail existantes, puis sur les profils LinkedIn ; le nom seul ne permet pas d’identifier un lead. Les champs manquants sont complétés, les valeurs existantes conservées et les tags ajoutés. Seules les données de contact sont enregistrées ; aucun message n’est envoyé.
Quand l’utiliser
Importez de nouveaux leads ou enrichissez des contacts existants, notamment en ajoutant une adresse e-mail à un lead LinkedIn déjà présent dans SalesTouch.
linkedin:accesssalestouch:usePrérequis
Exemple
Importe Grace comme nouveau lead et ajoute ada@example.com au contact LinkedIn existant https://www.linkedin.com/in/example.
{
"leads": [
{
"email": "grace@example.com",
"phone": "+1 202 555 0143",
"first_name": "Grace",
"last_name": "Hopper"
},
{
"linkedin_url": "https://www.linkedin.com/in/example",
"email": "ada@example.com"
}
],
"source_name": "Webinar October",
"tags": [
"Webinar"
]
}{
"content": [
{
"type": "text",
"text": "{\n \"data\": { ... },\n \"meta\": null\n}"
}
],
"isError": false
}Résultat attendu : Le nombre de contacts créés, enrichis et ignorés, les erreurs et avertissements par ligne, ainsi que le lead_id de chaque contact enregistré. Un enrichissement ne signifie pas que les champs existants ont été écrasés.
Paramètres
leadsobligatoirearrayNouveaux leads à importer ou contacts existants à enrichir, au plus 1000 par appel. Chaque ligne doit contenir email ou linkedin_url. Pour ajouter un e-mail à un contact LinkedIn existant, fournissez les deux champs sur la même ligne.
source_namestringNom de l’import enregistré comme source des leads, par exemple le nom d’une liste ou d’un événement.
tagsarrayTags ajoutés à chaque lead importé.
Les alias sont affichés séparément, car les clients MCP envoient un objet JSON plat. Utilisez un seul alias par groupe obligatoire, pas tous les alias.
Erreurs fréquentes
insufficient_scopeReconnectez le MCP et approuvez l’autorisation LinkedIn demandée.
paid_plan_requiredSuivez l’action_url de l’erreur : démarrez l’essai gratuit, choisissez un forfait si l’essai ou l’abonnement a pris fin, ou mettez à jour le moyen de paiement après un échec de paiement. details.reason indique le cas.
trial_payment_method_requiredRéessayez dans une minute si le paiement vient d’être validé ; sinon ajoutez un moyen de paiement dans la facturation SalesTouch pour activer l’essai et l’accès au MCP LinkedIn.
invalid_inputEnvoyez entre 1 et 1000 leads, chacun avec une adresse e-mail ou une URL de profil LinkedIn valide.