Resumen Esta guía de inicio rápido te llevará a través de la creación de tu primer análisis de riesgo Know Your Business (KYB) usando la API de gu1. Aprenderás cómo:
Autenticarte con la API
Definir un esquema personalizado para tus datos de empresas
Crear una entidad de empresa
Aplicar reglas de riesgo (desde el dashboard)
Monitorear alertas e investigaciones
Requisitos previos : Necesitarás una cuenta de gu1 y una API key. Regístrate en app.gu1.ai si aún no lo has hecho.Paso 1: Obtén tu API Key Primero, obtén tu API key desde el dashboard de gu1:
Inicia sesión en el Dashboard
Navega a API Keys
Haz clic en Configuración → API Keys en la barra lateral
Crea una Nueva Key
Haz clic en Crear API Key , dale un nombre (ej. “Integración KYB”) y copia la key
¡Mantén tu API key segura! Nunca la subas a control de versiones ni la compartas públicamente.
Paso 2: Define tu Esquema de Empresas Dile a gu1 qué campos de datos enviarás para las empresas:
curl -X POST http://api.gu1.ai/custom-schemas \ -H "Authorization: Bearer TU_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Datos KYB Corporativos", "version": "1.0.0", "description": "Información de empresas para análisis KYB", "type": "database", "category": "financial", "schemaData": { "fields": [ { "name": "company_name", "type": "string", "required": true, "description": "Nombre legal de la empresa" }, { "name": "tax_id", "type": "string", "required": true, "description": "Número de identificación fiscal" }, { "name": "country", "type": "string", "required": true, "description": "País de incorporación" }, { "name": "industry", "type": "string", "required": false, "description": "Sector industrial" }, { "name": "annual_revenue", "type": "number", "required": false, "description": "Ingresos anuales en USD" } ] } }'
{ "success" : true , "schema" : { "id" : "550e8400-e29b-41d4-a716-446655440000" , "name" : "Datos KYB Corporativos" , "version" : "1.0.0" , "organizationId" : "tu-org-id" , "createdAt" : "2025-10-03T12:00:00Z" } } Paso 3: Mapea Campos al Modelo de gu1 Crea una configuración de mapeo para indicarle a gu1 cómo tus campos se mapean a su modelo unificado de entidades:
curl -X POST http://api.gu1.ai/custom-schemas/mappings \ -H "Authorization: Bearer TU_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Mapeo de Campos KYB", "sourceSchemaId": "550e8400-e29b-41d4-a716-446655440000", "targetSchemaType": "gueno_entity", "mappingData": { "mappings": [ { "id": "1", "sourceField": "company_name", "targetField": "name", "transformation": { "type": "direct" }, "required": true, "dataType": "string" }, { "id": "2", "sourceField": "tax_id", "targetField": "external_id", "transformation": { "type": "direct" }, "required": true, "dataType": "string" }, { "id": "3", "sourceField": "country", "targetField": "country", "transformation": { "type": "direct" }, "required": true, "dataType": "string" } ] } }' Paso 4: Crea una Entidad de Empresa Ahora puedes crear una entidad de empresa usando el esquema mapeado:
curl -X POST http://api.gu1.ai/entities \ -H "Authorization: Bearer TU_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "type": "company", "name": "Acme Corporation", "externalId": "TAX123456789", "country": "US", "entityData": { "industry": "Tecnología", "annual_revenue": 5000000, "incorporation_date": "2010-01-15", "employees": 50 } }'
{ "success" : true , "entity" : { "id" : "a7c4c07f-a1f5-49d6-8c17-1577d0787a2e" , "type" : "company" , "name" : "Acme Corporation" , "externalId" : "TAX123456789" , "country" : "US" , "riskScore" : 0 , "status" : "active" , "createdAt" : "2025-10-03T12:05:00Z" } } Paso 5: Ver Análisis de IA gu1 genera automáticamente un análisis de riesgo potenciado por IA para la entidad. Consúltalo:
curl -X POST http://api.gu1.ai/ai-analysis/entity/a7c4c07f-a1f5-49d6-8c17-1577d0787a2e \ -H "Authorization: Bearer TU_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "language": "es" }'
{ "success" : true , "analysis" : { "executive_summary" : "Acme Corporation es una empresa tecnológica con sede en EE.UU. con un perfil de riesgo moderado. La empresa muestra operaciones estables con ingresos consistentes..." , "behavioral_analysis" : "La entidad demuestra patrones de negocio normales sin señales de alerta en el historial de transacciones..." , "risk_factors" : [ "Información pública limitada disponible" , "Opera en el sector tecnológico de alto riesgo" ], "recommendations" : [ "Solicitar documentación adicional de los beneficiarios finales" , "Monitorear cambios en la estructura de la empresa" ], "confidence_score" : 0.85 , "generated_at" : "2025-10-03T12:05:30Z" }, "cached" : false } Paso 6: Aplicar Reglas (Dashboard) La configuración de reglas se realiza a través del dashboard de gu1 por seguridad y facilidad de uso.
Ve a tu Dashboard de gu1
Navega a Análisis de Riesgo → Entidades
Encuentra “Acme Corporation” y haz clic para ver detalles
Ve a la pestaña Reglas y haz clic en Aplicar Reglas
Selecciona reglas KYB preconstruidas o crea las tuyas personalizadas
Las reglas generarán automáticamente alertas e investigaciones basadas en umbrales de riesgo.
Paso 7: Monitorear con Webhooks Configura webhooks para recibir notificaciones en tiempo real cuando se creen alertas o investigaciones:
curl -X POST http://api.gu1.ai/webhooks \ -H "Authorization: Bearer TU_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://tu-app.com/webhooks/gueno", "events": [ "investigation.created", "investigation.updated", "alert.created", "entity.risk_score_changed" ], "active": true }' Próximos Pasos ¿Necesitas Ayuda? 
