Scrive su LinkedInLinkedIn

Chiama uno strumento di dati

data_call

Chiama uno strumento di dati restituito da data_search e pagalo con i crediti agente dello spazio di lavoro. Passa i parametri URL in query e il corpo JSON in body, come mostra data_describe. max_credits limita questa chiamata (2000 crediti per impostazione predefinita); una chiamata stimata oltre il limite viene rifiutata prima di qualsiasi addebito. Restituisce la risposta del fornitore e credits_charged. Un errore del fornitore viene restituito con il suo stato: correggi l’input invece di riprovare alla cieca. Non ripetere mai una chiamata che ha restituito data_result_unknown.

Quando usarlo

Arricchisci un lead o recupera dati esterni e pagali con i crediti agente del tuo spazio di lavoro.

Scope richiesti

linkedin:accesssalestouch:use

Esecuzione

Chiamata sincrona a uno strumento MCP

Requisiti

Indica id da data_search e i parametri mostrati da data_describe.

Lo spazio di lavoro deve avere crediti agente disponibili. Gli analisti non possono spendere crediti.

Esempio

Chiedi al tuo agente

Trova l’email professionale di https://www.linkedin.com/in/example-person con uno strumento di dati.

Argomenti dello strumento

{
  "id": "salestouch.people.email.find",
  "body": {
    "linkedin_url": "https://www.linkedin.com/in/example-person"
  },
  "max_credits": 300
}

Envelope della risposta MCP

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Risultato atteso: La risposta del fornitore, il suo stato HTTP e i crediti addebitati per questa chiamata.

Parametri

NomeTipoDescrizione

idobbligatorio

string

Id dello strumento di dati restituito da data_search.

query

object

Parametri URL, come indicato da data_describe.

body

object

Corpo JSON della richiesta, come indicato da data_describe.

max_credits

number

Numero massimo di crediti che questa chiamata può costare. Predefinito: 2000.

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.

credits_required

Aggiungi crediti agente allo spazio di lavoro in SalesTouch, poi riprova.

data_cost_limit

Aumenta max_credits o restringi la richiesta.

data_result_unknown

Non ripetere la chiamata: ogni addebito viene regolato automaticamente.