Saltar a contenido

🤖 Explicar con IA

Construyendo con IA

Esta guía te guiará a través de la creación de productos en la plataforma 4Geeks y su integración con nuestras capacidades de IA — AI Agents y AI Studio — para construir flujos de trabajo inteligentes y automatizados.

Creando Productos

Los productos en 4Geeks representan los bienes, servicios o planes de suscripción que ofreces. Puedes crear y gestionar productos programáticamente a través de la API REST.

Autenticación de la API

Todas las solicitudes de API requieren tu Live API Key que se pasa a través del encabezado X-Api-Key:

X-Api-Key: sk_live_your_api_key_here

Obtén tus claves de API desde el panel de Configuración de la plataforma bajo la pestaña API & Webhooks. Consulta Obtener Claves de API para más detalles.

Crear un Producto

Envía una solicitud POST para crear un producto:

curl -X POST 'https://api.4geeks.io/v1/products' \
  -H 'X-Api-Key: sk_live_your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Premium Plan",
    "description": "Full-featured premium subscription with priority support",
    "active": true
  }'

import requests

response = requests.post(
    'https://api.4geeks.io/v1/products',
    headers={
        'X-Api-Key': 'sk_live_your_api_key_here',
        'Content-Type': 'application/json'
    },
    json={
        'name': 'Premium Plan',
        'description': 'Full-featured premium subscription with priority support',
        'active': True
    }
)
print(response.json())

const response = await fetch('https://api.4geeks.io/v1/products', {
    method: 'POST',
    headers: {
        'X-Api-Key': 'sk_live_your_api_key_here',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        name: 'Premium Plan',
        description: 'Full-featured premium subscription with priority support',
        active: true
    })
});
const data = await response.json();
console.log(data);

La respuesta incluye el producto creado con su ID:

{
    "id": "prod_abc123",
    "name": "Premium Plan",
    "description": "Full-featured premium subscription with priority support",
    "active": true,
    "created_at": "2026-05-02T10:30:00Z"
}

Listar Productos

Obtén todos tus productos con paginación:

curl -X GET 'https://api.4geeks.io/v1/products?limit=10&offset=0' \
  -H 'X-Api-Key: sk_live_your_api_key_here'

import requests

response = requests.get(
    'https://api.4geeks.io/v1/products',
    headers={'X-Api-Key': 'sk_live_your_api_key_here'},
    params={'limit': 10, 'offset': 0}
)
print(response.json())

Respuesta:

{
    "items": [
        {
            "id": "prod_abc123",
            "name": "Premium Plan",
            "description": "Full-featured premium subscription with priority support",
            "active": true
        }
    ],
    "total_items": 1,
    "limit": 10,
    "offset": 0
}

Crear un Plan para un Producto

Para productos basados en suscripciones, crea un plan vinculado a tu producto:

curl -X POST 'https://api.4geeks.io/v1/plans' \
  -H 'X-Api-Key: sk_live_your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "product_id": "prod_abc123",
    "amount": 4999,
    "currency": "USD",
    "interval": "month"
  }'

El amount está en centavos (4999 = $49.99). Intervalos soportados: month, year, week.

Integrando Productos con AI Agents

Una vez que tus productos estén creados, puedes conectarlos con los AI Agents de 4Geeks para automatizar los flujos de trabajo de ventas, soporte y cobros.

Cómo Funciona

Los AI Agents de 4Geeks utilizan tu catálogo de productos y documentación como base de conocimiento. Cuando un cliente interactúa con un agente, puede:

  • Recomendar productos basándose en las necesidades del cliente
  • Responder preguntas sobre precios, características y disponibilidad
  • Procesar pedidos y crear sesiones de checkout
  • Manejar tickets de soporte relacionados con productos específicos

Paso a Paso: Conectar Productos con un AI Sales Agent

1. Desplegar un AI Sales Agent

Navega a la Consola de 4Geeks y haz clic en Deploy Agent. Selecciona AI Sales Agent y asígnale un nombre.

2. Configurar la Fuente de Datos de Entrenamiento

En la configuración del agente, ingresa la URL de tu documentación de productos como la Training Data Source. Esto puede ser:

  • Tu página de catálogo de productos
  • Una página de precios
  • Documentación de la API
  • Un archivo público llms.txt (ver más abajo)

El agente rastrea esta URL y utiliza el contenido para responder con precisión las preguntas de los clientes.

3. Definir el Objetivo del Agente

Establece un objetivo claro para el agente:

Sell our software products. When a customer asks about features, recommend the
appropriate plan based on their needs. Always mention pricing in USD. Do not
offer discounts higher than 10% without escalation.

4. Conectar un Canal

Elige cómo los clientes interactuarán con el agente:

  • WhatsApp: Conecta tu cuenta de Meta Business para mensajería
  • Web Chat: Incrusta el agente en tu sitio web
  • Voice: Habilita interacciones telefónicas

Consulta Cómo Crear un WhatsApp AI Agent para una guía detallada.

5. Probar y Poner en Producción

El agente se ejecuta primero en un entorno sandbox. Prueba interacciones como:

Customer: "What plans do you offer?"
Agent: "We have three plans: Basic ($19/mo), Pro ($49/mo), and Premium ($99/mo). 
        The Pro plan includes priority support and API access. Would you like to 
        know more about any specific plan?"

Customer: "I need API access for my team of 10."
Agent: "For a team of 10 with API access, I recommend the Pro plan at $49/mo per 
        seat. Would you like me to send you a checkout link to get started?"

Una vez que estés satisfecho, haz clic en Go Live para desplegar el agente a producción.

Flujo de Trabajo de AI Agent + Producto

Así es como funciona la integración completa:

sequenceDiagram
    participant C as Customer
    participant A as AI Agent
    participant K as Knowledge Base
    participant P as 4Geeks API
    participant O as Checkout

    C->>A: "What products do you have?"
    A->>K: Query product catalog
    K-->>A: Return product data
    A-->>C: List products with pricing
    C->>A: "I want the Premium Plan"
    A->>P: Create checkout session
    P-->>A: Return checkout_url
    A-->>C: Send checkout link
    C->>O: Complete payment

AI Support Agent para Consultas de Productos

Despliega un AI Customer Support Agent para manejar preguntas de productos post-venta:

  1. Configura la Training Data Source con tu documentación de productos y FAQ
  2. Define el objetivo:
Answer customer questions about our products. Help with troubleshooting, 
billing inquiries, and feature explanations. Escalate to a human agent 
if the issue cannot be resolved within 3 interactions.
  1. Conecta a tu canal preferido (WhatsApp, web chat o voice)

El agente de soporte puede hacer referencia a productos específicos por ID y obtener datos en tiempo real de tu catálogo.

Integrando con AI Studio

Para funciones personalizadas relacionadas con productos que van más allá de los agentes pre construidos, utiliza 4Geeks AI Studio.

¿Qué es AI Studio?

AI Studio proporciona un Arquitecto Senior experto humano augmentado por la 4Geeks AI Factory — una infraestructura que orquesta LLMs de primer nivel (Claude, Gemini, GPT) para escribir, probar y refactorizar código hasta 5 veces más rápido.

Casos de Uso para Integración de Productos

  • Flujos de checkout personalizados: Construye experiencias de pago a medida para tus productos
  • Motor de recomendación de productos: Crea un sistema de recomendación impulsado por IA
  • Descripciones de productos automatizadas: Genera y actualiza contenido de productos a escala
  • Integraciones personalizadas: Conecta tu catálogo de productos con herramientas de terceros (CRM, ERP, análisis)

Primeros Pasos

  1. Ve a la Consola de 4Geeks
  2. Describe los requisitos de integración de tu producto
  3. Se asigna un Arquitecto Senior a tu proyecto
  4. La AI Factory acelera el desarrollo con orquestación multi-modelo
  5. Revisa los pull requests y despliega a producción

Consulta la visión general de AI Studio y el Private AI Gateway para más detalles.

Usando llms.txt para Integración con IA

4Geeks publica un archivo público llms.txt en:

https://docs.4geeks.io/llms.txt

¿Qué es llms.txt?

llms.txt es un archivo estandarizado que proporciona a las herramientas de IA y LLMs una visión concisa y legible por máquina de la API de 4Geeks. Incluye:

  • URL base y detalles de autenticación
  • Todos los endpoints disponibles con métodos, rutas y descripciones
  • Formatos de solicitud/respuesta
  • Ejemplos de código en múltiples lenguajes
  • Códigos de error y patrones

Cómo Usarlo

Puedes apuntar tus AI Agents, aplicaciones personalizadas de LLM o herramientas de desarrollo de IA a este archivo para que comprendan la estructura de la API de 4Geeks sin configuración manual:

  1. Datos de Entrenamiento para AI Agents: Agrega https://docs.4geeks.io/llms.txt como fuente de datos de entrenamiento para tus AI Agents
  2. Contexto de LLM: Incluye el contenido del archivo en tus prompts del sistema cuando construyas aplicaciones de IA personalizadas
  3. Desarrollo Asistido por IA: Los asistentes de IA en IDEs (Cursor, Copilot, etc.) pueden hacer referencia a este archivo para generar llamadas de API correctas

Ejemplo: Usando llms.txt en un Prompt del Sistema

You are an AI assistant that helps users integrate with the 4Geeks platform.
Use the following API reference to generate correct API calls:

[Content from https://docs.4geeks.io/llms.txt]

Esto asegura que la IA genere código preciso con los endpoints, encabezados y formatos de solicitud correctos.

Próximos Pasos

Aún con dudas? Pregunta en Discord o explore tutoriales