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

chercher_clients

Con cuentaSolo lectura

Lista los clientes del comercio según un segmento (habituales, perdidos de vista, a un sello de la recompensa, recompensa por entregar, nuevos, inactivos, que nunca han vuelto) combinado con filtros: nombre, sellos en la tarjeta, número de visitas, fecha de registro, fecha de última visita, tipo de wallet; ordenados y paginados. Devuelve para cada uno un identificador, el nombre y la inicial del apellido, las visitas, la última visita y el estado de la tarjeta, nunca correo ni teléfono. Úsala para «¿quiénes son mis mejores clientes?», «¿quién no ha vuelto?», «¿quién está cerca de su recompensa?», o para encontrar el identificador de un cliente antes de fiche_client.

Parámetros

segmentenumopcional
Grupo de partida, definido como en la aplicación. tous (por defecto); habitues = al menos 4 visitas en los últimos 60 días; perdus = han venido al menos 4 veces y faltan desde hace más de una vez y media su ritmo habitual (mediana de los intervalos entre sus visitas) o, sin historial suficiente, desde hace más que el plazo del comercio; vacaciones y días de cierre no cuentan; presque = solo les falta un sello para la recompensa; recompense_prete = una recompensa ganada, aún no entregada y no caducada; nouveaux = registrados en los últimos 30 días; inactifs = ninguna visita desde hace más que el plazo del comercio, en días naturales, sea cual sea su número de visitas; un_seul_passage = una visita como máximo: registrados pero nunca han vuelto.

Valores : tous habitues perdus presque recompense_prete nouveaux inactifs un_seul_passage

Por defecto : "tous"

recherchestring, ≤ 60 caracteresopcional
Fragmento del nombre o del apellido (se ignoran acentos y mayúsculas).
tampons_mininteger, ≥ 0opcional
Sellos como mínimo en la tarjeta actual.
tampons_maxinteger, ≥ 0opcional
Sellos como máximo en la tarjeta actual.
visites_mininteger, ≥ 0opcional
Visitas como mínimo desde el registro (sin contar los sellos de bienvenida).
visites_maxinteger, ≥ 0opcional
Visitas como máximo desde el registro.
inactif_depuis_joursinteger, 1…3650opcional
Ninguna visita desde hace al menos N días naturales (un cliente que nunca ha venido cuenta desde su registro).
actif_depuis_joursinteger, 1…3650opcional
Al menos una visita en los últimos N días.
inscrit_depuisstring (date)opcional
Registrado ese día o después (AAAA-MM-DD).
inscrit_avantstring (date)opcional
Registrado ese día o antes (AAAA-MM-DD).
derniere_visite_depuisstring (date)opcional
Última visita ese día o después (AAAA-MM-DD).
derniere_visite_avantstring (date)opcional
Última visita ese día o antes (AAAA-MM-DD). Excluye a quienes nunca han venido.
walletenumopcional
Dónde guarda el cliente su tarjeta. aucun = página web, sin wallet.

Valores : tous apple google aucun

Por defecto : "tous"

trienumopcional
Orden de los resultados. Por defecto derniere_visite (los más recientes primero).

Valores : derniere_visite visites visites_90j tampons recompenses inscription prenom

Por defecto : "derniere_visite"

ordreenumopcional
auto (por defecto): descendente, salvo prenom (A→Z).

Valores : auto asc desc

Por defecto : "auto"

limiteinteger, 1…100opcional
Número máximo de resultados.

Por defecto : 25

decalageinteger, ≥ 0opcional
Número de resultados que saltar (paginación).

Por defecto : 0

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.

Actualizado el

¿Te ha sido útil esta página?