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

envoyer_message

Con cuentaEscribe (confirmar)

Envía una notificación a la pantalla de bloqueo de los clientes (a través de su tarjeta de Apple Wallet o Google Wallet). Úsala para anunciar una novedad, una oferta, un evento o hacer que vuelvan los clientes. La audiencia es configurable (todos, habituales, perdidos de vista, casi en la recompensa, nuevos, recompensa por recoger, inactivos) y se combina con filtros (días sin visita, sellos en la tarjeta, visitas, fecha de registro). Texto de 180 caracteres como máximo, enviado tal cual. Un solo mensaje al día por comercio. Llámala primero con confirmer=false: la vista previa da el texto exacto, el número de destinatarios y cuántos pueden recibirlo de verdad, sin enviar nada. Llámala con confirmer=true solo tras la aprobación explícita de la persona: un mensaje enviado no se puede recuperar. Para los mensajes automáticos (recordatorio, cumpleaños, avisos), usa regler_automatismes.

Parámetros

textestring, ≤ 180 caracteresobligatorio
El texto exacto de la notificación, 180 caracteres como máximo. En el móvil va precedido del nombre del comercio: no hace falta repetirlo.
audienceenumopcional
Quién recibe el mensaje. tous = todos los clientes; habitues = 4 visitas o más en 60 días; perdus = habituales cuya ausencia supera una vez y media su ritmo habitual, o el plazo del comercio si no hay historial suficiente (la definición de la pantalla Clientes); presque = solo falta un sello para la recompensa; nouveaux = registrados en los últimos 30 días (o desde inscrit_depuis); recompense_prete = una recompensa ganada, aún no recogida; inactifs = cualquier cliente sin visitas desde hace inactif_depuis_jours días de apertura (por defecto el plazo del comercio), habitual o no. Cualquier audiencia distinta de tous, o cualquier filtro, requiere la función «notificaciones segmentadas».

Valores : tous habitues perdus presque nouveaux recompense_prete inactifs

Por defecto : "tous"

inactif_depuis_joursinteger, 1…730opcional
Filtro: sin visitas desde hace al menos N días de APERTURA (los días de cierre y las vacaciones no cuentan).
actif_depuis_joursinteger, 1…730opcional
Filtro: al menos una visita en los últimos N días de apertura.
tampons_mininteger, 0…500opcional
Filtro: al menos N sellos en la tarjeta actual.
tampons_maxinteger, 0…500opcional
Filtro: como máximo N sellos en la tarjeta actual.
passages_mininteger, 1…10000opcional
Filtro: al menos N visitas en total desde el registro.
inscrit_depuisstring (date)opcional
Filtro: registrados ese día o después (AAAA-MM-DD).
inscrit_avantstring (date)opcional
Filtro: registrados antes de ese día (AAAA-MM-DD, excluido).
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?