Lire le pipeline
Donne le pipeline sur une période qui finit avec le dernier mois entier de l'export du CRM.
Le taux de closing des deals clos dans la période (gagnés sur gagnés et perdus, en nombre et en montant, par canal et par mois), les deals créés, le cycle de vente, les motifs de perte, le mouvement du pipeline mois par mois, le temps passé dans chaque étape et le pipeline ouvert par étape.
Les nombres et les montants sont ceux du CRM. Chaque taux porte son échantillon. Les deals gagnés par canal demandent aussi le droit de lire le rendement par canal. Le propriétaire d'un deal n'est jamais donné.
Appel
| Repère | Valeur |
|---|---|
| Adresse | GET /api/v1/pipeline |
| Par son nom | POST /api/v1/tools/get_pipeline, la réponse sous data |
| Nom de l'outil | get_pipeline |
| Droit demandé | Lire le funnel (funnel.read) |
| Rôles qui ont ce droit par défaut | Propriétaire, CMO, Marketing Ops, VP Sales, DAF, Lecteur / auditeur |
| Par MCP | Oui, en lecture. |
Paramètres
Les paramètres suivent l'adresse, après ?.
| Paramètre | Requis | Type et limites | À quoi il sert |
|---|---|---|---|
asOf | oui | date, AAAA-MM-JJ | Le jour de lecture. En général, aujourd'hui. |
months | oui | valeur au choix, 1, 3, 6, 12, fiscal_year | La période : 1, 3, 6 ou 12 mois, ou fiscal_year pour l'exercice en cours. |
Exemple
curl "$MARVESTO_URL/api/v1/pipeline?asOf=2026-11-12&months=3" \
-H "x-api-key: $MARVESTO_API_KEY"Réponse
Les lectures de l'écran Pipeline, chacune avec son statut.
Refus
Un refus répond { "message": "…" }, en français, avec son statut HTTP : voir Droits et erreurs.