> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finsync.ar/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp

> Configuración del bot de WhatsApp: empleados autorizados, tools operativas y alias CBU/CVU para transferencias.

# WhatsApp

El módulo de **WhatsApp** permite que tu equipo interactúe con FinSync por mensaje: preparar operaciones, consultar información y vincular transferencias por CBU/CVU. Todo lo que el bot genera queda como **borrador** o **pendiente** hasta que alguien lo apruebe desde el dashboard.

## 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`).
* La configuración está en `Configuración > WhatsApp`.

## Estructura del módulo

Hay tres 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**.

#### Verificación del número

Para confirmar que el número es correcto, el empleado debe enviar el mensaje **`ping`** desde su WhatsApp al número de FinSync **+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.
* Crear una nueva en `Configuración > WhatsApp` → **Nueva tool** (o editar una existente).
* Activar o desactivar cada tool.
* Eliminar tools que ya no uses.

#### 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:

| Tipo base     | Uso típico                                                                                                                                              |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **UP / DOWN** | Movimientos entre caja y cuenta corriente (ingresos/egresos clásicos), con origen y destino configurables.                                              |
| **OTHER**     | Operaciones con una o más patas personalizadas (cliente interno o externo, montos, monedas y tipos de transacción fijos o pedidos al usuario por chat). |
| **EXCHANGE**  | Cambio de moneda vinculado al tipo de operación correspondiente.                                                                                        |

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.

### 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**.

Cada alias puede tener una etiqueta opcional para identificarlo en la lista. Solo se guardan CBU/CVU válidos de 22 dígitos.