SalesTouch Docs
Todas las herramientas MCP
Solo lecturaLinkedIn

Estado del lead

lead_status

Consulta la prospección por LinkedIn y correo de un lead: fechas de contacto, aceptación y acciones en cola. Búscalo por perfil de LinkedIn, lead_id o correo. El bloque email lista sus direcciones, los últimos correos enviados y recibidos y los correos programados. invitation_status comprueba un perfil y los bloqueos locales sin recorrer todas las invitaciones. pending está confirmado; eligible indica que el perfil es elegible, sin demostrar la ausencia de invitaciones; unknown no confirma el estado actual. Los envíos anteriores inciertos y los plazos de espera bloquean el envío. message solo refleja el seguimiento de linkedin_invite_then_message. message.status=none no demuestra la ausencia de linkedin_message directo; consulta last_contacted_at. queued solo indica la programación local.

Cuándo usarla

Consulta el miniperfil, el estado de CRM, el estado de la bandeja, las etiquetas, las fuentes, la relación, el seguimiento y el estado de los mensajes en cola de un lead.

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

Requisitos

Proporciona lead_id, followup_id o un miembro objetivo de LinkedIn.

Ejemplo

Pídeselo a tu agente

Comprueba el estado del lead de SalesTouch para https://www.linkedin.com/in/example.

Argumentos de la herramienta
{
  "linkedin_url": "https://www.linkedin.com/in/example"
}
Envoltorio de respuesta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: El registro del directorio de leads junto con el estado actual de la relación y la prospección.

Parámetros

crm_scope
string

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

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 devuelto por lead_status or leads_search.

followup_id
string

ID opcional del seguimiento tras la invitación.

email
string

Correo del lead. Encuentra un lead importado o contactado en esa direcció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.