GUIDES — Wiki interna

El AI Model Tester es un módulo que verifica automáticamente que todos los modelos de inteligencia artificial configurados en Perspectiva Studio funcionen correctamente. Detecta modelos que han fallado o están caídos, y mantiene un registro histórico de su estado en la base de datos del servidor. Esto permite que todos los usuarios compartan la misma configuración y que los modelos problemáticos se oculten de los menús desplegables, evitando errores y mejorando la experiencia de uso. El sistema es clave para garantizar la fiabilidad del producto y reducir el tiempo de inactividad.

• Prueba todos los modelos de IA (LLM, TTS, STT, imagen, visión) con diferentes modos: completo, por categoría, por proveedor, o solo la perspectiva actual.
• Los resultados se guardan en la base de datos del servidor, permitiendo que todos los clientes compartan la misma configuración y estado de salud de los modelos.
• Los modelos que fallan se ocultan automáticamente de los menús desplegables, evitando que los usuarios seleccionen opciones no funcionales.
• Incluye un panel de interfaz de usuario con resultados en tiempo real, progreso de pruebas y opciones de filtrado.
• Se integra con el registro de modelos existente para filtrar modelos no saludables y mostrar insignias de estado en los selectores.

Este documento es una guía práctica para configurar todas las claves secretas necesarias en los proyectos Cloudflare Workers de Cadences. Explica qué secrets son obligatorios para que los flujos de trabajo funcionen (como la clave de Gemini para el asistente de IA o las credenciales de Twilio para WhatsApp y SMS), cuáles son opcionales para funciones como llamadas de voz o envío de emails, y cómo configurarlos de forma segura. Incluye comandos paso a paso, una tabla de prioridades y buenas prácticas de seguridad para evitar exponer información sensible. Es esencial para cualquier equipo que despliegue o mantenga estos workers, ya que sin los secrets correctos las funcionalidades simplemente no operan.

• Lista completa de 24 secrets organizados por prioridad: críticos, importantes y opcionales.
• Incluye comandos exactos de wrangler para configurar cada secret en Cloudflare Workers.
• Proporciona tabla de prioridades que muestra qué secrets afectan a workflows, asistente IA, webhooks y email.
• Ofrece checklist de configuración mínima para workflows, voz, email y seguridad avanzada.
• Incluye buenas prácticas de seguridad como rotación periódica, no commiteo y uso de entornos separados.

Esta guía explica cómo conectar la plataforma ProjectOS con Twilio para enviar mensajes de texto, hacer llamadas de voz y enviar mensajes por WhatsApp. Permite automatizar comunicaciones con clientes, como recordatorios de citas o notificaciones de pedidos. La configuración toma menos de 15 minutos y es clave para mejorar la experiencia del cliente sin necesidad de intervención manual.

• Configuración paso a paso para integrar Twilio en ProjectOS.
• Incluye opciones para voz, SMS y WhatsApp, tanto en pruebas como en producción.
• Proporciona ejemplos de nodos de workflow para automatizar comunicaciones.
• Cubre costos estimados y solución de problemas comunes.
• Incluye recomendaciones de seguridad para proteger credenciales.

Esta guía explica cómo configurar webhooks para recibir mensajes de WhatsApp y llamadas de voz en tu aplicación. Los webhooks son como puertas de entrada que permiten que servicios externos (como WhatsApp o ElevenLabs) envíen información automáticamente a tu sistema cuando ocurre un evento, por ejemplo, cuando un cliente envía un mensaje o finaliza una llamada. Esto es clave para tener un historial completo de interacciones con clientes y poder analizar conversaciones. La guía cubre tanto la configuración en los servicios externos como en Cloudflare, incluyendo pasos de prueba y seguridad.

• Configura webhooks de WhatsApp (Meta Business API o Twilio) y ElevenLabs para llamadas de voz.
• Incluye URLs de producción y desarrollo local con ngrok/cloudflared.
• Detalla variables de entorno necesarias en Cloudflare Pages.
• Proporciona comandos de prueba con cURL y verificación en D1 database.
• Incluye checklist de producción y troubleshooting para problemas comunes.

Esta guía documenta el sistema de diseño elegante estilo Apple implementado en Cadences, enfocado en minimalismo, sofisticación y experiencia de usuario premium. Define principios como minimalismo elegante, claridad tipográfica, fluidez en transiciones y profundidad con efectos glassmorphic. Incluye una paleta de colores basada en escala de grises, jerarquía tipográfica, efectos visuales, componentes reutilizables y pautas de implementación en Tailwind CSS. Es una referencia esencial para mantener la coherencia visual en todos los productos de Cadences.

• Define una paleta de grises con variables CSS para fondos, bordes y texto, sin colores vibrantes.
• Establece una jerarquía tipográfica con pesos ligeros y espaciado generoso para claridad.
• Incluye efectos glassmorphism, sombras sutiles y gradientes para crear profundidad.
• Proporciona componentes como cards, botones minimalistas y headers colapsables con transiciones suaves.
• Ofrece un checklist de implementación y ejemplos prácticos para garantizar consistencia.

Este documento define la estructura estandarizada que todos los templates de ProjectOS deben seguir para garantizar compatibilidad con el sistema de preview y aplicación de templates. Explica cómo configurar correctamente proyectos, workflows, usuarios y perfiles de IA, destacando reglas críticas como el uso de mayúsculas en tipos de proyecto y la inclusión del campo 'data' en nodos. Es una guía esencial para desarrolladores que crean o mantienen templates, asegurando que funcionen correctamente en el modal de preview y evitando errores comunes.

• Los tipos de proyecto (STANDARD, DATA_TABLE) deben escribirse en MAYÚSCULAS para que el preview funcione.
• Todos los nodos de workflow deben incluir el campo 'data' con su configuración, no solo 'config'.
• Las tareas en proyectos STANDARD usan 'title' y 'tasks', no 'name' ni 'testTasks'.
• Los proyectos DATA_TABLE requieren 'schema' y 'sampleData' con estructura específica.
• Incluye checklist de validación y troubleshooting para errores comunes.

Esta guía explica cómo importar archivos CSV a ProjectOS para crear proyectos tipo 'Tabla de Datos' de forma automática. El sistema detecta las columnas, infiere los tipos de datos (como texto, número, fecha, etc.) y convierte cada fila en una tarea. Esto permite a los equipos cargar rápidamente información desde Excel u otras fuentes sin necesidad de configuración manual, ahorrando tiempo y reduciendo errores. Es útil para casos como gestión de clientes, inventarios o actas de reuniones.

• Soporta detección automática de tipos: string, number, boolean, email, url, date, datetime, json.
• El archivo debe tener primera fila de encabezados, usar comas como separador y codificación UTF-8.
• Al importar se crea un proyecto DATA_TABLE con schema y datos; se puede editar después.
• Incluye vista previa con las primeras 5 filas y validación de errores comunes.
• Próximamente: importación incremental, exportación a CSV y mapeo personalizado de columnas.

Esta guía explica cómo configurar llamadas telefónicas con inteligencia artificial en ProjectOS usando ElevenLabs. Permite que los usuarios gestionen proyectos y tareas mediante conversaciones telefónicas naturales, sin necesidad de usar una aplicación. El sistema puede consultar información del proyecto, crear tareas y actualizar su estado automáticamente. Es una herramienta que ahorra tiempo al permitir la gestión por voz, ideal para equipos que necesitan actualizar su trabajo rápidamente.

• Configuración en menos de 10 minutos con cuenta de ElevenLabs y API key.
• El agente conversacional entiende español y puede crear, actualizar y consultar tareas.
• Incluye tres herramientas personalizadas: obtener información del proyecto, crear tareas y actualizar estado.
• Plan recomendado Creator ($22/mes) incluye 250 minutos de llamadas.
• Ofrece historial de llamadas con transcripciones y análisis.

Este documento describe las herramientas internas de CadencesLab, destacando Perspectiva Studio, una plataforma que transcribe audios, analiza conversaciones con inteligencia artificial y genera contenido como actas, resúmenes o audiolibros. La herramienta permite a equipos comerciales y de producto extraer valor de reuniones y sesiones grabadas sin necesidad de conocimientos técnicos. Su importancia radica en que centraliza procesos de documentación y análisis, ahorrando tiempo y mejorando la toma de decisiones basada en datos conversacionales.

• Perspectiva Studio transcribe audios de hasta 150 MB y los analiza con múltiples proveedores de IA, priorizando velocidad y fiabilidad.
• Ofrece módulos como generación de actas, análisis psicológico, chat con IA, audiolibros e historias interactivas.
• Incluye un sistema de almacenamiento en la nube con URLs compartibles y persistencia de archivos de audio.
• Está protegido por dominio y no requiere autenticación JWT cuando se accede desde rutas internas.
• Se actualiza frecuentemente; la versión actual es v3.1.0 con mejoras en el chat flotante y persistencia de audio.

Perspectiva Studio es una herramienta interna de Cadences que permite analizar reuniones, documentos y otros contenidos usando inteligencia artificial. Convierte audios, URLs y archivos en transcripciones, resúmenes, actas y publicaciones para redes sociales. También incluye un chat contextual que recuerda todo el contenido de la sesión y puede generar imágenes o buscar información en internet. Es clave para que los equipos ahorren tiempo documentando y extrayendo valor de sus conversaciones y materiales.

• Soporta múltiples formatos de entrada: audio, URLs, PDFs, imágenes y texto.
• Ofrece transcripción con varios proveedores (Groq, ElevenLabs, Google, OpenAI) y generación de contenido con LLMs.
• Incluye un chat flotante (Super Chat) con acceso completo al contexto de la sesión y capacidad de ejecutar herramientas como TTS o búsqueda web.
• Almacena las perspectivas en la nube (R2 + D1) con un formato multi-archivo que incluye manifest.json.
• Proporciona un sistema de costes por uso de cada servicio de IA.

Publications Studio es un módulo de Perspectiva Studio que permite generar automáticamente publicaciones optimizadas para redes sociales a partir de contenido ya creado, como transcripciones, actas, blogs o audiobooks. El sistema analiza el contenido con inteligencia artificial para extraer temas, ganchos y frases destacables, y luego genera el texto, las imágenes y los hashtags adaptados a cada plataforma (Instagram, Twitter, Facebook, LinkedIn, TikTok). Incluye un editor con previsualizaciones realistas y opciones de exportación, facilitando la publicación sin necesidad de diseñar o redactar manualmente. Esto ahorra tiempo y asegura que el mensaje llegue de forma efectiva a cada audiencia.

• Genera automáticamente copy, imagen y hashtags para 5 plataformas sociales a partir de un solo contenido fuente.
• Utiliza IA para analizar el contenido y adaptar el tono y formato a cada red social.
• Incluye previsualizaciones realistas (mockups) y editor en tiempo real con contador de caracteres.
• Permite exportar individualmente o en pack ZIP, y está integrado con Perspectiva Studio, Blog Studio y Audiobook.
• Coste estimado por proyecto de 5 plataformas: ~0.17 €.

Este documento describe cómo conectar workflows con servicios externos como llamadas telefónicas, WhatsApp, SMS, email y APIs REST. Explica los tipos de integraciones disponibles, su configuración, manejo de errores y seguridad. Es una guía práctica para implementar comunicaciones automatizadas con clientes desde la plataforma.

• Soporta integraciones con ElevenLabs, Twilio, Vonage, WhatsApp Business API, SendGrid, AWS SES y APIs personalizadas.
• Permite enviar llamadas, WhatsApp, SMS, emails y mensajes de voz, así como esperar llamadas entrantes.
• Las API keys se configuran mediante variables de entorno o interfaz de usuario, con recomendaciones de seguridad.
• Incluye reintentos automáticos con backoff exponencial y registro de logs para monitoreo.
• Usa variables dinámicas para personalizar mensajes y outputs estructurados para cada integración.

El WhatsApp Local Agent es una aplicación de escritorio que automatiza WhatsApp Web desde tu computadora, permitiendo respuestas automáticas con IA, registro de conversaciones, transcripción de audios y análisis de imágenes. Se conecta con la plataforma Cadences para integrar workflows y gestionar tareas, todo sin costes adicionales de mensajería. Es ideal para equipos comerciales que quieran agilizar la comunicación con clientes sin depender de APIs de pago. La instalación es sencilla y los datos se mantienen locales, garantizando privacidad.

• Automatiza WhatsApp Web con respuestas IA (Gemini, GPT, Llama) sin costes de mensajería.
• Incluye transcripción de audios y análisis de imágenes para enriquecer el registro de conversaciones.
• Se integra con workflows de Cadences para crear tareas y ejecutar acciones automáticamente.
• Instalación local con Node.js; soporta modo headless para servidores.
• Configuración flexible: filtros por contactos, horarios y palabras clave.

Este documento explica cómo configurar el envío de correos electrónicos desde la plataforma, usando servicios externos como Resend o SendGrid. Detalla los pasos para crear cuentas, obtener claves de acceso y configurarlas en el sistema, así como las opciones para verificar dominios y evitar que los correos vayan a spam. Es importante para el negocio porque permite automatizar notificaciones como invitaciones a equipos o cambios de roles, mejorando la comunicación con los usuarios sin necesidad de enviar correos manualmente.

• Soporta dos proveedores: Resend (recomendado) y SendGrid, ambos con plan gratuito de 100 emails/día.
• La configuración se realiza mediante variables de entorno y secrets en Cloudflare Workers.
• Incluye templates para invitaciones, remociones y cambios de rol en organizaciones.
• Si no se configuran las claves, el sistema sigue funcionando pero no envía correos (muestra warning).
• Migrar de proveedor solo requiere cambiar una variable y redeploy, sin afectar invitaciones existentes.

La Vista de Tabla convierte proyectos en bases de datos visuales donde cada tarea es una fila. Permite gestionar información como clientes, inventarios o registros de ventas sin necesidad de programación. Los usuarios pueden agregar, editar, eliminar, buscar y ordenar datos de forma intuitiva. Es ideal para equipos comerciales que necesitan organizar y consultar datos estructurados rápidamente.

• Transforma proyectos en tablas editables con tipos de datos como texto, número, fecha, email y URL.
• Operaciones CRUD completas: agregar, editar y eliminar filas con validación de campos requeridos.
• Búsqueda global en todas las columnas y filtros por columna específica, combinables.
• Ordenamiento por cualquier columna con indicadores visuales ascendente/descendente.
• Integración con IA para agregar, consultar y modificar datos mediante comandos en lenguaje natural.

Esta guía enseña a usar las funciones de voz en ProjectOS, permitiendo hacer preguntas hablando y escuchar respuestas. Incluye pasos detallados para activar el micrófono, consejos para mejorar la precisión, y solución de problemas comunes. Es útil para cualquier usuario que quiera una experiencia manos libres, mejorando la productividad al interactuar con el asistente IA.

• Activar el micrófono para hacer preguntas por voz con reconocimiento en tiempo real.
• Escuchar respuestas del asistente con un solo clic en 'Escuchar'.
• Combinar texto y voz para preguntas más complejas.
• Disponible en Chrome y Edge; en iOS solo funciona escuchar respuestas.
• Incluye ejemplos prácticos y solución de problemas comunes.

Esta guía explica cómo usar una plantilla de laboratorio para probar y depurar flujos de trabajo sin afectar sistemas reales. Incluye datos de prueba, workflows de ejemplo para cada tipo de nodo, y perfiles de inteligencia artificial que ayudan a revisar errores. Es útil para que los equipos técnicos puedan experimentar, formar a nuevos desarrolladores y reproducir incidencias de forma controlada. Al final, permite mantener un registro de pruebas y compartir hallazgos con soporte y operaciones.

• Proporciona datasets de laboratorio y un kanban para seguimiento de pruebas.
• Incluye siete workflows de referencia que cubren desde triggers hasta manejo de errores.
• Cuenta con perfiles de IA para inspeccionar payloads y analizar causas raíz.
• Recomienda usar integraciones sandbox (REST mock, email, voz) para pruebas seguras.
• Sugiere duplicar la plantilla para crear laboratorios específicos por cliente o vertical.