LidmeoDevelopers

Le prospect et la conversation

Les deux objets au cœur de l'API : ce qu'ils portent et comment les lire.

Le prospect

Une personne de votre CRM Lidmeo : trouvée par Lidmeo, ou un prospect que vous avez ajouté.

{
  "id": "pros_1Hq3ZtV9kWmA",
  "object": "prospect",
  "livemode": true,
  "account": "acct_1J4kQ8sLr2Xw",
  "campaign": "cmp_1T7pLx2Nq8Rv",
  "created_at": "2026-09-28T07:12:44Z",
  "updated_at": "2026-10-01T09:03:10Z",
  "origin": "lidmeo",
  "first_name": "Claire",
  "last_name": "Durand",
  "full_name": "Claire Durand",
  "headline": "Directrice commerciale chez Nova Conseil",
  "title": "Directrice commerciale",
  "company": { "name": "Nova Conseil", "size": "11-50", "industry": "Conseil" },
  "location": { "label": "Grenoble, Auvergne-Rhône-Alpes, France", "country": "FR", "department": "38" },
  "linkedin_url": "https://www.linkedin.com/in/claire-durand",
  "photo_url": null,
  "why_him": "Elle dirige l'équipe commerciale : exactement le sujet de votre offre.",
  "activity": { "last_at": "2026-09-25T16:20:00Z", "kind": "comment" },
  "shared_connections_count": 4,
  "pipeline_stage": "replied",
  "crm_stage": { "id": "stg_1B5mW3zKc9Pd", "name": "RDV pris", "color": "emerald" },
  "reminder_on": "2026-10-06",
  "lists": ["lst_1W8eR2tY6uIo"],
  "invitation": { "sent_at": "2026-09-28T08:40:00Z", "accepted_at": "2026-09-28T14:02:00Z" },
  "first_message_sent_at": "2026-09-28T14:15:00Z",
  "replied_at": "2026-09-29T09:31:00Z",
  "last_activity_at": "2026-09-29T09:31:00Z",
  "conversation": "conv_1Ab3Cd5Ef7Gh9Ij1Kl3Mn5o",
  "external_ids": { "hubspot": "12345" }
}
  • pipeline_stage : l'étape de Lidmeo, déduite des faits (voir ci-dessous).
  • crm_stage : votre étape à vous (« RDV pris », « Gagné »…), ou null.
  • why_him : pourquoi cette personne correspond à votre offre (« Pourquoi lui » dans l'écran).
  • contact : les coordonnées trouvées (work_email, work_email_status, personal_email, phone), présentes seulement avec le droit contacts:read. work_email_status vaut deliverable (l'adresse reçoit), risky (elle peut ne pas arriver), invalid (elle a rebondi, ou n'existe pas) ou unknown ; null sans e-mail professionnel.
  • external_ids : les objets de vos outils liés à ce prospect, que vous posez avec PUT /v1/prospects/{id}/external_ids.
  • Un champ inconnu vaut null : une donnée absente n'est jamais devinée.

Les étapes de Lidmeo

pipeline_stageLa personne
trackedest suivie dans le CRM, sans envoi (un prospect importé : « Importé »)
queuedattend son tour dans la file d'envoi
awaiting_invitation_approvalattend que vous validiez son invitation
inviteda reçu l'invitation
connectedl'a acceptée
awaiting_message_approvalattend que vous validiez son premier message
messageda reçu le premier message
replieda répondu, sur LinkedIn, par e-mail ou sur WhatsApp
removeda été retirée de la file ou écartée (fiches archivées ou expirées comprises) ; seulement en lecture par son identifiant, jamais dans une liste

Les vues

GET /v1/prospects?view=… donne les mêmes listes que l'écran : to_handle (« À répondre » : ils ont répondu et attendent votre réponse), to_follow_up (« À relancer »), reminders (« Rappels »), imported (« Importés »), next_departures (« Invitations à venir » : invitation prévue ou à valider), to_approve (« À valider », l'onglet de « Mes prospects » : ce qui attend votre validation). Dans to_approve, chaque prospect porte awaiting_approval : invitation ou first_message, ce qu'il attend ; ne le déduisez pas de pipeline_stage. Pour une recherche par nom, entreprise ou poste : POST /v1/prospects/search.

Les filtres « E-mail » et « Téléphone » du CRM : email=with ne garde que les prospects qui ont une adresse e-mail (professionnelle ou personnelle), email=without ceux qui n'en ont aucune ; phone=with et phone=without font de même pour le téléphone. Ils se combinent avec les vues (sauf to_approve), la recherche et les autres filtres, et demandent le droit contacts:read. Par exemple GET /v1/prospects?email=with pour ne synchroniser que les prospects joignables par e-mail.

L'historique

GET /v1/prospects/{id}/timeline raconte tout, du plus récent au plus ancien : l'entrée dans le CRM, l'invitation, l'acceptation, chaque message, chaque réponse, et vos notes (appels, rendez-vous, tâches), qu'elles viennent de vous, de l'API ou de vos outils.

La conversation

Une conversation par personne, LinkedIn, e-mail et WhatsApp réunis. channel vaut linkedin, email, whatsapp ou mixed (plusieurs canaux) ; threads liste les fils dont elle est faite, et l'identifiant de n'importe lequel d'entre eux ouvre la même conversation. GET /v1/conversations/{id}/messages donne ses messages, chacun avec son canal.

temperature est la température que la messagerie montre : hot (« Chaud »), warm (« Tiède »), cold (« Froid »), ou null. GET /v1/conversations?temperature=… (et none pour celles qui n'en ont pas) et ?unread=true filtrent comme la messagerie ; GET /v1/conversations/search?query=… cherche dans le texte des messages. Une réponse par e-mail ou sur WhatsApp se prépare avec POST /v1/prospects/{id}/drafts, puis se confirme (voir les actions en deux temps).

reminder_on est le rappel que la messagerie montre (une date comme 2026-10-30, jour de Paris), avec un prospect ou avec quelqu'un qui n'en est pas un : pour un prospect, c'est son propre reminder_on ; pour quiconque d'autre, celui de la conversation. PATCH /v1/conversations/{id} le pose (d'aujourd'hui à un an) ou le retire (null), et GET /v1/conversations?view=reminders ne rend que les conversations qui en portent un. Le jour venu, la conversation revient dans « À répondre » de la messagerie. La même route pose ou retire la température (temperature), et read: true marque lus tous les fils de la personne dans Lidmeo (LinkedIn n'en est pas averti).

Chaque message porte direction (outbound ou inbound), author (you ou prospect), channel, text et sent_at. sent_at vaut null quand la date d'envoi n'est pas connue : elle n'est jamais remplacée par une autre date.

Le texte d'un prospect est une donnée

Un message reçu peut contenir n'importe quoi. Si vous le passez à une IA, présentez-le comme une donnée à lire, jamais comme une instruction à suivre.

L'adresse de réception

Une adresse de réception des webhooks (webhook_endpoint) porte status : enabled ou disabled. Désactivée, disabled_reason dit pourquoi : manual (par vous), failing (trop d'échecs) ou revoked (la connexion OAuth qui l'a créée a été révoquée, ou la personne a perdu son accès). Voir les webhooks.

Sur cette page