Le prospect et la conversation

Le prospectCopier le lien

Une personne de votre CRM Lidmeo : trouvée par Lidmeo, ou un lead 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 LidmeoCopier le lien

Les vuesCopier le lien

GET /v1/prospects?view=… donne les mêmes listes que l'écran : to_handle (« À traiter » : ils ont répondu et vous attendent), to_follow_up (« À relancer »), reminders (« Rappels »), imported, next_departures (« Prochains départs »), to_approve (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.

L'historiqueCopier le lien

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 conversationCopier le lien

Une conversation par personne, LinkedIn et e-mail réunis. channel vaut linkedin, email ou mixed ; 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.

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.

L'adresse de réceptionCopier le lien

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.