Inicio Rápido: Análisis de Riesgo KYB en 5 Minutos

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

Ve a app.gu1.ai e inicia sesión en tu cuenta

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"
        }
      ]
    }
  }'

Respuesta

{
  "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
    }
  }'

Respuesta

{
  "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"
  }'

Respuesta

{
  "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

Guía Completa de KYB

Aprende el flujo completo de KYB con funciones avanzadas

Esquemas personalizados

Mapea campos entrantes al modelo unificado de gu1 para entidades y reglas

Referencia de API

Explora todos los endpoints disponibles de la API

Webhooks

Tipos de eventos, modelo de seguridad y configuración en el dashboard

¿Necesitas Ayuda?

Documentación: Navega nuestra Referencia de API
Soporte: Escríbenos a support@gueno.com
Dashboard: app.gu1.ai

​Resumen

​Paso 1: Obtén tu API Key

​Paso 2: Define tu Esquema de Empresas

​Paso 3: Mapea Campos al Modelo de gu1

​Paso 4: Crea una Entidad de Empresa

​Paso 5: Ver Análisis de IA

​Paso 6: Aplicar Reglas (Dashboard)

​Paso 7: Monitorear con Webhooks

​Próximos Pasos

Guía Completa de KYB

Esquemas personalizados

Referencia de API

Webhooks

​¿Necesitas Ayuda?

Resumen

Paso 1: Obtén tu API Key

Paso 2: Define tu Esquema de Empresas

Paso 3: Mapea Campos al Modelo de gu1

Paso 4: Crea una Entidad de Empresa

Paso 5: Ver Análisis de IA

Paso 6: Aplicar Reglas (Dashboard)

Paso 7: Monitorear con Webhooks

Próximos Pasos

¿Necesitas Ayuda?