SalesTouch Docs
Todas as ferramentas MCP
Somente leituraLinkedIn

Conversas do LinkedIn

linkedin_conversations_list

Liste as conversas recentes de mensagens do LinkedIn das contas conectadas.

Quando usar

Leia o feed global unificado de conversas do LinkedIn ou percorra fluxos explícitos do Classic, Sales Navigator, empresa, pasta ou id de caixa.

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

Requisitos

account_id é opcional quando a SalesTouch consegue identificar automaticamente uma conta conectada.
Omita inbox_tags no feed global sem duplicatas; use uma ou mais tags retornadas por linkedin_inboxes_list para restringi-lo.
Reutilize um cursor somente com as mesmas contas, filtros de data/não lidas, seleção de caixas e valor sort_by.

Exemplo

Peça ao seu agente

Liste minhas 20 conversas não lidas mais recentes do LinkedIn e inclua os participantes.

Argumentos da ferramenta
{
  "limit": 20,
  "unread": true,
  "include_participants": true
}
Envelope da resposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: Uma lista paginada estável com metadados de produto/pasta das caixas e um cursor opaco de várias caixas vinculado à consulta.

Parâmetros

account_id
string

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

cursor
string

Cursor de paginação.

before
string

Limite superior de data e hora UTC no formato ISO 8601.

after
string

Limite inferior de data e hora UTC no formato ISO 8601.

inbox_tags
array

Tags legíveis retornadas por linkedin_inboxes_list. Os valores são combinados com OU. Exemplos: classic_primary, sales_navigator, archived, company_primary, company_123_primary, unread. As visualizações derivadas só são consultadas quando a tag da pasta é explícita.

sort_by
string

Use last_message_at para o feed global unificado (default), ou inbox para percorrer os fluxos em ordem determinística de conta/produto/pasta.

limit
integer

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

unread
boolean

Filtrar conversas lidas ou não lidas.

include_participants
boolean

Incluir participantes normalizados da conversa.

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