Solo lecturaLinkedIn

Mensajes de una conversación de LinkedIn

linkedin_conversations_messages

Lee una página de mensajes del proveedor de una conversación de linkedin identificada por un id de chat o perfil. order solo controla la presentación dentro de esa página; los cursores opacos recorren páginas más antiguas independientemente de order. Una página no es el historial completo.

Cuándo usarla

Carga una página del historial de mensajes del proveedor de una conversación o miembro conocido.

Scopes necesarios

linkedin:accesssalestouch:use

Ejecución

Llamada síncrona a una herramienta MCP

Requisitos

Proporciona un linkedin_conversation_id/chat_id/thread_id o un miembro objetivo.

account_id es opcional cuando SalesTouch puede resolver automáticamente una cuenta conectada.

Reutiliza el cursor devuelto sin modificarlo con la misma conversación y filtros mientras has_more sea true. Cada continuación carga una página más antigua del proveedor independientemente de order; oldest_first es cronológico dentro de cada página, no entre páginas.

Ejemplo

Pídeselo a tu agente

Lee hasta 50 mensajes con https://www.linkedin.com/in/example, del más antiguo al más reciente dentro de la página. Mientras has_more sea true, usa el cursor devuelto para leer páginas más antiguas con los mismos ajustes.

Argumentos de la herramienta

{
  "identifier": "https://www.linkedin.com/in/example",
  "limit": 50,
  "order": "oldest_first"
}

Envoltorio de respuesta MCP

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: Una página de mensajes normalizados con participantes, cursor y has_more. Una sola página no debe considerarse el historial completo de la conversación. Si aún no existe una conversación con el miembro, items está vacío, conversation es null y conversation_found es false.

Parámetros

NombreTipoDescripción

account_id

string

ID, nombre de usuario, correo, identificador o URL de la cuenta de SalesTouch conectada.

identifier

string

Identificador, ID público, ID de cuenta o URL de perfil del miembro de LinkedIn.

lead_id

string

ID canónico del lead de SalesTouch. Se resuelve localmente antes de cualquier solicitud al proveedor de LinkedIn.

cursor

string

Cursor opaco del proveedor devuelto por la página anterior. Recupera páginas más antiguas independientemente de order.

before

string

Límite superior de fecha y hora UTC en formato ISO 8601.

after

string

Límite inferior de fecha y hora UTC en formato ISO 8601.

linkedin_conversation_id

string

ID de conversación de LinkedIn o ID de chat del proveedor. No lo confundas con conversation_id, que contiene la sesión analítica MCP de PostHog.

limit

integer

Máximo de mensajes to return per page. Valor predeterminado: 50.

sender_id

string

Filtrar mensajes por ID de remitente del proveedor.

include_participants

boolean

Incluir participantes normalizados de la conversación. Valor predeterminado: true.

order

string

Orden de los mensajes solo dentro de cada página del proveedor. Valor predeterminado: oldest_first. No cambia el recorrido del cursor hacia páginas más antiguas.

Los alias se muestran por separado porque los clientes MCP envían un objeto JSON plano. Usa un solo alias de cada grupo obligatorio, no todos los alias.

Errores frecuentes

insufficient_scope

Vuelve a conectar el MCP y aprueba el permiso de LinkedIn solicitado.

paid_plan_required

Sigue la action_url del error: inicia la prueba gratuita, elige un plan si la prueba o la suscripción terminó, o actualiza el método de pago tras un pago fallido. details.reason indica el caso.

trial_payment_method_required

Reintenta en un minuto si acabas de completar el pago; si no, añade un método de pago en la facturación de SalesTouch para activar la prueba y el acceso al MCP de LinkedIn.

Mensajes de una conversación de LinkedIn

Cuándo usarla

Requisitos

Ejemplo

Parámetros

Errores frecuentes

Herramientas relacionadas

En esta página