SalesTouch Docs
Todas as ferramentas MCP
Somente leituraLinkedIn

Mensagens de uma conversa do LinkedIn

linkedin_conversations_messages

Leia uma página de mensagens do provedor de uma conversa do linkedin identificada por um id de chat ou perfil. order controla apenas a apresentação nessa página; os cursores opacos percorrem páginas mais antigas independentemente de order. Uma página não é o histórico completo.

Quando usar

Carregue uma página do histórico de mensagens do provedor de uma conversa ou membro conhecido.

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

Requisitos

Forneça um linkedin_conversation_id/chat_id/thread_id ou um membro-alvo.
account_id é opcional quando a SalesTouch consegue identificar automaticamente uma conta conectada.
Reutilize o cursor retornado sem alterá-lo, com a mesma conversa e filtros, enquanto has_more for true. Cada continuação carrega uma página mais antiga do provedor independentemente de order; oldest_first é cronológico dentro de cada página, não entre páginas.

Exemplo

Peça ao seu agente

Leia até 50 mensagens com https://www.linkedin.com/in/example, das mais antigas para as mais recentes dentro da página. Enquanto has_more for true, use o cursor retornado para ler páginas mais antigas com as mesmas configurações.

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

Resultado esperado: Uma página de mensagens normalizadas com participantes, cursor e has_more. Uma única página não deve ser tratada como o histórico completo da conversa. Quando ainda não existe conversa com o membro, items fica vazio, conversation é null e conversation_found é false.

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.

cursor
string

Cursor opaco do provedor retornado pela página anterior. Ele recupera páginas mais antigas independentemente de order.

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.

linkedin_conversation_id
string

ID da conversa do LinkedIn ou ID do chat do provedor. Não confunda com conversation_id, que contém a sessão de análise MCP do PostHog.

limit
integer

Máximo de mensagens to return per page. Padrão: 50.

sender_id
string

Filtrar mensagens pelo ID do remetente do provedor.

include_participants
boolean

Incluir participantes normalizados da conversa. Padrão: true.

order
string

Ordem das mensagens apenas dentro de cada página do provedor. Padrão: oldest_first. Não altera o percurso do cursor para páginas mais antigas.

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