SalesTouch Docs
Todas las herramientas MCP
Solo lecturaLinkedIn

Conversaciones de LinkedIn

linkedin_conversations_list

Enumera las conversaciones recientes de mensajería de LinkedIn de las cuentas conectadas.

Cuándo usarla

Lee el flujo global unificado de conversaciones de LinkedIn o recorre flujos explícitos de Classic, Sales Navigator, empresa, carpeta o id de bandeja.

Scopes necesarios
linkedin:accesssalestouch:use
Ejecución
Llamada síncrona a una herramienta MCP

Requisitos

account_id es opcional cuando SalesTouch puede resolver automáticamente una cuenta conectada.
Omite inbox_tags para el flujo global sin duplicados; usa una o varias etiquetas devueltas por linkedin_inboxes_list para acotarlo.
Reutiliza un cursor solo con los mismos filtros de fecha/no leídos, selección de bandejas y valor sort_by. account_id puede omitirse o limitarse a una de las cuentas del cursor.
Cuando scan_incomplete es true, una página vacía o corta no significa que nada coincida: vuelve a llamar con el cursor devuelto y los mismos filtros.

Ejemplo

Pídeselo a tu agente

Enumera mis 20 conversaciones no leídas más recientes de LinkedIn e incluye a los participantes.

Argumentos de la herramienta
{
  "limit": 20,
  "unread": true,
  "include_participants": true
}
Envoltorio de respuesta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: Una lista paginada estable con metadatos de producto/carpeta de las bandejas y un cursor opaco multibandeja ligado a la consulta.

Parámetros

account_id
string

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

cursor
string

Cursor de paginación.

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.

inbox_tags
array

Etiquetas legibles devueltas por linkedin_inboxes_list. Los valores se combinan con O. Ejemplos: classic_primary, sales_navigator, archived, company_primary, company_123_primary, unread. Las vistas derivadas solo se consultan cuando su etiqueta de carpeta es explícita.

sort_by
string

Usa last_message_at para el feed global unificado (default), o inbox para recorrer los flujos en un orden determinista de cuenta/producto/carpeta.

limit
integer

Máximo de conversaciones que se devolverán. Valor predeterminado: 25.

unread
boolean

Filtrar conversaciones leídas o no leídas.

include_participants
boolean

Incluir participantes normalizados de la conversación.

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.

En esta página

Cuándo usarlaRequisitosEjemploParámetrosErrores frecuentesHerramientas relacionadas