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é »…), ounull.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 droitcontacts:read.work_email_statusvautdeliverable(l'adresse reçoit),risky(elle peut ne pas arriver),invalid(elle a rebondi, ou n'existe pas) ouunknown;nullsans e-mail professionnel.external_ids: les objets de vos outils liés à ce prospect, que vous posez avecPUT /v1/prospects/{id}/external_ids.- Un champ inconnu vaut
null: une donnée absente n'est jamais devinée.
Les étapes de Lidmeo
pipeline_stage | La personne |
|---|---|
tracked | est suivie dans le CRM, sans envoi (un prospect importé : « Importé ») |
queued | attend son tour dans la file d'envoi |
awaiting_invitation_approval | attend que vous validiez son invitation |
invited | a reçu l'invitation |
connected | l'a acceptée |
awaiting_message_approval | attend que vous validiez son premier message |
messaged | a reçu le premier message |
replied | a répondu, sur LinkedIn, par e-mail ou sur WhatsApp |
removed | a é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.