Stato del lead
lead_statusConsulta l’outreach LinkedIn ed email di un lead: date di contatto, accettazione e azioni in coda. Trovalo tramite profilo LinkedIn, lead_id o email. Il blocco email elenca i suoi indirizzi, le ultime email inviate e ricevute e le email programmate. invitation_status controlla un profilo e i blocchi locali senza scorrere tutti gli inviti. pending è confermato; eligible indica l’idoneità del profilo senza dimostrare l’assenza di inviti; unknown non conferma lo stato attuale. Gli invii precedenti incerti e i periodi di attesa bloccano l’invio. message segue solo il messaggio successivo di linkedin_invite_then_message. message.status=none non dimostra l’assenza di linkedin_message diretto; consulta last_contacted_at. queued indica solo la pianificazione locale.
Quando usarlo
Consulta il mini-profilo, lo stato CRM, lo stato della casella, i tag, le fonti, la relazione, il follow-up e lo stato dei messaggi in coda di un lead.
linkedin:accesssalestouch:useRequisiti
Esempio
Controlla lo stato del lead SalesTouch per https://www.linkedin.com/in/example.
{
"linkedin_url": "https://www.linkedin.com/in/example"
}{
"content": [
{
"type": "text",
"text": "{\n \"data\": { ... },\n \"meta\": null\n}"
}
],
"isError": false
}Risultato atteso: Il record della directory dei lead insieme allo stato attuale della relazione e del contatto.
Parametri
crm_scopestringAmbito CRM: organization, member:<id> o group:<id>. Per impostazione predefinita, il tuo gruppo condiviso o il CRM personale.
account_idstringID, nome utente, e-mail, handle o URL dell’account SalesTouch collegato.
identifierstringHandle, ID pubblico, ID account o URL del profilo del membro LinkedIn.
lead_idstringID canonico del lead SalesTouch restituito da lead_status or leads_search.
followup_idstringID facoltativo del follow-up dopo l’invito.
emailstringEmail del lead. Trova un lead importato o contattato a quell’indirizzo.
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.