Écrit sur LinkedInLinkedIn

Appeler un outil de données

data_call

Appelez un outil de données renvoyé par data_search et payez-le avec les crédits agent de l’espace de travail. Passez les paramètres d’URL dans query et le corps JSON dans body, comme l’indique data_describe. max_credits plafonne cet appel (2000 crédits par défaut) ; un appel estimé au-dessus est refusé avant tout débit. Renvoie la réponse du fournisseur et credits_charged. Une erreur du fournisseur est renvoyée avec son statut : corrigez la requête plutôt que de réessayer à l’aveugle. Ne répétez jamais un appel qui a renvoyé data_result_unknown.

Quand l’utiliser

Enrichissez un lead ou récupérez des données externes et payez-les avec les crédits agent de votre espace de travail.

Scopes requis

linkedin:accesssalestouch:use

Exécution

Appel d’outil MCP synchrone

Prérequis

Fournissez id depuis data_search et les paramètres indiqués par data_describe.

L’espace de travail doit disposer de crédits agent. Les analystes ne peuvent pas dépenser de crédits.

Exemple

Demandez à votre agent

Trouve l’e-mail professionnel de https://www.linkedin.com/in/example-person avec un outil de données.

Arguments de l’outil

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

Enveloppe de réponse MCP

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

Résultat attendu : La réponse du fournisseur, son statut HTTP et les crédits débités pour cet appel.

Paramètres

NomTypeDescription

idobligatoire

string

Identifiant d’outil de données renvoyé par data_search.

query

object

Paramètres d’URL, tels qu’indiqués par data_describe.

body

object

Corps JSON de la requête, tel qu’indiqué par data_describe.

max_credits

number

Nombre maximal de crédits que cet appel peut coûter. Par défaut : 2000.

Les alias sont affichés séparément, car les clients MCP envoient un objet JSON plat. Utilisez un seul alias par groupe obligatoire, pas tous les alias.

Erreurs fréquentes

insufficient_scope

Reconnectez le MCP et approuvez l’autorisation LinkedIn demandée.

paid_plan_required

Suivez l’action_url de l’erreur : démarrez l’essai gratuit, choisissez un forfait si l’essai ou l’abonnement a pris fin, ou mettez à jour le moyen de paiement après un échec de paiement. details.reason indique le cas.

trial_payment_method_required

Réessayez dans une minute si le paiement vient d’être validé ; sinon ajoutez un moyen de paiement dans la facturation SalesTouch pour activer l’essai et l’accès au MCP LinkedIn.

credits_required

Ajoutez des crédits agent à l’espace de travail dans SalesTouch, puis réessayez.

data_cost_limit

Augmentez max_credits ou réduisez la requête.

data_result_unknown

Ne répétez pas l’appel : tout débit est régularisé automatiquement.