Integra Dify.ai con ChatCielo: chatbot de conocimiento empresarial con RAG, PDFs y base de datos — API Key y endpoint

Dify en ChatCielo

Dify.ai es una plataforma de RAG (Retrieval-Augmented Generation) que convierte tus PDFs, documentos, base de datos y FAQs en un chatbot de conocimiento empresarial. A diferencia de un LLM genérico, Dify responde citando tus fuentes reales — sin alucinar. En ChatCielo lo usas cuando tu base de conocimiento es demasiado grande o dinámica para caber en un prompt.

Úsalo cuando tengas manuales, políticas, catálogos o bases de conocimiento de 50+ páginas que cambian con frecuencia. Dify indexa tus documentos y ChatCielo los consulta en cada mensaje del cliente.

1. Qué es Dify y cuándo elegirlo

Escenario	¿Dify es la mejor opción?	Alternativa
Manual técnico de 200 páginas que cambia cada mes	✅ Sí — RAG con PDFs indexados	Prompt directo se queda corto
FAQs de 10 páginas estáticas	No necesario — usa prompt directo en ChatGPT/Claude	Más rápido y barato
Catálogo que se actualiza semanalmente	✅ Sí — reconecta tu fuente y Dify reindexa	Evita editar prompts manualmente
Documentos + necesidad de citas ("según el manual...")	✅ Sí — Dify cita la fuente	LLM genérico no cita
Privacidad estricta on-premise	Dify auto-alojado + Ollama	Ver Ollama

Cómo funciona con ChatCielo

Cliente escribe en WhatsApp
        ↓
ChatCielo envía el mensaje a Dify (API)
        ↓
Dify busca en tu base de conocimiento indexada (vector search)
        ↓
Dify genera respuesta con LLM + contexto de tus documentos
        ↓
Dify devuelve la respuesta a ChatCielo
        ↓
Cliente recibe respuesta en WhatsApp (con cita de fuente si configuras)

2. Cómo obtener tu API Key y endpoint de Dify

Crea tu cuenta en Dify

Ve a cloud.dify.ai para usar Dify Cloud, o usa tu instancia auto-alojada si ya la tienes. Crea una cuenta y verifica tu correo.

Crea tu aplicación de Chatbot

En Dify haz clic en Create App > Chatbot (o Chatflow si necesitas lógica avanzada).
Elige Chatbot: Basic para empezar — es suficiente para RAG con documentos.
Asigna un nombre como ChatCielo - Soporte y haz clic en Create.

Recomendado para empezar. Chatbot simple con base de conocimiento. Configuras el prompt, subes documentos y conectas. Sin lógica condicional.

Carga tu base de conocimiento

Ve a Knowledge (Conocimiento) en el menú lateral de Dify.
Haz clic en Create Knowledge y sube tus archivos: PDFs, DOCX, TXT, CSV o conecta una URL / Notion / base de datos.
Dify procesa y vectoriza los documentos automáticamente (chunking + embeddings).
Asocia el Knowledge a tu Chatbot en Context > Knowledge — selecciona el/los Knowledge creados.

Tip: divide PDFs muy largos en secciones temáticas (ej. "Manual Técnico - Capítulo 1") para mejorar la precisión de la búsqueda. Dify lo hace automáticamente, pero un buen nombrado ayuda a auditar.

Configura el prompt del Chatbot en Dify

En tu Chatbot ve a Prompt / Instructions y escribe el prompt del sistema. Ejemplo:

Eres el asistente virtual de {{empresa}}.

Reglas:
- Responde SOLO con información de la base de conocimiento.
- Si la respuesta no está en los documentos, di: "Ese dato no está en mi base de conocimiento. Te derivo con un asesor."
- Cita la fuente cuando sea posible: "Según [documento]..."
- Máximo 4 líneas por respuesta. Español neutro.
- Si el cliente dice "hablar con asesor", indica que será derivado.

Ajusta Temperature (0.3 para precisión) y Max Tokens según tu caso.

Obtén la API Key y el endpoint

En tu Chatbot ve a API Access o Access API (menú lateral o superior).
Haz clic en Create API Key o API Key > Create.
Copia la clave que empieza por app-... — esa es tu Dify API Key.
Copia también el API Endpoint / Base URL:

Entorno	Endpoint
Dify Cloud	`https://api.dify.ai/v1`
Auto-alojado	`https://tu-dify.com/v1`

Guarda la API Key como una contraseña. Cada Chatbot tiene su propia clave app-.... Si creas un nuevo Chatbot, necesitarás una nueva clave.

3. Configuración en ChatCielo

Ve a Canales > Tu canal > Integración IA > Dify.

Campo	Qué poner	Ejemplo
API Key	Pega la clave `app-...` de Dify	`app-1234567890abcdef...`
Endpoint / Base URL	URL base de la API de Dify	`https://api.dify.ai/v1`
App Type	`Chatbot` o `Chatflow`	Según el tipo de app que creaste
Prompt del Sistema (opcional)	Instrucciones adicionales en ChatCielo	Si lo dejas vacío, usa el prompt configurado en Dify
Palabra clave de derivación	`hablar con asesor, asesor humano`	Frases de 2–3 palabras

Pega los datos y guarda

En ChatCielo pega la API Key y el Endpoint. Selecciona el tipo de app y haz clic en Guardar > Probar conexión.

Prueba con un mensaje real

Envía un mensaje al número conectado que requiera buscar en tu base de conocimiento, por ejemplo: "¿Cuál es la política de devoluciones?" o "¿Cómo configuro el producto X?". Verifica que la respuesta cite tus documentos.

Variables que ChatCielo envía a Dify

ChatCielo envía automáticamente en cada consulta:

Variable	Contenido	Uso en Dify
`{{name}}`	Nombre del contacto	Personalización: "Hola `{{name}}`, según el manual..."
`{{phoneNumber}}`	Número con código país	Trazabilidad
`{{protocol}}`	Protocolo de la atención	Referencia para derivación
`{{email}}`	Email si existe	Contexto adicional

En Dify, puedes usar estas variables en el prompt si las declaras como Input Variables en la configuración del Chatbot.

4. Casos de uso recomendados

Manuales técnicos, guías de instalación, troubleshooting.

El cliente pregunta "¿Cómo reinicio el equipo X?" y Dify busca en el manual indexado, extrae los pasos exactos y responde citando la página/sección. Sin alucinar, sin inventar pasos.

Ideal para: tecnología, electrodomésticos, software, maquinaria.

5. Buenas prácticas

Chunking: Dify divide tus documentos en fragmentos (chunks) para la búsqueda. Usa el modo Automatic para empezar; cambia a Custom solo si necesitas ajustar el tamaño de chunk para documentos muy técnicos.
Actualización: cuando subas una nueva versión de un PDF, reemplaza el documento en el Knowledge — Dify reindexa automáticamente. No necesitas tocar ChatCielo.
Evaluación: en Dify usa Annotation y Feedback para marcar respuestas buenas/malas y mejorar la base con el tiempo.
Límites: Dify Cloud tiene límites por plan (documentos, mensajes/mes). Para alto volumen, considera Dify auto-alojado + modelo local (Ollama) para costo mínimo.
Derivación: configura en Dify un fallback: "Si no encuentras la respuesta en la base, indica que derivarás a un asesor" — y en ChatCielo configura la palabra clave hablar con asesor para que la derivación sea efectiva.

6. Solución de problemas

Problema	Causa	Solución
`Invalid API key`	Clave `app-...` mal copiada	Copia nuevamente desde API Access en Dify. Cada Chatbot tiene su propia clave.
Respuestas genéricas sin citar documentos	Knowledge no asociado al Chatbot	En Dify ve a Context > Knowledge y asocia el Knowledge al Chatbot.
`Knowledge not found`	Documento no indexado	Verifica en Knowledge que el documento esté en estado Indexed / Available. Reindexa si está en error.
Respuestas en inglés	Prompt sin idioma	Agrega en el prompt de Dify: "Responde siempre en español neutro".
Latencia alta (3–5 s)	RAG + LLM con muchos documentos	Reduce el número de chunks recuperados (Top K) en la config de Knowledge a 3–5.
No deriva a humano	Palabra clave no configurada	Configura `hablar con asesor` en ChatCielo y el fallback en el prompt de Dify.

¿Dify es demasiado para tu caso? Si tu base es de menos de 10 páginas, un prompt directo en ChatGPT o Claude con la información pegada es más rápido y barato. Reserva Dify para bases grandes y dinámicas.

Dify