Ir al contenido
StampyWalletDocs
MCP e IA / Herramientas con cuenta / modifier_carte

modifier_carte

Con cuentaEscribe (confirmar)

Cambia uno o varios ajustes de la tarjeta de fidelidad del comercio, en una sola llamada: nombre impreso, estilo (colección, paleta o color libre), sello, regla de recompensa (modo tampons/paliers/points, umbrales, recompensas), sellos de regalo al registrarse, caducidad de las recompensas, en modo paliers la forma de la tarjeta (forme_paliers: tampons o una de las cinco formas), y en modo points el nombre de los puntos, la forma de la tarjeta (forme_points), el valor por defecto de una visita, los atajos y los puntos por euro. Solo cambian los ajustes indicados; lee primero la tarjeta con voir_carte. Llámala con confirmer=false (por defecto) para enseñar el antes/después, y luego con confirmer=true tras la aprobación explícita. Un cambio de regla se aplica también a las tarjetas que ya tienen los clientes. Las imágenes (logo, fondo, sello en imagen) se cambian en la aplicación, página Tarjeta.

Parámetros

nomstring, ≤ 80 caracteresopcional
Nombre del comercio, impreso en la parte superior de la tarjeta.
modeenumopcional
tampons: una recompensa en un umbral (lo más sencillo). paliers: varias recompensas en la misma tarjeta (p. ej. 5 y 10). points: el comerciante introduce un número de puntos en cada visita (tickets variables).

Valores : tampons paliers points

recompensestring, ≤ 120 caracteresopcional
La recompensa (modo tampons). Se ignora si se indica «paliers».
tamponsinteger, 2…30opcional
Número de visitas para conseguir la recompensa (modo tampons), de 2 a 30.
paliersarray<object>, ≤ 6opcional
Las recompensas y sus umbrales (modos paliers y points). De menor a mayor.
paliers[].ainteger, 1…1000000obligatorio
Umbral: número de sellos (o de puntos en modo points) para conseguir este nivel.
paliers[].recompensestring, ≤ 120 caracteresobligatorio
Lo que recibe el cliente, tal como se imprime en la tarjeta. P. ej. «Un café gratis».
paliers[].iconeenumopcional
Icono del nivel (por defecto: cadeau).
Valores (63)

etincelle eclat goutte main pinceau oeil ciseaux sechoir fleur lotus coeur etoile diamant couronne soleil lune talon robe sac serviette cafe grain the cookie gateau pain part burger glace bol plat verre biere bulles cocktail cerises orange avocat piment oeuf poisson fromage popcorn feuille flamme eclair sourire patte chien chat cadeau haltere velo livre note appareil palette dent parapluie ballon tshirt basket croissant

collectionenumopcional
Estilo de la tarjeta: original (sobrio), cafe (marco fino), botanique (cursiva, follaje), trattoria (festoneado), atelier (moderno), pass (como un pase de Apple Wallet: logo en grande, sellos como objetos con sombra, fondo liso).

Valores : original cafe botanique trattoria atelier pass

paletteinteger, 0…3opcional
Paleta de la colección: 0, 1 o 2 (cada colección propone tres; pass propone una cuarta, 3). Se ignora si se indica «couleur».
couleurstringopcional
Color de fondo libre, en hexadecimal. La tinta (texto) se elige automáticamente para que siga siendo legible.
tamponenumopcional
El signo que se pone en cada visita. «rond»: el punto simple. Belleza: etincelle, eclat, goutte, main, pinceau, oeil, ciseaux, sechoir, fleur, lotus, coeur, etoile, diamant, couronne, soleil, lune, talon, robe, sac, serviette. Comida: cafe, grain, the, cookie, gateau, pain, part, burger, glace, bol, plat, verre, biere, bulles, cocktail, cerises, orange, avocat, piment, oeuf, poisson, fromage, popcorn. Varios: feuille, flamme, eclair, sourire, patte, chien, chat, cadeau, haltere, velo, livre, note, appareil, palette, dent, parapluie, ballon, tshirt, basket.
Valores (64)

rond etincelle eclat goutte main pinceau oeil ciseaux sechoir fleur lotus coeur etoile diamant couronne soleil lune talon robe sac serviette cafe grain the cookie gateau pain part burger glace bol plat verre biere bulles cocktail cerises orange avocat piment oeuf poisson fromage popcorn feuille flamme eclair sourire patte chien chat cadeau haltere velo livre note appareil palette dent parapluie ballon tshirt basket croissant

tampons_bienvenueinteger, 0…5opcional
Sellos de regalo al registrarse el cliente (0 a 5). 1 por defecto: una tarjeta empezada da ganas de terminarla.
nom_des_pointsstring, ≤ 20 caracteresopcional
Modo points: cómo se llaman los puntos («puntos», «semillas», «estrellas»…).
forme_paliersenumopcional
Modo paliers: el dibujo de la tarjeta. tampons (por defecto): los sellos en cuadrícula, cada recompensa en el lugar del sello de su umbral. O una de las cinco formas de los puntos, que entonces cuenta sellos: medailles (una barra y una medalla por recompensa), vitrine (las recompensas una al lado de otra, cada una con su barra), remplissage (la próxima recompensa en grande, que se va coloreando), chemin (una ruta en S en la que cada sello hace avanzar el cursor), anneau (una barra circular alrededor de la próxima recompensa). Las fotos de las recompensas se suben en la aplicación, página Tarjeta.

Valores : tampons medailles vitrine remplissage chemin anneau

forme_pointsenumopcional
Modo points: el dibujo de la tarjeta. medailles (por defecto): una barra gruesa y una medalla grande por recompensa. vitrine: las recompensas una al lado de otra, cada una con su barra pequeña. remplissage: la próxima recompensa en grande, que se va coloreando. chemin: una ruta en S, con las recompensas como etapas. anneau: una barra circular alrededor de la próxima recompensa, con la lista al lado. Las fotos de las recompensas se suben en la aplicación, página Tarjeta.

Valores : medailles vitrine remplissage chemin anneau

expiration_recompense_joursinteger, 0…365opcional
Días durante los que una recompensa ganada sigue siendo válida: 0, 30, 60, 90, 180, 365 (0 = no caduca).
points_par_defautinteger, 1…100000opcional
Modo points: puntos que se ponen por defecto en cada visita (1 a 100 000).
points_raccourcisarray<integer>, ≤ 12opcional
Modo points: los valores propuestos con un gesto al escanear (hasta 6, ordenados y sin duplicados). P. ej. [1, 2, 5, 10].
points_par_euronumber, 0.01…10000opcional
Modo points: puntos por euro gastado, referencia mostrada al comerciante (p. ej. 1 o 0,5).
confirmerbooleanopcional
false (por defecto): solo devuelve una vista previa de lo que se haría, sin cambiar nada. true: ejecuta. Enseña siempre la vista previa a la persona y espera su aprobación antes de volver a llamar con true.

Por defecto : false

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.

Atención : esta herramienta escribe. Llamada con confirmer: false (por defecto), solo devuelve una vista previa, sin cambiar nada. El asistente debe enseñártela y esperar tu aprobación antes de volver a llamarla con confirmer: true.

Actualizado el

¿Te ha sido útil esta página?