Requisitos de acceso
- El módulo debe estar habilitado para tu empresa. Si no lo ves, contactá a soporte.
- Necesitás el permiso de gestión del módulo WhatsApp (configurable en
Configuración > Roles) para números, tools y CBU/CVU. - El asistente Twin dentro del dashboard usa otro permiso, Asistente WhatsApp. El rol Operador lo trae. Confirmar un borrador de operación o de cheque desde Twin también exige poder crear esa operación o ese cheque.
- La configuración está en
Configuración > Equipo y acceso(tools y CBU/alias). El número de cada empleado se configura enConfiguración > Equipo y acceso→ Empleados.
Estructura del módulo
Hay cuatro pestañas principales:1. Empleados
Acá definís qué empleados pueden usar el bot y con qué número de WhatsApp.- Cada empleado puede tener un número de teléfono asociado.
- El acceso se activa o desactiva por empleado sin borrar la configuración.
- Estados posibles: No configurado, Pendiente de verificación, Verificado o Inactivo.
- Desactivar corta el acceso al bot; no borra el número ni desvincula al empleado.
- Si eliminás el empleado en
Configuración > Equipo y acceso→ Empleados, FinSync desvincula automáticamente su WhatsApp (borra el contacto de ese empleado). No hace falta desactivar antes. - Los destinos y horarios del export de cuentas corrientes se configuran en la pestaña Entregas. WhatsApp solo entrega el mensaje o el archivo si esa persona te escribió en las últimas 24 horas.
Verificación del número
Para confirmar que el número es correcto, el empleado debe enviar el mensajeping desde su WhatsApp a FinSync (@finsync_bot / +1 (208) 330-8007). Si la verificación es exitosa, recibirá pong como respuesta.
Como administrador podés:
- Copiar el número de FinSync o abrir WhatsApp directamente desde el modal de configuración.
- Enviar instrucciones por WhatsApp al empleado con un enlace prearmado (si configurás su número desde la tabla).
2. Tools del bot
Las tools son plantillas de operaciones que el bot puede preparar cuando un empleado autorizado escribe por WhatsApp. No se confirman solas: siempre quedan en estado borrador/pendiente y deben aprobarse en el dashboard como cualquier otra operación. Desde esta pestaña podés:- Ver la lista de tools configuradas (arriba).
- Aplicar packs de plantillas genéricos debajo de esa lista (ventanilla, bajada/subida, pase CC, USD/TT y gastos si el módulo de centros está activo). Las monedas de ventanilla salen de las cajas internas reales de la empresa.
- Crear una nueva en
Configuración > Equipo y acceso→ Tools de WhatsApp → Nueva tool (o editar una existente). - Activar o desactivar cada tool.
- Eliminar tools que ya no uses (baja lógica: se deshabilitan y quedan con
deleted_at).
x-api-key) en /api/whatsapp/tools, con el mismo fixed_config / parameter_schema que este formulario. Ver WhatsApp tools workflow.
Packs de plantillas
En Tools del bot, debajo de la lista, aparecen packs listos para aplicar (grilla compacta). Si la empresa ya tiene más de 3 tools (WHATSAPP_TOOL_TEMPLATES_ACCORDION_THRESHOLD), la sección arranca plegada como Agregar desde plantillas. Con 3 o menos (o ninguna) queda abierta. No traen ids de otra empresa: al aplicar se resuelven Crédito/Débito por nombre, las cajas por moneda y los tipos de operación de tu compañía. Si ya existe una tool con el mismo nombre, se omite.
- Ventanilla: compra y venta por cada par de monedas que realmente tengan caja interna. Perspectiva casa: compré = compra.
- Bajada / Subida: ingreso y egreso oficina ↔ cuenta corriente.
- Pase CC ↔ CC: dos patas de cuenta corriente dinámicas.
- USD / TT: proveedor TT dinámico y crédito ARS (caja, CC o split TT + efectivo). Solo si hay caja USD; las variantes de efectivo piden caja ARS.
- Gastos: solo si el módulo de centros de resultados está habilitado. Pago desde caja o desde cuenta corriente.
Tipos de operación soportados
Al crear una tool elegís un tipo de operación de tu empresa. Según ese tipo, el formulario adapta origen, destino y comisiones:
En cada tool podés definir:
- Nombre, descripción y si está habilitada.
- Campos fijos (valores predefinidos) o dinámicos (el bot pregunta al usuario por chat, por ejemplo cliente, cuenta, monto o moneda).
- Comisiones cuando el tipo de operación lo permita.
- Reglas de coincidencia de montos cuando origen y destino comparten moneda.
- Aclaraciones: instrucciones solo para el bot sobre cuándo usar esa tool (no reemplazan la descripción del movimiento).
Varias operaciones en un solo mensaje
Si un mensaje pide varias operaciones del mismo tipo para el mismo cliente o caja (por ejemplo, tres bajadas iguales con montos distintos), el bot llama la tool una vez por cada una con una clavebatch_key distinta. Cada operación queda como borrador independiente con sus propios botones Crear / Descartar y su código. Para confirmarlas o cancelarlas en conjunto, usá los botones de cada tarjeta o respondé CONFIRMAR <código> / CANCELAR <código>.
Si el bot detecta que un borrador quedó mal, lo descarta antes de enviarlo (herramienta discard_operation_draft) y vuelve a crear el correcto. No deberías ver dos versiones de la misma operación.
Prompt base del bot
Al final de la pestaña Tools hay un campo Prompt base del bot: instrucciones generales de la empresa que se agregan al prompt global de FinSync (no lo reemplazan ni cambian las reglas contables o de seguridad). Aplica a los próximos mensajes y sirve para casos propios de la empresa, por ejemplo:- Cómo nombrar operaciones o clientes en el chat.
- Cuando un pedido habitual necesita varios pasos.
- Aclarar que varias operaciones iguales en un mensaje deben prepararse por separado (
batch_key).
3. CBU/CVU
Esta pestaña mapea números de CBU o CVU (22 dígitos) a entidades de FinSync para que el bot reconozca transferencias mencionadas por WhatsApp. Podés asociar cada alias a:- Un cliente externo (cuenta corriente), o
- Una cuenta interna / caja.
4. Entregas
Horarios de export de cuentas corrientes por WhatsApp. Ver la sección siguiente.Export programado de cuentas corrientes
EnConfiguración > WhatsApp → Entregas armás una lista de horarios por empresa.
- Cada horario tiene hora de Argentina, destinatarios (empleados con WhatsApp) y alcance: todas las cuentas corrientes o clientes específicos.
- Las empresas que ya tenían el export diario siguen con un horario de todas las CC a las 23:00.
- Podés agregar más horarios, por ejemplo uno a las 16:00 con cinco clientes.
- Si el horario incluye 8 clientes o menos, el bot manda los saldos en un mensaje de texto. Si son más, manda el CSV de siempre (mismas columnas que Exportar Cuentas, solo CC externas).
- Cada horario se manda una vez por día (fecha de Argentina). Si se retrasa, se envía más tarde el mismo día. No se reenvía el de ayer después de medianoche.
- Enviar ahora manda ese horario en el momento, sin consumir el cupo del día.
- Hace falta el módulo de WhatsApp habilitado y al menos un empleado con WhatsApp activo.
- WhatsApp exige una ventana de 24 horas desde el último mensaje de esa persona. Si no escribió, FinSync omite ese destinatario.
- También podés pedirlo al bot en cualquier momento: “exportá cuentas corrientes”, “mandame el CSV de CCs”, “saldos CSV”. El pedido on-demand funciona aunque los horarios estén apagados, pero solo para empleados (no para clientes del portal).