Workflow LinkedIn

I workflow MCP più solidi usano chiamate agli strumenti piccole e facili da verificare. Risolvi prima le identità, apporta poi le modifiche e controlla lo stato del lavoro accodato o differito.

Ricercare un prospect e una conversazione

1. Chiama linkedin_accounts quando l’account non è noto.
2. Risolvi il membro con linkedin_lookup_profile.
3. Trova la conversazione con linkedin_conversations_search.
4. Carica il contesto con linkedin_conversations_messages.
5. Chiedi all’agente di riassumere la relazione prima di scrivere qualsiasi cosa.

Prompt:

Inviare a un collegamento esistente

1. Leggi la conversazione o chiama lead_status.
2. Conferma con l’utente il messaggio esatto.
3. Chiama linkedin_message con un membro di destinazione e text.
4. Se SalesTouch richiede l’accodamento, riprova con queue: true.
5. Indica se l’azione è stata inviata o accodata.

Invitare e ricontattare dopo l’accettazione

Usa linkedin_invite_then_message quando il follow-up deve essere eseguito solo dopo l’accettazione dell’invito. Fornisci il destinatario e follow_up_message. La nota dell’invito è facoltativa.

Usa poi lead_status per controllare l’accettazione, il follow-up salvato o lo stato del messaggio in coda.

Pianificare un’azione LinkedIn

Aggiungi scheduled_for a qualsiasi messaggio, invito, sequenza invito e messaggio, Mi piace, commento o post. Usa una data e ora ISO 8601 con fuso orario.

SalesTouch salva subito la richiesta, ma non la esegue mai prima dell’orario indicato. Gli orari di lavoro, i limiti dell’account o un periodo di attesa di LinkedIn possono posticipare il valore effettivo di scheduled_for. Le pianificazioni esplicite hanno la precedenza sulle azioni accodate automaticamente.

La risposta distingue requested_for dal valore effettivo di scheduled_for e indica se l’evento di esecuzione è registered, awaiting_horizon o pending_retry. Le pianificazioni a lungo termine restano salvate in SalesTouch finché non entrano nell’orizzonte di esecuzione.

Gli account LinkedIn con credenziali che sono inattivi si ricollegano quando l’azione è dovuta. I vecchi account basati sui cookie possono ancora richiedere un collegamento manuale.

Interagire con un post

1. Risolvi gli URL ambigui dei post con linkedin_lookup_post.
2. Chiama esattamente un’azione corrispondente: linkedin_like o linkedin_comment.
3. Usa queue: true quando l’azione non può essere eseguita subito.

Evita di chiedere all’agente di “interagire” senza indicare l’azione esatta e il testo del commento.

Estrarre chi ha interagito con un post

1. Risolvi il post con linkedin_lookup_post.
2. Chiama scrape_linkedin_post_reactions o scrape_linkedin_post_comments. L’estrazione dei commenti restituisce per impostazione predefinita gli autori dei commenti principali. Imposta include_replies: true solo quando servono gli autori delle risposte.
3. Leggi l’anteprima incorporata.
4. Se source_paging.exhausted è false, chiama di nuovo scrape_linkedin_post_comments con il valore restituito in source_paging.arguments. L’estrazione LinkedIn riprende dalla posizione salvata e conserva la modalità include_replies originale dopo il budget automatico di sicurezza per le richieste al provider o un’interruzione LinkedIn recuperabile.
5. Usa scrape_result_page con il result_id restituito solo per scorrere i profili già salvati da quella chiamata.
6. Usa i metadati di esportazione quando il set di dati completo deve rimanere fuori dal contesto dell’agente.

Estrarre da una ricerca

• Usa scrape_linkedin_search_url quando hai già un URL di ricerca nativo LinkedIn Classic per persone, aziende, post o lavori.
• Usa scrape_linkedin_people_search, scrape_linkedin_companies_search, scrape_linkedin_posts_search o scrape_linkedin_jobs_search per i filtri strutturati LinkedIn Classic.
• Usa scrape_sales_navigator_search_url quando hai già un URL nativo Sales Navigator per persone o aziende e vuoi che SalesTouch deduca il tipo di risultato.
• Usa scrape_sales_navigator_people per un URL di ricerca lead Sales Navigator o per filtri strutturati sulle persone.
• Usa scrape_sales_navigator_companies per un URL di ricerca aziende Sales Navigator o per filtri strutturati sulle aziende.
• Usa linkedin_sales_navigator_search_parameters per scoprire gli ID specifici dell’account per località, settori, aziende, ruoli e altri filtri enumerati. Imposta product: "classic" per LinkedIn Classic. Il valore predefinito resta Sales Navigator per compatibilità.
• Usa linkedin_lookup_job_posting dopo una ricerca di lavoro per recuperare un annuncio completo, incluse le sezioni facoltative su team di selezione, retribuzione e benefit.
• Imposta preview_limit per mantenere ridotta la risposta incorporata.
• Leggi i risultati salvati per pagine invece di richiedere l’intera estrazione in una sola chiamata.

I valori dei filtri strutturati accettano un id noto o una query leggibile. Una query viene usata automaticamente solo quando risolve un unico valore esatto. Se corrispondono più candidati, riprova con l’ID selezionato.

Esempio: growth hacker a Parigi in aziende con 1-10 dipendenti:

{
  "filters": {
    "current_job_title": { "include": [{ "query": "Growth Hacker" }] },
    "location": { "include": [{ "query": "Paris" }] },
    "company_headcount": [{ "min": 1, "max": 10 }]
  },
  "limit": 100,
  "preview_limit": 20
}

Esempio: aziende di servizi informatici a Parigi, usando il settore LinkedIn come indicatore aziendale:

{
  "filters": {
    "industry": { "include": [{ "query": "IT Services and IT Consulting" }] },
    "location": { "include": [{ "query": "Paris" }] }
  },
  "limit": 1000,
  "preview_limit": 20
}

Esempio: aziende di Parigi che stanno assumendo:

{
  "filters": {
    "location": { "include": [{ "query": "Paris" }] },
    "hiring_on_linkedin": true,
    "department_headcount_growth": {
      "department": [{ "query": "Engineering" }],
      "min": 1
    }
  },
  "limit": 1000,
  "preview_limit": 20
}

Per trovare persone solo all’interno di un risultato di aziende, chiama prima scrape_sales_navigator_companies. Passa quindi il suo result_id come company_result_id a scrape_sales_navigator_people, insieme a filtri per persone come current_job_title. SalesTouch convalida proprietà, scadenza e account LinkedIn del risultato, quindi applica le aziende in batch sicuri.

{
  "company_result_id": "previous_company_result_id",
  "filters": {
    "current_job_title": { "include": [{ "query": "Directeur des ressources humaines" }] }
  },
  "limit": 100,
  "preview_limit": 20
}

Annullare un’azione in coda o un follow-up in attesa

1. Recupera l’identificatore esatto da status o lead_status.
2. Chiama queue_cancel con esattamente uno dei seguenti valori:
   • queued_action_id per annullare un invito, un messaggio o un’altra azione in coda;
   • followup_id per annullare un messaggio automatico in stato waiting_acceptance senza modificare il relativo invito.
3. Comunica il risultato dell’annullamento. Non presumere che una richiesta locale abbia annullato l’azione remota.