Bài 5 — Ghi log CRM chuẩn

Agent research và viết hay tới đâu mà không ghi CRM đúng thì đội sales không tin, không dùng lại được. CRM là bộ nhớ dài hạn của cả team. Bài này chuẩn hóa cách agent ghi.

Ba thứ agent phải ghi mỗi lead

• Contact/Company record: upsert (không tạo trùng), điền các trường chuẩn hóa (industry, size, nguồn).
• Activity/Note: research_brief tóm tắt + nội dung outreach đã gửi + timestamp.
• Deal/Stage: tạo hoặc cập nhật deal về đúng giai đoạn (vd "Contacted").

Nguyên tắc upsert (find-or-create)

def crm_upsert_contact(email, props):
    existing = crm.search(email=email)
    if existing:
        crm.update(existing.id, props)   # cập nhật, không tạo mới
        return existing.id
    return crm.create(props).id

Email là khóa tự nhiên tốt nhất để chống trùng. Nếu thiếu email, dùng domain + tên.

Log activity có cấu trúc

Đừng ghi một cục text. Ghi theo template để sau lọc/báo cáo được:

[AGENT] Outreach #1 sent — 2026-07-10 09:12
Channel: email
ICP fit: true | Industry: F&B | Size: 200-500
Signal used: tuyển 3 vị trí e-commerce
Subject: 3 vị trí e-commerce ở ABC Foods
Status: queued_for_human_review
Sources: https://... (tin tuyển dụng)

Dòng [AGENT] giúp phân biệt hành động của agent với của người — quan trọng khi audit.

Chuẩn hóa trường trước khi ghi

Agent phải map dữ liệu tự do về giá trị chuẩn của CRM (picklist). Ví dụ industry: "đồ ăn", "thực phẩm", "F&B" → đều map về F&B. Nếu không, CRM đầy giá trị lộn xộn không lọc được.

{
  "industry_map": {
    "đồ ăn": "F&B", "thực phẩm": "F&B", "food": "F&B",
    "ngân hàng": "Finance", "fintech": "Finance"
  }
}

Khung tư duy: "Người kế nhiệm test"

Hãy tưởng tượng 3 tháng sau, một sales khác mở record này. Họ có hiểu đã làm gì, vì sao, bước tiếp là gì chỉ bằng cách đọc log không? Nếu không, log của bạn thiếu. Log tốt = tự-giải-thích.

Các bước triển khai

• Định nghĩa danh sách trường bắt buộc mỗi contact/deal.
• Viết bảng map chuẩn hóa cho các picklist chính (industry, source, stage).
• Bọc mọi thao tác ghi bằng upsert idempotent.
• Chuẩn template note có tiền tố [AGENT] và timestamp.
• Ghi cả nguồn (URL) của research để audit được.
• Ghi trạng thái outreach (queued / sent / replied) để bước next-action dùng.

Checklist ghi CRM

• [ ] Upsert theo email, không tạo contact trùng.
• [ ] Mọi picklist đã chuẩn hóa về giá trị hợp lệ.
• [ ] Note có tiền tố [AGENT], timestamp, và nguồn.
• [ ] Deal ở đúng stage, không nhảy stage sai.
• [ ] Trạng thái outreach được ghi để tự động follow-up.
• [ ] Không ghi đè dữ liệu người thật đã nhập tay (ưu tiên giữ).

Sai lầm thường gặp

• Tạo contact trùng: không upsert → CRM phình rác, báo cáo sai. Luôn find-or-create.
• Ghi đè trường người đã sửa tay: agent đè lên ghi chú của sales thật. Chỉ ghi vào trường agent sở hữu, hoặc chỉ append note.
• Note kể lể lan man: khó lọc. Dùng template có cấu trúc.
• Không chuẩn hóa picklist: 20 cách viết industry → không phân khúc được tệp.
• Nhảy deal lên stage cao (vd "Qualified") khi mới chỉ gửi email → dự báo doanh số ảo.
• Không đánh dấu hành động của agent: sau này không biết ai/cái gì đã đụng vào record.