Fluxos de trabalho do LinkedIn

Os fluxos MCP mais sólidos usam chamadas de ferramentas pequenas e fáceis de inspecionar. Resolva primeiro as identidades, faça as alterações depois e verifique o estado dos trabalhos colocados na fila ou adiados.

Pesquisar um prospect e uma conversa

1. Chame linkedin_accounts quando a conta for desconhecida.
2. Resolva o membro com linkedin_lookup_profile.
3. Encontre a conversa com linkedin_conversations_search.
4. Carregue o contexto com linkedin_conversations_messages.
5. Peça para o agente resumir o relacionamento antes de redigir qualquer coisa.

Prompt:

Enviar para uma conexão existente

1. Leia a conversa ou chame lead_status.
2. Confirme a mensagem exata com o usuário.
3. Chame linkedin_message com um membro-alvo e text.
4. Se a SalesTouch exigir a fila, tente novamente com queue: true.
5. Informe se a ação foi enviada ou colocada na fila.

Convidar e acompanhar após a aceitação

Use linkedin_invite_then_message quando o acompanhamento só deve ser executado depois que o convite for aceito. Forneça o alvo e follow_up_message. A nota do convite é opcional.

Depois, use lead_status para verificar a aceitação do convite, o acompanhamento salvo ou o estado da mensagem na fila.

Agendar uma ação do LinkedIn

Adicione scheduled_for a qualquer mensagem, convite, sequência de convite e mensagem, curtida, comentário ou publicação. Use uma data e hora ISO 8601 com fuso horário.

A SalesTouch salva a solicitação imediatamente, mas nunca a executa antes do horário solicitado. Horários de trabalho, limites da conta ou um período de espera do LinkedIn podem adiar o valor efetivo de scheduled_for. Agendamentos explícitos têm prioridade sobre ações colocadas automaticamente na fila.

A resposta diferencia requested_for do valor efetivo de scheduled_for e informa se o evento de execução está registered, awaiting_horizon ou pending_retry. Agendamentos de longo prazo permanecem salvos na SalesTouch até entrarem no horizonte de execução.

Contas do LinkedIn com credenciais que estejam inativas se reconectam quando a ação vence. Contas antigas baseadas em cookies ainda podem exigir uma reconexão manual.

Interagir com uma publicação

1. Resolva URLs de publicações ambíguas com linkedin_lookup_post.
2. Chame exatamente uma ação correspondente: linkedin_like ou linkedin_comment.
3. Use queue: true quando a ação não puder ser executada imediatamente.

Evite pedir para o agente apenas “interagir” sem especificar a ação exata e o texto do comentário.

Extrair pessoas que interagiram com uma publicação

1. Resolva a publicação com linkedin_lookup_post.
2. Chame scrape_linkedin_post_reactions ou scrape_linkedin_post_comments. A extração de comentários retorna por padrão os autores dos comentários principais. Defina include_replies: true apenas quando precisar dos autores das respostas.
3. Leia a prévia embutida.
4. Se source_paging.exhausted for false, chame scrape_linkedin_post_comments novamente com o valor retornado em source_paging.arguments. A extração continua da posição salva e preserva o modo include_replies original depois que o orçamento automático de segurança para solicitações ao provedor é atingido ou após uma interrupção recuperável do LinkedIn.
5. Use scrape_result_page com o result_id retornado apenas para paginar os perfis já salvos por essa chamada.
6. Use os metadados de exportação quando o conjunto completo de dados precisar ficar fora do contexto do agente.

Extrair de uma pesquisa

• Use scrape_linkedin_search_url quando já tiver uma URL nativa de pesquisa do LinkedIn Classic para pessoas, empresas, publicações ou vagas.
• Use scrape_linkedin_people_search, scrape_linkedin_companies_search, scrape_linkedin_posts_search ou scrape_linkedin_jobs_search para filtros estruturados do LinkedIn Classic.
• Use scrape_sales_navigator_search_url quando já tiver uma URL nativa do Sales Navigator para pessoas ou empresas e quiser que a SalesTouch descubra o tipo de resultado.
• Use scrape_sales_navigator_people para uma URL de pesquisa de leads do Sales Navigator ou filtros estruturados de pessoas.
• Use scrape_sales_navigator_companies para uma URL de pesquisa de empresas do Sales Navigator ou filtros estruturados de empresas.
• Use linkedin_sales_navigator_search_parameters para descobrir IDs específicos da conta para locais, setores, empresas, cargos e outros filtros enumerados. Defina product: "classic" para o LinkedIn Classic. O padrão continua sendo Sales Navigator por compatibilidade.
• Use linkedin_lookup_job_posting após uma pesquisa de vagas para buscar um anúncio completo, incluindo seções opcionais de equipe de contratação, salário e benefícios.
• Defina preview_limit para manter pequena a resposta embutida.
• Percorra os resultados salvos em vez de solicitar toda a extração em uma única chamada.

Os valores de filtros estruturados aceitam um id conhecido ou uma query legível. Uma consulta só é usada automaticamente quando resolve um único valor exato. Se vários candidatos corresponderem, tente novamente com o ID escolhido.

Exemplo: growth hackers em Paris em empresas com 1 a 10 funcionários:

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

Exemplo: empresas de serviços de TI em Paris, usando o setor do LinkedIn como aproximação de negócio:

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

Exemplo: empresas em Paris que estão contratando:

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

Para encontrar pessoas apenas dentro de um resultado de empresas, primeiro chame scrape_sales_navigator_companies. Depois, passe seu result_id como company_result_id para scrape_sales_navigator_people, junto com filtros de pessoas como current_job_title. A SalesTouch valida a propriedade do resultado, a validade e a conta do LinkedIn, e aplica as empresas em lotes seguros.

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

Cancelar uma ação na fila ou um acompanhamento pendente

1. Obtenha o identificador exato em status ou lead_status.
2. Chame queue_cancel com exatamente um destes valores:
   • queued_action_id para cancelar um convite, uma mensagem ou outra ação na fila;
   • followup_id para cancelar uma mensagem automática em waiting_acceptance sem alterar o convite.
3. Informe o resultado do cancelamento. Não suponha que uma solicitação local cancelou a ação remota.