SalesTouch Docs

Flujos de trabajo de LinkedIn

Secuencias MCP fiables de SalesTouch para investigación, conversaciones, prospección, interacción y extracción.

Los flujos MCP más sólidos utilizan llamadas pequeñas y fáciles de revisar. Resuelve primero las identidades, realiza después los cambios y comprueba el estado del trabajo puesto en cola o aplazado.

Investigar un prospecto y su conversación

  1. Llama a linkedin_accounts si no conoces la cuenta.
  2. Resuelve el miembro con linkedin_lookup_profile.
  3. Busca la conversación con linkedin_conversations_search.
  4. Carga el contexto con linkedin_conversations_messages.
  5. Pide al agente que resuma la relación antes de redactar nada.

Prompt:

Prompt

Busca este perfil, encuentra nuestra conversación de LinkedIn, lee el historial de mensajes y resume la relación. No envíes nada.

Enviar a un contacto existente

  1. Lee la conversación o llama a lead_status.
  2. Confirma el mensaje exacto con el usuario.
  3. Llama a linkedin_message con un miembro objetivo y text.
  4. Si SalesTouch exige usar la cola, repite con queue: true.
  5. Indica si la acción se ha enviado o puesto en cola.

Invitar y hacer seguimiento tras la aceptación

Usa linkedin_invite_then_message cuando el seguimiento solo deba ejecutarse tras la aceptación de la invitación. Proporciona el objetivo y follow_up_message. La nota de invitación es opcional.

Usa después lead_status para comprobar la aceptación, el seguimiento guardado o el estado del mensaje en cola.

Programar una acción de LinkedIn

Añade scheduled_for a cualquier mensaje, invitación, secuencia de invitación y mensaje, Me gusta, comentario o publicación. Usa una fecha y hora ISO 8601 con zona horaria.

SalesTouch guarda la solicitud de inmediato, pero nunca la ejecuta antes del momento solicitado. El horario de trabajo, los límites de la cuenta o un periodo de espera de LinkedIn pueden retrasar el valor efectivo de scheduled_for. Las programaciones explícitas tienen prioridad sobre las acciones puestas en cola automáticamente.

La respuesta distingue requested_for del valor efectivo de scheduled_for e indica si el evento de ejecución está registered, awaiting_horizon o pending_retry. Las programaciones a largo plazo permanecen guardadas en SalesTouch hasta que entran en el horizonte de ejecución.

Las cuentas de LinkedIn con credenciales que estén inactivas se reconectan cuando vence la acción. Las cuentas antiguas basadas en cookies todavía pueden requerir una reconexión manual.

Interactuar con una publicación

  1. Resuelve las URL de publicaciones ambiguas con linkedin_lookup_post.
  2. Llama a una sola acción que corresponda: linkedin_like o linkedin_comment.
  3. Usa queue: true cuando la acción no pueda ejecutarse de inmediato.

No pidas al agente que «interactúe» sin especificar la acción exacta y el texto del comentario.

Extraer las interacciones de una publicación

  1. Resuelve la publicación con linkedin_lookup_post.
  2. Llama a scrape_linkedin_post_reactions o scrape_linkedin_post_comments. La extracción de comentarios devuelve por defecto los autores de comentarios raíz. Define include_replies: true solo cuando necesites los autores de las respuestas.
  3. Lee la vista previa integrada.
  4. Si source_paging.exhausted es false, vuelve a llamar a scrape_linkedin_post_comments con el valor devuelto en source_paging.arguments. La extracción continúa desde la posición guardada y conserva el modo include_replies original tras alcanzar el presupuesto automático de seguridad para solicitudes al proveedor o sufrir una interrupción recuperable de LinkedIn.
  5. Usa scrape_result_page con el result_id devuelto únicamente para recorrer los perfiles ya guardados por esa llamada.
  6. Usa los metadatos de exportación cuando el conjunto completo de datos deba salir del contexto del agente.

Extraer desde una búsqueda

  • Usa scrape_linkedin_search_url si ya tienes una URL de búsqueda nativa de LinkedIn Classic para personas, empresas, publicaciones o empleos.
  • Usa scrape_linkedin_people_search, scrape_linkedin_companies_search, scrape_linkedin_posts_search o scrape_linkedin_jobs_search para filtros estructurados de LinkedIn Classic.
  • Usa scrape_sales_navigator_search_url si ya tienes una URL nativa de Sales Navigator para personas o empresas y quieres que SalesTouch deduzca el tipo de resultado.
  • Usa scrape_sales_navigator_people para una URL de búsqueda de leads de Sales Navigator o filtros estructurados de personas.
  • Usa scrape_sales_navigator_companies para una URL de búsqueda de empresas de Sales Navigator o filtros estructurados de empresas.
  • Usa linkedin_sales_navigator_search_parameters para descubrir identificadores específicos de la cuenta para ubicaciones, sectores, empresas, puestos y otros filtros enumerados. Define product: "classic" para LinkedIn Classic. Sales Navigator sigue siendo el valor predeterminado por compatibilidad.
  • Usa linkedin_lookup_job_posting después de una búsqueda de empleo para obtener una oferta completa, incluidas las secciones opcionales sobre equipo de contratación, salario y beneficios.
  • Define preview_limit para mantener pequeña la respuesta integrada.
  • Recorre los resultados guardados en lugar de solicitar toda la extracción en una sola llamada.

Los valores de los filtros estructurados aceptan un id conocido o una query legible. Una consulta se utiliza automáticamente solo cuando resuelve un valor exacto. Si coinciden varios candidatos, repite con el identificador seleccionado.

Ejemplo: growth hackers en París en empresas de 1 a 10 empleados:

{
  "filters": {
    "current_job_title": { "include": [{ "query": "Growth Hacker" }] },
    "location": { "include": [{ "query": "Paris" }] },
    "company_headcount": [{ "min": 1, "max": 10 }]
  },
  "limit": 100,
  "preview_limit": 20
}

Ejemplo: empresas de servicios informáticos en París, usando el sector de LinkedIn como aproximación empresarial:

{
  "filters": {
    "industry": { "include": [{ "query": "IT Services and IT Consulting" }] },
    "location": { "include": [{ "query": "Paris" }] }
  },
  "limit": 1000,
  "preview_limit": 20
}

Ejemplo: empresas de París que están contratando:

{
  "filters": {
    "location": { "include": [{ "query": "Paris" }] },
    "hiring_on_linkedin": true,
    "department_headcount_growth": {
      "department": [{ "query": "Engineering" }],
      "min": 1
    }
  },
  "limit": 1000,
  "preview_limit": 20
}

Para buscar personas únicamente dentro de un resultado de empresas, llama primero a scrape_sales_navigator_companies. Después, pasa su result_id como company_result_id a scrape_sales_navigator_people, junto con filtros de personas como current_job_title. SalesTouch valida la propiedad, caducidad y cuenta de LinkedIn del resultado, y aplica las empresas en lotes seguros.

{
  "company_result_id": "previous_company_result_id",
  "filters": {
    "current_job_title": { "include": [{ "query": "Directeur des ressources humaines" }] }
  },
  "limit": 100,
  "preview_limit": 20
}

Interpreta correctamente la contratación y la exhaustividad

hiring_on_linkedin: true significa que la empresa tiene al menos una oferta de empleo en LinkedIn. No demuestra que el puesto abierto sea para desarrollo. Añade department_headcount_growth para la función Engineering como señal de intención, o parte de un conjunto verificado de búsqueda de empleos cuando el puesto deba ser exacto. «Todas las empresas» también significa todos los resultados expuestos por los filtros seleccionados de Sales Navigator, sujetos al límite de LinkedIn. Segmenta las búsquedas amplias cuando la advertencia te pida acotarlas.

«ESN» no es una clasificación empresarial nativa de LinkedIn. Usa IT Services and IT Consulting como aproximación sectorial amplia y califica después las empresas devueltas a partir de su descripción o sitio web, en lugar de considerar una coincidencia de palabras clave como una prueba.

Cancelar una acción en cola o un seguimiento pendiente

  1. Obtén el identificador exacto desde status o lead_status.
  2. Llama a queue_cancel con uno solo de estos valores:
    • queued_action_id para cancelar una invitación, un mensaje u otra acción en cola;
    • followup_id para cancelar un mensaje automático en estado waiting_acceptance sin modificar su invitación.
  3. Informa del resultado de la cancelación. No supongas que una solicitud local canceló la acción remota.

Confía en el estado devuelto

Considera los estados enviado, en cola, aceptado y cancelado que devuelve SalesTouch como fuente de verdad. No deduzcas la ejecución a partir del prompt original.