Aller au contenu
Envoyer des données/Envoyer des volumes suivis hors du CRM

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èreValeur
AdressePOST /api/v1/funnel/volume-proposals
Par son nomPOST /api/v1/tools/propose_funnel_volumes, la réponse sous data
Nom de l'outilpropose_funnel_volumes
Droit demandéValider le mapping du CRM (crmMapping.validate)
Rôles qui ont ce droit par défautPropriétaire, CMO, Marketing Ops, VP Sales
Par MCPOui : l'envoi attend une personne.

Paramètres

Les paramètres sont dans le corps de la requête, en JSON.

ParamètreRequisType et limitesÀ quoi il sert
nameouitexte, 1 à 80 caractèresLe nom de la proposition.
linesouiliste d'objets, 1 à 1 200 élémentsLes volumes : un par canal, mois et étape.
lines[].monthouimois, AAAA-MMLe mois compté.
lines[].channelouitexte, 120 caractères au plusLe canal : une clé du catalogue ou son nom. Une autre valeur est associée une fois à un canal, à l'écran.
lines[].stageouivaleur au choix, lead, mql, sql, sqo, wonL'étape : lead, mql, sql, sqo, ou won pour un deal gagné.
lines[].countouinombre entier, 0 ou plusLe 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.json

Le 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.