SalesTouch Docs
Todas las herramientas MCP
Solo lecturaLinkedIn

Buscar leads

leads_search

Busca en el directorio de leads del espacio de trabajo por identidad, estado de CRM, estado de la bandeja, etiquetas, fuente y fechas de contacto por mensaje.

Cuándo usarla

Encuentra y segmenta leads ya observados por SalesTouch sin analizar conversaciones de LinkedIn.

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

Requisitos

Todos los filtros son opcionales y se aplican al espacio de trabajo actual.

Ejemplo

Pídeselo a tu agente

Encuentra leads contactados con la etiqueta Founder cuyo último mensaje enviado sea de los últimos 90 días.

Argumentos de la herramienta
{
  "crm_status": [
    "Contacted"
  ],
  "tags_any": [
    "Founder"
  ],
  "limit": 25
}
Envoltorio de respuesta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: Una lista paginada por cursor con miniperfiles, estados de CRM y bandeja, etiquetas, fechas de contacto y resúmenes de fuentes.

Parámetros

crm_scope
string

Ámbito CRM: organization, member:<id> o group:<id>. Por defecto, tu grupo compartido o tu CRM personal.

query
string

Texto comparado con los nombres de los leads, el titular, la URL de LinkedIn, las identidades conocidas y las direcciones de correo.

crm_status
array

Additional tool input.

inbox_status
array

Estado operativo de la mensajería: NOT_CONTACTED significa que no se envió ningún mensaje saliente; OUTREACH_SCHEDULED significa que hay un mensaje saliente en cola; AWAITING_PROSPECT_REPLY significa que el último mensaje es nuestro; PROSPECT_REPLIED significa que el último mensaje es del prospecto.

tags_any
array

Additional tool input.

tags_all
array

Additional tool input.

source_type
string

Tipo exacto de la fuente del lead.

source_id
string

ID exacto de la fuente del lead devuelto por lead_status o leads_search.

has_email
boolean

true para los leads con dirección de correo, false para los que no tienen.

last_contacted_from
string

Límite inferior inclusivo for el último mensaje enviado, por LinkedIn o por correo.

last_contacted_to
string

Límite superior inclusivo for el último mensaje enviado, por LinkedIn o por correo.

last_inbound_from
string

Límite inferior inclusivo for el último mensaje recibido, por LinkedIn o por correo.

last_inbound_to
string

Límite superior inclusivo for el último mensaje recibido, por LinkedIn o por correo.

sort
string

Orden de los leads. Valor predeterminado: updated_desc.

cursor
string

Cursor opaco de paginación de leads. Reutilízalo solo con los mismos filtros y el mismo orden.

limit
integer

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

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