Message LinkedIn
linkedin_messageEnvoyez un message direct LinkedIn à un membre cible.
Quand l’utiliser
Envoyez un message direct à une connexion LinkedIn existante ou à une conversation connue.
linkedin:accesssalestouch:usePrérequis
Exemple
Envoie « Merci pour la connexion, je serais ravi de comparer nos expériences. » à https://www.linkedin.com/in/example.
{
"linkedin_url": "https://www.linkedin.com/in/example",
"text": "Thanks for connecting, happy to compare notes.",
"queue": true
}{
"content": [
{
"type": "text",
"text": "{\n \"data\": { ... },\n \"meta\": null\n}"
}
],
"isError": false
}Résultat attendu : Un résultat de message envoyé ou mis en file avec l’identifiant de l’action.
Paramètres
account_idstringIdentifiant, nom d’utilisateur, e-mail, handle ou URL du compte SalesTouch connecté.
identifierstringHandle, identifiant public, identifiant de compte ou URL de profil du membre LinkedIn.
queuebooleanDéfinissez true pour mettre cette action en file si elle ne peut pas s’exécuter maintenant.
scheduled_forstringDate et heure ISO 8601 future avec fuseau horaire. L’action ne s’exécutera jamais avant cette date et la mise en file est implicite.
textstringTexte du message à envoyer. Required unless attachments are provided.
attachmentsarrayPièces jointes natives : 5 fichiers et 60 Mo au plus au total. Utilisez un attachment_id importé, une URL HTTPS publique ou des octets base64 ; le base64 inline est limité à 3 Mo par requête, envoyez donc les fichiers plus lourds par url ou attachment_id. Les chemins locaux et le HTML ne sont pas pris en charge. Importez les fichiers sélectionnés via /api/linkedin/attachments dans l’application, puis transmettez leur attachment_id.
idempotency_keystringClé stable du message avec pièces jointes, de 120 caractères au plus. Une même clé et un même contenu ne provoquent jamais deux envois. Sans clé, les messages identiques sont dédupliqués ; modifiez-la volontairement uniquement pour un nouvel envoi.
linkedin_conversation_idstringIdentifiant facultatif d’une conversation LinkedIn existante. conversation_id est réservé à la session d’analyse MCP.
bypass_rate_limitbooleanRemplacer le comportement de file tenant compte des réponses. Les messages destinés aux leads ayant déjà répondu contournent par défaut les limites d’envoi en file, sauf si queue ou scheduled_for est défini.
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_scopeReconnectez le MCP et approuvez l’autorisation LinkedIn demandée.
paid_plan_requiredSuivez 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_requiredRé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.
action_limit_queue_requiredRépétez l’appel avec queue défini sur true.
message_requires_connectionLe membre n’est pas une relation de 1er niveau et le compte ne peut pas lui envoyer d’InMail. Appelez retry_tool (linkedin_invite_then_message) avec retry_with ; ne relancez pas linkedin_message.
inmail_credits_exhaustedLe compte n’a plus de crédits InMail. Utilisez linkedin_invite_then_message, ou attendez que les crédits se rechargent.
message_too_longRaccourcissez le texte et renvoyez-le.
recipient_unreachableLinkedIn ne livrera pas de message à ce membre depuis ce compte. Ne réessayez pas.