SalesTouch Docs
Todas as ferramentas MCP
Somente leituraLinkedIn

Busca de conversas do LinkedIn

linkedin_conversations_search

Encontre conversas de mensagens do LinkedIn por identidade do perfil ou busca local de texto.

Quando usar

Encontre uma conversa a partir da identidade de um perfil ou de texto presente em mensagens recentes.

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

Requisitos

Forneça um membro-alvo, uma consulta ou ambos.
account_id é opcional quando a SalesTouch consegue identificar automaticamente uma conta conectada.

Exemplo

Peça ao seu agente

Encontre minha conversa do LinkedIn com https://www.linkedin.com/in/example.

Argumentos da ferramenta
{
  "linkedin_url": "https://www.linkedin.com/in/example",
  "limit": 5
}
Envelope da resposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: Conversas correspondentes classificadas a partir da análise de conversas recentes.

Parâmetros

account_id
string

ID, nome de usuário, e-mail, identificador ou URL da conta da SalesTouch conectada.

identifier
string

Identificador, ID público, ID da conta ou URL do perfil do membro do LinkedIn.

lead_id
string

ID canônico do lead da SalesTouch. Resolvido localmente antes de qualquer solicitação ao provedor do LinkedIn.

query
string

Text to match against conversations e recent mensagens.

limit
integer

Máximo de conversas a retornar. Padrão: 10.

scan_limit
integer

Máximo de conversas recentes a verificar. Padrão: 100.

message_scan_limit
integer

Máximo de mensagens recentes a verificar. Padrão: 250.

provider_request_limit
integer

Máximo de leituras direcionadas de mensagens durante a filtragem local de texto. Padrão: 8.

inspected_conversation_ids
array

IDs de conversas já verificadas por este fluxo. Eles são preservados e ignorados na retomada.

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.