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/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--

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=desc
Content-Type: application/json
api-key: YOUR_API_KEY

Antwort

{
"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:desc

Einzelne Datei abrufen

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

Datei herunterladen

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

Automatisierte 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

KategorieEndungenMaximalgröße
Dokumente.pdf, .doc, .docx, .txt10 MB
Tabellen.xls, .xlsx, .csv10 MB
Bilder.png, .jpg, .jpeg, .gif5 MB
Präsentationen.ppt, .pptx10 MB

API-Methoden-Referenz

// Datei hochladen
const file = await filesApi.uploadFile({
file: fileBuffer,
fileName: 'proposal.pdf',
dealIds: ['deal_abc123'],
companyIds: ['comp_123']
});
// Datei-Metadaten abrufen
const file = await filesApi.getFile('file_001');
// Datei herunterladen
const fileData = await filesApi.downloadFile('file_001');
// Datei löschen
await filesApi.deleteFile('file_001');
// Dateien mit Filtern auflisten
const files = await filesApi.getFiles({
filters: { dealIds: 'deal_abc123' },
sort: 'created_at:desc',
limit: 50
});

Best Practices

  1. Benennungskonventionen: Nutze sprechende Dateinamen mit Datum für leichte Wiedererkennung
  2. Datensätze verknüpfen: Verbinde Dateien mit allen relevanten Deals, Unternehmen und Kontakten
  3. Versionsverwaltung: Nimm Versionsnummern oder Daten in den Dateinamen mit auf
  4. Größenmanagement: Komprimiere große Dateien vor dem Upload
  5. Zugriffskontrolle: Prüfe Datei-Verknüpfungen regelmäßig, damit Zugriffe sauber bleiben
  6. 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

Subscribe to updates

developer-docs

Drop your email or phone number — we'll send you what matters next.

auto-detect
AI-Assistent

Hallo! Fragen Sie mich alles über die Dokumentation.