Soporte en Múltiples Idiomas Automático

🌎 ¿Por Qué Soporte Multilingüe?

Si tu negocio está en una zona turística, ciudad fronteriza, o vendes en línea a otros países, tus clientes no solo hablan español. Y responder en su idioma puede ser la diferencia entre cerrar la venta o perderla.

Contratar empleados bilingües cuesta 30-50% más. Tu agente habla todos los idiomas por el mismo precio: $0 adicional.

🔍 Cómo Funciona la Detección de Idioma

OpenClaw detecta el idioma del primer mensaje del cliente y responde en ese mismo idioma automáticamente. No necesitas crear bases de conocimiento separadas.

Cliente escribe en inglés → Agente responde en inglés
Cliente escribe en portugués → Agente responde en portugués
Cliente escribe en español → Agente responde en español
Cliente mezcla idiomas → Agente usa el idioma dominante

El modelo de IA (Claude, GPT) ya sabe traducir. Lo que configuramos es cómo y cuándo hacerlo.

⚙️ Paso 1: Activar Modo Multilingüe

Agrega esta configuración a tu config.yaml:

language:
  # Detección automática de idioma
  auto_detect: true

  # Idioma principal (para contenido interno y logs)
  primary: "es"

  # Idiomas soportados
  supported:
    - code: "es"
      name: "Español"
      greeting: "¡Hola! ¿En qué te puedo ayudar?"
    - code: "en"
      name: "English"
      greeting: "Hi! How can I help you?"
    - code: "pt"
      name: "Português"
      greeting: "Olá! Como posso te ajudar?"
    - code: "fr"
      name: "Français"
      greeting: "Bonjour! Comment puis-je vous aider?"

  # Si no puede detectar el idioma, usar este
  fallback: "es"

  # Mantener el idioma durante toda la conversación
  persist_language: true

Reinicia para activar:

📝 Paso 2: Instrucciones Multilingüe en SOUL.md

Agrega esta sección a tu SOUL.md:

## Reglas de Idioma

### Detección
- Detectar el idioma del primer mensaje del cliente
- Responder SIEMPRE en el idioma del cliente
- Si el cliente cambia de idioma, cambiar también
- Si mezcla idiomas (Spanglish), responder en español

### Español
- Tono cercano y profesional
- Usar "tú" (no "usted" a menos que el cliente use "usted")
- Emojis con moderación

### English
- Professional but friendly tone
- Use American English spelling
- Prices in both local currency and USD when relevant

### Português
- Tom profissional e amigável
- Usar português brasileiro (não de Portugal)
- Preços em moeda local e BRL quando relevante

### Notas
- Los nombres de servicios/productos se mantienen en español
  (son nombres propios del negocio)
- Direcciones y nombres de calles NO se traducen
- Montos siempre en moneda local (agregar USD si preguntan)

🧪 Probando la Detección Automática

Veamos cómo se ve en acción. Un turista americano escribe al hotel:

El agente detectó inglés en el primer mensaje y toda la conversación continuó en inglés, con precios en USD (porque el hotel ya los maneja en dólares).

Ahora un brasileño escribe al mismo hotel:

💰 Paso 3: Base de Conocimiento para Conversiones

Agrega esta sección a tu MEMORY.md:

## Conversiones de Moneda (aproximadas, actualizar mensualmente)
- 1 USD = 7.80 GTQ (Quetzales)
- 1 USD = 5.00 BRL (Reales brasileños)
- 1 USD = 17.50 MXN (Pesos mexicanos)
- 1 USD = 4,000 COP (Pesos colombianos)
- 1 USD = 0.92 EUR (Euros)
- Última actualización: Febrero 2026

## Notas para clientes internacionales
- Precios del hotel son en USD
- Tarjetas internacionales aceptadas (sin cargo adicional)
- Factura disponible en español o inglés
- Servicio de transporte del aeropuerto: $35 USD

🔧 Paso 4: Saludos Personalizados por Idioma

Para dar una primera impresión perfecta, configura saludos iniciales por idioma:

language:
  greetings:
    es:
      first_contact: "¡Hola! 👋 Bienvenido a {business_name}. ¿En qué te puedo ayudar?"
      returning: "¡Hola de nuevo! ¿En qué te ayudo hoy?"
    en:
      first_contact: "Hi there! 👋 Welcome to {business_name}. How can I help you?"
      returning: "Welcome back! How can I help you today?"
    pt:
      first_contact: "Olá! 👋 Bem-vindo ao {business_name}. Como posso te ajudar?"
      returning: "Olá de novo! Como posso ajudar hoje?"
    fr:
      first_contact: "Bonjour! 👋 Bienvenue à {business_name}. Comment puis-je vous aider?"
      returning: "Rebonjour! Comment puis-je vous aider?"

🌍 Pares de Idiomas más Comunes en LATAM

Dependiendo de tu ubicación, estos son los idiomas que más vas a necesitar:

⚠️ Casos Especiales y Cómo Manejarlos

Spanglish (mezcla español/inglés)

Muy común en ciudades fronterizas y con latinos en USA:

## Regla de Spanglish (agregar a SOUL.md)
Si el cliente mezcla español e inglés en un mismo mensaje:
- Responder en español
- Si insiste en inglés, cambiar a inglés
- NUNCA mezclar idiomas en mi respuesta — elegir uno

Cliente cambia de idioma a mitad de conversación

language:
  # Si el cliente cambia de idioma, seguirlo
  follow_language_switch: true
  # Mínimo 2 mensajes en nuevo idioma para cambiar
  switch_threshold: 1

Idioma no soportado

language:
  unsupported_response: "Lo siento, actualmente ofrecemos soporte en español e inglés. ¿Puedo ayudarte en alguno de estos idiomas? / Sorry, we currently offer support in Spanish and English. Can I help you in either language?"

📋 Paso 5: Escalar Según el Idioma

Si tu equipo tiene miembros que hablan diferentes idiomas, puedes enrutar las escalaciones:

escalation:
  language_routing:
    es:
      notify: "+502 5555-0001"     # Marco (español)
    en:
      notify: "+502 5555-0002"     # Ana (English speaker)
    pt:
      notify: "+502 5555-0003"     # Pedro (fala português)
    default:
      notify: "+502 5555-0001"     # Marco (si no hay match)

🧪 Verificar que Todo Funciona

Corre el test de idiomas:

📊 Monitorear Idiomas de tus Clientes

Revisa qué idiomas hablan tus clientes para optimizar:

✅ Resumen de Configuración

🎓 Lo Que Aprendiste en Este Add-On

En estas 4 lecciones configuraste un sistema de soporte al cliente completo:

1. Entendiste el costo de no responder a tiempo (y cómo tu agente lo elimina)
2. Creaste una base de conocimiento completa con toda la info de tu negocio
3. Configuraste escalación inteligente para que el agente sepa cuándo pasar a un humano
4. Activaste soporte multilingüe para atender clientes en cualquier idioma

Tu agente ahora trabaja 24/7, responde en segundos, habla múltiples idiomas y sabe cuándo necesita ayuda humana. Todo por menos de $20 al mes en costos de API.