SalesTouch Docs
Tutti gli strumenti MCP
Scrive su LinkedInLinkedIn

Importa o aggiorna lead

leads_import

Importa nuovi lead oppure aggiorna e arricchisci contatti esistenti (fino a 1000 per chiamata). Usa questo strumento per aggiungere un’email a un lead LinkedIn esistente: indica linkedin_url ed email. Cerca prima le email esistenti, poi i profili LinkedIn; il solo nome non identifica un lead. Compila i campi vuoti, conserva i valori esistenti e aggiunge tag. Salva solo i dati di contatto; non invia messaggi.

Quando usarlo

Importa nuovi lead o arricchisci contatti esistenti, ad esempio aggiungendo un’email a un lead LinkedIn già presente in SalesTouch.

Scope richiesti
linkedin:accesssalestouch:use
Esecuzione
Chiamata sincrona a uno strumento MCP

Requisiti

Fornisci per ogni lead un indirizzo email o un URL del profilo LinkedIn.
Per un contatto LinkedIn esistente, indica linkedin_url attuale ed email da aggiungere; cercalo prima con leads_search.
I valori esistenti del profilo vengono conservati: si compilano solo i campi vuoti e si aggiungono tag. La ricerca per nome o lead_id non è supportata.
Se l’email e il profilo LinkedIn appartengono a due lead diversi, vengono uniti nel lead LinkedIn e la riga restituisce l’avviso merged_with_existing_linkedin_lead; da quel momento usa il lead_id restituito.
Invia al massimo 1000 lead per chiamata e dividi le liste più lunghe in blocchi.

Esempio

Chiedi al tuo agente

Importa Grace come nuovo lead e aggiungi ada@example.com al contatto LinkedIn esistente https://www.linkedin.com/in/example.

Argomenti dello strumento
{
  "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"
  ]
}
Envelope della risposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Risultato atteso: Il numero di contatti creati, aggiornati e saltati, errori e avvisi per riga e il lead_id di ogni contatto salvato. Un aggiornamento non implica che i campi esistenti siano stati sovrascritti.

Parametri

leadsobbligatorio
array

Nuovi lead da importare o contatti esistenti da arricchire, al massimo 1000 per chiamata. Ogni riga richiede email o linkedin_url. Per aggiungere un’email a un contatto LinkedIn esistente, indica entrambi i campi nella stessa riga.

source_name
string

Nome dell’importazione registrato come origine dei lead, ad esempio il nome di una lista o di un evento.

tags
array

Tag aggiunti a ogni lead importato.

Gli alias sono mostrati separatamente perché i client MCP inviano un oggetto JSON piatto. Usa un solo alias per ogni gruppo obbligatorio, non tutti gli alias.

Errori comuni

insufficient_scope

Ricollega l’MCP e approva l’autorizzazione LinkedIn richiesta.

paid_plan_required

Segui l’action_url dell’errore: avvia la prova gratuita, scegli un piano se la prova o l’abbonamento è terminato, oppure aggiorna il metodo di pagamento dopo un pagamento non riuscito. details.reason indica il caso.

trial_payment_method_required

Riprova tra un minuto se hai appena completato il checkout; altrimenti aggiungi un metodo di pagamento nella fatturazione SalesTouch per attivare la prova e l’accesso all’MCP LinkedIn.

invalid_input

Invia da 1 a 1000 lead, ciascuno con un indirizzo email o un URL del profilo LinkedIn valido.