Envoyer vos contacts LinkedIn chauds vers HubSpot, Salesforce ou Pipedrive

Swimlane n'a pas de synchronisation native avec HubSpot, Salesforce ou Pipedrive. Vous les reliez vous-même avec l'API publique de Swimlane, les webhooks et n8n ou Make, qui proposent tous deux des modules HubSpot, Salesforce et Pipedrive. Cet article présente les deux montages qui fonctionnent et comment choisir.

Définissez d'abord ce qu'est un contact « chaud »

Ne copiez pas tous vos contacts dans le CRM. Swimlane crée un contact pour chaque personne avec qui vous échangez ou que vous importez : votre CRM se remplirait de gens qui n'ont jamais répondu. Choisissez un signal que l'équipe pose à la main, par exemple :

un tag comme « À envoyer au CRM », ajouté quand une conversation devient une vraie opportunité ;
ou une liste comme « Qualifiés », dans laquelle les commerciaux rangent les contacts.

Le tag est le signal le plus fiable, car l'API sait filtrer dessus (tag_id).

Montage 1 : transfert planifié sur un tag (recommandé)

Les tags n'envoient pas de webhook : l'automatisation vérifie donc à intervalle régulier les contacts tagués.

Dans Swimlane, créez deux tags : « À envoyer au CRM » et « Dans le CRM ». Notez leurs identifiants avec GET https://api.getswimlane.com/v1/tags (un tag n'y apparaît qu'une fois utilisé sur un contact).
Dans n8n ou Make, planifiez un workflow toutes les 15 minutes.
Appelez GET /v1/contacts?tag_id=<id À envoyer au CRM>&per_page=100.
Pour chaque contact, appelez GET /v1/companies/<uuid> avec le premier de ses companyUuids pour obtenir le nom de l'entreprise.
Cherchez la personne dans votre CRM (par URL LinkedIn, ou par nom et entreprise). Créez-la si elle n'existe pas, mettez-la à jour sinon.
Remettez les tags avec POST /v1/contacts/<uuid>/tags : les tagIds actuels du contact, moins « À envoyer au CRM », plus « Dans le CRM ». Cet appel remplace tous les tags : envoyez toujours la liste complète.

Le détail des appels API se trouve dans Connecter Swimlane à n8n et Connecter Swimlane à Make.

Montage 2 : en temps réel sur les événements contact

Créez un webhook abonné à Contact Created et/ou Contact Updated (voir Configurer des webhooks).
Dans le workflow, écartez les événements test, puis lisez le contact complet avec GET /v1/contacts/<uuid>.
Ne le gardez que s'il appartient à votre liste de qualifiés (listUuids) ou porte votre tag (tagIds).
Créez ou mettez à jour la fiche CRM.

Ce montage réagit en une minute environ, mais contact.updated se déclenche aussi quand les imports ou la synchronisation de la boîte de réception rafraîchissent un contact : le workflow tourne souvent. Filtrez dès le début.

Faire correspondre les champs

Ce que Swimlane vous donne via l'API :

firstName, lastName : souvent la seule identité disponible.
email, phone, website : généralement vides pour les contacts LinkedIn, sauf si quelqu'un les a renseignés.
headline, location, countryIso.
Profil LinkedIn : https://www.linkedin.com/in/<linkedinId>. Stockez-le dans une propriété du CRM : c'est la meilleure clé pour repérer les doublons.
Entreprise : le nom obtenu avec GET /v1/companies/<uuid>.
uuid : stockez-le dans une propriété personnalisée du CRM pour que les mises à jour retrouvent la bonne fiche.
pipelineStageUuid : l'étape où se trouve le contact, si vous voulez refléter une étape Swimlane dans une étape de transaction du CRM. Lisez les noms d'étapes avec GET /v1/pipelines/<uuid>/stages.

Indisponibles via l'API et les webhooks : les conversations et messages, les notes, l'adéquation ICP, les rappels et l'historique d'activité. Mettez un lien vers le profil LinkedIn du contact plutôt que d'essayer de copier la conversation.

Remarques par CRM

HubSpot : les contacts sont dédoublonnés sur l'e-mail par défaut. Sans e-mail, cherchez d'abord sur votre propriété URL LinkedIn, sinon vous créerez des doublons.
Salesforce : créez des Leads plutôt que des Contacts si la personne n'est pas encore rattachée à un compte. Stockez l'uuid Swimlane dans un champ personnalisé.
Pipedrive : créez la Personne, puis l'Organisation à partir du nom de l'entreprise, et une Affaire si le tag signifie « opportunité ».

Gardez un seul sens

Considérez Swimlane comme la source des conversations LinkedIn et votre CRM comme la source des affaires. Une synchronisation dans les deux sens via l'API est possible (contacts, tags, listes, étapes de pipeline) mais crée facilement des boucles. Si vous écrivez en retour, faites-le uniquement sur les tags ou les étapes de pipeline, qui n'envoient pas de webhook.