Invito LinkedIn
linkedin_inviteInvia un invito linkedin direttamente dopo aver risolto l’identità e ottenuto un blocco persistente per destinatario. Gli ID di profilo noti non richiedono un controllo preventivo del profilo né la ricerca negli inviti inviati. Gestisci esplicitamente i rifiuti del provider; un periodo di attesa di 3 settimane non dimostra che un invito sia già in sospeso. Gli invii confermati richiedono un’autorizzazione esplicita per un nuovo invio. Gli esiti incerti bloccano i tentativi successivi.
Quando usarlo
Invia una richiesta di collegamento LinkedIn, facoltativamente con una breve nota.
linkedin:accesssalestouch:useRequisiti
Esempio
Invita https://www.linkedin.com/in/example a collegarsi con la nota «Mi farebbe piacere collegarci.»
{
"linkedin_url": "https://www.linkedin.com/in/example",
"message": "Would love to connect.",
"queue": true
}{
"content": [
{
"type": "text",
"text": "{\n \"data\": { ... },\n \"meta\": null\n}"
}
],
"isError": false
}Risultato atteso: Un risultato di invito inviato o messo in coda.
Parametri
account_idstringID, nome utente, e-mail, handle o URL dell’account SalesTouch collegato.
identifierobbligatoriostringHandle, ID pubblico, ID account o URL del profilo del membro LinkedIn.
queuebooleanImposta true per mettere in coda l’azione quando non può essere eseguita ora.
scheduled_forstringData e ora ISO 8601 futura con fuso orario. L’azione non verrà mai eseguita prima di questo momento e l’accodamento è implicito.
textstringNota di invito facoltativa.
retry_invitationbooleanAutorizzazione 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_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.
action_limit_queue_requiredRipeti la chiamata con queue impostato su true.
invitation_cooldownNon riprovare automaticamente. Consulta lead_status per distinguere un invito in sospeso da una richiesta gestita di recente; un nuovo invio successivo richiede un’autorizzazione esplicita.
invitation_status_unknownLeggi nuovamente lead_status. Non inviare né riprovare automaticamente finché invitation_status è unknown.
invitation_outcome_unknownLeggi nuovamente lead_status. Non inviare né riprovare automaticamente finché invitation_status è unknown.
invitation_note_too_longMantieni la nota sotto i 300 caratteri (200 sugli account gratuiti) o chiama retry_tool con retry_with per inviarla senza nota.
invitation_note_unavailableL’account ha esaurito gli inviti personalizzati. Chiama retry_tool con retry_with per inviare l’invito senza nota.
invitation_limit_reachedL’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_pendingUn invito è già stato inviato. Controlla lead_status; non inviarne un altro.
invitation_requires_emailQuesto membro accetta solo inviti da chi conosce la sua email. Contattalo in un altro modo.