ChatCieloDocs

ChatGPT (OpenAI)

Configura ChatGPT en ChatCielo: API Key, modelos GPT-4o, o1, prompt del sistema, temperatura, Assistant ID y voz TTS

ChatGPT (OpenAI) en ChatCielo

OpenAI ChatGPT es el modelo más versátil para atención por WhatsApp, Instagram y WebChat: combina comprensión de lenguaje natural, razonamiento, manejo de objeciones y voz TTS en un solo proveedor. En ChatCielo lo configuras por canal en minutos.

Usa ChatGPT cuando necesites ventas consultivas, soporte complejo o respuestas en audio. Para alto volumen con presupuesto ajustado, combina gpt-4o-mini para triaje y gpt-4o para cierre.

1. Cómo obtener tu API Key en OpenAI

Crea tu cuenta en OpenAI

Ve a platform.openai.com y crea una cuenta o inicia sesión. Completa la verificación por correo y, si es tu primera vez, configura el método de pago en Settings > Billing. OpenAI requiere saldo prepago o tarjeta para generar claves.

Genera la API Key

  1. En el panel lateral ve a Dashboard > API keys.
  2. Haz clic en + Create new secret key.
  3. Asigna un nombre descriptivo, por ejemplo chatcielo-produccion.
  4. Elige Permissions: All o limita a Model capabilities si tu política de seguridad lo exige.
  5. Haz clic en Create secret key y copia la clave completa que empieza por sk-proj-....

La clave se muestra una sola vez. Cópiala de inmediato y guárdala en un gestor de contraseñas. Si la pierdes, deberás crear una nueva y actualizarla en ChatCielo.

Verifica créditos y límites

En Settings > Billing > Usage confirma que tienes crédito disponible. Sin saldo, las llamadas a la API fallan con error insufficient_quota. Configura un límite mensual en Billing > Usage limits para evitar sorpresas.

2. Configuración en ChatCielo

Ve a Canales > Tu canal (WhatsApp / Instagram / WebChat) > Integración IA > OpenAI / ChatGPT.

CampoQué ponerRecomendación
API KeyPega la clave sk-proj-...No compartas esta clave en chats. Usa una clave distinta por tenant si gestionas varias marcas.
Modelogpt-4o, gpt-4o-mini, o1, o1-minigpt-4o para calidad máxima; gpt-4o-mini para triaje económico; o1 para razonamiento profundo.
Prompt del SistemaInstrucciones que definen personalidad, tono y reglasVer plantillas abajo. Es el campo más importante.
Temperatura0 a 2 (usa 0.30.7)0.3 = respuestas precisas y consistentes; 0.7 = más creativas; 1.0+ = muy variables (no recomendado para atención).
Max Tokens150 a 4096300500 para WhatsApp (mensajes cortos); 1000+ para análisis de documentos. Cada token es ~0.75 palabras en español.
Palabra clave de derivaciónEj. hablar con asesor, asesor humanoCuando el cliente escribe esa frase, la IA cede la conversación a un agente humano.

Consejo: activa Histórico de conversación para que la IA recuerde los últimos 10–15 mensajes. Sin histórico, cada mensaje se trata como nuevo y la experiencia se vuelve repetitiva.

Modelos recomendados

El equilibrio ideal entre calidad, velocidad y costo para la mayoría de negocios.

  • Ventana de 128k tokens, multimodal (texto + imagen).
  • Excelente en ventas, manejo de objeciones, resúmenes y soporte.
  • Latencia 1–2 segundos, costo medio-alto pero justificable en cierres.

Úsalo como modelo principal en canales de ventas y soporte premium.

3. Prompt del Sistema — plantillas listas para usar

El Prompt del Sistema define quién es la IA, cómo debe hablar y qué no debe hacer. Es el 80% del resultado.

Plantilla 1: Atención al cliente general (recomendada para empezar)

Eres el asistente virtual de {{empresa}}.

Tono: cordial, profesional y cercano. Español neutro, frases cortas.
Objetivo: resolver dudas, orientar al cliente y derivar a un asesor humano cuando no tengas la respuesta.

Reglas:
- Responde en máximo 4 líneas por mensaje. Sé conciso y útil.
- Usa el nombre del cliente cuando lo conozcas: `{{name}}`.
- Nunca inventes precios, stock o políticas. Si no sabes, di: "Déjame derivarte con un asesor para confirmarte ese dato con precisión".
- Si el cliente escribe "hablar con asesor", "asesor humano" o "quiero hablar con alguien", responde exactamente: "Perfecto, te derivo con un asesor humano en este momento." y cede la conversación.
- No menciones que eres una IA. Eres parte del equipo de {{empresa}}.
- Horario de atención humana: lunes a viernes 9:00–18:00 (GMT-3). Fuera de horario, ofrece tomar el pedido y avisa que un asesor responderá al siguiente día hábil.

Información de la empresa:
- Empresa: {{empresa}}
- Productos/servicios: [lista breve]
- Políticas clave: [envíos, devoluciones, garantía]
- Contacto humano: [teléfono / email si aplica]

Plantilla 2: Ventas consultiva con manejo de objeciones

Eres asesor comercial de {{empresa}}, experto en [producto/servicio].

Objetivo: entender la necesidad del cliente, presentar beneficios (no solo características), manejar objeciones y cerrar o agendar.

Guion:
1. Saluda usando `{{name}}` y pregunta por la necesidad principal.
2. Haz 1 pregunta abierta para calificar (presupuesto, plazo, uso).
3. Presenta 1–2 beneficios clave + prueba social breve.
4. Si hay objeción de precio, ofrece plan alternativo o financiación sin presionar.
5. Cierra con CTA clara: "¿Te preparo la cotización?" o "¿Agendamos una llamada de 10 minutos?".

Reglas:
- Máximo 5 líneas por mensaje. Un CTA por mensaje.
- Nunca prometas descuentos que no estén en [política de precios].
- Si el cliente dice "hablar con asesor", deriva inmediatamente.

Plantilla 3: Soporte técnico paso a paso

Eres soporte técnico de {{empresa}}.

Método:
- Diagnostica con preguntas una a una. No des 5 pasos de golpe.
- Confirma cada paso antes de avanzar: "¿Pudiste reiniciar el equipo?".
- Si el problema persiste tras 3 intentos, deriva a técnico humano con resumen del caso.

Tono: paciente, claro, sin jerga innecesaria. Español neutro.
Variables disponibles: `{{name}}`, `{{phoneNumber}}`, `{{protocol}}`, `{{email}}`.

Evita prompts de más de 800 palabras. Los prompts largos diluyen la instrucción principal y aumentan el costo por mensaje. Sé específico en reglas y ejemplos, no en historia de la empresa.

Parámetros: Temperatura y Max Tokens en la práctica

ObjetivoTemperaturaMax TokensEfecto
Respuestas consistentes y seguras (soporte, FAQ)0.20.4300400Predecible, ideal para atención.
Ventas con un toque persuasivo0.50.7400600Más variación, tono más humano.
Creatividad (nombres, copys)0.81.0600+No recomendado para atención directa.

4. Prompt directo vs. OpenAI Assistant ID

ChatCielo soporta dos modos de usar OpenAI. Elige uno por canal.

Cómo funciona: escribes el Prompt del Sistema directamente en ChatCielo. Cada mensaje del cliente se envía a la API de OpenAI junto con el histórico y tu prompt.

Ventajas:

  • Configuración en 2 minutos, sin salir de ChatCielo.
  • Control total del prompt y parámetros por canal.
  • Fácil de duplicar entre canales y hacer A/B testing de prompts.

Cuándo usarlo: 90% de los casos — ventas, soporte, triaje, FAQ con base de conocimiento corta (hasta ~10 páginas de texto en el prompt).

Ejemplo de uso: pegas tu prompt en "Prompt del Sistema" y seleccionas gpt-4o-mini.
No necesitas crear nada en platform.openai.com además de la API Key.

5. Respuestas de voz (TTS) — notas de voz en WhatsApp

ChatCielo puede enviar las respuestas de ChatGPT como nota de voz usando los modelos de Text-to-Speech de OpenAI. El cliente escucha un audio natural en lugar de leer texto.

Voces disponibles

VozTimbreIdeal para
alloyNeutra, equilibradaUso general, atención profesional
echoCálida, con resonanciaNarración, tono envolvente
fableSuave, narrativaAudiolibros, explicaciones empáticas
onyxGrave, firmeInstrucciones, tono de autoridad
novaBrillante, optimistaMarcas jóvenes, tono energético
shimmerRefinada, serenaAtención premium, tono tranquilo

Cómo configurarlo en ChatCielo

Activa TTS en el canal

En Canales > Tu canal > Integración IA > Voz / TTS, activa Responder con audio y selecciona la Voz. Recomendado para empezar: alloy (general) o nova (tono más cercano).

Define cuándo usar voz

Elige el disparador:

  • Siempre en audio — cada respuesta de la IA se envía como nota de voz.
  • Solo si el cliente envía audio — si el cliente manda nota de voz, la IA responde en audio; si escribe texto, responde en texto.
  • Palabra clave — ej. el cliente escribe audio y la IA responde en voz.

Recomendado: "Solo si el cliente envía audio" para una experiencia natural.

Prueba y ajusta

Envía un mensaje de prueba al canal y verifica que llegue como nota de voz. Si el audio suena robótico, baja la longitud del prompt y evita párrafos de más de 2 líneas — los textos cortos generan audios más naturales.

Para la guía completa de TTS con ejemplos de prompts optimizados para audio, consulta Integraciones Modelos de Voz ChatGPT.

6. Palabra clave de desconexión y derivación humana

La palabra clave de derivación es tu red de seguridad: cuando la IA no debe seguir respondiendo, cede la conversación a un humano.

Configuración recomendada

En Canales > Tu canal > Integración IA > Derivación humana, configura:

  • Palabras clave: hablar con asesor, asesor humano, hablar con alguien, quiero hablar con persona, humano
  • Acción al detectar: Pausar IA y asignar a agente / departamento
  • Mensaje de derivación (opcional):
Perfecto `{{name}}`, te derivo con un asesor humano en este momento. 
Tu protocolo es `{{protocol}}` — un agente te responderá en breve. 
Horario de atención: lunes a viernes 9:00–18:00.

Buenas prácticas

  • Siempre ofrece salida humana en el prompt: "Si prefieres hablar con un asesor, escribe hablar con asesor en cualquier momento".
  • No uses una sola palabra como asesor — genera falsos positivos. Usa frases de 2–3 palabras.
  • Prueba la derivación enviando la frase exacta desde un número de prueba y verifica que la conversación se asigne correctamente en Atenciones > Panel de Chats.
  • Fuera de horario: configura un mensaje distinto que informe el horario y ofrezca dejar datos: "Nuestro equipo atiende de 9 a 18h. Déjame tu consulta y te contactamos al siguiente día hábil. ¿Cuál es tu {{email}}?".

7. Casos de uso por tipo de negocio

  • Pre-venta: responde dudas de talles, envíos, stock usando {{protocol}} y catálogo en el prompt.
  • Post-venta: seguimiento de pedido con {{protocol}} + derivación si hay reclamo.
  • Recuperación: si el cliente abandona, la IA ofrece cupón o financiación con CTA clara.

Prompt clave: incluye política de envíos y devoluciones en 5 líneas, no más.

8. Solución de problemas

ProblemaCausa probableSolución
Incorrect API keyClave mal copiada o con espaciosPega nuevamente sin espacios al inicio/final. Regenera la clave si persiste.
insufficient_quotaSin crédito en OpenAIRecarga saldo en Billing > Overview.
Respuestas muy largasMax Tokens alto + prompt sin límiteBaja a 350 y agrega en el prompt: "Responde en máximo 4 líneas".
La IA inventa datosPrompt sin regla de "no inventar"Agrega: "Nunca inventes precios o stock. Si no sabes, deriva a humano".
No deriva a humanoPalabra clave no configurada o muy cortaUsa frases como hablar con asesor y verifica en Derivación humana.
Audio TTS no llegaTTS desactivado o voz no seleccionadaActiva Responder con audio y elige voz alloy o nova. Verifica que el canal soporte audio.

¿Siguiente paso? Si tu base de conocimiento supera las 10 páginas, evalúa Dify para RAG o el modo Assistant ID descrito arriba. Para automatizaciones con CRM, combina ChatGPT con N8N.