Aller au contenu
Lire les chiffres/Lire le pipeline

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èreValeur
AdresseGET /api/v1/pipeline
Par son nomPOST /api/v1/tools/get_pipeline, la réponse sous data
Nom de l'outilget_pipeline
Droit demandéLire le funnel (funnel.read)
Rôles qui ont ce droit par défautPropriétaire, CMO, Marketing Ops, VP Sales, DAF, Lecteur / auditeur
Par MCPOui, en lecture.

Paramètres

Les paramètres suivent l'adresse, après ?.

ParamètreRequisType et limitesÀ quoi il sert
asOfouidate, AAAA-MM-JJLe jour de lecture. En général, aujourd'hui.
monthsouivaleur au choix, 1, 3, 6, 12, fiscal_yearLa 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.