Envoyer des volumes suivis hors du CRM
Dépose des volumes que le CMO suit hors du CRM (salons, opérations terrain) : pour un canal et un mois, le nombre de leads, de MQL, de SQL, de SQO ou de deals gagnés.
Des nombres seulement, jamais un contact. Là où le CRM compte déjà un canal, un mois et une étape, c'est le CRM qui est lu.
Rien n'est compté à l'envoi. Qui saisit les volumes examine la proposition sur la page Données et la valide ou la refuse. Un envoi plus récent sous le même nom remplace celui qui attend.
Un canal, un mois et une étape n'apparaissent qu'une fois par envoi. Un mois à venir est refusé. Les deals gagnés par canal demandent aussi le droit de lire le rendement par canal.
Appel
| Repère | Valeur |
|---|---|
| Adresse | POST /api/v1/funnel/volume-proposals |
| Par son nom | POST /api/v1/tools/propose_funnel_volumes, la réponse sous data |
| Nom de l'outil | propose_funnel_volumes |
| Droit demandé | Valider le mapping du CRM (crmMapping.validate) |
| Rôles qui ont ce droit par défaut | Propriétaire, CMO, Marketing Ops, VP Sales |
| Par MCP | Oui : l'envoi attend une personne. |
Paramètres
Les paramètres sont dans le corps de la requête, en JSON.
| Paramètre | Requis | Type et limites | À quoi il sert |
|---|---|---|---|
name | oui | texte, 1 à 80 caractères | Le nom de la proposition. |
lines | oui | liste d'objets, 1 à 1 200 éléments | Les volumes : un par canal, mois et étape. |
lines[].month | oui | mois, AAAA-MM | Le mois compté. |
lines[].channel | oui | texte, 120 caractères au plus | Le canal : une clé du catalogue ou son nom. Une autre valeur est associée une fois à un canal, à l'écran. |
lines[].stage | oui | valeur au choix, lead, mql, sql, sqo, won | L'étape : lead, mql, sql, sqo, ou won pour un deal gagné. |
lines[].count | oui | nombre entier, 0 ou plus | Le nombre d'entrées dans l'étape ce mois-là. |
Exemple
curl -X POST "$MARVESTO_URL/api/v1/funnel/volume-proposals" \
-H "x-api-key: $MARVESTO_API_KEY" \
-H "content-type: application/json" \
-d @corps.jsonLe fichier corps.json :
{
"name": "Salons T3",
"lines": [
{
"month": "2026-09",
"channel": "events",
"stage": "lead",
"count": 140
},
{
"month": "2026-09",
"channel": "events",
"stage": "sqo",
"count": 12
}
]
}Réponse
proposalId, lineCount (les volumes reçus) et superseded (les propositions en attente remplacées).
{
"proposalId": "PROPOSAL_ID",
"lineCount": 2,
"superseded": 0
}Refus
Un refus répond { "message": "…" }, en français, avec son statut HTTP : voir Droits et erreurs.