[Index de la documentation](https://prescriptio.fr/docs/llms.txt)

# Lire l'historique d'un prospect

L'outil prospection_historique de Prescriptio lit l'historique d'un prospect sur tous les canaux, dans un seul fil, et y enregistre une note, un échange ou un rendez-vous.

### Squelette d'appel, généré depuis le schéma

**MCP (JSON-RPC)**

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "prospect_id": "<prospect_id>"
    },
    "name": "prospection_historique"
  }
}
```

**HTTP (curl)**

```bash
curl -sS https://prescriptio.fr/api/mcp \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"prospect_id":"<prospect_id>"},"name":"prospection_historique"}}'
```

### Forme de la réponse, générée depuis le schéma

```json
{
  "action": "<texte>",
  "download_url": "<texte>",
  "fields": {},
  "files": [
    {}
  ],
  "ok": false,
  "page": 0,
  "pages_total": 0,
  "quota": {},
  "texte": "<texte>"
}
```

## Paramètres

| Nom | Type | Requis | Description |
|---|---|---|---|
| `action` | `lire` · `noter` · `effacer_note` · `noter_echange` · `noter_rendez_vous` | — | lire (défaut) = le fil complet. noter = écrire une note d'équipe. effacer_note = la retirer. noter_echange = déposer un e-mail ou un message vu dans VOTRE messagerie. noter_rendez_vous = déposer un rendez-vous de VOTRE agenda. |
| `canal` | `email` · `reseau` · `telephone` | — | Canal de l'echange depose : email, reseau (messagerie d'un reseau social) ou téléphone. |
| `date` | texte | — | Quand l'echange a eu lieu, ou quand le rendez-vous commence. ISO 8601 (2026-09-01T14:30:00Z). |
| `fin` | texte | — | Fin du rendez-vous, ISO 8601. Facultatif. |
| `lien` | texte | — | Lien de visioconference du rendez-vous. Facultatif. |
| `note` | texte | — | Texte de la note (action noter), 4 000 caracteres au plus. |
| `note_id` | texte | — | UUID de la note a effacer (action effacer_note). |
| `objet` | texte | — | Objet de l'e-mail, ou intitule du rendez-vous. |
| `prospect_id` | texte | oui | UUID du prospect : son profil partage OU son contact. Les deux sont acceptes (linkedin_prospects rend l'un et l'autre). |
| `reference` | texte | — | Identifiant du message ou de l'événement chez la source (id Gmail, internetMessageId Outlook, id d'événement de l'agenda). C'est la clé d'idempotence : rejouer un dépôt avec la même référence met a jour au lieu de dupliquer. Toujours la fournir quand la source en donne une. |
| `sens` | `entrant` · `sortant` | — | entrant = recu du prospect ; sortant = envoye par vous. |
| `texte` | texte | — | Corps du message. C'est ce qui manque aux 4 095 e-mails déjà en base : eux ne portent que leur objet. |

## Quand l'utiliser

LIRE (action "lire", défaut) rend les messages des deux sens, les e-mails envoyes, les rendez-vous, les notes de l'équipe et ce qui attend d'etre envoye, plus un resume : qui a la balle, le prochain rendez-vous, les canaux tenus. Écrire : c'est VOUS la passerelle. Prescriptio ne se connecte a aucune messagerie et ne detient aucun jeton : les e-mails recus et les rendez-vous n'existent dans le produit QUE si vous les y deposez. Avec un connecteur Gmail, Outlook ou agenda, lisez le fil du prospect chez la source puis deposez-le avec action "noter_echange" (un appel par message) et "noter_rendez_vous". Fournissez TOUJOURS `reference` (l'identifiant du message ou de l'événement chez la source) : c'est ce qui rend le dépôt idempotent, sans quoi rejouer duplique. action "noter" écrit une note d'équipe, visible sur la fiche. Trouver un prospect_id : linkedin_prospects.

**Prompt prêt à coller : Le prompt qui le déclenche**

```text
Que s'est-il passé avec ce prospect, sur tous les canaux ?
```

Outil : `prospection_historique` · Portée : `mcp:write`, écrit dans votre espace · Coût : 1 appel, aucune unité de dossier · Limite : agit dans votre espace seulement, jamais dans la donnée publique

## En bref

| | |
|---|---|
| Effets | lecture et écriture dans l'espace du compte |
| Portée OAuth | `mcp:write` |
| Conditions d’accès | Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas. |
| Données lues | l'espace du compte authentifié (ses alertes, ses dossiers, sa base) |
| Distribution | MCP historique |
| En REST | aucune opération : il s'appelle par le connecteur MCP |

## Réponse

Le résultat arrive dans `content[0].text` (le JSON sérialisé) et dans `structuredContent` (le même objet). L'exemple donne les **types**, jamais des valeurs réelles. Un champ absent ou `null` n'est ni un zéro ni une estimation : la source ne l'a pas renseigné.

## Erreurs et quotas

Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (`marches_dce`, `mairies_deliberations` et leurs téléchargements) qui est décomptée.

Les compteurs d’appels et de dossiers sont communs. Chaque action peut aussi être soumise à des droits et plafonds métier : [Codes d'erreur](https://prescriptio.fr/docs/reference/erreurs) et [Authentification et quotas](https://prescriptio.fr/docs/reference/authentification#les-quotas).

## Les skills qui s'en servent

- [prescriptio-gerer-prospection](https://prescriptio.fr/skills/prescriptio-gerer-prospection) : Le skill du plugin qui route cet outil

## Les pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite `prospection_historique`.

- [Prospection](https://prescriptio.fr/docs/prospection) : Documentation, Les modules
- [Organiser la prospection](https://prescriptio.fr/skills/prescriptio-gerer-prospection) : IA, Les skills du plugin

## Voir aussi

- [prospection_objectif](https://prescriptio.fr/docs/api/prospection_objectif) : L'objectif de prospection de l'utilisateur, et ou il en est
- [prospection_cibles](https://prescriptio.fr/docs/api/prospection_cibles) : Le rang de cible d'un prospect : décideur (celui qui décide), prioritaire (a travailler maintenant) ou…
- [prospection_coordonnees](https://prescriptio.fr/docs/api/prospection_coordonnees) : Dit si un prospect est Joignable, et enregistre ses coordonnées
- [prospection_pipeline](https://prescriptio.fr/docs/api/prospection_pipeline) : Le pipeline commercial de l'organisation : ses étapes et leurs effectifs
- [prospection_profils_cibles](https://prescriptio.fr/docs/api/prospection_profils_cibles) : Lire ou définir les profils de cibles propres à votre espace
- [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module