---
title: "فائلوں کا انتظام | Tajo"
description: "Tajo کی ڈیل دستاویزات کے لیے Brevo CRM میں فائل اٹیچمنٹس اپ لوڈ اور منظم کریں"
url: https://tajo.io/ur/docs/sales-crm/files/
markdown: https://tajo.io/ur/docs/sales-crm/files.md
lang: ur-PK
author: "Set Noa"
author_url: https://tajo.io/ur/set-noa/
robots: noindex
---

ابتدائی رسائی کی درخواست کریں

اپنا پہلا نام اور دفتری ای میل پتہ درج کریں۔ ہم Tajo تک رسائی کی درخواست کی تصدیق کے لیے ایک لنک ای میل کریں گے۔

# فائلوں کا انتظام

[Set Noa](https://tajo.io/ur/set-noa/)

Brevo CRM Files API آپ کو Tajo پلیٹ فارم کے اندر رابطوں، کمپنیوں اور ڈیلز سے منسلک فائل اٹیچمنٹس اپ لوڈ اور منظم کرنے کی سہولت دیتا ہے۔

## جائزہ

فائلوں کا انتظام ان کے لیے ضروری ہے:

- **ڈیل کی دستاویزات** تجاویز، معاہدے اور اقرار نامے محفوظ کرنا
- **گاہکوں کے ریکارڈ** انوائسز، رسیدیں اور خط و کتابت منسلک کرنا
- **لائلٹی پروگرام کا مواد** پروگرام کی تفصیلات اور فوائد کے خلاصے شیئر کرنا
- **تعمیل** انٹرپرائز اکاؤنٹس کے لیے دستاویزات کا آڈٹ ریکارڈ برقرار رکھنا
- **ٹیم کا تعاون** سیلز ٹیم کے ارکان کے درمیان وسائل شیئر کرنا

## فوری آغاز

### فائل اپ لوڈ کریں

```http
POST https://api.brevo.com/v3/crm/files
Content-Type: multipart/form-data
api-key: YOUR_API_KEY

--boundary
Content-Disposition: form-data; name="file"; filename="enterprise-proposal.pdf"
Content-Type: application/pdf

[file content]
--boundary
Content-Disposition: form-data; name="dealIds"

deal_abc123def456
--boundary
Content-Disposition: form-data; name="companyIds"

comp_123456789
--boundary
Content-Disposition: form-data; name="contactIds"

12345
--boundary--
```

### جواب

```json
{
  "id": "file_001",
  "name": "enterprise-proposal.pdf",
  "size": 245760,
  "contentType": "application/pdf",
  "dealIds": ["deal_abc123def456"],
  "companyIds": ["comp_123456789"],
  "contactIds": [12345],
  "created_at": "2026-01-25T14:30:00Z"
}
```

## فائلیں حاصل کریں

### تمام فائلوں کی فہرست

```http
GET https://api.brevo.com/v3/crm/files?limit=50&offset=0&sort=desc
Content-Type: application/json
api-key: YOUR_API_KEY
```

### جواب

```json
{
  "items": [
    {
      "id": "file_001",
      "name": "enterprise-proposal.pdf",
      "size": 245760,
      "contentType": "application/pdf",
      "dealIds": ["deal_abc123def456"],
      "companyIds": ["comp_123456789"],
      "created_at": "2026-01-25T14:30:00Z"
    }
  ],
  "total": 1
}
```

### فائلیں فلٹر کریں

```http
GET https://api.brevo.com/v3/crm/files?filters[dealIds]=deal_abc123def456&sort=created_at:desc
```

### ایک فائل حاصل کریں

```http
GET https://api.brevo.com/v3/crm/files/{file_id}
Content-Type: application/json
api-key: YOUR_API_KEY
```

### فائل ڈاؤن لوڈ کریں

```http
GET https://api.brevo.com/v3/crm/files/{file_id}/data
api-key: YOUR_API_KEY
```

## فائل مینجمنٹ کی آٹومیشن

### ڈیل دستاویز کا ورک فلو

ڈیل کے پورے دورانیے میں دستاویزات خودکار طور پر منظم کریں:

```javascript
class DealDocumentManager {
  constructor() {
    this.filesApi = new FilesApi();
  }

  async attachProposal(dealId, proposalBuffer, companyName) {
    const fileName = `proposal-${companyName.toLowerCase().replace(/\s+/g, '-')}-${Date.now()}.pdf`;

    const file = await this.filesApi.uploadFile({
      file: proposalBuffer,
      fileName: fileName,
      dealIds: [dealId]
    });

    // Create a note referencing the uploaded proposal
    await this.notesApi.createNote({
      text: `Proposal uploaded: ${fileName}`,
      dealIds: [dealId]
    });

    return file;
  }

  async attachContract(dealId, contractBuffer, companyId) {
    const fileName = `contract-${dealId}-${new Date().toISOString().slice(0, 10)}.pdf`;

    const file = await this.filesApi.uploadFile({
      file: contractBuffer,
      fileName: fileName,
      dealIds: [dealId],
      companyIds: [companyId]
    });

    return file;
  }

  async getDealDocuments(dealId) {
    const files = await this.filesApi.getFiles({
      filters: { dealIds: dealId },
      sort: 'created_at:desc'
    });

    return {
      proposals: files.items.filter(f => f.name.startsWith('proposal-')),
      contracts: files.items.filter(f => f.name.startsWith('contract-')),
      other: files.items.filter(f =>
        !f.name.startsWith('proposal-') && !f.name.startsWith('contract-')
      ),
      totalSize: files.items.reduce((sum, f) => sum + f.size, 0)
    };
  }
}
```

### لائلٹی پروگرام کی دستاویزات

```javascript
class LoyaltyDocumentManager {
  async generateAndAttachBenefitsSummary(companyId, tier) {
    const company = await this.companiesApi.getCompany(companyId);

    const summary = await this.generateBenefitsPDF({
      companyName: company.name,
      tier: tier,
      benefits: this.getTierBenefits(tier),
      annualSpend: company.attributes.annual_spend,
      pointsBalance: company.attributes.loyalty_points
    });

    return await this.filesApi.uploadFile({
      file: summary,
      fileName: `loyalty-benefits-${tier.toLowerCase().replace(/\s+/g, '-')}.pdf`,
      companyIds: [companyId]
    });
  }

  async attachTierUpgradeDocuments(companyId, oldTier, newTier) {
    const documents = [
      { name: 'tier-upgrade-confirmation', content: this.generateUpgradeConfirmation(oldTier, newTier) },
      { name: 'new-benefits-guide', content: this.generateBenefitsGuide(newTier) }
    ];

    const uploaded = [];
    for (const doc of documents) {
      const file = await this.filesApi.uploadFile({
        file: doc.content,
        fileName: `${doc.name}-${Date.now()}.pdf`,
        companyIds: [companyId]
      });
      uploaded.push(file);
    }

    return uploaded;
  }
}
```

## معاون فائل اقسام

| زمرہ | ایکسٹینشنز | زیادہ سے زیادہ سائز |
| --- | --- | --- |
| دستاویزات | `.pdf`، `.doc`، `.docx`، `.txt` | 10 MB |
| اسپریڈ شیٹس | `.xls`، `.xlsx`، `.csv` | 10 MB |
| تصاویر | `.png`، `.jpg`، `.jpeg`، `.gif` | 5 MB |
| پریزنٹیشنز | `.ppt`، `.pptx` | 10 MB |

## API طریقوں کا حوالہ

```javascript
// Upload a file
const file = await filesApi.uploadFile({
  file: fileBuffer,
  fileName: 'proposal.pdf',
  dealIds: ['deal_abc123'],
  companyIds: ['comp_123']
});

// Get file metadata
const file = await filesApi.getFile('file_001');

// Download file data
const fileData = await filesApi.downloadFile('file_001');

// Delete file
await filesApi.deleteFile('file_001');

// List files with filtering
const files = await filesApi.getFiles({
  filters: { dealIds: 'deal_abc123' },
  sort: 'created_at:desc',
  limit: 50
});
```

## بہترین طریقے

1. **نام دینے کے اصول**: آسان شناخت کے لیے تاریخ سمیت وضاحتی فائل نام استعمال کریں
2. **ریکارڈ سے جوڑیں**: فائلوں کو تمام متعلقہ ڈیلز، کمپنیوں اور رابطوں سے منسلک کریں
3. **ورژن کا انتظام**: فائل کے ناموں میں ورژن نمبر یا تاریخیں شامل کریں
4. **سائز کا انتظام**: بڑی فائلیں اپ لوڈ کرنے سے پہلے کمپریس کریں
5. **رسائی کا کنٹرول**: مناسب رسائی یقینی بنانے کے لیے فائل کے تعلقات کا باقاعدہ جائزہ لیں
6. **صفائی**: CRM ریکارڈ قابلِ انتظام رکھنے کے لیے پرانی دستاویزات ہٹا دیں

## غلطیوں کا انتظام

```javascript
try {
  const file = await filesApi.uploadFile(fileData);
  console.log('File uploaded:', file.id);
} catch (error) {
  if (error.status === 400) {
    console.error('Invalid file data:', error.message);
  } else if (error.status === 413) {
    console.error('File size exceeds maximum limit');
  } else if (error.status === 415) {
    console.error('Unsupported file type');
  } else {
    console.error('Unexpected error:', error);
  }
}
```

## اگلے اقدامات

- **[کمپنیوں کا انتظام](https://tajo.io/ur/docs/sales-crm/companies)** - کارپوریٹ اکاؤنٹس منظم کریں
- **[ڈیلز کا انتظام](https://tajo.io/ur/docs/sales-crm/deals)** - سیلز پائپ لائن ٹریک کریں
- **[ٹاسک مینجمنٹ](https://tajo.io/ur/docs/sales-crm/tasks)** - سیلز کی سرگرمیاں منظم کریں
- **[نوٹس](https://tajo.io/ur/docs/sales-crm/notes)** - گاہکوں کے تعاملات کو دستاویزی شکل دیں