1. Introducción

Acerca del Software

Nuestro sistema de tareas es una solución web de última generación diseñada para optimizar y simplificar la gestión de tareas. Con su interfaz intuitiva y funciones avanzadas, proporciona a los usuarios una plataforma incomparable para realizar tareas de manera eficiente y efectiva.

Beneficios Clave

Como oferta de Software como Servicio (SaaS), nuestro sistema de tareas ofrece los beneficios de actualizaciones continuas, fácil escalabilidad y reducción de costos de TI. Pero lo que realmente nos distingue es nuestra integración con tecnología de IA de vanguardia. Esto no solo mejora las capacidades de toma de decisiones, sino que también introduce analítica predictiva y automatización, asegurando que tu gestión de tareas siempre esté un paso adelante.

Plataformas / Navegadores Soportados

La compatibilidad es clave. Por eso nos hemos asegurado de que nuestro software sea compatible con todos los navegadores web principales tanto en plataformas de escritorio como móviles. Además, para quienes buscan integrar nuestras capacidades en sistemas de software personalizados, ofrecemos una API robusta que facilita la conectividad sin interrupciones.

2. Primeros Pasos

Configuración de Cuenta

Comienza tu viaje creando una cuenta con una dirección de correo electrónico válida. Una vez que tu cuenta esté configurada, explora nuestra gama de funciones. Para acceder a funcionalidades premium, elige entre nuestros planes de suscripción adaptados a tus necesidades.

Configuración Básica

Tu nueva cuenta se abre con un espacio en blanco, lista para personalizar. Aunque pueda parecer abrumador al principio, recuerda que no tienes que dominar todo de inmediato. Comienza con lo básico como Notas, Enlaces, Contactos y Eventos. A medida que te sientas más cómodo, explora gradualmente funciones más avanzadas como Tareas, Plantillas de Tareas y Shell. Cada módulo está diseñado para mejorar tu productividad a tu propio ritmo.

Incorporación Inicial del Usuario

Después de registrarte, recibirás un correo electrónico para verificar tu cuenta. Este es un paso importante para garantizar la seguridad de tu cuenta y activar todas las funciones. Sigue las instrucciones del correo electrónico para completar el proceso de verificación y comenzar tu experiencia con nosotros.

3. Funciones Principales

Resumen del Panel Principal

Comienza explorando el panel principal, donde tendrás acceso a un resumen de todos tus proyectos, tareas, actividad reciente y métricas importantes. Este centro centralizado te permite navegar rápidamente entre las diferentes secciones del sitio y monitorear el trabajo en curso de un vistazo.

Proyectos

Tu sistema de gestión de proyectos te permite crear, rastrear y colaborar en proyectos. Establece plazos, administra tareas dentro de cada proyecto y monitorea el progreso con herramientas fáciles de usar. Usa la sección de proyectos para ver todos los proyectos activos y archivados.

Notas

Después de iniciar sesión, los usuarios pueden crear notas para capturar ideas, actas de reuniones o cualquier información importante. Las notas se guardan automáticamente y se pueden buscar fácilmente más adelante. Pronto podrás organizar notas por proyectos, categorías o etiquetas.

Artículos

La sección de artículos está diseñada para ayudarte a crear y publicar contenido de formato largo, como documentación o reportes. Puedes redactar, editar y colaborar en artículos con otros miembros del equipo. El control de versiones integrado asegura que siempre puedas revertir a versiones anteriores si es necesario.

Enlaces

Después de descubrir recursos útiles, puedes guardarlos y organizarlos en la sección de Enlaces. Etiqueta, categoriza y busca tus enlaces para recuperarlos fácilmente más adelante. Esta sección es perfecta para administrar materiales de investigación, documentación externa o referencias útiles.

Contactos

Después de agregar contactos a tu sistema, puedes administrar y organizar sus datos en la sección de Contactos. Puedes buscar personas específicas fácilmente, y pronto categorizar contactos por proyecto o empresa, e integrar con otras herramientas de comunicación.

Eventos

Después de crear eventos, puedes ver todas las reuniones programadas, recordatorios y fechas límite en la sección de Eventos. Pronto podrás sincronizar eventos con calendarios, enviar invitaciones y administrar notificaciones para estar al día con las fechas importantes.

Tareas y Plantillas de Tareas

Después de crear tareas, puedes organizarlas por prioridad, asignarlas a miembros del equipo y rastrear su estado de finalización. Las plantillas de tareas te permiten crear estructuras de tareas reutilizables para actividades recurrentes, garantizando consistencia y ahorrando tiempo.

Archivos

La sección de Archivos proporciona un sistema potente para subir, organizar y administrar documentos con categorización automática, extracción de texto y capacidades de creación de tareas.

Funciones Clave

• Subida Inteligente: Arrastra y suelta múltiples archivos con procesamiento automático
• Categorización Automática: Los archivos se organizan automáticamente en carpetas lógicas
• Inteligencia PDF: La extracción de texto hace que todos los PDFs sean buscables
• Creación de Tareas: Crea tareas automáticamente a partir de facturas, contratos y documentos
• Operaciones Masivas: Administra múltiples archivos a la vez

Subida de Archivos

Sube archivos navegando a Archivos → Subir. Puedes:

• Arrastrar y soltar múltiples archivos a la vez
• Asociar archivos con proyectos específicos
• Ver el progreso de subida en tiempo real
• Subir documentos hasta el límite de tu plan (10-100 MB)

Categorización Automática

AskRobots organiza automáticamente tus archivos usando reconocimiento inteligente de patrones:

• financial/invoices/2024/ - Para documentos de facturación
• contracts/vendor/active/ - Para acuerdos con proveedores
• receipts/travel/2024/ - Para recibos de gastos
• personal/photos/vacation/ - Para imágenes personales

Extracción de Texto de PDF

Cada PDF se procesa automáticamente para:

• Extraer todo el texto para búsquedas
• Identificar información clave (fechas, montos, nombres)
• Crear metadatos buscables
• Habilitar búsqueda de texto completo en todos los documentos

Creación de Tareas desde Documentos

Sube documentos y deja que la IA cree tareas automáticamente:

• Facturas → Tareas de recordatorio de pago con fechas de vencimiento
• Contratos → Tareas de recordatorio de revisión y renovación
• Notas de Reunión → Elementos de acción como tareas individuales
• Documentos de Proyecto → Tareas de entregables y hitos

Límites de Almacenamiento por Plan

4. Objetos (Arquitectura 100x)

Los Objetos son código Python en vivo que se ejecuta instantáneamente sin despliegue. Esta es la arquitectura 100x: la IA edita el código, actualizas tu navegador y las funciones están en vivo.

¿Por qué 100x?

El desarrollo tradicional toma de 10 a 30 minutos por cambio (código, migraciones, compilación, despliegue, pruebas). Con Objetos, los cambios toman de 10 a 30 segundos (editar código, actualizar navegador, listo). Eso es una iteración 100 veces más rápida.

Tipos de Objetos

Ejemplo de Inicio Rápido

Así es como la IA crea una vista simple:

# Object: u_1_view_hello
# This renders at /v/hello/

def GET(request, context):
    name = context.get('params', {}).get('name', 'World')
    return {
        'html': f'<h1>Hello, {name}!</h1>',
        'title': 'Greeting'
    }

Visitar /v/hello/?name=Dan and see "Hello, Dan!" - no deploy needed.

Ejemplo de Almacén de Datos

# Object: u_1_deals (data store)
# Stores deals as JSON in _state_manager

def GET(request, context):
    deals = _state_manager.get('deals', [])
    return {'deals': deals, 'count': len(deals)}

def POST(request, context):
    deals = _state_manager.get('deals', [])
    new_deal = context.get('data', {})
    deals.append(new_deal)
    _state_manager.set('deals', deals)
    return {'status': 'added', 'count': len(deals)}

Uso de Objetos vía MCP

Tu IA (Claude Code, Cursor, etc.) puede crear y modificar objetos a través de la API MCP:

• create_object - Crear un nuevo objeto con código Python
• get_object_source - Leer el código fuente del objeto
• update_object_source - Modificar el código del objeto
• execute_object - Llamar métodos del objeto (GET/POST/PUT/DELETE)
• get_object_state - Leer el estado persistido del objeto

Aislamiento de Objetos

Los objetos de cada usuario están aislados con prefijos:

• u_1_view_dashboard - Vista del panel del Usuario 1
• u_1_deals - Almacén de datos de tratos del Usuario 1
• views_landing - Vista del sistema (solo lectura)

Los usuarios solo pueden ver y modificar sus propios objetos. Los objetos del sistema están disponibles como ejemplos de solo lectura.

5. El Futuro de la Gestión de Tareas Personalizable: Liberando el Poder de los Formularios Dinámicos

En una era de evolución digital implacable, las formas en que interactuamos con plataformas en línea, manejamos tareas y gestionamos flujos de trabajo están en constante evolución.

Los sistemas tradicionales de gestión de tareas son estáticos, forzando a los usuarios a un enfoque único para todos. Pero imagina un mundo donde cada tarea, grande o pequeña, encaja perfectamente. Bienvenido a nuestro Sistema de Formularios Dinámicos.

• Adaptabilidad: Evoluciona tus tareas a medida que cambian las necesidades de tu negocio.
• Eficiencia: Usa metadatos para transferir datos, eliminar redundancia y mejorar la velocidad.
• Personalización: Personaliza cada elemento de tus formularios.
• Escalabilidad: Maneja sin problemas proyectos de cualquier escala o complejidad.

Sumérgete, explora y experimenta el futuro de la gestión de tareas con nosotros.

Desglosando el Sistema de Formularios Dinámicos

Nuestro sistema de gestión de tareas está diseñado para ofrecer flexibilidad y eficiencia a través de sus componentes principales: Metadatos, JSON Schema y UI Schema. Cada uno juega un papel crucial en la creación y gestión de formularios dinámicos.

Metadatos:

¿Qué es?

Metadata is essentially "data about data." It functions as a detailed ledger, recording specific attributes and contextual information about each task.

¿Por qué es importante?

Los metadatos sirven como la columna vertebral para contextualizar tareas. Facilitan la integración continua de datos entre varias tareas, asegurando que los detalles importantes se transfieran. Esta continuidad es clave para mantener la eficiencia y coherencia en la gestión de tareas.

JSON Schema (Esquema de Datos):

¿Qué es?

JSON Schema actúa como el plano arquitectónico para los datos de tus tareas. Describe los tipos de datos esperados, restricciones y la estructura general de los datos asociados con cada tarea.

¿Por qué es importante?

El rol principal del esquema es garantizar la integridad y estructura de los datos. Al proporcionar una definición clara de los requisitos de datos, asegura que toda la información recopilada sea consistente, predecible y cumpla con los estándares establecidos. Esto es crucial para mantener la calidad de los datos y facilitar la automatización y el procesamiento de datos.

UI Schema (Modelo de Vista):

¿Qué es?

El UI Schema es responsable de la representación visual de la estructura de datos definida por JSON Schema. Proporciona opciones de personalización para el diseño y disposición de campos de formulario, widgets y otros elementos interactivos.

¿Por qué es importante?

El UI Schema cierra la brecha entre las estructuras de datos del backend y la experiencia del usuario en el frontend. Su importancia radica en su capacidad de adaptar la presentación e interacción con los datos para ajustarse a las necesidades específicas del usuario y preferencias estéticas. Esta personalización mejora la participación del usuario y asegura una interfaz más intuitiva y amigable.

Datos JSON y Plantillas de Tareas

Comienza con tus datos JSON. ¿No tienes? Ve algunos ejemplos aquí o crea aquí.

JSON Schema (Esquema de Datos)

[ Imagen de código JSON o diagrama UML aquí ]

Describe tu objeto de formulario usando un archivo JSON. Incluye nombres, tipos, valores y tamaños de campos.

Crea tu JSON schema aquí y previsualiza el formulario en línea.

UI Schema (Modelo de Vista)

[ Imagen del código y su wireframe de interfaz correspondiente aquí ]

Usa un archivo JSON para listar las etiquetas y opciones de la interfaz.

Interfaz de Usuario

[ Imagen de la interfaz con datos adentro, renderizada en Bootstrap aquí ]

El resultado final se muestra en el formulario del trabajador. Los resultados enviados se almacenan en el blob campo.

Ejemplos Básicos

• Verdadero o Falso
• Opción múltiple
• Responder Pregunta

Código de Ejemplo:

• Python

6. Cuenta y Facturación

AskRobots usa un sistema de facturación simple basado en billetera. Agrega fondos según sea necesario, solo paga por lo que usas, sin cargos sorpresa ni tarifas ocultas.

Cómo Funciona Nuestro Sistema de Billetera

A diferencia de las suscripciones tradicionales, nuestro sistema de billetera te da control total:

• Modelo Prepago: Agrega fondos entre $5-$100 en cualquier momento
• Sin Renovación Automática: Tu tarjeta nunca se cobra sin tu permiso
• Basado en Uso: Los fondos se deducen solo cuando usas funciones de IA
• Nunca Expira: Tu saldo permanece hasta que lo uses
• Transparencia Total: Ve exactamente cuánto cuesta cada operación de IA

Planes de Suscripción y Funciones

Aunque la facturación es basada en billetera, los planes determinan tus funciones y límites:

Costos de Uso de IA

Las operaciones de IA se cobran según el uso real:

• GPT-4o-mini: ~$0.001 por solicitud
• GPT-4: ~$0.03 por solicitud
• Claude 3.5 Sonnet: ~$0.015 por solicitud
• Análisis de Imágenes: ~$0.005 por imagen
• Procesamiento de PDF: ~$0.01 por documento

Los costos reales dependen de la complejidad de la solicitud y la longitud de la respuesta

Seguimiento de Uso

Monitorea tu uso en tiempo real:

• Panel: Ve el saldo de tu billetera y cargos recientes
• Página de Uso de IA: Desglose detallado por modelo y operación
• Historial de Transacciones: Registro completo de todos los cargos
• Resúmenes Diarios: Rastrea patrones de gasto

Métodos de Pago

Aceptamos todos los métodos de pago principales a través de Stripe:

• Tarjetas de Crédito (Visa, Mastercard, American Express, Discover)
• Tarjetas de Débito
• Billeteras Digitales (Apple Pay, Google Pay)
• Transferencias Bancarias (para Empresarial)

Todos los pagos se procesan de forma segura a través de Stripe. Nunca almacenamos los datos de tu tarjeta.

Agregar Fondos

1. Ve a Facturación → Agregar Fondos
2. Elige el monto (mínimo $5, máximo $100)
3. Ingresa los datos de pago
4. Click "Add Funds"
5. Los fondos están disponibles de inmediato

Procedimientos de Mejora/Reducción de Plan

Cambiar de plan es simple e inmediato:

Mejorar Tu Plan

1. Visita la página de Planes
2. Selecciona tu nuevo plan
3. Los cambios surten efecto de inmediato
4. El almacenamiento y los límites aumentan de inmediato
5. Sin cargos prorrateados: el sistema de billetera permanece igual

Reducir Tu Plan

1. Asegúrate de estar dentro de los límites del plan inferior (almacenamiento, etc.)
2. Visita la página de Planes
3. Selecciona el plan inferior
4. Es posible que necesites eliminar archivos si excedes el nuevo límite de almacenamiento
5. Las funciones se ajustan de inmediato

Notificaciones de Saldo Bajo

Te notificaremos cuando:

• El saldo baje de $5.00
• El saldo llegue a $0.00
• Una operación falle por fondos insuficientes

Historial de Facturación y Facturas

Accede a tu historial de facturación completo:

• Registro de Transacciones: Cada cargo con fecha y hora y descripción
• Estados de Cuenta Mensuales: Resumen de toda la actividad
• Opciones de Exportación: Descargar como CSV o PDF
• Documentos Fiscales: Resúmenes anuales para contabilidad

Encuéntralos en: Facturación → Historial de Transacciones

Política de Reembolsos

Ofrecemos reembolsos por:

• Saldo de billetera no utilizado (al cerrar la cuenta)
• Errores técnicos que resulten en cobros excesivos
• Cargos duplicados

Contacta a support@askrobots.com dentro de los 30 días para solicitudes de reembolso.

Facturación Empresarial

Para organizaciones que necesitan:

• Facturación con plazo de pago (NET 30)
• Descuentos por volumen
• Múltiples cuentas de usuario
• Contratos personalizados

Contacta a sales@askrobots.com para opciones Empresariales.

11. Documentación de la API

Resumen de la API

Nuestra API te permite interactuar programáticamente con nuestra plataforma, permitiéndote administrar tareas, ver estados y mucho más. Está diseñada para desarrolladores que desean integrar sus aplicaciones o automatizar flujos de trabajo.

Métodos de Autenticación

Usamos autenticación basada en tokens para asegurar nuestra API. Cada solicitud debe incluir un token de API válido en el encabezado. Los tokens se pueden obtener a través de tu panel de usuario. Puedes encontrar tu clave de API desde el panel o a través de este enlace.

Endpoints, Formatos de Solicitud y Respuesta

La API proporciona varios endpoints para acceder a diferentes funcionalidades. Las solicitudes deben hacerse en formato JSON, y las respuestas también se devuelven como JSON. Aquí hay un ejemplo de endpoint para tareas: https://askrobots.com/api/tasks/. Para una lista detallada de todos los endpoints disponibles, sus métodos de solicitud y formatos de respuesta, consulta nuestra documentación completa de la API.

Listar Tareas

curl -X GET \
          -H "Authorization: Token YOUR_API_TOKEN" \
          -H "Content-Type: application/json" \
          https://askrobots.com/api/tasks/

Detalles de Tarea

curl -X GET \
          -H "Authorization: Token YOUR_API_TOKEN" \
          -H "Content-Type: application/json" \
          https://askrobots.com/api/tasks/TASK_ID/

Listar Plantillas de Tareas

curl -X GET \
            -H "Authorization: Token YOUR_API_TOKEN" \
            -H "Content-Type: application/json" \
            https://askrobots.com/api/tasktemplates/
    

Crear una Tarea

         % curl -X POST \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "title": "New Task with Template",
           "urgency": "normal",
           "template": "TEMPLATE_ID",
           "instructions": "Please follow the template guidelines",
           "json_form": {},
           "metadata": {},
           "priority": 1,
           "due_date": "2024-03-25T00:00:00Z",
           "project": "PROJECT_ID"
         }' \
     https://askrobots.com/api/tasks/
    

Listar Proyectos

         % curl -X GET \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     https://askrobots.com/api/projects/
    

Referencia de Endpoints de la API

A continuación se muestra una lista completa de los endpoints de la API disponibles:

curl -X GET \
     -H "Authorization: Token YOUR_API_TOKEN" \
     "https://askrobots.com/api/search/?q=project&types=tasks,notes&limit=5"

{
  "query": "project",
  "total_count": 15,
  "types_searched": ["tasks", "notes"],
  "results": {
    "tasks": {
      "count": 10,
      "results": [
        {
          "id": "uuid",
          "type": "task",
          "title": "Create project dashboard",
          "snippet": "Build the main project...",
          "created_at": "2026-02-03T...",
          "project": {"id": "uuid", "name": "AskRobots"},
          "status": "open"
        }
      ]
    },
    "notes": {
      "count": 5,
      "results": [...]
    }
  }
}

curl -X POST \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "content": "Discussed project timeline and deliverables",
       "project": "PROJECT_UUID"
     }' \
     https://askrobots.com/api/notes/

curl -X POST \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "title": "Team Meeting",
       "start_date_time": "2025-06-15T14:00:00Z",
       "end_date_time": "2025-06-15T15:00:00Z",
       "description": "Weekly team sync",
       "project": "PROJECT_ID"
     }' \
     https://askrobots.com/api/events/

curl -X POST \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -F "file=@/path/to/document.pdf" \
     -F "project=PROJECT_UUID" \
     -F "description=Project documentation" \
     https://askrobots.com/api/files/upload/

# 1. Find claimable tasks
GET /api/tasks/claimable/?urgency=high&limit=5

# 2. Claim a task atomically
POST /api/tasks/{id}/claim/?timeout_minutes=30

# 3. Send heartbeats while working
POST /api/tasks/{id}/heartbeat/

# 4. Complete or release when done
POST /api/tasks/{id}/complete_simple/
# or
POST /api/tasks/{id}/release/

Formatos de respuesta

Todas las respuestas de la API siguen un formato JSON consistente:

Respuesta exitosa (200 OK):

{
  "id": "uuid-here",
  "title": "Sample Note",
  "content": "This is the note content",
  "created_at": "2025-06-11T12:00:00Z",
  "updated_at": "2025-06-11T12:00:00Z",
  "user": "user-id",
  "project": "project-id"
}

Respuesta de error (400 Bad Request):

{
  "error": "Bad Request",
  "message": "Title field is required",
  "field_errors": {
    "title": ["This field is required."]
  }
}

Respuesta de paginación:

{
  "count": 45,
  "next": "https://askrobots.com/api/notes/?page=2",
  "previous": null,
  "results": [
    {
      "id": "uuid-1",
      "title": "Note 1",
      ...
    },
    {
      "id": "uuid-2", 
      "title": "Note 2",
      ...
    }
  ]
}

Límite de Tasa

Las solicitudes a la API tienen límite de velocidad para garantizar un uso justo:

• 1000 solicitudes por hora para usuarios autenticados
• 100 solicitudes por hora para solicitudes no autenticadas
• La información del límite de velocidad se incluye en los encabezados de respuesta:
  • X-RateLimit-Limit: Máximo de solicitudes permitidas
  • X-RateLimit-Remaining: Solicitudes restantes
  • X-RateLimit-Reset: Momento en que se restablece el límite

Webhooks

Configura webhooks para recibir notificaciones en tiempo real cuando ocurran eventos:

POST /api/webhooks/
{
  "url": "https://your-app.com/webhook",
  "events": ["task.created", "task.updated", "task.completed"],
  "active": true
}

SDKs y Bibliotecas

Proporcionamos SDKs oficiales para lenguajes populares:

• Python: pip install askrobots-sdk
• JavaScript/Node: npm install @askrobots/sdk
• Ruby: gem install askrobots
• PHP: composer require askrobots/sdk

Ejemplo de SDK de Python:

from askrobots import Client

client = Client(api_key="YOUR_API_TOKEN")

# List tasks
tasks = client.tasks.list()

# Create a new task
new_task = client.tasks.create(
    title="Complete API documentation",
    urgency="high",
    project_id="PROJECT_ID"
)

# Update task status
client.tasks.update(new_task.id, status="completed")

Detalles de autenticación

Obtener tokens de API

1. Navega a Configuración → Claves API
2. Click "Generate New Token"
3. Dale a tu token un nombre descriptivo
4. Copia el token inmediatamente (no se mostrará de nuevo)
5. Guárdalo de forma segura en tu aplicación

Uso de tokens en solicitudes

Incluye tu token en el encabezado Authorization de cada solicitud:

Authorization: Token YOUR_API_TOKEN

Ejemplo con diferentes herramientas:

# curl
curl -H "Authorization: Token YOUR_API_TOKEN" https://askrobots.com/api/tasks/

# Python requests
import requests
headers = {"Authorization": "Token YOUR_API_TOKEN"}
response = requests.get("https://askrobots.com/api/tasks/", headers=headers)

# JavaScript fetch
fetch('https://askrobots.com/api/tasks/', {
    headers: {
        'Authorization': 'Token YOUR_API_TOKEN'
    }
});

Límites de velocidad

Los límites de velocidad de la API se basan en tu plan de suscripción:

Encabezados de límite de velocidad

Cada respuesta incluye información del límite de velocidad:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1698765432

Códigos de error

La API usa códigos de estado HTTP estándar y devuelve respuestas de error en JSON:

Paginación

Los endpoints de lista devuelven resultados paginados con 20 elementos por página de forma predeterminada:

{
    "count": 150,
    "next": "https://askrobots.com/api/tasks/?page=2",
    "previous": null,
    "results": [...]
}

Controla la paginación con parámetros de consulta:

• page - Número de página (predeterminado: 1)
• page_size - Elementos por página (máx: 100)

Filtrado y búsqueda

La mayoría de los endpoints de listado soportan filtrado:

# Filter tasks by project
/api/tasks/?project=PROJECT_ID

# Filter by status
/api/tasks/?status=open

# Search tasks
/api/tasks/?search=invoice

# Combine filters
/api/tasks/?project=PROJECT_ID&status=open&urgency=high

Webhooks

Configura webhooks para recibir notificaciones en tiempo real:

Eventos de Webhook

• task.created - Nueva tarea creada
• task.completed - Tarea marcada como completada
• file.uploaded - Archivo subido
• file.processed - Procesamiento de archivo completado
• wallet.low_balance - Saldo menor a $5

Ejemplo de carga útil de Webhook

{
    "event": "task.completed",
    "timestamp": "2025-06-19T10:30:00Z",
    "data": {
        "id": "task123",
        "title": "Process invoices",
        "completed_by": "user456"
    }
}

Mejores prácticas de la API

• Almacena respuestas en caché cuando sea posible para reducir las llamadas a la API
• Maneja los límites de velocidad de forma elegante con retroceso exponencial
• Usa webhooks en lugar de sondeo para actualizaciones en tiempo real
• Operaciones en lote al crear múltiples recursos
• Incluye solo los campos necesarios con parámetros de selección de campos
• Usa paginación correctamente para conjuntos de datos grandes
• Almacena los tokens de forma segura y rótalos regularmente

7. Seguridad y Privacidad

AskRobots está construido con seguridad y privacidad en su núcleo. Implementamos las mejores prácticas de la industria para proteger sus datos y garantizar el cumplimiento de las regulaciones de privacidad.

Aislamiento de Datos

Los datos de cada usuario están completamente aislados:

• Seguridad a nivel de fila: Todas las consultas a la base de datos se filtran por ID de usuario
• Sin datos compartidos: Tus archivos, tareas y proyectos nunca son accesibles para otros usuarios
• Aislamiento de API: La autenticación basada en tokens garantiza que el acceso a los datos sea específico por usuario
• Límites de proyecto: Incluso dentro de equipos, el acceso se controla a nivel de proyecto

Cifrado

Usamos múltiples capas de cifrado para proteger tus datos:

• En tránsito: Todas las conexiones usan cifrado TLS 1.3
• En reposo: Los archivos se cifran usando cifrado AES-256
• Base de datos: Los campos sensibles usan cifrado a nivel de aplicación
• Respaldos: Todos los respaldos se cifran antes de almacenarlos

Procedimientos de respaldo

Tus datos están protegidos mediante estrategias de respaldo integrales:

• Respaldos diarios automatizados de todas las bases de datos
• Retención de 30 días para recuperación en un punto específico del tiempo
• Pruebas de restauración regulares para garantizar la integridad de los respaldos

Permisos de Usuario

Controles de permisos detallados:

• Acceso basado en roles: Roles de Administrador, Usuario y Trabajador
• Permisos de proyecto: Controla quién puede ver, editar o administrar proyectos
• Permisos de API: Tokens separados para diferentes niveles de acceso
• Registro de auditoría: Rastrea todos los cambios de permisos

Seguridad de la API

Nuestra API implementa múltiples medidas de seguridad:

• Autenticación por token: Tokens de API seguros que pueden ser revocados
• Limitación de velocidad: Previene el abuso con límites de velocidad inteligentes
• Validación de entrada: Todas las entradas son sanitizadas y validadas
• Protección CORS: Compartición de recursos de origen cruzado controlada

Cumplimiento del RGPD

Respetamos tus derechos de privacidad bajo el GDPR:

• Derecho de acceso: Exporta todos tus datos en cualquier momento
• Derecho al olvido: Elimina tu cuenta y todos los datos asociados
• Portabilidad de datos: Exporta datos en formatos estándar (JSON, CSV)
• Privacidad por diseño: La privacidad se considera en todas las funciones
• Minimización de datos: Solo recopilamos los datos necesarios

Políticas de retención de datos

Políticas claras sobre cuánto tiempo conservamos tus datos:

• Cuentas activas: Datos retenidos mientras la cuenta esté activa
• Elementos eliminados: Eliminación temporal por 30 días, luego eliminación permanente
• Cuentas inactivas: Notificación después de 12 meses, eliminación después de 18 meses
• Cuentas con saldo negativo: Periodo de gracia de 90 días antes de la eliminación de datos
• Registros de auditoría: Retenidos por 1 año con fines de seguridad

Opciones de Exportación de Datos

Tus datos te pertenecen y puedes exportarlos en cualquier momento:

• Exportación completa de la cuenta: Todos los datos en un solo archivo ZIP
• Exportación selectiva: Elige proyectos específicos o rangos de fechas
• Múltiples formatos: JSON, CSV, PDF para diferentes tipos de datos
• Acceso a la API: Exportación programática a través de nuestra API REST
• Sin dependencia de proveedor: Los formatos estándar garantizan la portabilidad

Mejores prácticas de seguridad para usuarios

Ayúdanos a mantener tu cuenta segura:

• Contraseñas seguras: Usa contraseñas únicas y complejas
• Autenticación de dos factores: Habilita 2FA cuando esté disponible
• Gestión de tokens de API: Rota los tokens regularmente
• Monitorea el acceso: Revisa tus registros de actividad periódicamente
• Reporta problemas: Contáctanos inmediatamente si sospechas de acceso no autorizado