Importa o aggiorna lead
leads_importImporta 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.
linkedin:accesssalestouch:useRequisiti
Esempio
Importa Grace come nuovo lead e aggiungi ada@example.com al contatto LinkedIn esistente 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
}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
leadsobbligatorioarrayNuovi 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_namestringNome dell’importazione registrato come origine dei lead, ad esempio il nome di una lista o di un evento.
tagsarrayTag 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_scopeRicollega l’MCP e approva l’autorizzazione LinkedIn richiesta.
paid_plan_requiredSegui 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_requiredRiprova 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_inputInvia da 1 a 1000 lead, ciascuno con un indirizzo email o un URL del profilo LinkedIn valido.