MCP y agentes de IA
Conectá Claude, ChatGPT o tu propio agente al servidor MCP de Fiuit para buscar horarios, reservar y operar el negocio con tu clave de API.
Actualizado:
Fiuit incluye un servidor MCP (Model Context Protocol) para que los agentes de IA usen el mismo motor que el bot de WhatsApp: mismas pre-reservas, misma validación y mismo registro de auditoría. El servidor es un cliente fino de la API: cada herramienta llama a la API con tu misma clave, así que el MCP nunca da más permisos que la clave.
El servidor alojado es https://mcp.fiuit.com/ (https://mcp.fiuit.com/mcp es la misma dirección). Para conectar Claude o ChatGPT con un botón, sin copiar claves, seguí Conectar Fiuit a tu IA. Lo que sigue es para conectarlo con una clave de API o correrlo vos.
Material del partner
El conjunto partner incluye partner_courses, partner_league, partner_kit y partner_news: cursos revisados con tu avance y puntaje, tu liga, mensajes y plantillas con tu link de referido, y novedades listas para compartir. Las cuatro herramientas son de solo lectura, aceptan lang (pt, es o en) y solo aparecen con el scope partner:read.
Funcionan con clave de API o conexión OAuth. Leen el partner de quien creó la clave o autorizó la conexión, mientras siga siendo miembro activo del proyecto. Si todavía no hay cursos revisados, la lista va vacía; el avance queda en el navegador y no se consulta por MCP.
Correr el servidor
Necesitás Python 3.12+ y uv.
cd packages/mcp
uv sync
WAGEND_API_URL=https://api.fiuit.com MCP_PORT=8700 uv run python -m wagend_mcp
# escucha en http://127.0.0.1:8700/ (Streamable HTTP)
Variables:
| Variable | Para qué |
|---|---|
WAGEND_API_URL | URL de la API (por defecto https://api.fiuit.com) |
MCP_TOOLSETS | Conjuntos a exponer: booking, admin, tasks, payments, customers, inbox, finance, partner y setup (configuración que se usa poco: servicios, recursos, horarios, flujos, automatizaciones, web, tienda, zonas y cuentas de cobro). Por defecto, los nueve; sin setup la lista baja a unas 130 herramientas |
MCP_HOST, MCP_PORT | Dónde escucha (por defecto 127.0.0.1:8700) |
MCP_ALLOWED_HOSTS | Hosts permitidos (protección contra DNS rebinding) |
Conectar un cliente
La autenticación es una clave de API en el header Authorization. Sin una clave con formato válido, el servidor responde 401 antes de entrar al protocolo.
Con Claude Code:
claude mcp add --transport http wagend http://127.0.0.1:8700/ \
--header "Authorization: Bearer wg_live_xxx"
O con la configuración JSON de cualquier cliente que soporte HTTP:
{
"mcpServers": {
"wagend": {
"type": "http",
"url": "http://127.0.0.1:8700/",
"headers": { "Authorization": "Bearer wg_live_xxx" }
}
}
}
Para probarlo sin un agente: npx @modelcontextprotocol/inspector (transporte Streamable HTTP, la misma URL y el header).
MCP público para los asistentes de IA de tus clientes
Además del MCP del negocio (con clave), Fiuit publica un MCP sin clave para los asistentes de IA de las personas (ChatGPT, Claude, Gemini y otros): https://mcp.fiuit.com/clientes. Con él, un asistente puede encontrar tu negocio, ver lo que ofrece tu bot y pedir un turno para una persona real.
claude mcp add --transport http fiuit-clientes https://mcp.fiuit.com/clientes
| Herramienta | Qué hace |
|---|---|
find_business | Busca por nombre o subdominio exacto, o por texto del directorio («pádel Uruguaiana»). Hasta 10 resultados por página y 3 páginas, en orden neutral: cercanía, horario libre ese día y abierto ahora. |
list_offer | Lo que ofrece el bot, con precios ya formateados. |
find_slots | Horarios libres de un servicio. |
quote_order | Cotiza un pedido de productos: cada línea con su precio y el total, ya formateados. Solo cotiza (no aparta ni pide nada); para cambiar el carrito, se vuelve a cotizar. Solo en los negocios que la tienen habilitada. |
my_assets | Los bienes de la persona (su vehículo), solo en una charla verificada. Solo lee: para guardar o corregir uno, la persona se lo cuenta al negocio con talk_to_business. Solo tipos que el negocio ya activó. Solo en los negocios que lo tienen habilitado. |
my_context | El contexto de la persona, solo en una charla verificada: su nombre de pila, lo activo (reservas y pedidos abiertos, planes con lo que le queda, si tiene un cobro pendiente, sin monto) y lo que suele reservar o comprar (servicio, día, franja y recurso). Sirve para saludarla por el nombre y sugerirle una vez repetir lo de siempre, buscando de verdad con find_slots o quote_order. Nada del equipo (ni notas ni etiquetas). Solo en los negocios que lo tienen habilitado. |
request_booking | Aparta el horario unos minutos y le manda a la persona un código por WhatsApp (por defecto), Telegram o email. |
confirm_booking | Confirma con el código que recibió la persona. Sin el código, el horario se libera solo. |
talk_to_business | Conversa con el bot del negocio, como por WhatsApp. Devuelve conversation para seguir la charla y la respuesta con montos y fechas ya formateados. |
end_conversation | Cierra la charla antes de que venza, si la persona lo pide: lo que siga empieza sin sus datos. |
search_knowledge | Contesta preguntas sobre tu negocio con lo que dice tu base de conocimiento. |
handoff | Pasa la charla a una persona de tu equipo cuando el cliente lo pide. |
request_task | Pide un servicio sin horario (una evaluación, un presupuesto) a nombre de la persona, solo después de que confirmó un código en la charla. |
my_bookings | Muestra las reservas y pedidos abiertos de la persona, solo después de que confirmó un código en la charla. |
cancel_booking, reschedule_booking | Piden cancelar o cambiar de horario una reserva de la persona: le llega un código nuevo y recién con ese código se hace. |
El asistente nunca confirma solo: siempre hace falta el código que le llega a la persona. Solo aparecen los negocios con la web publicada y «Aceptar agentes de IA» encendido; el directorio muestra además solo los que tienen «Aparecer en el directorio de Fiuit». Los dos vienen encendidos y se cambian con update_site (accept_agents, in_directory), por la API (PATCH /v1/site) o pidiéndoselo a Wagy. Los productos y planes se piden por la web del negocio. Las mismas rutas están en la API sin credencial: /v1/public/agents/*.
Conversar con el bot (talk_to_business). Responde el mismo bot que en WhatsApp, con tus reglas: lo que vende, las etapas, el pase a una persona, el tono y el saludo. La charla aparece en el Mensajes marcada «Vía IA» y tu equipo la puede tomar; si la toma, el asistente lee la respuesta de la persona. Para apartar un horario el asistente tiene que mandar el nombre y el teléfono (o el email) de la persona: el «sí» al resumen no confirma, a la persona le llega un código y la reserva queda recién con confirm_booking. Hasta que la persona confirma un código en la charla, pedir sin horario, cancelar o reprogramar no se hace desde un asistente. Cada charla gasta uso de IA de tu plan, como cualquier canal. Rutas en la API: POST /v1/public/agents/businesses/{business}/conversations y .../conversations/{conversation_id}/messages (POST para mandar, GET para leer, con espera opcional).
Sesión verificada. Cuando la persona confirma el código de una reserva pedida en la charla, la charla no se corta: sigue 24 horas en su ficha (verified_until). El bot la saluda por el nombre y conoce sus reservas, pedidos y planes (la deuda, solo el total). Reservar o pedir de nuevo sin cobro no pide otro código; cancelar, reprogramar y pagar piden uno nuevo cada vez, que llega al contacto que la persona confirmó y se usa en confirm_booking. La charla no renueva las 24 horas: solo otro código confirmado. Pasado ese plazo, o en una charla nueva, el asistente empieza sin datos de la persona; con end_conversation (DELETE .../conversations/{conversation_id}) la persona la cierra antes.
Herramientas
Las herramientas de tareas y cobros solo aparecen en la lista si la clave tiene el scope que necesitan (una clave sin permisos de cobros no las ve ni puede usarlas). En el resto, cada una funciona solo si la clave tiene el scope; si no, devuelve el error 403 de la API. Las escrituras quedan auditadas con actor mcp.
Cada herramienta trae sus anotaciones MCP: readOnlyHint (solo lee), destructiveHint (cancela, borra, anula o devuelve plata), idempotentHint y openWorldHint (le escribe a un cliente, cobra con un proveedor o publica en internet). Así ChatGPT y Claude saben qué pueden usar sin pedir confirmación. Al conectarse, el servidor se presenta como Fiuit y le dice al modelo por dónde empezar (list_today, list_tasks, list_conversations).
Reservas (booking): para asistentes que reservan en nombre de un cliente.
| Herramienta | Scope | Hace |
|---|---|---|
list_services | config:read | Servicios con duración y precio |
find_slots | slots:read | Horarios disponibles de un servicio entre dos fechas o de un día de apertura (day, incluye su noche después de las 00:00) |
hold_slot | bookings:write | Pre-reserva de 10 minutos |
confirm_booking | bookings:write | Confirma una pre-reserva con los datos del cliente |
cancel_booking | bookings:write | Cancela una reserva. Exige confirm=true: sin él solo muestra la reserva y no cancela |
reschedule_booking | bookings:write | Mueve una reserva existente a otro horario |
get_booking | bookings:read | Detalle de una reserva |
Administración (admin): para que el Dueño opere el negocio desde su asistente de IA.
| Herramienta | Scope | Hace |
|---|---|---|
list_resources | config:read | Equipo, salas, máquinas y equipos, con su ícono y color si los tienen |
list_today | bookings:read | Reservas del día y lo sin terminar de varios días que lo atraviesa |
block_time | config:write y bookings:read | Cierra días completos de un recurso (máx. 31). No cancela reservas existentes: las devuelve para que una persona decida |
list_service_pauses | config:read | Lista las pausas por fechas de un servicio |
pause_service | config:write | Pausa un servicio de una fecha a otra (inclusive) sin bloquear a los recursos que lo atienden: sus otros servicios siguen ofreciéndose |
resume_service | config:write | Reabre un servicio pausado en un rango de fechas |
create_service, update_service | config:write | Crea o cambia un servicio, con su formulario de reserva |
update_schedule | config:write | Cambia el horario semanal o la zona horaria |
list_booking_series, get_booking_series | bookings:read | Turnos fijos (reservas que se repiten, «todos los martes a las 20:00») y sus fechas: con tarea, salteadas o con choque |
create_booking_series | bookings:write | Crea un turno fijo: mismo servicio y cliente cada 1 a 4 semanas, en uno o varios días, hasta una fecha (máx. un año) o una cantidad de veces (máx. 52). Cada fecha es una tarea normal que se cobra ese día. Sin confirm=true devuelve la vista previa (fechas de las próximas 8 semanas y cuáles chocan); las que chocan se saltean con skip_dates o skip_conflicts |
update_booking_series, cancel_booking_series | bookings:write | Edita o cancela toda la serie o, con from_date, «esta y las siguientes». Las fechas futuras sin iniciar ni cobrar se rehacen (o se cancelan sin aviso); lo pasado o cobrado no se toca. «Solo esta» es reschedule_booking o cancel_booking de esa tarea. Exigen confirm=true |
get_coverage | config:read | Cobertura del negocio: zonas activas y qué pasa con lo que cae fuera (out_of_coverage) |
set_coverage | config:write | Elige qué hacer fuera de cobertura (también con una entrega que no llega a esa zona): out_of_coverage = take (tomar y avisar) o reject (no tomar) |
get_stats | bookings:read | Reservas, ocupación y ausencias por recurso; por defecto solo personas, con canchas o lugares pasá kind=all |
get_control_summary | bookings:read (conversaciones con messages:read, montos con finance:analyze) | «¿Cómo vamos?»: atención ahora, tareas en curso por etapa, números del período (vendido, cobrado, por cobrar) y saturación por día de la semana y hora. Filtros opcionales date_from/date_to (por defecto hoy), service_id y resource_id. Solo lectura; lo que la key no puede ver llega null Las etapas se cuentan por servicio y por el estado real de la tarea. Cobrado usa la fecha del pago, incluso si el trabajo pertenece a otro día; los pagos en revisión son los pendientes actuales, también de tareas sin fecha. Cada respuesta conserva una única vista temporal del proyecto. |
list_flows, get_flow, list_flow_versions, get_flow_version | config:read | Flujos (el recorrido de etapas que eligen los servicios), sus servicios, salidas y requisitos; historial de versiones. get_flow trae además procedure: el flujo como texto por idioma, regenerado desde la versión vigente |
validate_flow | settings:write | Valida sin escribir; devuelve impact con las tareas a mover y shared_with |
simulate_flow | settings:write | Simulacro de entrada de un flujo por intención: dónde cae cada frase de entry (la dada, sin guardarla) y si choca; usa la IA del proyecto en las frases que las palabras clave no deciden |
copy_flow | settings:write | Copia un flujo (también de sistema) en uno propio e independiente con otro nombre, tras la confirmación; no cambia a ningún servicio |
customize_flow | settings:write | Edita un flujo de sistema en la copia propia del negocio (la crea la primera vez y le pasa los servicios que usaban la base), tras la confirmación |
restore_flow | settings:write | «Volver al original» desde la copia propia: los servicios vuelven al flujo de sistema y las tareas abiertas terminan con la versión que tenían |
delete_flow | settings:write | Borra un flujo sin uso y sin tareas, tras la confirmación |
create_flow, update_flow | settings:write | Crean un flujo o publican una versión tras la vista previa y confirmación; publicar mueve las tareas de todos los servicios del flujo. Cada etapa puede traer bot_offers (qué ofrece el bot mientras la tarea está ahí; un ítem inexistente da 422 bot_offer_unknown_item) |
upload_stage_image | settings:write | Guarda la imagen de fondo de «Marcar sobre imagen» y devuelve su id, que se publica en sketch_background con update_flow |
revert_flow | config:read + settings:write | Crea otra versión a partir de la elegida; conserva el historial |
get_flow_examples, get_base_states, get_flow_message_catalog | config:read | Ejemplos de flujo para copiar, estados fijos del motor y las variables protegidas con el texto por defecto del mensaje al cliente de cada etapa |
get_flow_usage | bookings:read | Cuánto se usa cada flujo: sin flow_id, las tareas que entraron en los últimos 7 días contra los 7 anteriores; con flow_id, entradas y completadas por día y las tareas abiertas por etapa con su espera promedio (bottleneck, la etapa que más traba). Solo lectura. |
get_business_traits, set_business_traits | config:read / settings:write | Rasgos del negocio (del catálogo cerrado: «agenda del lugar», «con espacios», «vende productos»…) y su etiqueta libre de rubro, solo informativa. Guardar reemplaza la lista y la etiqueta tras la confirmación; omitir business_label o enviar null borra la etiqueta. Para conservarla, leela con get_business_traits y enviala al guardar; no cambia las reglas de reserva ni la agenda |
get_item_performance | bookings:read (servicio, producto); prepaid:read (plan) | Rendimiento de un servicio, producto o paquete/club en cantidades (completadas, unidades, vendidos, activos hoy) por día, semana o mes, con el período anterior. Con una clave son los totales del negocio (scope: business). Nunca trae importes: están en Financiero. |
Tareas (tasks): tareas con y sin horario, el "por agendar" y la cola.
| Herramienta | Scope | Hace |
|---|---|---|
list_tasks | bookings:read (y payments:read_balance si pedís saldo) | Lista tareas por estado, por agendar (scheduling_state=pending), sin asignar (unassigned=true), atrasadas (late=true), cola, origen (origin=conversation es el pedido por chat) y, opcionalmente, con su saldo y filtro por estado de pago de la página. Con flow_id deja las tareas de un flujo y con group_by (stage, status, resource, priority, type, tag, day, zone, customer o flow) suma los conteos por grupo; con group_by=stage y flow_id trae todas las etapas del flujo en orden, como las columnas del Tablero del panel; statuses y resource_ids filtran por «cualquiera de» esos estados o recursos antes de paginar; group_by=tag expone texto libre de las etiquetas y exige include_sensitive=true con customers:read; match aplica los criterios de una vista de Trabajo: estados múltiples, una fecha con su campo y un rango relativo (hoy, mes pasado, últimos N días…) resuelto en la zona del proyecto, y grupos «o» (any_of) |
create_task | bookings:write | Crea una tarea con horario, de cola o por agendar sin horario (schedule_later=true); con flow_id de un flujo por intención, una tarea sin servicio (reclamo, presupuesto), sin horario ni monto; con internal=true, una tarea del equipo sin cliente (de un servicio sin precio) |
schedule_task | bookings:write | Da horario a una tarea sin horario, o cambia el que tiene; la API valida disponibilidad |
assign_task | bookings:write | Asigna personas o recursos a una tarea |
list_task_lines | bookings:read | Ítems de la tarea, sus dos bloques (servicios y productos) y el margen (solo con permiso de costos) |
add_task_line | bookings:write | Suma un servicio o producto del catálogo, o un ítem libre con precio y costo opcional; sube lo que se cobra, exige confirm=true |
edit_task_line | bookings:write | Corrige precio (también de un ítem del catálogo, solo en esa tarea), cantidad y costo; en un ítem libre, también nombre; exige confirm=true |
remove_task_line | bookings:write | Quita un ítem y baja lo que se cobra (no por debajo de lo ya cobrado); exige confirm=true |
list_task_checklist | bookings:read | Checklist de la tarea: sus puntos por hacer, cuáles están marcados y quién los marcó. Interno: el cliente no lo ve |
add_task_checklist_item | bookings:write | Suma un punto al checklist («revisar frenos»); no toca lo que se cobra ni lo que ve el cliente. Se deshace borrándolo |
change_task_checklist_item | bookings:write | Marca o desmarca un punto (done) o le cambia el texto (name); expected_version evita pisar a otra persona |
remove_task_checklist_item | bookings:write | Borra un punto del checklist; exige confirm=true |
preview_task_discount | payments:adjust | Muestra cómo queda el total con un descuento, sin guardar nada |
apply_task_discount | payments:adjust | Aplica o cambia el descuento de la tarea, en monto o porcentaje (value en puntos básicos); el staff hasta 10 %; exige confirm=true |
remove_task_discount | payments:adjust | Quita el descuento y el total vuelve a la lista; exige confirm=true |
preview_plan_discount | prepaid:sell | Muestra cómo quedan las cuotas con un precio especial, de un plan por vender o vendido, sin guardar nada |
apply_plan_discount | prepaid:sell | Precio especial de un plan vendido, desde la próxima cuota; solo cobro manual; exige confirm=true |
remove_plan_discount | prepaid:sell | Quita el precio especial: las cuotas siguientes vuelven al precio del plan; exige confirm=true |
accept_work_item_offer | bookings:write | Acepta una oferta («Ofrecer…») de la etapa actual de la tarea (vienen en offers del detalle de la tarea): un producto se suma a esa tarea con el precio del catálogo y sube lo que se cobra; un servicio crea otra tarea, independiente, para el mismo cliente. Exige confirm=true; nunca acepta un precio |
Las herramientas de ítems conservan identificadores, cantidades y montos en la respuesta mínima. Para ver nombres y unidades, usá include_sensitive=true con el scope de lectura indicado. Si cambian el total de un presupuesto aceptado, pueden mandar una revisión al cliente; por eso exigen confirmación.
Cobros (payments): cobros manuales y saldos. Los saldos los calcula siempre la API; el MCP no suma ni resta.
| Herramienta | Scope | Hace |
|---|---|---|
record_payment | payments:record | Registra un cobro manual (efectivo, tarjeta, transferencia, Pix, Mercado Pago u otro; la forma de pago es obligatoria y queda en la auditoría), opcionalmente repartido entre tareas |
void_payment | payments:void | Anula un cobro, con motivo obligatorio |
expense_categories | expenses:read | Las 11 categorías de gasto del proyecto (nombres fijos, tipo y si está oculta). «Comisiones del equipo» es una línea calculada: no se carga a mano |
expense_list | expenses:read | Gastos cargados por período, categoría o recurso; total_minor lo suma la API (solo aprobados: sin pendientes, rechazados, anulados ni de prueba; status filtra por estado). Con tag_id, solo los gastos con esa etiqueta: su total no se suma con el de otra etiqueta, porque un gasto puede tener varias. Sin recurso, el gasto es «General» |
expense_record | expenses:record | Carga un gasto en la moneda del proyecto (fecha local, nunca futura). Exige confirm=true; si el monto es alto para el negocio (desde el doble del valor mensual de su plan), también confirm_high_amount=true, una segunda confirmación de la persona. Acepta tags (etiquetas por nombre; las nuevas se crean) y, si no mandás category_id, usa la categoría que recuerda la primera etiqueta que tenga una (si ninguna, 409 expense.category_required) |
expense_void | expenses:void | Anula un gasto con motivo; un gasto nunca se borra. Exige confirm=true |
income_record | payments:record | Registra un ingreso que no pasó por una tarea («+ Ingreso»): una venta rápida con su cobro. Lo vendido es una categoría (product_sale, rental, tip, other_income), un servicio o un producto (income_options los lista). collection: paid (cobrado ya, con method), mercadopago (queda por cobrar; el link se crea aparte con create_payment_link, siempre con el OK de la persona) o debt (exige customer_id). Sin cliente va a «Venta sin cliente». Sin confirm=true devuelve la vista previa sin escribir |
income_void | payments:void | Anula un ingreso con motivo: sus recibos quedan anulados y deja de contar. Un pago de Mercado Pago ya acreditado se devuelve, no se anula |
expense_tags | expenses:read | Las etiquetas de gastos del proyecto («moto», «local centro»), las más usadas primero, con la categoría que recuerda cada una y cuántos gastos la tienen |
expense_tag_rename | expenses:record | Renombra una etiqueta; si otra ya se llama así, unilas con expense_tag_merge. Exige confirm=true |
expense_tag_merge | expenses:record | Une dos etiquetas: los gastos de una pasan a la que queda y la otra se borra. No se deshace. Exige confirm=true |
expense_tag_delete | expenses:record | Borra una etiqueta y la saca de sus gastos; los gastos no se tocan. Exige confirm=true |
expense_pending | expenses:approve | Cuántos gastos cargados por el equipo esperan aprobación y cuánto suman (sin los de prueba) |
expense_history | expenses:read | Historial de un gasto: quién, cuándo y qué cambió (antes y después). No hay cierre de mes |
expense_get | expenses:read | Un gasto: monto, categoría, fecha, estado (aprobado, pendiente, rechazado o anulado), comprobante y revisión. Es el detalle de un gasto de Movimientos |
expense_approve | expenses:approve | Aprueba un gasto pendiente del equipo: desde ahora suma. Nadie aprueba lo que cargó. Exige confirm=true |
expense_reject | expenses:approve | Rechaza un gasto pendiente con motivo; queda rechazado y no suma. Exige confirm=true |
recurring_expense_list | expenses:read | Gastos que se repiten (alquiler, sueldos fijos), con su próxima fecha y si están activos, en pausa o terminados |
recurring_expense_create | expenses:record | Crea un gasto que se repite cada semana o cada mes; Fiuit lo carga solo cada fecha, una sola vez. Exige confirm=true |
recurring_expense_update | expenses:record | Cambia el importe o el día, lo pausa o lo reanuda, o lo termina, de acá en adelante. Exige confirm=true |
recurring_expense_skip | expenses:record | Saltea la próxima fecha sin cargar el gasto. Exige confirm=true |
apply_refund_due_to_account | payments:adjust | «Usar para otra deuda»: un pago tardío separado «a devolver» (refund_due) pasa al saldo del cliente y cubre sus deudas más antiguas. Exige confirm=true; la API lo rechaza con un reclamo abierto en Mercado Pago |
refund_payment | payments:refund | Devuelve al cliente (total o parcial) un cobro de Mercado Pago, con motivo; sin monto, todo lo que queda. Exige confirm=true con la clave de la vista previa: repetirla no devuelve dos veces y nunca se devuelve más de lo cobrado. Responde succeeded, failed (Mercado Pago la rechazó), pending (se reintenta sola, consultando antes a Mercado Pago) o review (Mercado Pago no la confirmó: no se vuelve a pedir, el monto queda reservado y Dueño/Encargado recibe un aviso). Solo Dueño/Encargado |
get_payment_refunds | payments:refund | Devoluciones de un cobro: lo devuelto, lo que está en curso y lo que todavía se puede devolver (o por qué no) |
charge_fiscal_get | payments:fiscal | Marcador fiscal de un cobro y comprobantes del emisor del negocio, si hay. Fiuit nunca emite comprobantes. Solo Dueño/Encargado |
charge_fiscal_mark | payments:fiscal | Marca si un cobro lleva comprobante: no requiere, pendiente o emitido fuera de Fiuit (con número y fecha). Solo cobros con dinero recibido. Exige confirm=true. Solo Dueño/Encargado |
charge_fiscal_issue | payments:fiscal | Pide la nota fiscal (NFS-e de Brasil) con Fiuit Fiscal, o la reintenta si falló, sin emitir dos notas por cobro. Solo proyectos con país fiscal Brasil (si no, fiscal.country_not_supported) y cobros en reales con dinero recibido. Exige confirm=true. Solo Dueño/Encargado. Activar Fiuit Fiscal y marcar una nota cancelada en el portal del municipio se hacen en el panel |
get_task_balance | payments:read_balance | Saldo de una tarea y, si querés, su historial de cobros |
get_customer_account | customer_balance:read (y customer_account:read para el detalle) | Cuenta corriente del cliente: saldo, pagos a cuenta y deudas; con include_movements=true, desglose por tarea y cobros |
get_commissions | commissions:read | Comisiones del equipo calculadas por la API sobre lo cobrado: con day, el día por persona (cobrado por método, propinas, comisión, ajustes y caja); sin day, el reporte entre start y end. refund_amount_unavailable lista las tareas con un reembolso parcial sin monto informado, que todavía cuentan completas. Solo lectura |
get_commission_settlements | commissions:read | Liquidaciones de comisiones de un período: montos congelados, ajustes automáticos que ya congelaron de otros períodos y lo pendiente de pasar al período abierto siguiente. Solo lectura |
settle_commissions | commissions:settle | «Liquidar comisiones»: congela el período de una persona en un asiento que no se reescribe, con motivo. Un cambio posterior (anulación, devolución o regla) queda como ajuste automático en el primer día sin liquidar. Liquidar otra vez el mismo período devuelve el mismo asiento. Exige confirm=true |
finance_overview | finance:analyze | Resumen de Finanzas calculado por la API: Entró, Salió y Quedó realizados de 2 períodos anteriores y el actual, y lo que falta del actual y el siguiente, seguro (ya recibido, gastos fijos) o previsto (saldo sin pagar, comisión del equipo estimada, gastos por aprobar). Solo cosas con fecha. |
finance_result | finance:analyze | Resultado calculado por la API, con basis cash (caja, por defecto) o accrual (por competencia: lo hecho en el período, cobrado o no, con «a cobrar» aparte). En caja: Entró (cobrado menos devuelto), Salió (gastos aprobados, comisiones del equipo y comisiones de cobro informadas) y Quedó, con margen y el período anterior, por período, recurso, servicio o categoría. Los gastos sin recurso o servicio quedan como «General», sin repartir. missing_expenses avisa que entró dinero y no hay gastos cargados. Solo lectura |
finance_result_lines | finance:analyze | De qué se compone un número del Resultado: los cobros, devoluciones, comisiones de cobro, comisiones del equipo y gastos aprobados que suma, con importe con signo, día, categoría, recurso, servicio, persona y cliente. Se abre una fila (row, «General» con general), Entró o Salió (side) o un tipo (kind), o una celda del estado de resultados del año (dre); total_minor es el número abierto aunque la lista se corte en limit. Solo lectura |
finance_year | finance:analyze | El estado de resultados del año, mes a mes: ingresos brutos, devoluciones, impuestos, costos directos, margen bruto, gastos operativos por categoría y el resultado de cada mes (sobró o faltó), en caja o por competencia (basis). El total del año es el de finance_result. Solo lectura |
export_finance_result_csv | finance:analyze y finance:export | Exporta el Resultado del período como CSV para el contador: un movimiento por renglón (cobro, devolución, comisión de cobro, comisión del equipo o gasto) con categoría, recurso, servicio, persona, cliente, importe legible e importe en unidad menor con signo; la suma es lo que quedó. Mismo separador y decimales que Excel en el país de la moneda. Hasta 50.000 movimientos. El Excel de 8 hojas se baja por la API REST. Queda registrado |
create_finance_package · list_finance_packages · get_finance_package | finance:analyze y finance:export | Pide el paquete para el contador del período (Excel de 8 hojas y resumen en PDF de una hoja, con los mismos números del Resultado) y consulta su estado. Si es chico vuelve listo con un link de descarga que vale 5 minutos; si es grande se arma aparte. Con API key no incluye las fotos de los comprobantes: esas solo se bajan desde el panel. El archivo vence a las 48 horas. Queda registrado |
| list_prepaid_plans | prepaid:read | Paquetes (N sesiones con vencimiento), planes de club (N por mes) y membresías (precio fijo por mes, sin contar usos) del catálogo, con precio, valor por unidad y cupo por día/franja |
| get_customer_plans | prepaid:read | Paquetes, club y membresías de un cliente: unidades que le quedan, reservadas, vencimiento y cuota adeudada. Cada período es una cuota, una tarea que se cobra (period.booking_id); open_fees trae las cuotas por cobrar (tarea, vencimiento e importe) y next_due_at el vencimiento de la próxima. active = al día, past_due = alguna cuota vencida sin cobrar. Pagar una cuota = cobrar su tarea (record_payment con ese booking_id); no hay herramienta aparte |
| sell_prepaid_plan | prepaid:sell y payments:record | Vende un plan cobrado en mano (efectivo, tarjeta, transferencia, Pix, Mercado Pago u otro; la forma de pago queda en la auditoría). Sin cobrar (unpaid=true), la cuota 1 queda Por cobrar y se cobra como cualquier tarea (record_payment con su booking_id), igual que las cuotas siguientes. Un club o membresía con tarjeta se vende con el email del cliente (payer_email), solo si list_prepaid_plans trae card_billing_available=true: queda esperando autorización y devuelve checkout_url, el link de Mercado Pago para que el cliente autorice su tarjeta (para eso alcanza prepaid:sell). Si el cliente ya tiene ese plan con tarjeta vigente, responde 409 prepaid_card_sale_exists con el subscription_id de esa venta: no se vende otra. Exige confirm=true |
| cancel_prepaid_plan | prepaid:sell (reembolso: también payments:void y payments:record) | Cancela: no nacen más cuotas y las ya creadas no cambian (una impaga sigue siendo deuda; la respuesta las trae en open_fees); libera las sesiones de tareas futuras. Con refund=true devuelve lo no consumido de la cuota del período vigente de un plan cobrado en mano (lo vencido se pierde). Exige confirm=true |
| extend_prepaid_plan | prepaid:sell | Extiende a mano el vencimiento de un paquete o club (o reabre un paquete vencido). Al vencer, lo no usado se pierde. Exige confirm=true |
| remove_task_plan | prepaid:sell | Quita el plan de una tarea: libera la unidad y la tarea vuelve a su valor normal. Hace falta antes de cambiarle el cliente o el servicio. Exige confirm=true |
cancel_booking también exige confirm=true: sin él devuelve la reserva y confirmation_required, y no cancela nada. Mostrale la reserva a la persona antes de repetir la llamada con confirm=true.
record_payment y void_payment mueven dinero: exigen confirm=true y, sin él, no ejecutan la operación monetaria (el protocolo puede consultar GET /me). Pasá siempre idempotency_key para reintentar sin cobrar dos veces; los límites de monto y la detección de duplicados son los de la API. received_by es la membresía de quien recibió el dinero: con una clave de API es obligatorio.
expense_record, expense_void, income_record, income_void, expense_approve, expense_reject y los recurring_expense_* que escriben también son dinero: exigen confirm=true e idempotency_key. Renombrar, unir y borrar etiquetas no mueven dinero, pero también exigen confirm=true (sin idempotency_key). Para corregir un gasto desde un agente, anulalo y cargalo de nuevo; la edición con historial se hace en el panel. La foto o el PDF del comprobante de un gasto no pasan por el MCP ni por una clave de API: se adjuntan con la sesión del panel.
La preparación sin confirm devuelve idempotency_key; la confirmación exige esa clave o una del agente (1-128 caracteres). Reutilizala con el mismo destino y payload en todos los reintentos, incluso si se pierde la respuesta. Una operación nueva requiere otra clave, aunque el cobro sea idéntico.
Por defecto, list_tasks omite contactos, dirección exacta, coordenadas, notas y formulario. include_sensitive=true solicita el detalle y exige además customers:read. Los movimientos de get_customer_account y el historial de get_task_balance omiten nombres de receptores, notas y motivos; el mismo parámetro exige además payments:read. Las claves mode=test solo ven herramientas de lectura.
Las escrituras de configuración, de tareas y de cobros exigen confirm=true. Sin él, la herramienta no ejecuta la escritura (puede consultar datos para la vista previa): devuelve confirmation_required con lo que enviaría, para que el agente se lo muestre a una persona y repita con la confirmación.
Conexión con OAuth: permisos y herramientas que no aparecen
Cuando el dueño conecta Claude o ChatGPT (ver Conectar tu IA), la IA usa un token con los permisos que marcó en la página de permisos. Qué cambia respecto de una clave de API:
- Varios proyectos en una conexión. Una clave de API es de un proyecto; una conexión OAuth puede cubrir varios.
list_projectslos lista (id, nombre, slug, rol y permisos en cada uno) y todas las herramientas aceptan unprojectopcional con ese id o slug, que el MCP manda como encabezadoX-Wagend-Project. Con un solo proyecto no hace falta. Con varios y sinproject, la herramienta responde400 project_requiredcon la lista para que la IA pregunte; un proyecto que no es de la conexión da403 project_not_in_connection, exista o no. Los permisos y el rol se revisan en cada llamada, en el proyecto elegido. Con una clave de API,list_projectsdevuelve su único proyecto. - La lista de herramientas se recorta. Solo aparecen las que el token puede usar.
get_task_balanceylist_tasksconinclude_balance=truepidenpayments:read_balance(permiso «Ver dinero»): si no está, la herramienta no aparece o responde403 insufficient_scope. Para sumarlo hay que conectar de nuevo marcando «Ver dinero» (solo lo da el dueño). Los metadatos de/.well-known/oauth-protected-resourcepublicanscopes_supportedpara que el cliente sepa qué pedir. - Editar los productos de un pedido (
replace_task_items) pide solobookings:write(«Crear y mover turnos»); no hace falta ver dinero. El valor a cobrar se recalcula y la API no deja bajar el pedido por debajo de lo ya cobrado (409order_below_paid). - Cobros en efectivo:
record_paymentconmethod: "cash"y el permisopayments:record(«Registrar cobros y enviar links de pago»). Ajustar a mano el valor a cobrar (payments:adjust) no se da por OAuth: se hace desde el panel. - Zona de una dirección:
match_zonenecesita coordenadas (latylng), barrio, ciudad o código postal; con una dirección en texto libre sola devuelvezone: null. Con coordenadas gana el área dibujada, y la zona de una dirección guardada del cliente usa esa misma regla. - Clientes:
list_customerssininclude_sensitive=truedevuelve soloidylocale; para elegir un cliente por nombre hace faltainclude_sensitive=true(ycustomers:read). - Hábitos del cliente:
get_customer_summarytraehabits(cada cuánto viene, día y franja, servicio, fecha esperada y estado según su ritmo:on_track,due,late,at_risk,lost) y, si es candidato,fixed_proposalpara armar el turno fijo concreate_booking_series.list_customersfiltra porhabit(un estado:on_track,due,late,at_risk,lost; ofixed_candidate); «¿a quiénes perdí este mes?» eshabit=lostconlost_sinceel primer día del mes. - Línea de tiempo:
customer.updatedybooking.updatedtraenfieldsochangedcon los nombres de los campos editados, nunca sus valores.
Panel del partner (partner)
Si sos partner de Fiuit, tu IA puede leer tu cartera con las mismas reglas que tu panel. Todas son de solo lectura (readOnlyHint) y piden el scope partner:read: por OAuth, el permiso «Ver tu cartera de partner», que la página de permisos solo le ofrece a un partner. Sin ese scope, no aparecen en la lista.
| Herramienta | Scope | Hace |
|---|---|---|
partner_today | partner:read | La próxima acción, el progreso de la cartera y las alertas |
partner_clients | partner:read | Tus clientes con plan, último uso, conteos y semáforo; orden, cursor y filtro rápido quick |
partner_client_detail | partner:read | Un cliente y sus hitos. Un proyecto que no es de tu cartera da 404 client_not_found |
partner_activity | partner:read | Hitos de tus clientes, del más nuevo al más viejo |
El partner es quien emitió la credencial (creó la clave o autorizó la conexión), nunca un dato del pedido. Una clave con el scope emitida por otra persona da 403 partner_required; si el partner se da de baja o deja el proyecto de la credencial, deja de funcionar en la próxima llamada. Solo conteos y estados: ni el contenido de los negocios ni sus importes. Crear un proyecto para un cliente sigue siendo solo desde el panel.
Ejemplos de pedidos
- "Reservame un corte con Juan mañana a la mañana, a nombre de Carlos."
- "Bloqueá la máquina de láser el lunes que viene por mantenimiento y decime qué reservas quedan afectadas."
- "¿Cuántas ausencias tuvimos este mes?"
- "Mostrame las tareas sin asignar y dales horario mañana a las 10."
- "Registrá un cobro en efectivo de 50.000 a Ana por su última tarea y decime el saldo."
Docs para LLMs
/llms.txtlista todas las páginas de la documentación./llms-full.txtcontiene la documentación completa en Markdown.
Flujos: las herramientas de un flujo requieren flow_id (list_flows); create_service y update_service aceptan flow_id para elegir el flujo de un servicio. update_flow valida antes de previsualizar (impact y shared_with, los servicios que comparten el flujo y cambian todos); confirm=true crea versión. Los flujos de sistema no se editan directamente: customize_flow da la copia propia (que se edita con update_flow) y restore_flow vuelve al original; o copy_flow (o create_flow) y asignalo. delete_flow borra un flujo sin uso ni tareas. revert_flow crea otra versión (lectura config:read y escritura settings:write). validate_flow, get_flow_examples y get_base_states completan la configuración.
«Cómo se ve la tarea»: update_flow con task_view elige qué va arriba en la tarea (main: auto, when = Cuándo, destination = Destino, order = Pedido o none = nada), el interruptor «Ítems» (items: apagado, la tarea no ofrece «+ Agregar ítem»; los ítems cargados se siguen viendo). chips (cliente y cobro) ya no tiene efecto: se acepta por compatibilidad y se ignora. Lo que no mandás queda igual y clear_task_view=true vuelve a automático. Sin confirm muestra task_view_diff con el antes y el después; no crea versión ni mueve tareas y sirve también en un flujo de sistema. Cada tarea trae el ajuste vigente en task_view.
MCP incorpora get_work_item_next_steps, move_work_item_stage y use_work_item_tool. Las escrituras requieren confirm=true e Idempotency-Key. complete_task se elimina. Cobro electrónico pendiente F4-29. get_work_item_stage_history (scope bookings:read) lee el historial inmutable de etapas (máximo 100). Los scopes: lectura bookings:read; mover y usar herramientas bookings:write (más payments:record si hay cobro); editar etapas del servicio settings:write. Un 403 (permiso o scope), 409 (stage_conflict, already_claimed) o 422 (stage_requirements_missing) llega tal cual al agente; un reintento con la misma idempotency_key y cuerpo repite el resultado sin duplicar. Wagy explica la capacidad vigente y el panel incluye Siguiente paso y el editor de etapas. Los efectos habilitados se encolan vía outbox; esto no acredita entrega al cliente.
Completar con la foto (FIU-672): fill_stage_from_photo lee una foto de la tarea y propone los campos de texto o número de la etapa que siguen vacíos. No guarda nada: los valores se confirman con move_work_item_stage. Lo dudoso no viene y lo ya guardado no se pisa. Mismos permisos que completar la etapa. Cada lectura descuenta de la IA del plan; sin cupo responde ai_limit_reached.
create_service y update_service aceptan price_per_time («Precio por tiempo», con confirm=true): al cambiar la duración de una tarea de ese servicio, su valor se recalcula en proporción, salvo con cobro o seña registrados o un valor ajustado a mano.
create_service y update_service aceptan duration_options (las duraciones que elige el cliente al reservar, por ejemplo 1 h, 1 h 30 y 2 h: [{"minutes": 90, "price_cents": 17000000}], hasta 6; sin precio, en proporción; con confirm=true); clear_duration_options las quita. find_slots y hold_slot aceptan duration_min (una de esas duraciones): la reserva es una sola tarea con esa duración y su precio; otra duración responde 422 duration_not_offered.
create_service y update_service aceptan location_mode (local, customer_address, customer_choice o remote: a distancia, sin dirección) y meeting_url, el enlace http(s) de la reunión de un servicio remote que carga el negocio (Fiuit no lo genera); clear_meeting_url lo quita y pasar a otro modo lo borra. El bot y los recordatorios comparten ese enlace en lugar de una dirección.
update_service acepta title_template: las piezas del título de las tareas de ese servicio (de 1 a 3: customer, order, address, number o field:<clave> de un campo del formulario o de una etapa), unidas por « · »; clear_title_template vuelve a «Cliente · Pedido». update_task_metadata acepta title para escribir el título de una tarea a mano (queda fijo) o null para volverlo automático. Las dos son escrituras: muestran la propuesta con el cambio y se aplican con confirm=true.
update_service también cambia la anticipación y la cancelación: lead_time_min (minutos mínimos antes del turno; 0 = sin mínimo), max_advance_days (hasta cuántos días adelante se reserva; clear_max_advance_days = sin límite) y cancel_policy ({"deposit_refund_hours": N}, de 1 a 2160: cancelar con al menos N horas devuelve la seña cobrada por Mercado Pago; exige además payments:refund; clear_cancel_policy la quita). create_service y update_service aceptan accepts_chat_requests (los clientes lo piden por el chat sin elegir horario) y bot_offered (false: el bot no lo ofrece). Si el formulario de un servicio repite claves de los ítems de su flujo, el error 422 invalid_service_stages nombra cada clave repetida.
create_service y update_service aceptan booking_payment («Cobro al reservar»: none, deposit o total) y deposit_cents, con confirm=true. Con total el turno cobra el valor completo de la tarea por el flujo de la seña; deposit sin seña da 422. Los valores se validan antes de llamar a la API.
También aceptan full_day («Día completo»): se deja y se retira, y el cliente elige el día, no la hora. Hay un solo horario por día, de la apertura al cierre; con un lugar que atiende 3 a la vez, entran 3 por día. No vale para un servicio que asigna una persona (un equipo con un recurso staff): responde 422 service_full_day_invalid.
list_tasks(date_from=…, date_to=…, include_carried=true) suma las tareas iniciadas que pasaron su fin y siguen ocupando su lugar en esas fechas (servicio de día completo o sin persona, hasta 7 días después del fin): vienen con carried_over=true y carried_until. Es la misma regla que usa la disponibilidad, con el scope bookings:read.
list_tasks muestra por defecto (fees=due) solo las cuotas de clubes y membresías que vencieron o vencen dentro de los días de aviso del plan, como Hoy y Trabajo: no trae las pagadas, las perdonadas ni las que se cobran solas con tarjeta mientras el cobro esté al día. Con fees=all las trae todas (por ejemplo, para ver el historial de cuotas de un cliente).
create_service y update_service aceptan chat_payment («Cobro por chat», con confirm=true): mode (on_delivery|ask|link), prepare (anyway|after_payment) unpaid (keep|cancel) y remind (booleano: un único recordatorio al cliente antes de que venza el link); no lleva montos, el link es por el saldo de la tarea que calcula Fiuit y requiere Mercado Pago listo.
update_service admite payment_requirement: required|optional|off: muestra una propuesta y con confirm=true aplica el mismo PATCH del catálogo (config:write). Cambiar la regla crea una versión auditada; el ejecutor aplica la política vigente del servicio a los destinos completed. Con payments_enabled=false explícito no exige resolver cobro ni borra saldos (cambio respecto de F3-177).
Mercado Pago
Brasil y Argentina conectan solo con OAuth. Chile, Uruguay, Colombia, México y Perú conectan solo con token desde Pagos. Paraguay no ofrece Mercado Pago. Las cuentas existentes se conservan.
Con cuenta de producción y servicio con seña, BRL/ARS generan un link de pago que vence antes que la reserva temporal. En Brasil, Pix se paga dentro de Mercado Pago. El portal muestra el link y el chat lo envía por la conversación disponible.
La reserva queda esperando seña hasta verificar el pago. El prepago aplicado cubre o reduce la seña. Un pago tardío exige revisión del equipo: no reconfirma ni devuelve dinero automáticamente.
Un intento rechazado o cancelado permite volver a intentar el checkout. Si un pago tardío deja dinero sin aplicar en revisión, la reserva pendiente vence y libera el horario; el recibo y el aviso se conservan. La conciliación detecta pagos adicionales también cuando llegan juntos en la búsqueda de Mercado Pago.
Un cobro tardío, devuelto o con contracargo sin seña aplicada conserva su recibo y revisión al liberar el horario. Un snapshot local cancelado no prueba ausencia de dinero: exige consulta final. La gracia de 24 horas por pérdida de credenciales solo libera una reserva sin cobertura aplicada ni enlaces reemplazados sin verificar.
La disponibilidad de MP incluye country (país de cobro según moneda del negocio) aun sin cuenta; Pix solo BR. Sin nuevas herramientas, scopes ni acciones de reembolso.
Antes de vencer una reserva, el worker concilia todos sus enlaces electrónicos pendientes de verificación, incluidos los reemplazados y cancelados por cambio de importe, aunque su reintento esté pospuesto. Si alguna consulta falla o falta acceso a un enlace reemplazado, conserva el horario. Los recibos ya verificados conservan su estado financiero.
Un pago a tiempo del enlace anterior se aplica aunque sea parcial: reduce el pendiente y genera un enlace por la diferencia. La reserva permanece esperando seña y conserva el horario; el enlace por diferencia conserva el vencimiento original y nunca pasa de dos horas antes del turno. Al agotarse ese plazo queda en revisión, sin más links ni avisos al cliente; Dueño/Encargado recibe un aviso al retener el parcial. Confirmar exige cubrir el total. La falta posterior de credenciales no elimina la cobertura aplicada. El equipo debe completar el cobro o resolver la reserva; no hay devolución automática.
Checkout Pro recibe solo contacto y descripción conocidos. El descriptor se normaliza a letras y números ASCII, sin acentos ni símbolos, con hasta 13 caracteres. El retorno abre el portal privado del cliente mediante su enlace existente; si no existe uno vigente o fue revocado, vuelve a /payment-return, una página neutra sin datos del cliente. El retorno nunca crea ni revoca portales. El token queda en el fragmento y no confirma ningún pago. El receptor exige HTTPS público y rechaza .test, .example, .invalid y .localhost. Los tests habilitan explícitamente sus dominios reservados; producción no lo hace.
Un POST de creación ambiguo libera automáticamente el lugar tras siete días de búsquedas vacías exitosas, con aviso al negocio y auditoría. Error, pago observado o pérdida de credenciales reinicia esa ventana; no se deduce ausencia de dinero sin acceso. Dueño/Encargado puede elegir «Liberar el lugar» junto a la revisión: cancelación auditada y confirmada que conserva los cobros, sin devolución. Usa tasks:work y payments:accounts_configure en sesión de panel; no hay tool de liberación ni API key autorizada para ese motivo.
F4-25: get_mercadopago_account (payments:read) informa además workspace_currency, mismatch (currency o country si la cuenta cobra en otra moneda o país que el proyecto: no se crean links), methods (link, Pix, QR y tarjeta con available y el motivo reason si no lo están; QR y tarjeta todavía no existen) y deposit_hold_minutes. list_mercadopago_charges (payments:read, solo lectura) lista los últimos cobros de Mercado Pago con estado, monto, propósito y tarea, sin datos del pagador ni link. La cuenta se conecta y la seña de cada servicio se edita en Finanzas → Cobros.
F4-23: get_mercadopago_account suma el método point (terminal Point Smart; motivo terminal_required si no hay terminal vinculada) y account.point_terminal_id. Vincular la terminal y «Cobrar con Point» son solo del panel: no hay herramienta MCP (las operaciones no aceptan API key).
F4-20: create_payment_link (payments:link) crea el link de Mercado Pago por el saldo de una tarea («Cobrar»); sin amount_minor, el monto lo calcula la API. Sin confirm devuelve una vista previa con idempotency_key; confirm=true exige esa clave. deliver="conversation" lo manda además por la conversación del cliente. Un link abierto por el mismo monto se reutiliza; con otro monto abierto responde 409 payment.link_pending.
F4-92: «Cobrar una parte». create_payment_link acepta amount_minor opcional (entero en unidad menor, el que indicó una persona): crea un link propio por esa parte, que convive con otras partes abiertas. La suma de los cobros abiertos nunca pasa el saldo: si no entra, responde 422 payment_part_exceeds_balance con remaining_minor (lo que queda por cubrir) y open_minor. Reintentar con la misma idempotency_key devuelve la misma parte; otra clave es otra parte aunque el monto sea igual. Sin monto, el link cobra lo que queda sin parte. cancel_payment_charge (payments:link, confirm=true) anula un link abierto, sea una parte o el link por el saldo (QR y Point se anulan solo desde el panel); uno ya pagado responde 409 payment.charge_not_open. El historial de get_task_balance con include_charges=true marca cada parte con part=true. El QR y el Point con monto son solo del panel.
Evaluaciones después del servicio
get_feedback(kind, identifier) (bookings:read): booking, service, customer, resource; 0–100. get_feedback_settings (config:read).
Qué vende el bot: bot_offer (config:read) devuelve lo que el bot ofrece hoy por chat (tipos habilitados, servicios, productos de cada modalidad de pedido, planes y el link «ver todo o contratar»). stages lista las etapas de flujos que achican esa lista; con flow_id y stage juntos, devuelve lo que vería un cliente con su tarea en esa etapa. list_services y search_products traen bot_offered por ítem: apagado, el bot no lo nombra ni lo vende. Link por ítem: create_service y update_service aceptan offer_url (clear_offer_url lo quita) y save_product lo recibe en el producto; https, hasta 500 caracteres. Si está, el bot lo muestra junto al ítem; si no, usa el link del bot. bot_offer lo devuelve en cada servicio, producto y plan. search_products acepta stock (out, low, in), missing (photo, price, category; repetible), variant (talle o color) y sort (name, price_asc, price_desc, stock_asc, best_selling, recent); q busca también por SKU. El cursor vale solo con el mismo sort y los mismos filtros.
Buscar en tu tienda: get_store_search muestra la búsqueda de productos en vivo en tu tienda online (Tiendanube, WooCommerce, Shopify, Make, n8n o una URL propia): la plantilla, la URL de búsqueda con {q}, el mapeo de campos, el servicio de pedidos por chat al que entran los productos, cuántos resultados muestra el bot y si está activa; de las credenciales solo dice sus nombres. list_store_search_presets trae las plantillas listas. save_store_search la crea o la edita y disable_store_search la apaga: los dos muestran antes y después sin escribir y solo cambian con confirm=true. Las credenciales van en headers, se guardan cifradas y nunca se devuelven. test_store_search hace la misma búsqueda que el bot y muestra los productos con su precio. Todas piden products:write.
Atención del bot: bot_tree (config:read) devuelve el árbol de atención del bot: las ramas (servicios, productos, suscripciones, flujos propios, preguntas, mis turnos y hablar con una persona) con si están pausadas, si se pueden pausar y a qué tarea y flujo lleva cada una. Pausar servicios, productos o suscripciones es el campo sells de «Qué vende el bot». Las ramas vienen en el orden en que el bot las ofrece, con el flow_id de la raíz, su saludo (greeting) y el orden guardado (order): update_flow sobre ese flow_id con order o greeting los cambia (config:write, el mismo permiso que «Qué vende el bot»). Una rama propia pausada también se ordena y conserva su lugar. La raíz no se desactiva ni se duplica.
Recorrido de las conversaciones: bot_tree_funnel (config:read) dice, por rama del árbol de atención y en los últimos días (days, 7 por defecto), cuántas conversaciones crearon una tarea, se respondieron, pasaron a una persona o se cortaron, y en qué paso; bot_conversation_path muestra por dónde pasó una conversación y dónde se cortó. No incluyen lo que escribió el cliente.
Tu web: get_site (config:read) muestra «Atención → Sitio web»: plantilla (booking, catalog o showcase), secciones opcionales marcadas (galería, equipo y recursos, reseñas, planes), los textos de portada y «Quiénes somos», el subdominio (negocio.fiuit.app) y si está publicada. update_site cambia esos campos y publish_site / unpublish_site la encienden o la apagan (config:write); los tres muestran antes y después sin escribir y solo cambian con confirm=true. La web nace apagada. Lo que muestra del catálogo es lo mismo que ofrece el bot (bot_offer), y sus preguntas frecuentes son las del bot. El subdominio va de 3 a 40 letras minúsculas, números y guiones, sin nombres reservados ni repetidos; cambiarlo en una web publicada apaga el link anterior (no hay redirección) y exige confirm_link_break: true dentro de changes; sin él la API responde 409 y no cambia nada. Si Fiuit revoca una web, no se puede volver a publicar hasta que la restaure. «Hecho con Fiuit» aparece al pie de la web: con un plan pago se quita con made_with_fiuit: false (can_hide_made_with_fiuit dice si tu plan lo permite); en el plan gratis la API responde 409 y sigue visible.
Base de los documentos (FIU-774, FIU-795): una sola base por marca para presupuesto, recibo y extracto de cuenta. get_quote_base (config:read) muestra «Configuración → Documentos»: las marcas (encabezado con logo y datos de la empresa, pie y encabezado de página), los bloques fijos (términos y condiciones, garantía, confidencialidad) con los documentos donde sale cada uno (document_types: quote, receipt, statement) y las variables disponibles. Sin nada configurado devuelve configured: false y una sola marca con id: null, la del proyecto: no hace falta configurar nada. preview_quote_base (config:read, no guarda nada) muestra cómo la congelaría un envío del documento que pidas (document_type: quote por defecto, receipt o statement; solo salen sus bloques), con valores de ejemplo de cliente y presupuesto. create_quote_brand y update_quote_brand (config:write) cargan o corrigen los datos de una marca y siempre piden confirm=true: usá solo datos que te dé el negocio, nunca inventes la razón social ni el documento. Los bloques fijos son textos legales que escribe el negocio en el panel o por la API; no hay herramienta para redactarlos, elegir en qué documentos salen, borrar marcas ni subir el logo.
El Dueño puede activar evaluaciones al completar una tarea: formulario configurable, enlace de un solo uso, marca de la empresa e indicadores de satisfacción con muestra mínima. Los comentarios respetan permisos de privacidad. Una puntuación baja entra en atención y genera aviso por email y Telegram, según preferencias y disponibilidad. Apagado por defecto; el envío depende del canal y de su ventana. La entrega puede repetir el mismo enlace después de una caída del worker; la respuesta sigue siendo única.
F3-143 incorpora estado de admisión en lecturas de conversaciones de la API. Mensajes sigue excluido del MCP: bloquear/liberar contactos exige sesión Dueño/Encargado en el panel (contacts:moderate). No hay una tool externa de moderación ni desafío anti-bot en esta entrega inicial.
La política de Telegram se configura en el panel o mediante propuestas confirmadas de Wagy. WebChat puede exigir Turnstile al abrir sesión. Son superficies públicas/panel, sin scopes de API key: MCP no abre sesiones WebChat ni modera contactos.
La revisión con una seña electrónica ya aplicada no dispara consultas finales repetidas. Los cobros restantes se concilian con reintentos acotados; los webhooks verificados siguen procesándose. Una creación ambigua usa espera exponencial hasta un día entre consultas durante la ventana de siete días de búsquedas vacías exitosas; la liberación ocurre en la siguiente consulta, como máximo un día después de cumplir la ventana. Errores, pagos observados o credenciales perdidas reinician la evidencia vacía.
Los turnos guiados, deshacer y reiniciar la entrevista de alta requieren sesión Dueño y CSRF del panel; no son herramientas MCP. La API pública de setup está pendiente (F3-220).
confirm_booking aplica las guardas vigentes del core: un hold pendiente cuyo servicio fue retirado devuelve 409 service_inactive. Una confirmación ya comprometida conserva su replay. Turnos, deshacer y reiniciar la entrevista requieren sesión Dueño y CSRF; siguen fuera de MCP.
La revisión y fusión de identidad de clientes (F3-154) solo está disponible para sesiones Dueño/Encargado con CSRF en el panel. MCP no ofrece fusión por contactos declarados; coincidencias no verifican identidad. Códigos y fusión con cobros siguen pendientes.
Las reglas de reconfirmación y alerta por falta de respuesta (F3-75) se configuran por la API de automatizaciones y siguen excluidas de MCP. Solo avisan tras una solicitud enviada sin respuesta. No hay una tool MCP para responder reconfirmaciones ni liberar horarios por silencio.
Importar productos (F3-153, FIU-859): export_products_csv(template=false), preview_products_csv(csv) y confirm_products_import(import_id, confirm=false, actions) en toolset admin; scope products:write, incluso para exportar. La vista previa no cambia productos. Confirmar exige confirm=true, es atómico e idempotente por ID (resultado retenido 7 días); una vista previa vence en 30 minutos y cambios de catálogo/moneda requieren repetir. Máximo 1 MiB / 2000 filas; UTF-8, precios con regla única (PYG/CLP enteros; BRL «1,500» ambiguo). Wagy dirige el archivo al panel; no confirma CSV por chat.
Puesta a punto desde Claude o ChatGPT (FIU-525)
Guía para el dueño: Configurá Fiuit con Claude o ChatGPT.
- Prompts (
prompts/list), uno por tarea e idioma, sin argumentos:setup_from_scratch_{pt,es,en}(entrevista corta como la de Wagy: agenda, horario, qué vende, cómo cobra),setup_bot_and_knowledge_{pt,es,en}(bot y base de conocimiento) eimport_catalog_{pt,es,en}. Son instrucciones fijas que nombran herramientas existentes; toda escritura sigue con vista previa yconfirm=true. La auditoría de puesta a punto (audit_setup) llega cuando la API de la auditoría esté publicada. - Recursos:
fiuit://setup/{pt,es,en}/guide(buenas prácticas y rubros de ejemplo, Markdown) y la plantillafiuit://setup/{idioma}/examples/{clave}(servicios, flujos, automatizaciones apagadas, preguntas y horario típico de un rubro; se aplica conapply_examples). - Importar desde archivos (una sola importación):
preview_products_csvaceptacsv,file_base64,xlsx(Excel en base64) orows(hasta 2000 filas que el modelo leyó de un Excel, PDF o foto), detecta las columnas solas ycolumns{encabezado: columna}las corrige (name,unit,price,category,sku,ean,stock,option1/value1…). Devuelve los conteos de cada acción:update(actualizar datos),create(crear los que no encontró),stock(cantidades, solo si el archivo las trae) yarchive_missing(archivar, nunca borrar, lo que el archivo no trae; sale desmarcado y lista lo que archiva);actionselige las casillas. Un archivo con solo código y cantidad toca solo el stock.undo_products_import(import_id, confirm)deshace TODO lo aplicado (datos, altas, stock y archivados) mientras nadie lo toque (409products.import_undo_stale), hasta 7 días. - Servicios en lote:
preview_services_import(mismas fuentes; columnasname,duration_min,price,team,full_day,bot_offered; solo crea),confirm_services_importyundo_services_import, conconfig:write. La API arma la tabla y valida. preview_service_from_text(config:write): lee un texto («corte 30 min $8.000 con lavado opcional») y propone nombre, duración, precio y adicionales sugeridos. Devuelve la misma vista previa quepreview_services_import: nada se crea hastaconfirm_services_import, y el precio se confirma antes de guardar.- Origen: el MCP manda el nombre de la app (
clientInfoo User-Agent) enX-Wagend-Client-Name; la auditoría lo guarda comoclientjunto al actormcp(«MCP · Claude»). No da permisos.
Operaciones del negocio (F4-45)
El servidor del repositorio agrega 76 herramientas: clientes/direcciones (customers), Mensajes (inbox),
finanzas solo lectura (finance), transiciones de tarea (tasks) y catálogo, horarios, automatizaciones
y conocimiento JSON (admin). Los siete conjuntos se habilitan por defecto.
tools/list publica cada herramienta con su scope y los esquemas de path (IDs de ruta), query
(filtros) y body (comando JSON). No tenés que pasar una URL ni un proyecto. Las nuevas escrituras
muestran el envío previsto y una clave; repetí con confirm=true e idempotency_key estable. La API
valida permisos, requisitos y disponibilidad al confirmar; la vista previa no garantiza éxito.
| Área / ejemplos | Scope base |
|---|---|
list_customers, get_customer, direcciones, resumen e historial | customers:read |
create_customer, update_customer, guardar/borrar dirección; eliminar un cliente (preview_customer_deletion, delete_customer: sin historia se borra, con historia queda archivado) y restore_customer | customers:write |
Vehículos del cliente (FIU-609): list_customer_assets, get_customer_asset / create_customer_asset (alcanza con patente o modelo), update_customer_asset, delete_customer_asset | customers:read / customers:write |
Agregar dato con texto libre (FIU-962): add_customer_detail reparte «tel 11 5555-1234, tiene un Fiat Uno ABC123» en contacto, dirección, notas y bienes | customers:write + customers:read |
Historial de un auto (FIU-611): list_customer_asset_tasks; y assets (asset_id o un auto nuevo con text: «Modelo o patente») al crear o editar una tarea | customers:read / bookings:write |
Tipos de bien: list_customer_asset_types / activar Vehículos con create_customer_asset_type ({"preset": "vehicle"}) o desactivarlo (active: false: los autos quedan en solo lectura) | customers:read / config:write |
list_conversations, list_conversation_messages, contadores | messages:read |
send_conversation_message, modo, resolver, leído, intención, abrir conversación y add_conversation_note (aviso de sistema, nunca se envía al cliente) | messages:write |
move_work_item_stage, use_work_item_tool, quitar horario, metadata e ítems | bookings:write |
fill_stage_from_photo (FIU-672), propone valores sin guardar | bookings:write |
«Datos del update_work_item_asset corrige el bien de la tarea (p. ej. los km) y, si es la más reciente del bien, el del contacto | bookings:write |
| Historial, comentarios, adjuntos y ubicación de tarea | bookings:read |
| Detalle de producto / categorías y sugerencias | products:read / products:write |
Ventas por producto (get_products_stats) / rendimiento por paquete o club (get_prepaid_plans_stats); el dinero solo con finance:analyze | bookings:read / prepaid:read |
| Horarios, zonas, recursos, automatizaciones y conocimiento | config:read / config:write |
| Resumen, informes, deuda, cuentas, clientes y previsión financieros | finance:analyze |
Números de cobros (get_finance_collections): bruto, devuelto, comisión de Mercado Pago, comisión de Fiuit y neto por método, servicio y día o semana, más lo estimado sin cobro | finance:analyze |
| Disponibilidad/movimientos financieros; caja; configuración de caja | payments:read; cash:read; cash:configure |
Clientes omiten nombres, contactos, documentos y direcciones por defecto; las otras vistas sensibles
omiten texto libre y contactos. include_sensitive=true exige el scope de lectura que indica cada
herramienta, además del scope base; para mensajes y comentarios habilita su contenido. Las finanzas
conservan importes, advertencias y estimaciones de la API. Una acción que cobre necesita además el
permiso financiero que exige el core: bookings:write no basta para cobrar.
Las exclusiones bajan de 134 a 58. No hay equivalencia completa con el panel: 26 rutas aún no
admiten API key (comentarios de escritura, resúmenes de conversación y otras; seguimiento F4-47).
También quedan fuera sesión/campana personal, SSE, simulador, secretos/webhooks, transferencias
binarias/CSV masivo y nuevas escrituras de dinero. Consultá el catálogo con tu clave para saber qué
podés usar. La respuesta de un mensaje puede quedar pending: eso no confirma entrega al cliente.
Avisos al cliente y bitácora
Configurá avisos por servicio para pedidos sin horario, asignación, cambios de datos y progreso. Comienzan apagados. Consultá intentos enviados, omitidos, diferidos o fallidos en Configuración, Actividad y la ficha del cliente. La bitácora conserva 90 días sin copiar mensajes ni datos de contacto; enviado no confirma entrega. Wagy y MCP consultan los mismos resultados.
list_customer_notice_deliveries, get_customer_notice_policies: config:read. update_customer_notice_policy: config:write, confirm=true.
get_notices_overview (config:read) devuelve el índice «Avisos»: todo lo que recibe el cliente, ordenado desde el turno, con el valor efectivo de cada aviso, por qué está frenado y dónde se edita. Con config:write, set_notice_item_enabled enciende o apaga un aviso en su fuente (regla, política por servicio, etapa o flujo) y set_all_notices_enabled es «apagar todos los avisos a clientes»; ambas piden confirm=true. Manda el más específico: el interruptor de cada aviso decide, y el general gana sobre todo. Las filas de etapa publican el flujo y requieren además settings:write; sin ese permiso, toggleable=false y la escritura devuelve 403.
PUT y revert conservan la regla de cobro vigente del catálogo en todas las etapas completed. Volver a guardar payment_requirement repara versiones divergentes; una restauración histórica no cambia el cobro.
La revisión de una reserva vencida con enlaces reemplazados comparte la espera creciente de toda la reserva, hasta un día. Cada consulta final lee todas las preferencias pendientes de resolución; un error impide liberar y reinicia la evidencia vacía. Los webhooks verificados siguen activos.
El enlace vence 15 minutos antes que la reserva; si el plazo es corto, el margen es la mitad del tiempo disponible, con un mínimo de 5 minutos. La página y el chat muestran la hora del enlace. La reserva conserva su propio plazo para verificar aprobaciones demoradas. Un estado local expired no bloquea un pago verificado y aprobado a tiempo: cubre la seña si la reserva sigue pendiente; si ya está cerrada o el pago llegó tarde, conserva el dinero y solicita revisión, sin reabrir ni devolver automáticamente. Si el enlace viviría menos de 5 minutos (con el margen mínimo, menos de 10 minutos hasta el plazo de la reserva), no se crea: queda el cobro manual. Un pago tardío con el lugar ya liberado queda separado «a devolver» (refund_due) en la tarea, en la cuenta del cliente y en el Financiero, con un aviso al equipo por cada pago: no se descuenta de otras deudas del cliente hasta que llega la devolución de Mercado Pago o el equipo (Dueño/Encargado) lo pasa al saldo con «Usar para otra deuda» (auditado). Con un reclamo abierto en Mercado Pago (in_mediation) no se marca «a devolver»: no devolver hasta que se resuelva. Nada es automático.
Las unidades reservadas también se pierden al vencer: la tarea vuelve al precio normal y el equipo recibe un aviso. Un fallo de consumo devuelve prepaid_consumption_failed y conserva la tarea sin completar. Primero quitá el plan para ajustar el importe o el cobro; las notas internas sí se editan.
Si la ventana vence durante el envío, se intenta otro canal utilizable del mismo cliente. La marca no-se-pudo-avisar tiene un lugar reservado además de las veinte etiquetas de negocio, sin reemplazarlas. Reconfirmaciones y pedidos de reseña conservan su conversación y no cambian de canal.
Configurar el negocio por MCP y ayuda de Fiuit (FIU-397)
Todo lo que arma el onboarding también se configura por MCP, con los permisos de la API key:
| Herramienta | Scope | Hace |
|---|---|---|
duplicate_service | config:write (settings:write para copiar etapas) | Crea una copia pausada de un servicio |
delete_schedule | config:write | Baja lógica: conserva las reservas futuras y las devuelve |
delete_service, delete_resource, delete_resource_group | config:write | Sin mode pausa (se reactiva con update_* y active=true). mode=remove borra si no tiene historial y archiva si lo tiene; archive archiva; delete borra o falla con 409 catalog_item_has_history. Con tareas futuras falla con 409 catalog_item_future_bookings y su lista |
delete_product | products:write | Igual, con remove por defecto |
set_product_photo, remove_product_photo | products:write | Pone, reemplaza o quita la foto del producto que el bot manda por chat: image_url (https pública; Fiuit la baja sin seguir direcciones privadas, hasta 2 MiB) o image_base64 (PNG, JPEG o WebP). Sin confirm muestra producto, tipo y tamaño |
suggest_product_from_text | products:write | Lee un texto («zapatilla talle 42, $15.000, stock 10») y propone nombre, talle, precio, stock, categoría, color y material. No guarda nada: el precio se confirma antes de guardar. |
suggest_product_from_photo | products:write | Lee la foto de un producto (url https pública, o image en base64 con mime) y propone nombre, categoría, color, material, una descripción de vendedor y sinónimos; nunca el precio. Con product_id, solo lo vacío. No guarda nada: lo aceptado se guarda con save_product y la foto con set_product_photo. Gasta energía de IA del plan |
list_product_variants, set_product_options, create_product_variant, update_product_variant, delete_product_variant | products:read / products:write | Talles, colores y otras opciones del producto (hasta 3) y sus variantes, cada una con su SKU, código de barras (EAN) y precio propio opcional. available=true lista solo las que se pueden vender. Las escrituras piden confirm=true |
adjust_product_stock, list_stock_movements | products:write | Con «controlar stock» encendido en el producto (save_product, track_stock): fija (qty) o suma y resta (delta) las unidades de una variante, nunca por debajo de cero, y lista los movimientos (venta, devolución, manual, importación) |
export_product_variants_csv | products:write | Planilla de variantes y stock (una fila por variante, por SKU, EAN o producto y opciones); se vuelve a importar con preview_products_csv, la importación única de productos, variantes y stock (también el archivo diario de tu sistema: CSV, Latin-1 y con punto y coma) |
get_service_removal, get_resource_removal, get_resource_group_removal, get_product_removal | config:write / products:write | Qué pasaría al eliminar: si se borra o se archiva y qué tareas futuras tiene |
restore_service, restore_resource, restore_resource_group, restore_product | config:write / products:write | Saca un ítem de «Archivados»; vuelve pausado |
get_bot_settings, update_bot_settings | config:read / config:write | Personalidad del bot (nombre, tono, saludo, qué vende, fotos de productos), versionada |
create_prepaid_plan, update_prepaid_plan | prepaid:manage | Define paquetes y club: precio, unidades, vigencia, cupos y servicios, y sus cuotas: vencimiento (due_rule: signup, month_start, month_end o fixed_day con due_day 1–28), días de aviso (notice_days, 5 por defecto), first_fee_full (sin ella la cuota 1 es proporcional) y flujo del alta (flow_id). Un precio nuevo rige para la próxima cuota de cada suscripción viva (sin aviso al cliente; la respuesta trae live_subscriptions). Vender sigue siendo sell_prepaid_plan |
suggest_plan_from_text | prepaid:manage | Lee un texto («pack 4 cortes $28.000, vence a los 60 días») y propone tipo, nombre, precio, unidades, vigencia y servicios. No guarda nada: es dinero, se muestra y con el OK se crea con create_prepaid_plan |
list_recommended_automations, install_recommended_automations, set_recommended_automation_active, activate_recommended_automations, undo_recommended_automations | config:read / config:write | Automatizaciones que recomienda el ejemplo de negocio; se instalan inactivas y se activan una por una |
get_automation_stage_options | config:read | Etapas y acciones válidas para las reglas por etapa |
preview_customer_notices | config:write | Vista previa de los avisos al cliente con datos de ejemplo; no envía ni guarda |
list_faq_suggestions, approve_faq_suggestion, dismiss_faq_suggestion | config:read / config:write | FAQ automático: las preguntas que hicieron dos o más clientes, sin datos personales y con una respuesta propuesta (si hay de dónde sacarla). Aprobar (tal cual o editada) la suma a la base de conocimiento; descartar hace que no vuelva. Las dos piden confirmación |
list_knowledge_sources, get_knowledge_source, list_knowledge_source_pages | config:read | Fuentes web y listados de la base de conocimiento |
preview_knowledge_source, create_knowledge_source, update_knowledge_source, refresh_knowledge_source, delete_knowledge_source | config:write | Registran, pausan, refrescan o borran una fuente (borrar también quita lo que importó) |
list_live_queries, create_live_query, update_live_query, test_live_query, disable_live_query | config:write | Consultas HTTP en vivo que usa el bot |
apply_business_template | settings:write | Aplica la plantilla de rubro (barbería, estética, clínica…): vocabulario, automatizaciones y flujos inactivos. Solo en un proyecto nuevo y vacío; no se vuelve a elegir |
apply_examples, undo_example | settings:write | Compone de 1 a 3 ejemplos por parte (vocabulario, flujos, automatizaciones, catálogo) y los deshace sin tocar lo que el negocio cambió |
get_vocabulary, update_vocabulary | config:read / settings:write | Glosario del proyecto (cómo se llaman las tareas, los clientes, el equipo) |
export_project_template | config:read | La configuración del proyecto como plantilla (flujos, catálogo, planes, ayuda, bot y automatizaciones), sin datos de clientes ni secretos |
get_bot_channel_policies, update_bot_channel_policy | config:read / config:write | Política del bot por canal: contacto exigido, tope de respuestas, derivación e instrucción del canal |
update_feedback_settings | settings:write | Configura las evaluaciones después del servicio (se leen con get_feedback_settings) |
search_help | cualquier key | Busca en la ayuda de Fiuit: guías de uso, «¿Qué pasa si…?» y políticas de producto vigentes, con el link a la guía y al contacto. No lee datos del negocio |
Las credenciales de fuentes y consultas en vivo no viajan por el MCP: se cargan en el panel y la API nunca las devuelve. Sigue afuera solo lo que no tiene sentido abrir: la sesión y el CSRF del panel, los streams, el simulador, los secretos de webhooks y canales, la campana personal, las descargas binarias grandes (se da el link), la charla guiada del onboarding (sus resultados sí están arriba), revocar un enlace de evaluación y la baja de la suscripción.
Etiquetas de cada escritura. Toda herramienta que escribe declara en su descripción y en _meta["wagend/labels"] si avisa al cliente (notifies_customer), si mueve dinero (moves_money) y si es reversible, con la herramienta que la deshace (inverse). Lo que le llega al cliente o mueve plata pedilo siempre con confirmación explícita de una persona.
Pausar y duplicar
Pausar deja de ofrecer el servicio para pedidos nuevos en bot, reserva pública, Wagy y MCP. Las tareas ya agendadas siguen su curso normal. Reactivar vuelve a ofrecerlo. Pausar y desactivar son la misma acción.
En el detalle abrí ⋯ → Duplicar o Pausar. En escritorio también hay un menú en la lista. Wagy propone ambas acciones y espera la confirmación del plan. MCP permite pausar con update_service(active=false, confirm=true); duplicar es duplicate_service (copia pausada, con confirmación).
API: POST /v1/services/{id}/duplicate, Idempotency-Key, config:write; settings:write para copiar etapas.
Club impago
list_prepaid_subscriptions lista las suscripciones del proyecto con deuda y pausa (limit/offset); las membresías traen standing: al día, en gracia (grace, con los días que faltan) o bloqueada (blocked, no cubre hasta pagar y se libera sola al pagar). Con unpaid=true, solo las impagas (club o membresía), con el nombre del cliente y los meses adeudados (months_due), bloqueadas primero y el club al final. La respuesta trae unpaid_count, el total de impagas del proyecto aunque haya más que el limit. set_prepaid_benefits pausa un club impago o reactiva sus beneficios con confirm=true, sin cobrar ni borrar deuda. Ambas requieren prepaid:benefits. Pagar una cuota no reactiva: se reactiva con set_prepaid_benefits.
Con la membresía bloqueada, hold_slot y la creación de tareas del socio para los servicios de esa membresía devuelven 409 membership_blocked (con plan): hay que regularizar la cuota y se libera sola al pagar.
Si tu proyecto queda «Aguardando pago» (el pago del plan de Fiuit no llegó y venció la gracia), todas las herramientas devuelven 402 workspace_awaiting_payment, también las de lectura, hasta que se acredite el pago.
Flujos v2
Flujos v2: validate_flow, create_flow y update_flow reciben flow con
format:2, stages y exits. La vista previa devuelve impact (conteo total, hasta 100 movimientos, by_service y shared_with); confirm=true confirma publicar/restaurar y mover las tareas
abiertas a la primera etapa del mismo estado base, sin ejecutar avisos al entrar.
El equipo ve todos los ítems; con visible_to cliente, el bot pide esos ítems y aprieta esos botones por el chat donde nació la tarea (origen customer_chat en el historial).
Una etapa puede avanzar sola: ítem timer con timer: {until: duration|task_start|task_end|no_reply, minutes, to} (to es un botón de la etapa sin ítems obligatorios; task_start y task_end van sin minutes, siguen la hora de inicio o de fin de la tarea y solo existen en flujos con horario) o auto: payment_received en un botón (la tarea pagada por completo con Mercado Pago). La tarea trae stage_deadline para la cuenta regresiva y el avance queda en el historial con origen auto. Si el avance falla, la tarea trae auto_advance_failed hasta que alguien la mueva. Un pago cargado a mano también dispara auto: payment_received. Además, auto: customer_replied (el cliente escribió por cualquier canal después de entrar a la etapa) y auto: form_completed (completos los ítems obligatorios que ve el cliente; la etapa necesita al menos uno), uno por evento en cada etapa; el motivo queda en data.automatic.
move_work_item_stage y use_work_item_tool exigen from_stage; enviar también
config_version obtenido al leer la tarea. Un 409 stage_conflict exige recargar.
Los requisitos de botón usan item.<clave>; Cerrar sin completar usa exit.reason
y guarda un motivo privado. Revertir a v1 responde 422 version_format_unsupported.
V2 no incluye link público del cliente, simulador, ítems de pago/productos ni
condiciones. El cobro manual actual conserva las reglas del servicio.
SLA y escalada (F3-595), solo con until: duration: alert: {roles} o alert: {resource: assignee} en lugar de to avisa al equipo al vencer y la tarea se queda en la etapa (un aviso por entrada; stage_deadline.alert es true); by_item: {item, minutes: {opción: min}} toma los minutos de la respuesta de un ítem de opciones (sin respuesta rige minutes) y from: created cuenta desde el alta. En un flujo en cola, la etapa de entrada (held) admite un temporizador duration para escalar lo que nadie tomó. Tope: 43200 minutos (30 días corridos).
get_work_item_stage_history devuelve actor, origen (source), clase (kind) e ítems con las etiquetas históricas, incluidos movimientos por publicación. Son los últimos 100 eventos, del más reciente al más antiguo; la API acepta order=asc para presentarlos cronológicamente. Fotos y firmas son referencias privadas: obtener el archivo exige la descarga autorizada de la tarea. visible_to solo limita al cliente; el equipo conserva el alcance autorizado de sus tareas. Wagy puede explicar este recorrido mediante get_work_item con su alcance vigente.
El ítem live_location («Ubicación en vivo») no se completa por MCP ni por formulario: al entrar a esa etapa el bot de equipo de Telegram le pide al responsable compartir su ubicación en tiempo real y el ítem se cumple con la primera posición. La última posición de una tarea se lee con GET /v1/bookings/{id}/location-events (mismos permisos que la tarea); el mapa del equipo (GET /v1/tasks/live-locations) es solo del panel.
Revisá todos los servicios antes de cambiar un flujo
Al cambiar etapas compartidas, ves qué otros servicios cambian y confirmás el alcance actualizado.
Varias fotos: el ítem photo acepta max_photos (de 1 a 10; sin el campo, una). Con más de 1, move_work_item_stage recibe una lista de ids de adjunto para esa clave. Con el ítem obligatorio alcanza una foto, y una de más se rechaza. Cada foto cuenta en el cupo de la tarea (20 archivos y 50 MB).
«Marcar sobre imagen»: el ítem sketch acepta sketch_background, el id que devuelve upload_stage_image (PNG, JPEG o WebP, hasta 2 MiB). Sin ese campo, quien completa la etapa adjunta una imagen.
update_flow / revert_flow: Enviá en shared_with_ack los IDs de validation.impact.shared_with revisados y aceptados. Ante 409 stage_shared_unconfirmed, volvé a validar y pedí nueva confirmación; no reintentes automáticamente.
La lista incluye todos los servicios del flujo, también el editado.
get_work_item_journey (tasks, bookings:read) lee el recorrido completo de una tarea con sus mapas históricos: eventos cronológicos y versiones v2 referenciadas, incluidas etapas retiradas. Conserva el alcance autorizado y no sustituye versiones ausentes por el flujo vigente. Por defecto devuelve claves y fechas; include_sensitive=true permite consultar etiquetas, actores y respuestas históricas con bookings:read.
configure_customer_habits propone y guarda cuándo un cliente está Por volver, Atrasado, En riesgo o Perdido según su ritmo: due_window (0,15), late_multiple (1,5), at_risk_multiple (2), lost_multiple (3) y lost_cap_days (tope opcional); lo que no pasás vuelve al valor por defecto y null vuelve a todos (scope settings:write, confirm=true). No hay pantalla para esto en el panel.
configure_pay_info propone y guarda los datos para pagar sin Mercado Pago (alias, CBU/CVU, Pix), un texto por idioma: texts con pt, es o en, hasta 600 caracteres cada uno; {} los borra (scope settings:write, confirm=true). El bot los muestra cuando el cobro por chat es «preguntar» y Mercado Pago no está listo; «Ya pagué» solo avisa al equipo y nunca registra un cobro. La lectura de estos datos es del panel y de Wagy: la API key no lee GET /v1/workspace; la respuesta confirmada devuelve lo guardado.
configure_chat_payment permite proponer y guardar el cobro por chat por defecto del negocio (scope settings:write, confirm=true). update_service usa chat_payment para una regla propia y inherit_chat_payment=true para volver al default (scope config:write, confirm=true). El monto lo calcula el servidor; estas herramientas no crean links.
La baja de la suscripción (GET /v1/subscription, POST y DELETE /v1/subscription/cancellation) es solo para la sesión del Dueño en el panel: una API key recibe 403 y no hay herramienta MCP. Wagy lee el estado y lleva a la pantalla, pero no da de baja.
get_control_summary: La atención coincide con Hoy: late respeta la tolerancia del proyecto; notice_undelivered solo abiertas; feedback_review incluye finalizadas; out_of_coverage solo abiertas y excluidas de sin zona. Los motivos pueden solaparse: no sumes sus contadores.
list_tasks(attention="notice_undelivered") usa la misma selección que el contador de Control. attention acepta los ocho motivos de atención, se combina con otros filtros antes de paginar y agrupar, y no agrega fechas implícitas. Mantiene el scope bookings:read.
Los flujos por intención pueden declarar entry al crearse o editarse: cuándo usarlos, ejemplos, exclusiones, palabras clave y si el cliente puede iniciarlos. MCP permite previsualizar estos cambios antes de confirmar. Como máximo hay ocho intenciones activas. El bot recoge los datos iniciales por chat y pide confirmar antes de crear la tarea; crearla directamente por MCP sigue siendo una acción explícita.
Con list_tasks(group_by="flow"), flow_capabilities devuelve solo outcomes y delivery: los estados que permiten los flujos activos del proyecto, incluso sin tareas, sin nombres ni IDs. Una cola de atención en el local no implica entregas.
Al guardar rasgos, el glosario se arma automáticamente si no hay uno guardado; conserva tus ediciones. Para cambiar sus nombres, usá Configuración → Vocabulario o pedíselo a Wagy y confirmá la propuesta. La edición del glosario requiere sesión del panel; no se ofrece por MCP.
Proponé una característica nueva con Wagy
get_trait_catalog (config:read): pt/es/en. list_trait_proposals(cursor) (config:read). propose_trait(trait, confirm=false) / confirm=true (settings:write). Wagy prepara un nombre y preguntas en tres idiomas. Revisá la propuesta y confirmá el envío: queda como etiqueta propia hasta que el equipo la aprueba, rechaza o une a otra. No cambia cómo atendés a tus clientes.
¿Qué pasa si se agota el canal de asistentes de IA?
El cupo es por negocio: 600 llamadas de IA y 200 conversaciones nuevas por día, y hasta 10 horarios apartados a la vez. Distintas personas comparten esos cupos, por lo que también pueden agotarlos. Te avisamos en las notificaciones de Atención → Canales; el canal vuelve cuando se renueva el cupo o se liberan los horarios. Los demás canales siguen funcionando. Si el límite de IA se alcanza durante una respuesta, el bot pide esperar y no deriva la charla por ese motivo.
Motivos de cierre
get_flow → exits.close.reasons / exits.cancel.reasons: {key, label: {pt, es, en}}; update_flow → confirm=true. get_outcome_reasons(start, end, service_id?, resource_id?) → bookings:read.
Configurá los motivos en Mi negocio → Etapas. Al cerrar elegí uno u Otro con una explicación. Cancelar permite omitirlo. En Resultados ves la cantidad por flujo, salida y motivo.
list_tasks(sales="hide") excluye todas las ventas rápidas de «+ Ingreso» (como Hoy y la agenda). sales="work" conserva las ventas con saldo junto al trabajo normal (como Trabajo); sales="only" lista solo ventas rápidas y sales="all" (por defecto) incluye todo. El filtro se aplica antes de paginar y contar; no cambia permisos ni montos.
list_tasks(pay="unpaid"|"partial"|"paid") aplica el estado de pago a toda la selección antes de contar y paginar, junto con los demás filtros. paid incluye sobrepago; sin cargo o estado desconocido no coincide. Requiere payments:read_balance y conserva el alcance asignado de staff. El parámetro anterior payment_status conserva su filtro solo sobre la página.