SalesTouch Docs
Todas as ferramentas MCP
Somente leituraLinkedIn

Buscar leads

leads_search

Pesquise no diretório de leads do espaço de trabalho por identidade, status no CRM, status da caixa de entrada, tags, fonte e datas de contato por mensagem.

Quando usar

Encontre e segmente leads já observados pela SalesTouch sem analisar conversas do LinkedIn.

Escopos necessários
linkedin:accesssalestouch:use
Execução
Chamada síncrona de ferramenta MCP

Requisitos

Todos os filtros são opcionais e se aplicam ao espaço de trabalho atual.

Exemplo

Peça ao seu agente

Encontre leads contatados com a tag Founder cuja última mensagem enviada foi nos últimos 90 dias.

Argumentos da ferramenta
{
  "crm_status": [
    "Contacted"
  ],
  "tags_any": [
    "Founder"
  ],
  "limit": 25
}
Envelope da resposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: Uma lista paginada por cursor com miniperfis, status no CRM e na caixa de entrada, tags, datas de contato e resumos das fontes.

Parâmetros

crm_scope
string

Escopo do CRM: organization, member:<id> ou group:<id>. Por padrão, seu grupo compartilhado ou CRM pessoal.

query
string

Texto comparado com os nomes dos leads, o título, a URL do LinkedIn, as identidades conhecidas e os endereços de e-mail.

crm_status
array

Additional tool input.

inbox_status
array

Estado operacional das mensagens: NOT_CONTACTED significa que nenhuma mensagem de saída foi enviada; OUTREACH_SCHEDULED significa que uma mensagem de saída está na fila; AWAITING_PROSPECT_REPLY significa que a última mensagem é nossa; PROSPECT_REPLIED significa que a última mensagem é do prospect.

tags_any
array

Additional tool input.

tags_all
array

Additional tool input.

source_type
string

Tipo exato da origem do lead.

source_id
string

ID exato da origem do lead retornado por lead_status ou leads_search.

has_email
boolean

true para leads com endereço de e-mail, false para os que não têm.

last_contacted_from
string

Limite inferior inclusivo for a última mensagem enviada, no LinkedIn ou por e-mail.

last_contacted_to
string

Limite superior inclusivo for a última mensagem enviada, no LinkedIn ou por e-mail.

last_inbound_from
string

Limite inferior inclusivo for a última mensagem recebida, no LinkedIn ou por e-mail.

last_inbound_to
string

Limite superior inclusivo for a última mensagem recebida, no LinkedIn ou por e-mail.

sort
string

Ordenação dos leads. Padrão: updated_desc.

cursor
string

Cursor opaco de paginação de leads. Reutilize apenas com os mesmos filtros e a mesma ordem.

limit
integer

Máximo de leads a retornar. Padrão: 25.

Os aliases são exibidos separadamente porque os clientes MCP enviam um objeto JSON plano. Use apenas um alias de cada grupo obrigatório, não todos os aliases.

Erros comuns

insufficient_scope

Reconecte o MCP e aprove a permissão solicitada do LinkedIn.

paid_plan_required

Siga a action_url do erro: inicie o período de teste gratuito, escolha um plano se o teste ou a assinatura terminou, ou atualize a forma de pagamento após um pagamento recusado. details.reason indica o caso.

trial_payment_method_required

Tente novamente em um minuto se o checkout acabou de ser concluído; caso contrário, adicione uma forma de pagamento no faturamento da SalesTouch para ativar o período de teste e o acesso ao MCP do LinkedIn.

Nesta página

Quando usarRequisitosExemploParâmetrosErros comunsFerramentas relacionadas