SalesTouch Docs
Tutti gli strumenti MCP
Scrive su LinkedInLinkedIn

Messaggio LinkedIn

linkedin_message

Invia un messaggio diretto LinkedIn a un membro di destinazione.

Quando usarlo

Invia un messaggio diretto a un collegamento LinkedIn esistente o a una conversazione nota.

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

Requisiti

Fornisci un membro di destinazione: identifier, recipient, linkedin_url, profile_url o handle.
Fornisci il contenuto del messaggio con text, message o content.
Il parametro facoltativo attachments usa un attachment_id caricato, content_base64 o una url HTTPS pubblica. Massimo 5 file e 60 MB totali; content_base64 inline è limitato a 3 MB per richiesta, quindi invia i file più grandi tramite url o attachment_id. HTML e percorsi locali non sono supportati. Riutilizza idempotency_key nei nuovi tentativi.

Esempio

Chiedi al tuo agente

Invia «Grazie per il collegamento, mi farà piacere confrontarci.» a https://www.linkedin.com/in/example.

Argomenti dello strumento
{
  "linkedin_url": "https://www.linkedin.com/in/example",
  "text": "Thanks for connecting, happy to compare notes.",
  "queue": true
}
Envelope della risposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Risultato atteso: Un risultato di messaggio inviato o messo in coda con il relativo identificatore dell’azione.

Parametri

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.

queue
boolean

Imposta true per mettere in coda l’azione quando non può essere eseguita ora.

scheduled_for
string

Data e ora ISO 8601 futura con fuso orario. L’azione non verrà mai eseguita prima di questo momento e l’accodamento è implicito.

text
string

Testo del messaggio da inviare. Required unless attachments are provided.

attachments
array

Allegati nativi: massimo 5 file e 60 MB totali. Usa un attachment_id caricato, un URL HTTPS pubblico o byte base64; il base64 inline è limitato a 3 MB per richiesta, quindi invia i file più grandi tramite url o attachment_id. Percorsi locali e HTML non sono supportati. Carica i file selezionati tramite /api/linkedin/attachments nell’app e passa il loro attachment_id.

idempotency_key
string

Chiave stabile del messaggio con allegati, massimo 120 caratteri. La stessa chiave e contenuto non generano due invii. Senza chiave, i messaggi identici vengono deduplicati; cambiala consapevolmente solo per un nuovo invio.

linkedin_conversation_id
string

ID facoltativo di una conversazione LinkedIn esistente. conversation_id è riservato alla sessione di analisi MCP.

bypass_rate_limit
boolean

Ignora il comportamento della coda basato sulle risposte. I messaggi ai lead che hanno già risposto ignorano per impostazione predefinita i limiti degli invii in coda, salvo che sia impostato queue o scheduled_for.

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.

action_limit_queue_required

Ripeti la chiamata con queue impostato su true.

message_requires_connection

Il membro non è un collegamento di 1° grado e l’account non può inviargli un InMail. Chiama retry_tool (linkedin_invite_then_message) con retry_with; non riprovare linkedin_message.

inmail_credits_exhausted

L’account non ha più crediti InMail. Usa linkedin_invite_then_message o attendi la ricarica dei crediti.

message_too_long

Accorcia il testo e invialo di nuovo.

recipient_unreachable

LinkedIn non recapiterà messaggi a questo membro da questo account. Non riprovare.

In questa pagina

Quando usarloRequisitiEsempioParametriErrori comuniStrumenti correlati