add_payment_method
ChatGPTAgrega una forma de pago que el reseller acepta. Las instrucciones (número de cuenta, SINPE, a nombre de quién) se muestran al negocio para que sepa cómo pagar. No incluyas números de tarjeta ni contraseñas: Tacty no procesa pagos, solo le muestra estas instrucciones al negocio.
add_visit
ChatGPTRegistra una visita o compra en una tarjeta de un cliente; es la acción autorizada que hace avanzar el programa. Si el negocio tiene varias tarjetas, indica en cuál con program_id (si el cliente tiene solo una de ellas, se usa esa). En tarjetas de sellos suma 1; en tarjetas de puntos envía amount (monto de la compra) y suma los puntos que correspondan. Al completar la meta genera la recompensa automáticamente. Identifica al cliente con customer_id o con phone. Envía idempotency_key si puedes reintentar la misma operación: con la misma clave nunca se duplica.
adjust_visits
ChatGPTCorrección manual: suma o resta sellos a un cliente con un motivo obligatorio (por ejemplo, migrar una tarjeta de cartón). Queda registrado en el ledger como ajuste. Para deshacer una visita concreta usa cancel_visit.
archive_loyalty_program
ChatGPTArchiva una tarjeta del negocio: deja de aceptar inscripciones y visitas. Quienes la tienen en su Wallet la siguen viendo y sus premios siguen canjeables. Sus puntos NFC/QR pasan a abrir la tarjeta principal. No se puede archivar la única tarjeta activa: para cambiarla crea otra con replace_program_id.
cancel_reseller_invite
ChatGPTAnula una invitación a la cuenta del reseller que todavía no se aceptó: el enlace deja de servir.
cancel_visit
ChatGPTAnula una visita registrada por error. No borra nada: agrega un movimiento de cancelación al ledger. Si esa visita había completado una recompensa aún sin canjear, la recompensa se revierte.
create_business
ChatGPTCrea un negocio nuevo en la cartera del reseller y, si envías plan_id, lo suscribe a ese plan con su primer cobro. Después conviene: create_loyalty_program (programa de visitas), create_nfc_asset (puntos NFC/QR) y create_employee (personal que confirma visitas). plan_id solo registra el plan acordado con el negocio; Tacty no le cobra nada.
create_custom_automation
ChatGPTGuarda una automatización propia del negocio, armada como «cuándo, a quién y qué mensaje»: por ejemplo, los martes a las 3 p. m., a quienes no vienen hace 3 semanas, «¡{nombre}, hoy el café va por la casa!». Queda corriendo en los servidores de Tacty: cada semana, en ese día y esa hora, le llega el aviso a la tarjeta del Wallet de quienes cumplen los filtros (los mismos de find_customers), nunca dos veces a la misma persona dentro de cooldown_days. Puede llevar una promo dibujada. El dueño la ve y la apaga en el panel (Automatizaciones). Antes de crearla, muéstrale al dueño el mensaje, el grupo (cuántos son, con find_customers) y la promo (preview_wallet_promo), y créala solo con su sí.
create_customer
ChatGPTInscribe a un cliente en un negocio con su nombre y teléfono y le crea su tarjeta digital (en la tarjeta indicada con program_id, o en la principal). El teléfono identifica al cliente: si ya existe, devuelve el cliente existente (created: false) en vez de duplicarlo, y le agrega esa tarjeta si aún no la tenía.
create_employee
ChatGPTDa de alta a una persona del negocio que confirmará visitas y canjes. No necesita correo ni cuenta: con la cámara de su teléfono escanea el QR de la tarjeta del cliente y escribe su PIN (la primera vez en ese teléfono); después confirma con un toque. El PIN se devuelve una sola vez; compártelo con esa persona. Solo sirve para confirmar visitas y canjes en ese negocio; no da acceso al panel ni a otros negocios.
create_loyalty_program
ChatGPTCrea una tarjeta de fidelización en un negocio. Un negocio puede tener varias tarjetas activas a la vez (por ejemplo una de miembros y otra de puntos): cada una es su propio pase en el Wallet del cliente, con su propio punto NFC/QR (se crea solo) y su diseño. kind "member": la tarjeta base de Tacty, con la que todo negocio empieza; el cliente se hace miembro, recibe los avisos del negocio y cada visita queda registrada; reward es opcional (su beneficio de miembro). kind "stamps": cada visita confirmada suma un sello y con visits_required sellos gana la recompensa. kind "points": cada compra suma puntos según su monto (amount_per_point) y con points_required puntos gana la recompensa. kind "coupon": al inscribirse el cliente recibe un regalo de un solo uso (reward) que vence a los valid_days días; el personal lo canjea con redeem_reward. kind "discount": el cliente tiene un beneficio fijo (reward, por ejemplo "10 % en todo") cada vez que viene; el personal registra cada uso con add_visit. Para cambiar una tarjeta sin perder el progreso usa update_loyalty_program. Para reemplazar una tarjeta por esta (los clientes que la tenían reciben la nueva en el mismo pase del Wallet, y la vieja se archiva con sus premios canjeables) usa replace_program_id; replace_existing: true reemplaza todas las activas. Puntos: máximo de compras que un mismo cliente puede registrar por día.
create_nfc_asset
ChatGPTCrea uno o varios puntos de contacto de un negocio. Cada uno es una dirección web fija con su código QR descargable y una hoja lista para imprimir (print_url); el negocio imprime el QR o graba la dirección en un tag NFC que consigue por su cuenta (Tacty no envía objetos físicos). Al tocarlo o escanearlo, el cliente abre su tarjeta de fidelización o se inscribe. Requiere que el negocio ya tenga tarjeta (create_loyalty_program).
create_plan
ChatGPTCrea un plan del reseller: cuánto cobra, en qué moneda y si es mensual o anual. Los negocios se asignan a un plan. Solo registra el precio; Tacty no procesa pagos.
create_promotion
ChatGPTCrea una promoción de texto para un negocio (por ejemplo, para llenar sus horas flojas). Aparece en la tarjeta digital de sus clientes y en el reverso de su pase de Apple Wallet. No envía notificación: para avisar al teléfono usa send_wallet_update.
delete_custom_automation
ChatGPTBorra una automatización a la medida: deja de correr. Los avisos que ya salieron quedan en el registro. Para pausarla sin perderla, mejor apágala con update_custom_automation (enabled: false). Confirma con el dueño antes de borrar.
find_customers
ChatGPTArma un grupo de clientes de un negocio combinando los criterios que quieras: visitas, días sin venir, fecha de inscripción, sellos o puntos, premios, cumpleaños, Wallet, referidos, compras y hábitos (días de la semana y horas en que vienen). Devuelve cuántos son y los primeros (limit). Para mandarles un aviso, usa send_wallet_update con estos mismos filters.
get_activity
ChatGPTMovimientos recientes del ledger de un negocio (visitas, recompensas ganadas y canjeadas, ajustes, cancelaciones), del más nuevo al más viejo. Indica quién hizo cada uno.
get_best_times
ChatGPTVisitas por día de la semana y por hora (en la zona horaria del negocio) en una ventana de días, con los momentos más fuertes y los más flojos. Sirve para programar promociones en las horas muertas.
get_billing
ChatGPTSuscripción que el reseller le cobra a un negocio, el cobro pendiente (con lo pagado y lo que falta), el historial de pagos y las formas de pago aceptadas. El dueño del negocio también puede consultarla para saber cuánto y cuándo paga.
get_business
ChatGPTDevuelve la ficha completa de un negocio: datos, marca, sus tarjetas activas (programs; program es la principal), puntos NFC/QR, enlace del personal y conteos.
get_business_analytics
ChatGPTMétricas de un negocio en una ventana de días: clientes, visitas, clientes activos, tasa de repetición, recompensas, toques/escaneos de sus puntos NFC/QR, inscripciones y visitas por día.
get_customer
ChatGPTFicha de un cliente: sus tarjetas en el negocio (cada una con su progreso y su enlace para reenviársela), recompensas y últimos movimientos.
get_customers
ChatGPTLista o busca clientes de un negocio con su progreso en una tarjeta (program_id; sin ella, la principal). Con program_id solo salen quienes tienen esa tarjeta. Segmentos: "inactive" (sin visitas en inactive_days días), "new" (inscritos en los últimos 30 días), "frequent" (5 visitas o más), "birthday_month" (cumplen años este mes), "near_reward" (les falta poco para el premio), "reward_available" (tienen recompensa por canjear). Con send_wallet_update se le puede mandar un aviso a un segmento.
get_customers_at_risk
ChatGPTClientes que se están perdiendo: los que tienen ritmo (3 visitas o más) y llevan más de 1,25 veces su ritmo sin venir, y los que sin ritmo llevan más de inactive_days sin venir. Ordenados por cuánto se pasaron. Ideal para decidir a quién mandar una oferta.
get_reseller
ChatGPTDatos del reseller: nombre comercial, color, logo y correo de contacto. Es la marca con la que sus negocios reciben los correos.
get_reseller_overview
ChatGPTVista de toda la cartera del reseller: negocios activos (con visitas, toques o inscripciones en la ventana), totales de clientes y visitas, y una fila por negocio con su actividad y promociones creadas. Sirve para detectar negocios sin uso.
get_setup_status
ChatGPTDice qué pasos de la activación de la fidelización digital ya están hechos en un negocio y cuál sigue: 1) negocio creado, 2) tarjeta (programa) definida, 3) punto NFC/QR creado, 4) alguien que confirme visitas, 5) primer cliente. Úsala al empezar a trabajar con un negocio y después de cada paso, para guiar a la persona sin que se pierda.
get_top_customers
ChatGPTLos clientes que más vienen (y más gastan, en tarjetas de puntos) en una ventana de días, con su ritmo de visita y su última visita. Sirve para saber a quién cuidar y a quién premiar.
invite_business_user
ChatGPTInvita al dueño o encargado de un negocio a crear su contraseña y entrar al panel de ese negocio (solo ve ese negocio). Sirve si el negocio se creó sin owner_email o si el enlace de bienvenida venció. Se le envía un correo con la marca del reseller y además se devuelve el enlace por si prefieres compartirlo tú. Vence en 14 días.
invite_reseller_user
ChatGPTInvita a una persona a la cuenta del reseller con los permisos que indiques. Le llega un correo con la marca del reseller para crear su acceso, y además se devuelve el enlace por si prefieres compartirlo tú. Vence en 14 días. Solo puedes dar los permisos que tú tienes.
list_assets
ChatGPTLista los puntos NFC/QR de un negocio con su URL, su QR y cuántas veces se tocaron o escanearon en los últimos 30 días.
list_automations
ChatGPTLas recetas de avisos automáticos de un negocio: si están encendidas, su mensaje, su ajuste de días, su regalo, si aplican a su tipo de tarjeta, cuántos avisos salieron en 30 días y cuántos clientes volvieron después, y cuántos clientes las recibirían hoy. Los avisos llegan a la tarjeta del Wallet del cliente.
list_billing
ChatGPTUna fila por negocio con su plan, próxima fecha de pago, lo pendiente y el estado: ok (al día), due_soon (vence en 7 días), partial (pagó una parte), overdue (vencido), paused o none (sin plan). Incluye totales: MRR (ingreso mensual recurrente) por moneda, por cobrar y vencidos. Úsala para saber a quién cobrar y cuánto genera la cartera.
list_businesses
ChatGPTLista los negocios de la cartera con su programa activo, número de clientes y visitas de los últimos 30 días. Empieza por aquí para obtener los business_id.
list_custom_automations
ChatGPTLas automatizaciones propias del negocio (las que armó el asistente con el dueño): cuándo salen, a quién (en palabras y con sus filtros), el mensaje, la promo (con su imagen), si están encendidas, cuántos avisos salieron en 30 días y cuántos de esos clientes volvieron después, y a cuántos les llegaría hoy. Úsala para medir y ajustar.
list_employees
ChatGPTLista el personal de un negocio (quienes confirman visitas con su PIN). Los PIN no se pueden consultar; usa update_employee con reset_pin para generar uno nuevo.
list_loyalty_programs
ChatGPTLista las tarjetas de fidelización de un negocio: las activas (puede haber varias) y las archivadas, con cuántos clientes tiene cada una y su punto NFC/QR. La primera activa es la principal: la que abre un punto NFC/QR sin tarjeta propia.
list_payment_methods
ChatGPTFormas de pago que el reseller acepta de sus negocios (SINPE, transferencia, efectivo…), con las instrucciones que ve el negocio. Son solo instrucciones de texto; Tacty no guarda tarjetas ni procesa pagos.
list_plans
ChatGPTPlanes que el reseller ofrece a sus negocios: nombre, monto, moneda y periodo. Al dar de alta un negocio se le asigna uno (create_business con plan_id o set_subscription). Son los precios que el reseller cobra por su cuenta; Tacty no procesa pagos.
list_promotions
ChatGPTLista las promociones de un negocio. Por defecto solo las activas.
list_reseller_users
ChatGPTLista los usuarios de la cuenta del reseller con su rol (owner: dueño, admin o member) y sus permisos, y las invitaciones que todavía no aceptan. El dueño y los admin tienen todos los permisos.
open_demo
ChatGPTEntra al café demo del reseller (Café Altura) para mostrarle Tacty a un dueño de negocio: unos 330 clientes de ejemplo con meses de historia que siguen avanzando cada día. Úsalo cuando la persona diga "modo demo", "demo" o quiera enseñar cómo funciona. Devuelve el business_id: úsalo con todas las demás herramientas mientras dure el modo demo. El café demo no aparece en list_businesses ni en el resumen de la cartera. Los avisos a los clientes de ejemplo quedan en sus tarjetas y no salen a ningún teléfono.
preview_wallet_promo
ChatGPTDibuja una promo con los colores de la tarjeta, sin enviar nada. Devuelve preview_url: una imagen que puedes mostrarle al dueño (como imagen en el chat) antes de mandarla con send_wallet_update o de guardarla en una automatización a la medida. shows_as dice cómo se verá: "strip" (ocupa la franja de la tarjeta) o "band" (tarjetas de sellos o puntos: una cinta con la etiqueta, el titular y el sello arriba del avance; la imagen de la vista previa ya la muestra así).
reactivate_loyalty_program
ChatGPTVuelve a activar una tarjeta archivada del negocio: acepta otra vez inscripciones y visitas, y quienes la tenían conservan su progreso. Su punto NFC/QR vuelve a abrirla (si ya no tenía uno, se le crea). Se suma a las tarjetas activas como la más reciente; no reemplaza a ninguna ni cambia la principal.
record_payment
ChatGPTRegistra un pago recibido de un negocio (completo o parcial) y lo aplica al cobro abierto más antiguo, o al cobro indicado. Cuando el cobro queda cubierto se marca pagado y se genera el cobro del siguiente periodo con la nueva fecha de pago.
redeem_reward
ChatGPTMarca como entregada una recompensa disponible de un cliente. Sin reward_id canjea la más antigua (de la tarjeta program_id, si se indica). No se puede deshacer.
remove_reseller_user
ChatGPTLe quita a un usuario el acceso a la cuenta del reseller. Si esa persona no tiene acceso a ninguna otra cuenta ni negocio, también se borra su usuario. No se puede quitar al dueño ni a uno mismo.
send_payment_reminder
ChatGPTEnvía por correo al dueño del negocio un recordatorio del cobro pendiente (monto, fecha y formas de pago), con la marca del reseller. Solo si el negocio tiene usuarios con correo. Tacty no cobra: solo envía el recordatorio.
send_wallet_update
ChatGPTEnvía una notificación corta a los clientes de un negocio: una promoción, un cambio de horario, un recordatorio. Con segment "all" (o sin segmento) llega a todos y queda como la novedad del negocio en todas las tarjetas, reemplazando a la anterior; a quien tiene varias tarjetas del negocio le llega una sola vez, en su tarjeta principal. Con program_id llega solo a quienes tienen esa tarjeta, en ese pase (se combina con el segmento y los filtros). Con un segmento (inactive, new, frequent, birthday_month, near_reward, reward_available), con filters (los mismos de find_customers, cualquier combinación de criterios) o con customer_ids llega solo a ese grupo, como aviso personal («Para ti») en su tarjeta. Con promo, el aviso va acompañado de una promo dibujada en la tarjeta (con los colores de la marca) hasta que vence. Quienes tienen la tarjeta en Apple Wallet o Google Wallet la reciben en el teléfono; el resto la ve al abrir su tarjeta. Confirma el texto, la promo y el grupo con la persona antes de enviarla.
set_subscription
ChatGPTAsigna o cambia el plan que paga un negocio. Lo normal es enviar plan_id (de list_plans); también se puede ajustar monto, moneda, periodo o la próxima fecha de pago a mano para ese negocio. Al crearla se genera el primer cobro; al pagarse un cobro se genera el siguiente. Cambiar el monto afecta el cobro abierto que aún no tiene pagos y los siguientes. status "paused" deja de generar cobros; "cancelled" la cierra. Tacty no cobra ni mueve dinero: solo lleva la cuenta de lo que el reseller le cobra al negocio por su cuenta.
update_asset
ChatGPTCambia el nombre, las acciones o el estado de un punto NFC/QR. La URL grabada en el objeto físico no cambia. status "disabled" lo apaga.
update_automation
ChatGPTEnciende, apaga o ajusta una receta de avisos automáticos. message admite {nombre}, {negocio}, {premio}, {faltan} y {regalo}; vacío vuelve al mensaje de fábrica. days solo en win_back, reward_waiting y coupon_expiring. gift: en win_back "stamp" regala 1 sello (tarjetas de sellos); en birthday, el texto del regalo, que queda como cupón por 14 días.
update_business
ChatGPTActualiza los datos, la marca o el estado de un negocio. Solo cambia los campos que envíes. status "paused" detiene el registro de visitas y apaga sus puntos NFC/QR; "archived" lo retira de la operación.
update_charge
ChatGPTCambia el monto, la fecha de pago o la descripción de un cobro abierto, o lo condona (status "waived"). Para un descuento puntual, baja el monto de ese cobro sin tocar la suscripción.
update_custom_automation
ChatGPTCambia, enciende o apaga una automatización a la medida (id cau_ de list_custom_automations). Solo cambia lo que mandes; filters reemplaza todos los filtros. Confirma el cambio con el dueño.
update_employee
ChatGPTRenombra, desactiva o reactiva a un empleado, o le genera un PIN nuevo (reset_pin). Un empleado desactivado ya no puede entrar.
update_loyalty_program
ChatGPTAjusta una tarjeta del negocio sin perder el progreso de los clientes: nombre, reglas o diseño (colores e ícono de sellos). Si el negocio tiene varias tarjetas, indica cuál con program_id. Solo cambia los campos que envíes; el tipo (kind) no se cambia: para pasar de sellos a puntos crea una nueva con replace_program_id. Si bajas la meta, quienes ya la alcancen reciben su recompensa en la siguiente visita. Los pases guardados en el Wallet se actualizan solos.
update_payment_method
ChatGPTCambia el nombre o las instrucciones de una forma de pago, o la desactiva (active: false) para que deje de ofrecerse. Los pagos ya registrados la conservan. Son solo instrucciones de texto; Tacty no guarda tarjetas ni procesa pagos.
update_plan
ChatGPTCambia un plan o lo desactiva (active: false) para que no se ofrezca a negocios nuevos. Los negocios que ya lo tienen conservan lo pactado; para subirles el precio usa set_subscription en cada uno. Solo cambia el precio registrado; Tacty no procesa pagos.
update_promotion
ChatGPTCambia el texto, el vencimiento o el estado de una promoción. status "archived" la retira.
update_reseller
ChatGPTCambia el nombre comercial, el color o el correo de contacto del reseller. Los correos a sus negocios salen con ese nombre y color, y las respuestas llegan al correo de contacto.
update_reseller_user
ChatGPTCambia el nombre o los permisos de un usuario de la cuenta del reseller. Los permisos que envíes reemplazan a los que tenía. No se puede editar al dueño ni a uno mismo, ni dar permisos que tú no tienes.
add_payment_method
Claudeadd_visit
Claudeadjust_visits
Claudearchive_loyalty_program
Claudecancel_reseller_invite
Claudecancel_visit
Claudecreate_business
Claudecreate_custom_automation
Claudecreate_customer
Claudecreate_employee
Claudecreate_loyalty_program
Claudecreate_nfc_asset
Claudecreate_plan
Claudecreate_promotion
Claudedelete_custom_automation
Claudefind_customers
Claudeget_activity
Claudeget_best_times
Claudeget_billing
Claudeget_business
Claudeget_business_analytics
Claudeget_customer
Claudeget_customers
Claudeget_customers_at_risk
Claudeget_reseller
Claudeget_reseller_overview
Claudeget_setup_status
Claudeget_top_customers
Claudeinvite_business_user
Claudeinvite_reseller_user
Claudelist_assets
Claudelist_automations
Claudelist_billing
Claudelist_businesses
Claudelist_custom_automations
Claudelist_employees
Claudelist_loyalty_programs
Claudelist_payment_methods
Claudelist_plans
Claudelist_promotions
Claudelist_reseller_users
Claudeopen_demo
Claudepreview_wallet_promo
Claudereactivate_loyalty_program
Clauderecord_payment
Clauderedeem_reward
Clauderemove_reseller_user
Claudesend_payment_reminder
Claudesend_wallet_update
Claudeset_subscription
Claudeupdate_asset
Claudeupdate_automation
Claudeupdate_business
Claudeupdate_charge
Claudeupdate_custom_automation
Claudeupdate_employee
Claudeupdate_loyalty_program
Claudeupdate_payment_method
Claudeupdate_plan
Claudeupdate_promotion
Claudeupdate_reseller
Claudeupdate_reseller_user
Claude