Apps conectadas

Conecta un asistente de IA que ya uses, como Claude, ChatGPT o cualquier herramienta compatible con conectores personalizados, y registra las actividades de tu homeschool chateando. Di “registra 30 minutos de matemáticas con Emma” en medio de una conversación y aparecerá en Homeschool Fox automáticamente.

Las apps conectadas requieren una suscripción o prueba gratis activa.

Dos formas de conectar

• Conectar con inicio de sesión: los asistentes compatibles con Homeschool Fox directamente (o cualquier conector personalizado que agregues por URL) se conectan con un aviso de inicio de sesión: haz clic en Conectar, inicia sesión en Homeschool Fox, aprueba y listo. No hay claves que copiar. Adminístralos o desconéctalos cuando quieras desde Configuración → Apps conectadas → Administrar asistentes conectados.
• Clave de API personal: para las herramientas que piden una clave o una URL, genera una como se explica abajo.

Obtener la URL de tu conector

1. Ve a Configuración
2. Busca Apps conectadas
3. Haz clic en Generar clave de API
4. Copia la URL del conector (y la clave de API, si planeas usar la API directamente)

Cópialas de inmediato: por tu seguridad, solo se muestran una vez. Si se te pasó, haz clic en Regenerar para obtener un juego nuevo.

Agregarla a Claude

1. Abre Configuración → Conectores en Claude
2. Haz clic en Agregar conector personalizado
3. Pega la URL de tu conector
4. Guarda: Homeschool Fox ahora aparece en la lista de conectores de Claude

Agregarla a ChatGPT

1. Abre Configuración → Conectores en ChatGPT
2. Activa el Modo desarrollador si no aparecen los conectores personalizados (la disponibilidad depende de tu plan de ChatGPT)
3. Agrega un conector nuevo y pega la URL de tu conector
4. Guarda

Qué puedes hacer

Una vez conectado, tu asistente puede:

• Registrar actividades: “Registra una hora de lectura con los dos niños esta mañana”
• Configurar horarios repetitivos: “Matemáticas todos los lunes y miércoles a las 9 hasta junio”
• Revisar lo registrado: “¿Qué registramos esta semana?”
• Informar el avance: “¿Cómo vamos con las horas este año escolar?”
• Consultar tus estudiantes y materias: para registrar con los nombres correctos
• Agregar una materia: cuando confirmes que quieres una que todavía no existe

Algunas cosas que conviene saber:

• Una materia por actividad. “Hicimos matemáticas y lectura” se convierte en dos actividades, igual que con el intérprete de IA de la app.
• Nombra a tus estudiantes. Si tienes más de un estudiante en la cuenta, di para quién fue la actividad. En las cuentas con un solo estudiante se completa automáticamente.
• Las materias salen de tu cuenta. Si el asistente menciona una materia que no tienes, se le indica qué materias hay disponibles para que se corrija, y puede crear la materia por ti si se lo pides.
• Sin duplicados. Si tu asistente reintenta una solicitud, Homeschool Fox reconoce la repetición y no registra la misma actividad dos veces.

Cuentas compartidas

Cada persona genera su propia clave desde su propio inicio de sesión. Tu pareja con acceso completo inicia sesión en la cuenta compartida como siempre; los miembros de solo lectura pueden leer actividades y avance, pero no registrar.

Mantener tu clave segura

Trata la URL del conector y la clave de API como una contraseña: cualquiera que las tenga puede leer y registrar actividades en tu cuenta.

• Regenerar emite una clave nueva y revoca la anterior de inmediato. Las apps que usan la clave anterior dejan de funcionar hasta que les des la nueva URL.
• Revocar corta el acceso por completo.

Para desarrolladores

La misma clave funciona como token Bearer contra la API REST:

• POST /api/v1/activities: registra una actividad (materias y estudiantes por nombre o id; admite campos de recurrencia)
• GET /api/v1/activities: actividades recientes, con filtros de fecha from/to
• GET /api/v1/students y GET /api/v1/subjects: contra qué puedes registrar
• POST /api/v1/subjects: agrega una materia (devuelve la existente si el nombre coincide)
• GET /api/v1/progress: horas y asistencia por estudiante frente a las metas del año escolar actual

Envíala en un encabezado Authorization: Bearer <key>. Las solicitudes tienen un límite de frecuencia por clave.