> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Inicio Rápido: Análisis de Riesgo KYB en 5 Minutos
> Aprende a analizar el riesgo de empresas usando la API de gu1 en menos de 5 minutos — con ejemplos de código para la API REST de gu1 y configuración del panel.
## 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:
1. Autenticarte con la API
2. Definir un esquema personalizado para tus datos de empresas
3. Crear una entidad de empresa
4. Aplicar reglas de riesgo (desde el dashboard)
5. Monitorear alertas e investigaciones
**Requisitos previos**: Necesitarás una cuenta de gu1 y una API key. Regístrate en [app.gu1.ai](https://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:
Ve a [app.gu1.ai](https://app.gu1.ai) e inicia sesión en tu cuenta
Haz clic en **Configuración** → **API Keys** en la barra lateral
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:
```bash theme={null}
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"
}
]
}
}'
```
```json theme={null}
{
"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:
```bash theme={null}
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:
```bash theme={null}
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
}
}'
```
```json theme={null}
{
"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:
```bash theme={null}
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"
}'
```
```json theme={null}
{
"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.
1. Ve a tu [Dashboard de gu1](https://app.gu1.ai)
2. Navega a **Análisis de Riesgo** → **Entidades**
3. Encuentra "Acme Corporation" y haz clic para ver detalles
4. Ve a la pestaña **Reglas** y haz clic en **Aplicar Reglas**
5. 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:
```bash theme={null}
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
Aprende el flujo completo de KYB con funciones avanzadas
Mapea campos entrantes al modelo unificado de gu1 para entidades y reglas
Explora todos los endpoints disponibles de la API
Tipos de eventos, modelo de seguridad y configuración en el dashboard
## ¿Necesitas Ayuda?
* **Documentación**: Navega nuestra [Referencia de API](/es/api-reference/authentication)
* **Soporte**: Escríbenos a [support@gueno.com](mailto:support@gueno.com)
* **Dashboard**: [app.gu1.ai](https://app.gu1.ai)