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

query
string

Text matched against lead names, headline, LinkedIn URL, e known identities.

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.

last_contacted_from
string

Limite inferior inclusivo for a última mensagem enviada no LinkedIn.

last_contacted_to
string

Limite superior inclusivo for a última mensagem enviada no LinkedIn.

last_inbound_from
string

Limite inferior inclusivo for a última mensagem recebida no LinkedIn.

last_inbound_to
string

Limite superior inclusivo for a última mensagem recebida no LinkedIn.

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

Use um espaço de trabalho da SalesTouch com acesso ao MCP do LinkedIn.

trial_payment_method_required

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