dale-plugin-knownfy

Plugin de Dale para Knownfy — inteligencia de compliance via WhatsApp.

Permite a compliance officers investigar personas y empresas, consultar casos, revisar alertas y compartir reportes directamente desde WhatsApp.

Instalacion

npm install dale-plugin-knownfy

Configuracion

1. En el dashboard de Dale, crea un workspace (o usa uno existente).
2. En la seccion de credenciales del vault, agrega tu API key de Knownfy con el ID knownfy.
3. Instala el plugin desde el dashboard o via CLI:

dale plugin install dale-plugin-knownfy

Acciones disponibles

Investigacion (requieren confirmacion)

| Accion | Que hace | Ejemplo de mensaje | |--------|----------|-------------------| | Investigar persona | Lanza analisis KYC | "Investigar a Pablo Girod, Argentina, CUIT 20-32920155-5" | | Investigar empresa | Lanza analisis KYB | "Investigar empresa MercadoLibre, Argentina" | | Compartir reporte | Genera link publico | "Compartir reporte rpt-001 a [email protected]" | | Resolver alerta | Cambia estado de alerta | "Resolver alerta 42" |

Consultas (automaticas)

| Accion | Que hace | Ejemplo de mensaje | |--------|----------|-------------------| | Mis casos | Lista casos del tenant | "Mis casos" | | Resumen de caso | Muestra resumen rapido | "Resumen del caso rpt-001" | | Estado del trabajo | Consulta progreso | "Ya esta?" | | Alertas | Muestra alertas activas | "Alertas" | | Cobertura | Fuentes por pais | "Que cubren en Chile?" |

Ejemplo de conversacion

Usuario: Investigar a Juan Perez de Argentina
Dale:    Confirmas investigar a Juan Perez en Argentina?
Usuario: Si
Dale:    Investigacion iniciada. Job ID: job-abc123.
         La investigacion puede tomar entre 1 y 3 minutos.
         Preguntame "ya esta?" para consultar el progreso.

Usuario: Ya esta?
Dale:    Investigacion completada
         Entidad: Juan Perez
         Tipo: Persona
         Pais: Argentina
         Riesgo: MEDIO
         Accion sugerida: Requires Monitoring
         Screening: LOW
         Hallazgos adversos: 2
         Reporte completo: https://app.knownfy.com/viewer/rpt-xyz-456

Paises soportados

Argentina (AR), Bolivia (BO), Brasil (BR), Chile (CL), Colombia (CO), Ecuador (EC), Mexico (MX), Peru (PE), Paraguay (PY), Uruguay (UY).

Desarrollo

npm install
npm test           # corre 47 tests
npm run build      # compila TypeScript
npm run lint       # chequeo de tipos

Estructura

src/
  connector.ts        # DaleConnectorAdapter — 11 acciones mapeadas a la API de Knownfy
  pack.ts             # DalePackManifest — 8 intents, 8 grafos con paramsSchema
  installer.ts        # Funcion de instalacion para Dale
  knownfy-client.ts   # HTTP client tipado contra la API REST de Knownfy
  formatters.ts       # Convierte JSONs de la API a mensajes cortos para WhatsApp
  types.ts            # Tipos de respuesta de la API de Knownfy
  dale-types/         # Stubs de @dale/core-types para desarrollo local
  index.ts            # Exports publicos
tests/
  connector.test.ts   # Tests del conector con mock HTTP
  formatters.test.ts  # Tests de formateo de mensajes
  install.test.ts     # Tests de instalacion y estructura del pack

Licencia

MIT