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ère | Valeur |
|---|---|
| Adresse | POST /api/v1/tools/get_funnel |
| Réponse | Sous data. |
| Nom de l'outil | get_funnel |
| 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 sont dans le corps de la requête, en JSON.
| 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 -X POST "$MARVESTO_URL/api/v1/tools/get_funnel" \
-H "x-api-key: $MARVESTO_API_KEY" \
-H "content-type: application/json" \
-d @corps.jsonLe 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.