SalesTouch Docs
Tutti gli strumenti MCP
Scrive su LinkedInLinkedIn

Aggiorna lo stato CRM del lead

lead_crm_status_update

Imposta uno stato CRM manuale per un lead oppure ripristina il monitoraggio automatico dello stato.

Quando usarlo

Qualifica manualmente un lead oppure ripristina l’avanzamento automatico nel CRM.

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

Requisiti

Fornisci lead_id o un membro LinkedIn di destinazione.
Usa uno stato CRM manuale oppure AUTO.

Esempio

Chiedi al tuo agente

Contrassegna questo lead come Interested.

Argomenti dello strumento
{
  "lead_id": "lead_example",
  "crm_status": "Interested"
}
Envelope della risposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Risultato atteso: Lo stato completo e aggiornato del lead, inclusi lo stato della casella e i tag rimasti invariati.

Parametri

crm_scope
string

Ambito CRM: organization, member:<id> o group:<id>. Per impostazione predefinita, il tuo gruppo condiviso o il CRM personale.

account_id
string

ID, nome utente, e-mail, handle o URL dell’account SalesTouch collegato.

identifier
string

Handle, ID pubblico, ID account o URL del profilo del membro LinkedIn.

lead_id
string

ID canonico del lead SalesTouch restituito da lead_status or leads_search.

crm_statusobbligatorio
string

Stato CRM manuale, oppure AUTO per ripristinare lo stato calcolato.

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.