Aller au contenu
Lire les chiffres/Lire le funnel

Lire le funnel

Donne le funnel sur une période qui finit avec le dernier mois entier de l'export du CRM.

Les volumes par étape et par canal, les conversions, les deals créés, le coût par étape. Les deals gagnés par canal demandent aussi le droit de lire le rendement par canal.

Appel

RepèreValeur
AdressePOST /api/v1/tools/get_funnel
RéponseSous data.
Nom de l'outilget_funnel
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 sont dans le corps de la requête, en JSON.

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 -X POST "$MARVESTO_URL/api/v1/tools/get_funnel" \
  -H "x-api-key: $MARVESTO_API_KEY" \
  -H "content-type: application/json" \
  -d @corps.json

Le fichier corps.json :

{
  "asOf": "2026-11-12",
  "months": 3
}

Réponse

Ce que l'écran affiche au membre de la clé : chaque valeur avec son statut, une valeur indisponible à null, et ce qui lui est masqué dit avec sa raison.

Refus

Un refus répond { "message": "…" }, en français, avec son statut HTTP : voir Droits et erreurs.