Escribe en LinkedInLinkedIn

Llamar a una herramienta de datos

data_call

Llama a una herramienta de datos devuelta por data_search y págala con los créditos de agente del espacio de trabajo. Pasa los parámetros de URL en query y el cuerpo JSON en body, como indica data_describe. max_credits limita esta llamada (2000 créditos por defecto); una llamada estimada por encima se rechaza antes de cobrar nada. Devuelve la respuesta del proveedor y credits_charged. Un error del proveedor se devuelve con su estado: corrige la entrada en lugar de reintentar a ciegas. Nunca repitas una llamada que devolvió data_result_unknown.

Cuándo usarla

Enriquece un lead u obtén datos externos y págalos con los créditos de agente de tu espacio de trabajo.

Scopes necesarios

linkedin:accesssalestouch:use

Ejecución

Llamada síncrona a una herramienta MCP

Requisitos

Indica id de data_search y los parámetros que muestra data_describe.

El espacio de trabajo necesita créditos de agente disponibles. Los analistas no pueden gastar créditos.

Ejemplo

Pídeselo a tu agente

Encuentra el correo profesional de https://www.linkedin.com/in/example-person con una herramienta de datos.

Argumentos de la herramienta

{
  "id": "salestouch.people.email.find",
  "body": {
    "linkedin_url": "https://www.linkedin.com/in/example-person"
  },
  "max_credits": 300
}

Envoltorio de respuesta MCP

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: La respuesta del proveedor, su estado HTTP y los créditos cobrados por esta llamada.

Parámetros

NombreTipoDescripción

idobligatorio

string

Id de herramienta de datos devuelto por data_search.

query

object

Parámetros de URL, según data_describe.

body

object

Cuerpo JSON de la solicitud, según data_describe.

max_credits

number

Máximo de créditos que puede costar esta llamada. Valor predeterminado: 2000.

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.

credits_required

Añade créditos de agente al espacio de trabajo en SalesTouch y vuelve a intentarlo.

data_cost_limit

Aumenta max_credits o acota la solicitud.

data_result_unknown

No repitas la llamada: cualquier cargo se liquida automáticamente.