SalesTouch Docs
Tutti gli strumenti MCP
Scrive su LinkedInLinkedIn

Invito LinkedIn e poi messaggio

linkedin_invite_then_message

Invia subito un invito e, dopo l’accettazione del membro, invia automaticamente un messaggio di follow-up.

Quando usarlo

Invita subito un membro e invia automaticamente un follow-up dopo l’accettazione.

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 follow-up con follow_up_message, follow_up_text, message o text.
Il parametro facoltativo follow_up_attachments usa un attachment_id caricato in modo duraturo, 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. I file attendono l’accettazione fino a 90 giorni.
Imposta retry_invitation solo dopo che l’utente ha chiesto esplicitamente di sostituire un workflow di invito in attesa esistente.

Esempio

Chiedi al tuo agente

Invita https://www.linkedin.com/in/example, quindi dopo l’accettazione invia «Grazie per il collegamento.»

Argomenti dello strumento
{
  "linkedin_url": "https://www.linkedin.com/in/example",
  "invite_message": "Would love to connect.",
  "follow_up_message": "Thanks for connecting."
}
Envelope della risposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Risultato atteso: Stato dell’invito e identificatore persistente del follow-up.

Parametri

account_id
string

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

identifierobbligatorio
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.

invite_message
string

Nota di invito facoltativa.

follow_up_message
string

Messaggio da inviare dopo l’accettazione dell’invito. Required unless follow_up_attachments are provided.

follow_up_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 successivo con allegati. I messaggi successivi identici vengono deduplicati per impostazione predefinita.

retry_invitation
boolean

Autorizzazione esplicita per un altro tentativo dopo un invio confermato. Non supera mai gli esiti incerti né il periodo di attesa di 3 settimane registrato; nessuna ricerca completa negli inviti.

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.

invitation_note_too_long

Mantieni la nota sotto i 300 caratteri (200 sugli account gratuiti) o chiama retry_tool con retry_with per inviarla senza nota.

invitation_note_unavailable

L’account ha esaurito gli inviti personalizzati. Chiama retry_tool con retry_with per inviare l’invito senza nota.

invitation_limit_reached

L’account ha raggiunto il limite settimanale di inviti di LinkedIn. Smetti di invitare da questo account per qualche giorno; metti gli inviti in coda o programmali.

invitation_already_pending

Un invito è già stato inviato. Controlla lead_status; non inviarne un altro.

invitation_requires_email

Questo membro accetta solo inviti da chi conosce la sua email. Contattalo in un altro modo.

In questa pagina

Quando usarloRequisitiEsempioParametriErrori comuniStrumenti correlati