Préparer une tournée terrain | Documentation Prescriptio

Lit et écrit dans votre espace Prescriptio, jamais dans la donnée publique ; les portées accordées doivent couvrir l’écriture, et chaque action garde ses droits et ses conditions d’offre. Chaque appel compte pour une unité de quota.

généré depuis le schéma

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "action": "lister"
    },
    "name": "tournees"
  }
}

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":{"action":"lister"},"name":"tournees"}}'

Réponsegénérée depuis le schéma

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

Paramètres

actionlister · lire · creer · modifier · supprimer · ajouter_etape · retirer_etape · regler_etape · proposer · optimiser · preparer · marquer · client · feuille_de_routerequis

Lister (défaut) ; lire { tournee_id } ; creer { nom, jour, depart, rayon_km } ; modifier { tournee_id, nom?, jour?, depart?, rayon_km?, statut? } ; supprimer { tournee_id } ; ajouter_etape { tournee_id, fiche_id \

action_messagerendez_vous · depot_documents · presentation

Preparer : ce que le message propose.

adressetexte

Adresse d'un arret sans fiche (un rendez-vous), geocodee par la ban.

clientbooléen

client : true (défaut) pose le statut client sur la fiche de l'arret, false le remet en prospect.

corpstexte

Preparer : corps du message. Vide = compose depuis les reglages de prospection.

departtexte

Ville ou adresse de depart, résolue par la ban (creer, modifier).

duree_minentier

Durée de l'arret en minutes (défaut 30). (min 5, max 480)

emailtexte

Le destinataire du message de l'arret : écrit ici, jamais relu par l'outil.

etape_idtexte

Identifiant de l'arret (rendu par lire). Pour preparer : "toutes" = tous les arrets sans action.

fiche_idtexte

Une fiche de la base de l'utilisateur (base_suivis, ou proposer).

heuretexte

Hh:mm, l'heure fixee d'un rendez-vous. Vide = quand le trajet le veut.

jourtexte

Le jour, aaaa-mm-jj. Vide = a fixer.

naftexte

Proposer : codes NAF (5 caracteres) séparés par des virgules. Défaut : les activites les plus presentes dans la base.

naturerendez_vous · prospect

rendez_vous = point fixe a heure fixe ; prospect = insere ou le trajet le veut (défaut).

nomtexte

Nom de la tournee (creer, modifier) ou de l'arret (ajouter_etape).

notetexte

objettexte

Preparer : objet du message. Vide = compose depuis les reglages de prospection.

rayon_kmentier

Rayon des propositions autour des arrets (défaut 20). (min 1, max 50)

sirentexte

Une entreprise de l'annuaire : elle entre dans la base et dans la tournee.

sirettexte

Etablissement precis, facultatif avec siren.

statuttexte

Modifier : brouillon \

textetexte

feuille_de_route : la feuille de route du jour, ecrite par l'assistant après avoir prepare la tournee (l'ordre, les heures d'arrivee, ce qui manque), en texte simple, paragraphes séparés par une ligne vide. Elle s'affiche sur la tournee, en carte de l'agent IA. Vide = l'effacer. (max. Caractères 6000)

tournee_idtexte

Identifiant de la tournee (rendu par lister / creer).

Quand l'utiliser

Dans l'ordre : creer { nom, jour, depart } ; ajouter_etape pour les rendez-vous (nom + adresse + heure) ; proposer { tournee_id } pour voir les prospects de la base et de l'annuaire dans le rayon ; ajouter_etape { fiche_id } ou { siren } ; optimiser (ordre et trajet) ; preparer { etape_id | "toutes", action_message } pour écrire les messages. ⚠ Prescriptio n'envoie rien : le message part de la messagerie de l'utilisateur (ou de son assistant, depuis SA boite) ; marquer { statut: "envoyee" } enregistre qu'il est parti. Client { etape_id } pose le statut client sur la fiche. Une fois la tournee preparee, feuille_de_route { tournee_id, texte } y garde la feuille de route du jour (l'ordre, les heures d'arrivee, ce qui manque). Aucune coordonnee n'est rendue : le destinataire (email) s'écrit, ne se relit pas.

Texte du registre des outils, rendu lisible ; la vue agent le garde tel quel.

Le prompt qui le déclenche

Voir le prompt

Collez ce prompt dans votre agent IA, une fois Prescriptio connecté. Remplacez ce qui est entre crochets.

Prépare ma tournée de jeudi autour de Grenoble : mes rendez-vous fixes, les prospects à voir autour, et l'ordre de passage.

Outil : tournees · 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 et Authentification et quotas.

Les skills qui s'en servent

prescriptio-preparer-terrainLe skill du plugin qui route cet outil

Les pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite tournees.

ProspectionDocumentation, Les modules Préparer une tournée terrain autour de vos rendez-vousGuides, Prospecter Prompts de la prospectionIA, Prompts par métier Préparer une tournéeIA, Les skills du plugin Comment préparer une tournée de visites chez les applicateurs d'un secteur ?Base de connaissances, Agir auprès du bon interlocuteur

Voir aussi

Catalogue des outilsTous les outils, rangés par module

[Index de la documentation](https://prescriptio.fr/docs/llms.txt) # Préparer une tournée terrain L'outil tournees de Prescriptio prépare une journée de prospection sur le terrain : rendez-vous, prospects à voir autour, ordre de passage, trajet et message de chaque arrêt ; l'envoi se fait depuis votre messagerie. ### Squelette d'appel, généré depuis le schéma **MCP (JSON-RPC)** ```json { "id": 1, "jsonrpc": "2.0", "method": "tools/call", "params": { "arguments": { "action": "lister" }, "name": "tournees" } } ``` **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":{"action":"lister"},"name":"tournees"}}' ``` ### 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` | `lister` · `lire` · `creer` · `modifier` · `supprimer` · `ajouter_etape` · `retirer_etape` · `regler_etape` · `proposer` · `optimiser` · `preparer` · `marquer` · `client` · `feuille_de_route` | oui | lister (défaut) ; lire { tournee_id } ; creer { nom, jour, depart, rayon_km } ; modifier { tournee_id, nom?, jour?, depart?, rayon_km?, statut? } ; supprimer { tournee_id } ; ajouter_etape { tournee_id, fiche_id \ | | `action_message` | `rendez_vous` · `depot_documents` · `presentation` | — | preparer : ce que le message propose. | | `adresse` | texte | — | Adresse d'un arret sans fiche (un rendez-vous), geocodee par la BAN. | | `client` | booléen | — | client : true (défaut) pose le statut client sur la fiche de l'arret, false le remet en prospect. | | `corps` | texte | — | preparer : corps du message. Vide = compose depuis les reglages de prospection. | | `depart` | texte | — | Ville ou adresse de depart, résolue par la BAN (creer, modifier). | | `duree_min` | entier | — | Durée de l'arret en minutes (défaut 30). (min 5, max 480) | | `email` | texte | — | Le destinataire du message de l'arret : écrit ici, JAMAIS relu par l'outil. | | `etape_id` | texte | — | Identifiant de l'arret (rendu par lire). Pour preparer : "toutes" = tous les arrets sans action. | | `fiche_id` | texte | — | Une fiche de la base de l'utilisateur (base_suivis, ou proposer). | | `heure` | texte | — | HH:MM, l'heure fixee d'un rendez-vous. Vide = quand le trajet le veut. | | `jour` | texte | — | Le jour, AAAA-MM-JJ. Vide = a fixer. | | `naf` | texte | — | proposer : codes NAF (5 caracteres) séparés par des virgules. Défaut : les activites les plus presentes dans la base. | | `nature` | `rendez_vous` · `prospect` | — | rendez_vous = point fixe a heure fixe ; prospect = insere ou le trajet le veut (défaut). | | `nom` | texte | — | Nom de la tournee (creer, modifier) ou de l'arret (ajouter_etape). | | `note` | texte | — | — | | `objet` | texte | — | preparer : objet du message. Vide = compose depuis les reglages de prospection. | | `rayon_km` | entier | — | Rayon des propositions autour des arrets (défaut 20). (min 1, max 50) | | `siren` | texte | — | Une entreprise de l'annuaire : elle entre dans la base ET dans la tournee. | | `siret` | texte | — | Etablissement precis, facultatif avec siren. | | `statut` | texte | — | modifier : brouillon \ | | `texte` | texte | — | feuille_de_route : la feuille de route du jour, ecrite par l'assistant après avoir prepare la tournee (l'ordre, les heures d'arrivee, ce qui manque), en texte simple, paragraphes séparés par une ligne vide. Elle s'affiche sur la tournee, en carte de l'agent IA. Vide = l'effacer. (max. caractères 6000) | | `tournee_id` | texte | — | Identifiant de la tournee (rendu par lister / creer). | ## Quand l'utiliser Dans l'ordre : creer { nom, jour, depart } ; ajouter_etape pour les rendez-vous (nom + adresse + heure) ; proposer { tournee_id } pour voir les prospects de la base et de l'annuaire dans le rayon ; ajouter_etape { fiche_id } ou { siren } ; optimiser (ordre et trajet) ; preparer { etape_id | "toutes", action_message } pour écrire les messages. ⚠ Prescriptio n'ENVOIE rien : le message part de la messagerie de l'utilisateur (ou de son assistant, depuis SA boite) ; marquer { statut: "envoyee" } enregistre qu'il est parti. client { etape_id } pose le statut client sur la fiche. Une fois la tournee preparee, feuille_de_route { tournee_id, texte } y garde la feuille de route du jour (l'ordre, les heures d'arrivee, ce qui manque). Aucune coordonnee n'est rendue : le destinataire (email) s'écrit, ne se relit pas. **Prompt prêt à coller : Le prompt qui le déclenche** ```text Prépare ma tournée de jeudi autour de Grenoble : mes rendez-vous fixes, les prospects à voir autour, et l'ordre de passage. ``` Outil : `tournees` · 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-preparer-terrain](https://prescriptio.fr/skills/prescriptio-preparer-terrain) : Le skill du plugin qui route cet outil ## Les pages qui s'en servent Calculé depuis la documentation : chaque page qui cite `tournees`. - [Prospection](https://prescriptio.fr/docs/prospection) : Documentation, Les modules - [Préparer une tournée terrain autour de vos rendez-vous](https://prescriptio.fr/docs/guides/tournee-terrain) : Guides, Prospecter - [Prompts de la prospection](https://prescriptio.fr/docs/prompts/prospection) : IA, Prompts par métier - [Préparer une tournée](https://prescriptio.fr/skills/prescriptio-preparer-terrain) : IA, Les skills du plugin - [Comment préparer une tournée de visites chez les applicateurs d'un secteur ?](https://prescriptio.fr/docs/connaissances/tournee-terrain) : Base de connaissances, Agir auprès du bon interlocuteur ## Voir aussi - [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module