Dateienverwaltung
Mit der Brevo CRM Files API lädst du Dateianhänge hoch und verwaltest sie zu Kontakten, Unternehmen und Deals innerhalb der Tajo-Plattform.
Überblick
Dateienverwaltung ist essenziell für:
- Deal-Dokumentation mit Angeboten, Verträgen und Vereinbarungen
- Kundendatensätze mit Rechnungen, Belegen und Korrespondenz
- Loyalty-Programm-Materialien mit Programmdetails und Vorteilsübersichten
- Compliance mit Audit-Trails von Dokumenten für Enterprise-Konten
- Team-Zusammenarbeit durch gemeinsam genutzte Ressourcen im Sales-Team
Schnellstart
Datei hochladen
POST https://api.brevo.com/v3/crm/filesContent-Type: multipart/form-dataapi-key: YOUR_API_KEY
--boundaryContent-Disposition: form-data; name="file"; filename="enterprise-proposal.pdf"Content-Type: application/pdf
[file content]--boundaryContent-Disposition: form-data; name="dealIds"
deal_abc123def456--boundaryContent-Disposition: form-data; name="companyIds"
comp_123456789--boundaryContent-Disposition: form-data; name="contactIds"
12345--boundary--Antwort
{ "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"}Dateien abrufen
Alle Dateien auflisten
GET https://api.brevo.com/v3/crm/files?limit=50&offset=0&sort=descContent-Type: application/jsonapi-key: YOUR_API_KEYAntwort
{ "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}Dateien filtern
GET https://api.brevo.com/v3/crm/files?filters[dealIds]=deal_abc123def456&sort=created_at:descEinzelne Datei abrufen
GET https://api.brevo.com/v3/crm/files/{file_id}Content-Type: application/jsonapi-key: YOUR_API_KEYDatei herunterladen
GET https://api.brevo.com/v3/crm/files/{file_id}/dataapi-key: YOUR_API_KEYAutomatisierte Dateienverwaltung
Workflow für Deal-Dokumente
Verwalte Dokumente automatisch über den gesamten Deal-Lebenszyklus:
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] });
// Notiz mit Verweis auf das hochgeladene Angebot anlegen 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) }; }}Loyalty-Programm-Dokumente
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; }}Unterstützte Dateitypen
| Kategorie | Endungen | Maximalgröße |
|---|---|---|
| Dokumente | .pdf, .doc, .docx, .txt | 10 MB |
| Tabellen | .xls, .xlsx, .csv | 10 MB |
| Bilder | .png, .jpg, .jpeg, .gif | 5 MB |
| Präsentationen | .ppt, .pptx | 10 MB |
API-Methoden-Referenz
// Datei hochladenconst file = await filesApi.uploadFile({ file: fileBuffer, fileName: 'proposal.pdf', dealIds: ['deal_abc123'], companyIds: ['comp_123']});
// Datei-Metadaten abrufenconst file = await filesApi.getFile('file_001');
// Datei herunterladenconst fileData = await filesApi.downloadFile('file_001');
// Datei löschenawait filesApi.deleteFile('file_001');
// Dateien mit Filtern auflistenconst files = await filesApi.getFiles({ filters: { dealIds: 'deal_abc123' }, sort: 'created_at:desc', limit: 50});Best Practices
- Benennungskonventionen: Nutze sprechende Dateinamen mit Datum für leichte Wiedererkennung
- Datensätze verknüpfen: Verbinde Dateien mit allen relevanten Deals, Unternehmen und Kontakten
- Versionsverwaltung: Nimm Versionsnummern oder Daten in den Dateinamen mit auf
- Größenmanagement: Komprimiere große Dateien vor dem Upload
- Zugriffskontrolle: Prüfe Datei-Verknüpfungen regelmäßig, damit Zugriffe sauber bleiben
- Aufräumen: Entferne veraltete Dokumente, damit CRM-Datensätze überschaubar bleiben
Fehlerbehandlung
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); }}Nächste Schritte
- Unternehmensverwaltung – Firmenkonten verwalten
- Deal-Management – Sales-Pipeline verfolgen
- Aufgabenverwaltung – Vertriebsaktivitäten verwalten
- Notizen – Kundeninteraktionen dokumentieren