Centro de ayuda: guías y tutoriales

💡 Multi-proveedor: SGG soporta 4 proveedores de IA diferentes. Puedes elegir el que mejor se adapte a tus necesidades de costo, velocidad y calidad de respuestas.

Proveedores de IA Disponibles

🤖 OpenAI (GPT-4o)

Modelos: GPT-4o, GPT-4o-mini, GPT-3.5 Turbo
Ventajas: Alta calidad, muy versátil
Costo: Medio-Alto
Ideal para: Respuestas complejas y naturales

🧠 Claude (Anthropic)

Modelos: Claude 3.5 Sonnet, Haiku, Opus
Ventajas: Respuestas muy naturales y seguras
Costo: Medio-Alto
Ideal para: Conversaciones extensas

💎 Gemini (Google)

Modelos: Gemini 1.5 Flash, Gemini 1.5 Pro
Ventajas: Rápido, buena integración Google
Costo: Bajo-Medio
Ideal para: Alto volumen de mensajes

🚀 DeepSeek

Modelos: DeepSeek Chat
Ventajas: Muy económico, API compatible
Costo: Muy Bajo
Ideal para: Presupuesto limitado

Habilitar el Chatbot

Ve a Configuración → Negocio
Busca la sección "Chatbot IA"
Activa el switch "Habilitar Chatbot"
Selecciona el proveedor de IA preferido
Guarda los cambios

⚠️ Importante: El chatbot requiere que tengas productos configurados en tu catálogo. El bot utiliza la información de tus productos, precios y categorías para responder a los clientes.

Cómo Interactúan los Clientes

Widget de Chat en tu Tienda

Los clientes verán un botón de chat flotante en tu tienda online. Al hacer clic, se abre una ventana de conversación donde pueden:

Capacidades del Chatbot:

📋 Información del Menú

"¿Qué pizzas tienen?"
"¿Cuánto cuesta la hamburguesa?"
"¿Tienen opciones vegetarianas?"
"¿Cuáles son los ingredientes de...?"

🛒 Pedidos

"Quiero ordenar una pizza grande"
"Agregar una coca cola al pedido"
"¿Cuál es el total?"
"Confirmar mi pedido"

📍 Información del Negocio

"¿Cuál es el horario?"
"¿Hacen delivery a mi zona?"
"¿Dónde están ubicados?"
"¿Aceptan tarjeta?"

📦 Seguimiento

"¿Cómo va mi pedido?"
"Estado del pedido #123"
"¿Cuánto falta para la entrega?"

Entrada de Voz

El chatbot también soporta mensajes de voz. Los clientes pueden:

Presionar el botón de micrófono
Grabar su mensaje de voz
El audio se transcribe automáticamente a texto
El chatbot responde como si fuera un mensaje escrito

🎙️ Transcripción: La transcripción de voz usa el servicio Whisper de OpenAI para convertir audio a texto con alta precisión, incluso con ruido de fondo.

Moderación de Contenido

El chatbot incluye un sistema de moderación que:

Filtra mensajes con contenido inapropiado
Detecta intentos de inyección de prompts
Bloquea mensajes muy largos (límite configurable)
Previene spam y abuso del sistema

Rate Limiting

Para proteger el sistema y controlar costos, hay límites de uso:

Tipo	Límite	Ventana
Mensajes de texto	20 mensajes	Por minuto, por cliente
Transcripciones de voz	10 transcripciones	Por minuto, por cliente

Caché Inteligente

Para reducir costos y mejorar velocidad, el chatbot usa un sistema de caché:

Preguntas frecuentes: Se cachean respuestas a preguntas comunes
Por tenant: Cada negocio tiene su propio caché
TTL configurable: Las respuestas expiran después de cierto tiempo
Ahorro significativo: Reduce llamadas a la API de IA

Acciones Automáticas

El chatbot puede ejecutar acciones basadas en la conversación:

🛒

Crear Pedido

Cuando el cliente confirma su pedido, el chatbot puede crearlo automáticamente en el sistema con todos los productos seleccionados durante la conversación.

📋

Consultar Estado

Cuando el cliente pregunta por el estado de su pedido, el chatbot consulta la base de datos y responde con información actualizada en tiempo real.

👤

Transferir a Humano

Si el cliente necesita ayuda que el bot no puede proporcionar, puede transferir la conversación a un empleado humano.

Monitoreo de Conversaciones

Los administradores pueden ver todas las conversaciones:

Ve al panel de SuperAdmin → Chatbot Monitoring
Verás una lista de todas las conversaciones activas
Puedes filtrar por tenant, canal, o estado
Haz clic en una conversación para ver el historial completo
Opcionalmente, un empleado puede "tomar control" de la conversación

Configuración Técnica (Para Desarrolladores)

Variables de Entorno

# OpenAI
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxx
OPENAI_MODEL=gpt-4o-mini

# Claude (Anthropic)
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxx

# DeepSeek
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxx

# Gemini (Google Vertex AI)
GOOGLE_CLOUD_PROJECT=my-project-id
VERTEX_AI_LOCATION=us-central1

Endpoint del Webhook

// Enviar mensaje al chatbot
POST /api/v1/chatbot/webhook/:channel
Headers: {
  "x-tenant-slug": "mi-restaurante"
}
Body: {
  "customerId": "cliente-123",
  "message": "¿Qué pizzas tienen?",
  "customerInfo": {
    "name": "Juan",
    "phone": "+5491155555555"
  }
}

// Respuesta
{
  "success": true,
  "conversationId": "conv-abc123",
  "response": "Tenemos las siguientes pizzas:
    - Muzzarella ($2500)
    - Napolitana ($2800)
    - Especial ($3200)
    ¿Cuál te gustaría ordenar?"
}

¿Qué sigue?

Agregar productos →

El chatbot necesita productos para funcionar correctamente

Bunny CDN →

Optimiza las imágenes que el chatbot muestra

Solución de Problemas

El chatbot no responde

Verifica lo siguiente:

El chatbot está habilitado en la configuración del negocio
Las API keys del proveedor de IA están configuradas correctamente
No has excedido el límite de rate limiting
El mensaje no fue bloqueado por moderación de contenido

Las respuestas son lentas

Posibles soluciones:

Cambia a un modelo más rápido (GPT-4o-mini o Gemini Flash)
Verifica que el caché esté funcionando correctamente
Reduce la longitud máxima de las respuestas
Considera usar DeepSeek para mejor latencia

El chatbot da información incorrecta

Esto puede ocurrir porque:

Los productos no tienen toda la información (descripción, ingredientes)
Los precios no están actualizados
El caché tiene respuestas antiguas (espera a que expire)
Prueba con Claude o GPT-4o para mejor precisión

Error "Too many requests"

Este error indica que se excedió el rate limit. Soluciones:

Espera 1 minuto antes de enviar más mensajes
El límite es de 20 mensajes por minuto por cliente
Si necesitas más capacidad, contacta a soporte

La transcripción de voz no funciona

Verifica:

El navegador tiene permisos de micrófono
La API key de OpenAI está configurada (Whisper es de OpenAI)
El audio no está vacío o es muy corto
No excediste el límite de 10 transcripciones por minuto