Skip to main content

​
Resumen

gu1 proporciona ambientes duales para cada organización, permitiéndote probar configuraciones y flujos de trabajo de forma segura antes de desplegarlos a producción:
  • Producción: Tu ambiente en vivo con datos reales e integraciones
  • Sandbox: Un ambiente de prueba seguro con proveedores simulados y datos de prueba
Cuando te registras, ambos ambientes se crean automáticamente con los mismos miembros del equipo y permisos.

​
Entendiendo las Organizaciones

En gu1, una Organización representa la cuenta de tu empresa. Cada organización tiene:
  • Organization ID Único: Un UUID que identifica tu organización (ej: 8e2f89ab-c216-4eb4-90eb-ca5d44499aaa)
  • Dos Ambientes Pareados: Producción y Sandbox, vinculados pero con datos separados
  • Miembros del Equipo: Usuarios con roles específicos (Owner, Admin, Member) sincronizados entre ambos ambientes
  • Datos Aislados: Todas las entidades, reglas, investigaciones y configuraciones están dentro del alcance de la organización
Encontrar tus Organization IDs: Navega a app.gu1.ai/api-keys para ver ambos IDs de Producción y Sandbox con botones de copiado convenientes.

​
Por Qué Importan los Organization IDs

Al hacer requests API a api.gu1.ai, debes incluir el header X-Organization-ID para indicarle a gu1 qué organización y ambiente estás apuntando: 
# Request a Producción (usando Organization ID de Producción)
curl -X GET https://api.gu1.ai/entities \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "X-Organization-ID: 8e2f89ab-c216-4eb4-90eb-ca5d44499aaa"

# Request a Sandbox (usando Organization ID de Sandbox)
curl -X GET https://api.gu1.ai/entities \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "X-Organization-ID: 86122d3c-6dfc-4afa-9c46-aaf841262c7e"
Nunca hardcodees Organization IDs en repositorios públicos. Guárdalos como variables de entorno en tu aplicación.

​
Diferencias Clave

Ambiente Producción

  • Integraciones de proveedores reales
  • Costos reales por llamadas API
  • Datos y transacciones en vivo
  • Badge azul “Live” en la interfaz
  • Límites de rate completos según el plan

Ambiente Sandbox

  • Respuestas de proveedores simuladas
  • Cero costos (datos simulados)
  • Solo datos de prueba
  • Badge naranja “Test” en la interfaz
  • Límites de rate reducidos (100 req/h)
  • 🧪 Banner global indicador

​
Cómo Funcionan los Ambientes

Importante: Producción y Sandbox están completamente aislados entre sí:
  • Datos Separados: Entidades, reglas, investigaciones y configuraciones son independientes
  • API Keys Separadas: Cada ambiente tiene sus propias API keys
  • Mismo Equipo: Los miembros del equipo y permisos se sincronizan automáticamente
  • Sin Cruce: Las acciones en Sandbox nunca afectan los datos de Producción
Piénsalos como dos universos paralelos: cualquier cosa que hagas en Sandbox permanece en Sandbox, y Producción queda intacto.

​
Cambiar de Ambiente en el Dashboard

Controlas qué ambiente estás viendo a través del switcher de ambientes en app.gu1.ai:
1

Ingresa a app.gu1.ai

Accede a tu dashboard en app.gu1.ai
2

Ubica el Switcher

Encuentra el toggle de ambiente en la esquina superior derecha del header
3

Haz Click para Cambiar

Haz click para alternar entre “Producción” y “Sandbox”
4

Actualización Instantánea

El dashboard se actualiza instantáneamente para mostrar datos del ambiente seleccionado
Indicador de Sandbox: Cuando estás en modo Sandbox, aparece un banner naranja global (🧪 Sandbox Mode) en la parte superior de cada página para que siempre sepas dónde estás.

​
Requests API y Ambientes

Cuando haces requests a la API en api.gu1.ai, el ambiente se determina por el Organization ID que envías: 
# Este request va a PRODUCCIÓN (usando Org ID de Producción)
curl -X GET https://api.gu1.ai/entities \
  -H "Authorization: Bearer gk_prod_..." \
  -H "X-Organization-ID: 8e2f89ab-c216-4eb4-90eb-ca5d44499aaa"

# Este request va a SANDBOX (usando Org ID de Sandbox)
curl -X GET https://api.gu1.ai/entities \
  -H "Authorization: Bearer gk_devel_..." \
  -H "X-Organization-ID: 86122d3c-6dfc-4afa-9c46-aaf841262c7e"
El switcher del dashboard en app.gu1.ai solo afecta lo que ves en la interfaz. Para requests API a api.gu1.ai, usa el header Organization ID correcto.
Encontrar tus Organization IDs: Ve a la página de API Keys en tu dashboard en app.gu1.ai para ver ambos Organization IDs (Producción y Sandbox) con botones de copiar al portapapeles.

​
API Keys por Ambiente

Las API keys son específicas del ambiente y su comportamiento depende de a qué Organización (Producción o Sandbox) pertenecen:

​
Prefijos de Keys

Los prefijos de API keys indican el ambiente de infraestructura donde se ejecuta la plataforma gu1, no si la key pertenece a una organización Producción o Sandbox:
  • gk_development_... - Keys creadas cuando la plataforma gu1 se ejecuta localmente (development)
  • gk_staging_... - Keys creadas cuando la plataforma gu1 se ejecuta en servidores de staging
  • gk_production_... - Keys creadas cuando la plataforma gu1 se ejecuta en servidores de producción (plataforma gu1 en vivo)
Importante: El prefijo NO indica si tu organización es Producción o Sandbox. Tanto tu organización Producción como tu organización Sandbox tendrán el mismo prefijo basado en dónde está desplegada la plataforma gu1.
Ejemplo: Cuando creas una API key en app.gu1.ai (plataforma en vivo), tanto las keys de tu organización Producción COMO las keys de tu organización Sandbox tendrán el prefijo gk_production_.... El Organization ID en el header X-Organization-ID determina a qué datos accedes.

​
Rate Limits

Los rate limits dependen del tipo de Organización, no del prefijo de la key:
  • Organizaciones Sandbox: Fijo en 100 requests/hora (sin importar el plan)
  • Organizaciones Producción: Basado en tu plan:
    • Freemium: 60 req/min
    • Startup: 120 req/min
    • Growth: 600 req/min
    • Enterprise: 1,200+ req/min

​
Comportamiento de Proveedores

  • Organizaciones Sandbox: Siempre usan proveedores simulados (respuestas simuladas, sin costos API reales)
  • Organizaciones Producción: Usan integraciones de proveedores reales
Al crear una API key, los campos de ambiente son solo lectura y se establecen automáticamente según tu ambiente actual. El Organization ID determina si es una key de Sandbox o Producción.

​
Proveedores Simulados en Sandbox

En Sandbox, todas las integraciones de proveedores retornan respuestas simuladas en lugar de hacer llamadas API reales:
  • Retorna perfiles de riesgo variados: limpio, bajo, medio, alto, crítico
  • Simula tiempos de respuesta realistas (100-2000ms)
  • Incluye datos de personas/entidades simuladas con alias
  • No se incurren costos reales
  • Los webhooks son simulados, no se envían a URLs reales
  • Todos los intentos se registran con éxito/fallo simulado
  • Ver logs en la sección Sandbox
  • Acciones como “Enviar email” o “Crear tarea” son simuladas
  • Todas las simulaciones se registran para revisión
  • Permite probar flujos complejos sin efectos secundarios
Las respuestas simuladas están diseñadas para imitar el comportamiento de producción de cerca, así tu testing es lo más realista posible.

​
Promoción de Configuraciones

Una vez que hayas probado y validado tu configuración en Sandbox, puedes promoverla a Producción:
1

Configurar en Sandbox

Crea y prueba tus reglas, field mappings, esquemas y data lists en Sandbox
2

Validar

Usa el endpoint de validación de promoción para verificar conflictos
3

Promover

Promueve configuraciones individuales o en bloque
4

Rollback si es Necesario

Ver historial de promociones y hacer rollback si es necesario
Aprende más sobre promoción de configuraciones en la Referencia API de Promoción.

​
Mejores Prácticas

Antes de crear o modificar reglas, pruébalas exhaustivamente en Sandbox para evitar falsos positivos o problemas de flujo en Producción.
Incorpora nuevos miembros del equipo en Sandbox donde pueden experimentar sin afectar datos en vivo.
Usa diferentes API keys para Sandbox y Producción en tu código para evitar requests accidentales entre ambientes.
El banner naranja de Sandbox es tu recordatorio de que estás en modo de prueba. Siempre verifica antes de hacer cambios importantes.
Después de promover configuraciones, verifica que funcionen como se espera en Producción y revisa el historial de promociones para un registro de auditoría.

​
Limitaciones de Sandbox

Los ambientes Sandbox tienen las siguientes limitaciones:
  • Rate Limits: 100 requests/hora (vs. basado en plan en Producción)
  • Retención de Datos: Los datos de Sandbox pueden limpiarse periódicamente
  • Expiración: Dependiendo de tu plan, Sandbox puede tener fecha de expiración
  • Solo Datos Simulados: No puede acceder a integraciones de proveedores reales por defecto

​
Preguntas Frecuentes

Los rate limits de Sandbox están fijos en 100 req/h para fomentar testing en volúmenes razonables. Si necesitas límites más altos para load testing, contacta a soporte.
¡Sí! Cuando agregas o quitas miembros del equipo en cualquier ambiente, los cambios se sincronizan automáticamente al ambiente pareado.
Por defecto, no. Sandbox usa proveedores simulados para evitar costos. Contacta a soporte si tienes una necesidad específica de probar integraciones reales en Sandbox.
Dependiendo de tu plan, Sandbox puede tener fecha de expiración. Recibirás advertencias antes de la expiración, y puedes extenderlo o hacerlo permanente actualizando tu plan.
Sandbox y Producción son ambientes pareados. Si quieres remover tu Sandbox, contacta a soporte.

​
Recursos Relacionados

Autenticación API

Aprende cómo autenticarte con API keys

Promoción de Configuraciones

Promueve configs de Sandbox a Producción

API de Entidades

Crea y gestiona entidades en tu ambiente

Motor de Reglas

Configura reglas de riesgo por ambiente