Invitation LinkedIn
linkedin_inviteEnvoyez une invitation linkedin directement après résolution de l’identité et prise d’un verrou persistant par destinataire. Un identifiant de profil connu ne nécessite aucun contrôle préalable du profil ni parcours des invitations. Gérez explicitement les refus du fournisseur ; un délai de 3 semaines ne prouve pas qu’une invitation est en attente. Les envois déjà confirmés exigent une autorisation explicite de réinvitation. Un résultat d’envoi incertain bloque les nouvelles tentatives.
Quand l’utiliser
Envoyez une invitation à se connecter sur LinkedIn, avec éventuellement une courte note.
linkedin:accesssalestouch:usePrérequis
Exemple
Invite https://www.linkedin.com/in/example à se connecter avec la note « Ravi de nous connecter. »
{
"linkedin_url": "https://www.linkedin.com/in/example",
"message": "Would love to connect.",
"queue": true
}{
"content": [
{
"type": "text",
"text": "{\n \"data\": { ... },\n \"meta\": null\n}"
}
],
"isError": false
}Résultat attendu : Un résultat d’invitation envoyée ou mise en file.
Paramètres
account_idstringIdentifiant, nom d’utilisateur, e-mail, handle ou URL du compte SalesTouch connecté.
identifierobligatoirestringHandle, 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.
textstringNote d’invitation facultative.
retry_invitationbooleanAutorisation explicite pour une nouvelle tentative après un envoi confirmé. Ne contourne jamais un résultat incertain ni le délai de 3 semaines enregistré ; aucun parcours complet des invitations.
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.
invitation_cooldownNe réessayez pas automatiquement. Consultez lead_status pour distinguer une invitation en attente d’une demande récemment traitée ; une réinvitation ultérieure exige une autorisation explicite.
invitation_status_unknownRelisez lead_status. N’envoyez rien et ne relancez pas automatiquement tant que invitation_status est unknown.
invitation_outcome_unknownRelisez lead_status. N’envoyez rien et ne relancez pas automatiquement tant que invitation_status est unknown.
invitation_note_too_longGardez la note sous 300 caractères (200 sur un compte gratuit), ou appelez retry_tool avec retry_with pour l’envoyer sans note.
invitation_note_unavailableLe compte a épuisé ses invitations personnalisées. Appelez retry_tool avec retry_with pour envoyer l’invitation sans note.
invitation_limit_reachedLe compte a atteint la limite hebdomadaire d’invitations de LinkedIn. N’envoyez plus d’invitations depuis ce compte pendant plusieurs jours ; mettez-les en file d’attente ou planifiez-les.
invitation_already_pendingUne invitation a déjà été envoyée. Consultez lead_status ; n’en envoyez pas d’autre.
invitation_requires_emailCe membre n’accepte que les invitations de personnes qui connaissent son e-mail. Contactez-le autrement.