---
title: "Quản lý ghi chú | Tajo"
description: "Tạo và quản lý ghi chú khách hàng cùng hồ sơ tương tác trong Brevo CRM cho Tajo"
url: https://tajo.io/vi/docs/sales-crm/notes/
markdown: https://tajo.io/vi/docs/sales-crm/notes.md
lang: vi-VN
author: "Set Noa"
author_url: https://tajo.io/vi/set-noa/
robots: noindex
---

Đăng ký quyền truy cập sớm

Nhập tên và địa chỉ email công việc của bạn. Chúng tôi sẽ gửi liên kết để xác nhận yêu cầu truy cập Tajo.

# Quản lý ghi chú

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

Brevo CRM Notes API cho phép bạn ghi lại các tương tác với khách hàng, tóm tắt cuộc họp và những chi tiết quan trọng gắn với liên hệ, công ty và thương vụ trong nền tảng Tajo.

## Tổng quan

Quản lý ghi chú là thiết yếu cho:

- **Lịch sử tương tác** ghi lại các cuộc trò chuyện với khách hàng và kết quả cuộc họp
- **Cộng tác nhóm** chia sẻ bối cảnh về các tài khoản trong toàn đội ngũ bán hàng của bạn
- **Tài liệu thương vụ** ghi lại chi tiết đàm phán và các quyết định
- **Ghi chú chương trình khách hàng thân thiết** theo dõi sở thích của khách hàng và phản hồi về chương trình
- **Hồ sơ tuân thủ** duy trì dấu vết kiểm toán cho các trao đổi với khách hàng

## Bắt đầu nhanh

### Tạo ghi chú

```http
POST https://api.brevo.com/v3/crm/notes
Content-Type: application/json
api-key: YOUR_API_KEY

{
  "text": "Met with Acme Corp to discuss enterprise loyalty program upgrade. They're interested in Diamond tier benefits and want to consolidate all 12 locations under a single account. Key decision maker is VP of Operations. Follow up with volume discount proposal by end of week.",
  "contactIds": [12345],
  "dealIds": ["deal_abc123def456"],
  "companyIds": ["comp_123456789"]
}
```

### Phản hồi

```json
{
  "id": "note_001",
  "text": "Met with Acme Corp to discuss enterprise loyalty program upgrade...",
  "contactIds": [12345],
  "dealIds": ["deal_abc123def456"],
  "companyIds": ["comp_123456789"],
  "created_at": "2026-01-25T14:30:00Z",
  "updated_at": "2026-01-25T14:30:00Z"
}
```

## Lấy ghi chú

### Liệt kê tất cả ghi chú

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

### Phản hồi

```json
{
  "items": [
    {
      "id": "note_001",
      "text": "Met with Acme Corp to discuss enterprise loyalty program upgrade...",
      "contactIds": [12345],
      "dealIds": ["deal_abc123def456"],
      "companyIds": ["comp_123456789"],
      "created_at": "2026-01-25T14:30:00Z"
    }
  ],
  "total": 1
}
```

### Lọc ghi chú

```http
GET https://api.brevo.com/v3/crm/notes?filters[companyIds]=comp_123456789&sort=created_at:desc
```

### Lấy một ghi chú

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

## Tạo ghi chú tự động

### Ghi chú dựa trên hoạt động

Tạo ghi chú tự động từ các hoạt động CRM:

```javascript
class NoteAutomation {
  constructor() {
    this.notesApi = new NotesApi();
  }

  async logDealStageChange(deal, oldStage, newStage) {
    const noteText = [
      `Deal stage changed: ${oldStage} → ${newStage}`,
      `Deal value: $${deal.attributes.amount?.toLocaleString()}`,
      `Probability: ${deal.attributes.probability}%`,
      newStage === 'Closed Won'
        ? `Loyalty points awarded: ${deal.attributes.loyalty_points_bonus}`
        : '',
      `Updated by: ${deal.attributes.deal_owner}`
    ].filter(Boolean).join('\n');

    return await this.notesApi.createNote({
      text: noteText,
      dealIds: [deal.id],
      companyIds: deal.attributes.company_id ? [deal.attributes.company_id] : [],
      contactIds: deal.attributes.contact_id ? [deal.attributes.contact_id] : []
    });
  }

  async logLoyaltyTierChange(company, oldTier, newTier) {
    const noteText = [
      `Loyalty tier upgraded: ${oldTier} → ${newTier}`,
      `Annual spend: $${company.attributes.annual_spend?.toLocaleString()}`,
      `New benefits: ${this.getTierBenefits(newTier).join(', ')}`,
      `Account manager notified: ${company.attributes.account_manager}`
    ].join('\n');

    return await this.notesApi.createNote({
      text: noteText,
      companyIds: [company.id]
    });
  }

  async logCustomerFeedback(contactId, feedback) {
    const noteText = [
      `Customer feedback received:`,
      `Category: ${feedback.category}`,
      `Rating: ${feedback.rating}/5`,
      `Comment: ${feedback.comment}`,
      feedback.loyaltyRelated ? `Loyalty program feedback: ${feedback.loyaltyComment}` : ''
    ].filter(Boolean).join('\n');

    return await this.notesApi.createNote({
      text: noteText,
      contactIds: [contactId]
    });
  }
}
```

### Ghi chú tóm tắt cuộc họp

```javascript
class MeetingNotes {
  async createMeetingSummary(meetingData) {
    const noteText = [
      `Meeting: ${meetingData.title}`,
      `Date: ${new Date(meetingData.date).toLocaleDateString()}`,
      `Attendees: ${meetingData.attendees.join(', ')}`,
      '',
      '## Discussion Points',
      ...meetingData.topics.map(t => `- ${t}`),
      '',
      '## Action Items',
      ...meetingData.actions.map(a => `- [ ] ${a.description} (${a.assignee}, due ${a.dueDate})`),
      '',
      '## Next Steps',
      meetingData.nextSteps
    ].join('\n');

    return await this.notesApi.createNote({
      text: noteText,
      contactIds: meetingData.contactIds || [],
      dealIds: meetingData.dealIds || [],
      companyIds: meetingData.companyIds || []
    });
  }
}
```

## Tham chiếu các phương thức API

```javascript
// Create a note
const note = await notesApi.createNote({
  text: 'Customer interested in premium loyalty tier',
  contactIds: [12345],
  dealIds: ['deal_abc123']
});

// Get note by ID
const note = await notesApi.getNote('note_001');

// Update note
await notesApi.updateNote('note_001', {
  text: 'Updated: Customer confirmed interest in premium loyalty tier. Meeting scheduled for next week.'
});

// Delete note
await notesApi.deleteNote('note_001');

// List notes with filtering
const notes = await notesApi.getNotes({
  filters: { companyIds: 'comp_123456789' },
  sort: 'created_at:desc',
  limit: 50
});
```

## Thực hành tốt nhất

1. **Hãy cụ thể**: Đưa vào các chi tiết liên quan như số tiền, ngày tháng và bước tiếp theo
2. **Liên kết bản ghi**: Gắn ghi chú với tất cả liên hệ, thương vụ và công ty liên quan
3. **Tự động hóa việc ghi nhật ký**: Tạo ghi chú tự động cho các thay đổi giai đoạn và sự kiện quan trọng
4. **Dùng định dạng nhất quán**: Áp dụng một cấu trúc ghi chú chung cho cả đội khi tóm tắt cuộc họp
5. **Ghi chép kịp thời**: Tạo ghi chú ngay sau mỗi tương tác khi chi tiết còn mới

## Xử lý lỗi

```javascript
try {
  const note = await notesApi.createNote(noteData);
  console.log('Note created:', note.id);
} catch (error) {
  if (error.status === 400) {
    console.error('Invalid note data:', error.message);
  } else if (error.status === 404) {
    console.error('Associated contact, deal, or company not found');
  } else {
    console.error('Unexpected error:', error);
  }
}
```

## Bước tiếp theo

- **[Quản lý công ty](https://tajo.io/vi/docs/sales-crm/companies)** - Quản lý các tài khoản doanh nghiệp
- **[Quản lý thương vụ](https://tajo.io/vi/docs/sales-crm/deals)** - Theo dõi quy trình bán hàng
- **[Quản lý công việc](https://tajo.io/vi/docs/sales-crm/tasks)** - Quản lý các hoạt động bán hàng
- **[Tệp](https://tajo.io/vi/docs/sales-crm/files)** - Quản lý tệp đính kèm của thương vụ