Grava no LinkedInLinkedIn

Chamar uma ferramenta de dados

data_call

Chame uma ferramenta de dados retornada por data_search e pague com os créditos de agente do espaço de trabalho. Passe os parâmetros de URL em query e o corpo JSON em body, como data_describe mostra. max_credits limita esta chamada (2000 créditos por padrão); uma chamada estimada acima disso é recusada antes de qualquer cobrança. Retorna a resposta do fornecedor e credits_charged. Um erro do fornecedor é retornado com seu status: corrija a entrada em vez de repetir às cegas. Nunca repita uma chamada que retornou data_result_unknown.

Quando usar

Enriqueça um lead ou obtenha dados externos e pague com os créditos de agente do seu espaço de trabalho.

Escopos necessários

linkedin:accesssalestouch:use

Execução

Chamada síncrona de ferramenta MCP

Requisitos

Informe id de data_search e os parâmetros mostrados por data_describe.

O espaço de trabalho precisa de créditos de agente disponíveis. Analistas não podem gastar créditos.

Exemplo

Peça ao seu agente

Encontre o e-mail profissional de https://www.linkedin.com/in/example-person com uma ferramenta de dados.

Argumentos da ferramenta

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

Envelope da resposta MCP

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

Resultado esperado: A resposta do fornecedor, seu status HTTP e os créditos cobrados por esta chamada.

Parâmetros

NomeTipoDescrição

idobrigatório

string

Id da ferramenta de dados retornado por data_search.

query

object

Parâmetros de URL, conforme data_describe.

body

object

Corpo JSON da solicitação, conforme data_describe.

max_credits

number

Máximo de créditos que esta chamada pode custar. Padrão: 2000.

Os aliases são exibidos separadamente porque os clientes MCP enviam um objeto JSON plano. Use apenas um alias de cada grupo obrigatório, não todos os aliases.

Erros comuns

insufficient_scope

Reconecte o MCP e aprove a permissão solicitada do LinkedIn.

paid_plan_required

Siga a action_url do erro: inicie o período de teste gratuito, escolha um plano se o teste ou a assinatura terminou, ou atualize a forma de pagamento após um pagamento recusado. details.reason indica o caso.

trial_payment_method_required

Tente novamente em um minuto se o checkout acabou de ser concluído; caso contrário, adicione uma forma de pagamento no faturamento da SalesTouch para ativar o período de teste e o acesso ao MCP do LinkedIn.

credits_required

Adicione créditos de agente ao espaço de trabalho no SalesTouch e tente novamente.

data_cost_limit

Aumente max_credits ou restrinja a solicitação.

data_result_unknown

Não repita a chamada: qualquer cobrança é acertada automaticamente.