Flujos de trabajo de LinkedIn

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:

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
}

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.

Comprobar las invitaciones actuales antes de contactar

Llama a lead_status o linkedin_lookup_profile con el miembro objetivo y el linkedin_account_id previsto. Ambos devuelven invitation_status: pending confirma una invitación saliente, incluso enviada fuera de SalesTouch; none confirma su ausencia tras leer la lista actual completa; connected indica que el miembro ya está conectado; unknown indica pruebas no disponibles, incompletas, antiguas o un envío anterior sin resolver. Consulta source, complete, coverage, checked_at, started_at, max_age_ms y reason. can_invite: false bloquea el envío. Un perfil de segundo grado, un campo ausente o una cola local vacía nunca demuestran la ausencia de una invitación.

Las invitaciones de salestouch_status son el historial de SalesTouch, con source: "salestouch_history" y complete: false. En lead_status, invitation.live_status es la observación actual; invitation.history_status, las fechas de contacto y los campos de cola describen actividad guardada. Una invitación en cola sigue siendo una tarea programada aunque su estado actual sea desconocido. Las consultas de solo lectura no envían nada ni crean historial de invitaciones.

Ambas herramientas comprueban de nuevo justo antes del envío real, también para acciones en cola y solicitudes scheduled_for. Omiten invitaciones ya pendientes. linkedin_invite_then_message conserva un solo seguimiento hasta la aceptación, incluso para invitaciones externas. Si ya existe conexión, el flujo continúa con el seguimiento. invitation_status_unknown o invitation_outcome_unknown detiene la invitación; consulta lead_status antes de reintentar. Un timeout tras enviar puede significar que linkedin aceptó la solicitud. Los resultados de envío desconocidos siguen bloqueados incluso con retry_invitation; reenviar expresamente tras retirar un envío confirmado exige una nueva comprobación completa de ausencia.

El estado actual es una observación limitada, no una reserva atómica en linkedin. Una lectura que supera su límite de páginas o tiempo permanece desconocida; una acción externa puede coincidir con el envío final. SalesTouch serializa sus propios intentos y resuelve resultados ambiguos sin un segundo envío. La cancelación de tareas en cola se aplica antes de ejecutarlas; no puede recuperar un envío remoto ya iniciado.

Un checked_at reciente no basta: provider_freshness: "origin_confirmed" indica que se ha verificado que la respuesta procede del proveedor. Una respuesta en caché o una actualidad no verificable devuelve unknown y bloquea el envío. Estas comprobaciones pueden consumir los límites de lectura del proveedor; SalesTouch no los omite.