---

Resumen de Plantillas

Blue admite dos tipos de plantillas:

• Plantillas de Empresa: Creadas por tu organización para uso interno
• Plantillas Oficiales: Creadas por Blue para todos los usuarios (plantillas estándar de la industria)

Las plantillas preservan toda la estructura del proyecto, incluidos los pendientes, listas, campos personalizados, automatizaciones y más.

Listar Plantillas

Usando la consulta de plantillas

query GetTemplates {
  templates(
    companyId: "company-123"
    isOfficialTemplate: false
    category: MARKETING
  ) {
    id
    name
    description
    category
    isOfficialTemplate
    icon
    color
    image {
      thumbnail
      small
    }
  }
}

Usando projectList con Filtro de Plantilla

query ListTemplates {
  projectList(
    filter: {
      companyIds: ["company-id"]
      isTemplate: true
    }
    sort: [updatedAt_DESC]
    take: 20
    skip: 0
  ) {
    items {
      id
      slug
      name
      description
      category
      isTemplate
      isOfficialTemplate
      color
      icon
      createdAt
      updatedAt
    }
    pageInfo {
      hasNextPage
      totalItems
    }
    totalCount
  }
}

Crear Proyecto a partir de Plantilla

Para crear un nuevo proyecto a partir de una plantilla existente:

mutation CreateFromTemplate {
  createProject(
    input: {
      templateId: "template-id-or-slug"
      name: "Q1 Marketing Campaign"
      companyId: "company-id"
      description: "Marketing initiatives for Q1"
      color: "#10B981"
    }
  ) {
    id
    name
    slug
  }
}

Convertir Proyecto a Plantilla

Transforma un proyecto existente en una plantilla reutilizable:

mutation ConvertToTemplate {
  convertProjectToTemplate(
    input: {
      projectId: "project-123"
      isOfficialTemplate: false
    }
  ) {
    id
    name
    isTemplate
    isOfficialTemplate
  }
}

Eliminar Estado de Plantilla

Convierte una plantilla de nuevo a un proyecto regular:

mutation RemoveTemplateStatus {
  removeProjectFromTemplates(projectId: "template-123") {
    id
    name
    isTemplate
  }
}

Obtener Plantilla Única

Recupera detalles sobre una plantilla específica:

query GetTemplate {
  template(templateId: "template-123") {
    id
    name
    description
    category
    isOfficialTemplate
    todoLists {
      name
      todos {
        title
      }
    }
  }
}

Parámetros de Consulta

Consulta de plantillas

Parámetro	Tipo	Requerido	Descripción
companyId	String	No	Filtrar plantillas por empresa. Omitir para ver plantillas oficiales.
isOfficialTemplate	Boolean	No	Mostrar solo plantillas oficiales de Blue
category	ProjectCategory	No	Filtrar por categoría de proyecto

Entrada convertProjectToTemplate

Parámetro	Tipo	Requerido	Descripción
projectId	String!	✅ Sí	El proyecto a convertir en una plantilla
isOfficialTemplate	Boolean!	✅ Sí	Marcar como plantilla oficial (solo empleados de Blue)

Categorías de Plantilla

Valor	Descripción
CRM	Gestión de Relaciones con Clientes
CROSS_FUNCTIONAL	Proyectos de equipos multifuncionales
CUSTOMER_SUCCESS	Iniciativas de éxito del cliente
DESIGN	Proyectos de diseño y creatividad
ENGINEERING	Ingeniería y desarrollo
GENERAL	Proyectos generales (predeterminado)
HR	Recursos Humanos
IT	Tecnología de la Información
MARKETING	Campañas de marketing
OPERATIONS	Operaciones y logística
PRODUCT	Gestión de productos
SALES	Ventas y desarrollo de negocios

Qué se Copia de las Plantillas

Al crear un proyecto a partir de una plantilla, se copia lo siguiente:

• ✅ Estructura: Todas las listas de tareas y tareas con sus posiciones
• ✅ Contenido: Descripciones, comentarios y archivos adjuntos
• ✅ Organización: Etiquetas, rótulos y campos personalizados
• ✅ Automatización: Todas las reglas y flujos de trabajo de automatización
• ✅ Formularios: Formularios del proyecto y sus configuraciones
• ✅ Documentos: Páginas de wiki y documentación
• ✅ Configuraciones: Configuraciones de portada y preferencias de visualización
• ✅ Roles: Definiciones de roles de usuario (pero no asignaciones de usuario)

No se copia:

• ❌ Asignaciones de usuario (excepto el creador)
• ❌ Historial de actividad
• ❌ Datos de seguimiento de tiempo
• ❌ Estado completado de las tareas

Permisos Requeridos

Creando Plantillas

Acción	Rol Requerido
Convert project to template	Project OWNER or ADMIN
Create official template	Blue employee only
Remove template status	Project OWNER or ADMIN

Usando Plantillas

Tipo de Plantilla	Quién Puede Usar
Company templates	Users in the same company
Official templates	All Blue users

Respuestas de Error

Plantilla No Encontrada

{
  "errors": [{
    "message": "Template not found",
    "extensions": {
      "code": "TEMPLATE_NOT_FOUND"
    }
  }]
}

Demasiados Todos

{
  "errors": [{
    "message": "This project has more than 250,000 todos and cannot be used as a template",
    "extensions": {
      "code": "TOO_MANY_TODOS"
    }
  }]
}

Notas Importantes

• Límite de Tamaño: Los proyectos con más de 250,000 tareas no pueden usarse como plantillas
• Copia Asíncrona: El contenido de la plantilla se copia en segundo plano a través de una cola de trabajos
• Estado de Archivo: Convertir a plantilla desarchiva automáticamente el proyecto
• Eliminación de Carpeta: Las plantillas se eliminan de las carpetas cuando se convierten
• Control de Acceso: Las plantillas oficiales son visibles para todos, las plantillas de empresa solo para miembros
• Actualizaciones en Tiempo Real: Suscríbete a los cambios de plantilla usando la suscripción subscribeToProject