MCP e IA / Herramientas con cuenta / tableau_de_bord

tableau_de_bord

Con cuentaSolo lectura

Las cifras de fidelidad del comercio en el periodo que elijas: visitas en caja, clientes que han venido, clientes nuevos, tasa de retorno, recompensas ganadas y entregadas, facturación estimada, con una curva por día, semana o mes y, si hace falta, la comparación con el periodo anterior de la misma duración. Úsala para «¿cómo va este mes?», «¿cuántos clientes en agosto?», «¿va subiendo?». Para la lista de clientes, usa chercher_clients; para saber si la tarjeta es rentable, rentabilite.

Parámetros

periodeenumopcional

Periodo analizado, en días de la zona horaria del comercio, con hoy incluido en los periodos en curso (ce_mois = del día 1 a hoy). «personnalisee» usa du/au. Por defecto derniers_30_jours.

Valores : aujourdhui hier derniers_7_jours derniers_30_jours derniers_90_jours derniers_12_mois cette_semaine semaine_derniere ce_mois mois_dernier cette_annee annee_derniere depuis_le_debut personnalisee

Por defecto : "derniers_30_jours"

dustring (date)opcional

Primer día incluido (AAAA-MM-DD). Basta con indicarlo: el periodo pasa a «personnalisee».

austring (date)opcional

Último día incluido (AAAA-MM-DD). Por defecto: hoy.

comparerbooleanopcional

Añade la variación respecto al periodo de la misma duración justo anterior (p. ej. los 30 días anteriores a los últimos 30 días).

Por defecto : true

indicateursarray<enum>, ≤ 9opcional

Indicadores que devolver, en este orden. Por defecto: todos. taux_retour = parte de los clientes que vinieron en el periodo y que ya habían venido antes; chiffre_estime = visitas × ticket medio declarado (una estimación, no una caja).

Valores : passages clients_venus nouveaux_clients taux_retour passages_par_client recompenses_gagnees recompenses_offertes chiffre_estime total_clients

courbeenumopcional

Lo que traza la curva. Por defecto passages.

Valores : passages clients_venus nouveaux_clients recompenses_gagnees recompenses_offertes aucune

Por defecto : "passages"

granulariteenumopcional

Paso de la curva. auto (por defecto): día hasta 2 meses, semana hasta ~9 meses, mes a partir de ahí.

Valores : auto jour semaine mois

Por defecto : "auto"

Respuesta

Un texto que lee el asistente (content) y la misma información en datos estructurados (structuredContent). En caso de rechazo (parámetro que corregir, plan, rol), la respuesta lleva isError: true y una frase que el asistente puede reformular.

¿Cómo va este mes, comparado con el mes pasado?

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tableau_de_bord",
    "arguments": {
      "periode": "ce_mois",
      "comparer": true
    }
  }
}

curl https://app.stampywallet.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer $STAMPY_JETON" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"tableau_de_bord","arguments":{"periode":"ce_mois","comparer":true}}}'

$STAMPY_JETON es el token OAuth que obtiene el asistente cuando conectas tu cuenta (ver Conectar). No tienes que manejarlo tú.

Actualizado el 22 de octubre de 2026

¿Te ha sido útil esta página?