LidmeoDevelopers

Votre CRM : HubSpot, Pipedrive et les autres

Tenir votre CRM à jour avec Lidmeo : les règles qui marchent, en attendant les synchronisations intégrées.

Les synchronisations intégrées avec HubSpot et Pipedrive arrivent. Vous pouvez déjà relier n'importe quel CRM avec les webhooks et l'API, en suivant les mêmes règles qu'elles suivront.

Les règles d'une bonne synchronisation

1. Entrer dans le CRM à l'acceptation. Un prospect proposé par Lidmeo n'est encore qu'une piste. Créez le contact à invitation.accepted : c'est le moment où la personne devient une relation. Pour vos leads importés, prospect.created suffit.

2. Lier les deux fiches. Rendez à Lidmeo l'identifiant de votre CRM avec PUT /v1/prospects/{id}/external_ids. Il revient ensuite dans chaque prospect (external_ids) et chaque événement : vous savez toujours quel contact mettre à jour, sans chercher par nom. Un contact créé dans votre CRM entre dans Lidmeo par PUT /v1/prospects : une fiche déjà là n'est que complétée (ses champs vides), elle garde sa place dans une campagne, et une fiche retirée le reste. Une fiche déjà liée à un autre objet du même outil répond 409 conflict, avec linked_external_id : changez ce lien par PUT /v1/prospects/{id}/external_ids.

{ "hubspot": { "id": "12345", "url": "https://app.hubspot.com/contacts/1/record/0-1/12345" } }

3. Suivre la conversation. prospect.replied (la première réponse) et message.received (chaque message, texte compris) font avancer l'affaire. message.sent dit chaque message parti, avec son canal (linkedin ou email) et sa nature (first_message, follow_up, reply).

4. Écrire dans Lidmeo ce qui se passe dans le CRM. Un appel, un rendez-vous, une note : POST /v1/prospects/{id}/notes avec kind (call, meeting, email, task, note) et votre external_id, qui évite tout doublon si vous renvoyez la même note. Un external_id déjà pris par une note d'une autre fiche répond 409 conflict, et rien n'est déplacé. Une étape gagnée ou perdue : PATCH /v1/prospects/{id} avec crm_stage.

5. Propager « ne plus contacter ». prospect.opted_out doit marquer le contact partout. Dans l'autre sens, une désinscription venue de votre CRM entre dans Lidmeo par POST /v1/suppressions : plus rien ne part vers cette personne, sur aucun canal.

6. Rattraper plutôt que relire tout. Pour une première synchronisation, parcourez GET /v1/prospects page par page, tant que has_more vaut true (une page peut être courte, voire vide, sans être la dernière). Ensuite, suivez les événements, ou relisez seulement ce qui a changé avec updated_since. Sur les prospects, il suit les changements de la fiche elle-même : ajouter ou retirer une liste, relier un identifiant externe ou renommer une étape ne la fait pas remonter. Sur les conversations, il suit le dernier message. Il ne se combine ni avec une vue ni avec la recherche (400 invalid_request). Voir la pagination.

Les coordonnées

Les e-mails et téléphones trouvés par Lidmeo ne sortent qu'avec le droit contacts:read, sur la clé ou sur l'adresse de réception. Ne les recopiez dans votre CRM que si vous en avez besoin : voir vos obligations.

Sur cette page