Solicita acceso anticipado

Indica tu nombre y un email o número de teléfono. Nos pondremos en contacto contigo para darte los detalles de acceso a Tajo.

En esta página

Gestión de archivos

La API de archivos del CRM de Brevo te permite subir y gestionar los archivos adjuntos asociados a contactos, empresas y negocios dentro de la plataforma Tajo.

Resumen

La gestión de archivos es imprescindible para:

  • Documentar negocios, guardando propuestas, contratos y acuerdos
  • Fichas de cliente, adjuntando facturas, recibos y correspondencia
  • Materiales del programa de fidelización, compartiendo los detalles del programa y los resúmenes de beneficios
  • Cumplimiento normativo, manteniendo el rastro documental de las cuentas Enterprise
  • Colaboración del equipo, compartiendo recursos entre los comerciales

Inicio rápido

Subir un archivo 

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

Respuesta 

{
  "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"
}

Obtener archivos

Listar todos los archivos 

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

Respuesta 

{
  "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
}

Filtrar archivos 

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

Obtener un solo archivo 

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

Descargar un archivo 

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

Automatización de la gestión de archivos

Flujo de trabajo documental de un negocio

Gestiona los documentos de forma automática durante todo el ciclo de vida del negocio:

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)
    };
  }
}

Documentos del programa de fidelización 

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;
  }
}

Tipos de archivo admitidos

CategoríaExtensionesTamaño máximo
Documentos.pdf, .doc, .docx, .txt10 MB
Hojas de cálculo.xls, .xlsx, .csv10 MB
Imágenes.png, .jpg, .jpeg, .gif5 MB
Presentaciones.ppt, .pptx10 MB

Referencia de métodos de la API 

// 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
});

Buenas prácticas

  1. Convenciones de nomenclatura: usa nombres descriptivos con fecha para identificar los archivos de un vistazo
  2. Enlaza los registros: asocia cada archivo con todos los negocios, empresas y contactos relacionados
  3. Control de versiones: incluye el número de versión o la fecha en el nombre del archivo
  4. Control del tamaño: comprime los archivos grandes antes de subirlos
  5. Control de acceso: revisa las asociaciones de archivos con regularidad para garantizar el acceso correcto
  6. Limpieza: elimina los documentos obsoletos para que los registros del CRM sigan siendo manejables

Gestión de errores 

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);
  }
}

Próximos pasos

Solicita acceso anticipado

Indica tu nombre y un email o número de teléfono. Nos pondremos en contacto contigo para darte los detalles de acceso a Tajo.

detección automática
Asistente AI

¡Hola! Pregúntame lo que quieras sobre la documentación.