SalesTouch Docs
Tous les outils MCP
Écrit sur LinkedInLinkedIn

Importer ou enrichir des leads

leads_import

Importez 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.

Scopes requis
linkedin:accesssalestouch:use
Exécution
Appel d’outil MCP synchrone

Prérequis

Donnez à chaque lead une adresse e-mail ou une URL de profil LinkedIn.
Pour un contact LinkedIn existant, fournissez son linkedin_url actuel et l’email à ajouter ; utilisez d’abord leads_search pour le retrouver.
Les valeurs du profil existantes sont conservées : seuls les champs manquants sont complétés et les tags ajoutés. La recherche par nom ou lead_id n’est pas prise en charge.
Si l’adresse e-mail et le profil LinkedIn appartiennent à deux leads différents, ils sont fusionnés dans le lead LinkedIn et la ligne renvoie un avertissement merged_with_existing_linkedin_lead ; utilisez ensuite le lead_id renvoyé.
Envoyez au plus 1000 leads par appel et découpez les listes plus longues en lots.

Exemple

Demandez à votre agent

Importe Grace comme nouveau lead et ajoute ada@example.com au contact LinkedIn existant https://www.linkedin.com/in/example.

Arguments de l’outil
{
  "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"
  ]
}
Enveloppe de réponse MCP
{
  "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

leadsobligatoire
array

Nouveaux 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_name
string

Nom de l’import enregistré comme source des leads, par exemple le nom d’une liste ou d’un événement.

tags
array

Tags 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_scope

Reconnectez le MCP et approuvez l’autorisation LinkedIn demandée.

paid_plan_required

Suivez 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_required

Ré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_input

Envoyez entre 1 et 1000 leads, chacun avec une adresse e-mail ou une URL de profil LinkedIn valide.