> ## Documentation Index
> Fetch the complete documentation index at: https://agentbase.vn/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Thu thập khách hàng tiềm năng

> Tự động hiển thị form thu thập thông tin liên hệ trong cuộc trò chuyện — tên, email, số điện thoại — và lưu vào danh sách leads.

Hành động Thu thập khách hàng tiềm năng (Collect Leads) cho phép agent tự động hiển thị form thu thập thông tin liên hệ vào đúng thời điểm trong cuộc trò chuyện. Thông tin được lưu lại và có thể xem, xuất, hoặc đẩy tới CRM qua webhook.

## Thêm hành động

<Steps>
  <Step title="Mở trang Hành động">
    Vào **Sidebar → Hành động**, nhấn **Thêm hành động** → chọn **Thu thập khách hàng tiềm năng**.
  </Step>

  <Step title="Cấu hình form">
    Điền các thông tin cài đặt (xem chi tiết từng mục bên dưới).
  </Step>

  <Step title="Kiểm tra trong Playground">
    Dùng tính năng xem trước ngay trên trang cấu hình, hoặc vào **Playground** để thử kịch bản thực tế.
  </Step>

  <Step title="Bật hành động">
    Bật switch **Kích hoạt** để hành động có hiệu lực với khách hàng thực.
  </Step>
</Steps>

## Cấu hình

### Thời điểm hiển thị (Instructions)

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/agent/actions-collect-leads-timing.png" alt="Cấu hình thời điểm hiển thị form" />
</Frame>

Nhập hướng dẫn cho agent về **khi nào** nên hiển thị form. Đây là phần quan trọng nhất quyết định trải nghiệm khách hàng.

**Ví dụ hướng dẫn:**

```text theme={null}
Hiển thị form khi khách hàng hỏi về giá, muốn được tư vấn, hoặc sau khi trả lời 3 tin nhắn.
```

```text theme={null}
Chỉ hiển thị form sau khi giải thích xong về sản phẩm và khách hàng tỏ ra quan tâm.
```

```text theme={null}
Hiển thị form ngay đầu cuộc trò chuyện trước khi trả lời.
```

**Nguyên tắc viết hướng dẫn tốt:**

* Dùng ngôn ngữ ngắn gọn, rõ ràng
* Bắt đầu bằng động từ hành động: "Hiển thị khi...", "Thu thập sau khi..."
* Cung cấp ví dụ về tình huống cụ thể
* Tránh điều kiện quá phức tạp hoặc mâu thuẫn

<Tip>
  Thêm vào system prompt của agent câu: **"Khi thu thập thông tin, chỉ hiển thị form — không liệt kê các trường thông tin bằng văn bản."** Điều này tránh agent nhắc lại nội dung form bằng lời.
</Tip>

### Các trường thông tin

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/agent/actions-collect-leads-fields.png" alt="Cấu hình trường thông tin form" />
</Frame>

Có 3 trường có thể bật hoặc tắt:

| Trường            | Mô tả                     | Mặc định |
| ----------------- | ------------------------- | -------- |
| **Họ và tên**     | Tên đầy đủ của khách hàng | Bật      |
| **Email**         | Địa chỉ email             | Bật      |
| **Số điện thoại** | Số điện thoại liên hệ     | Tắt      |

Mỗi trường có thể được đánh dấu là **Bắt buộc** hoặc **Tùy chọn**.

<Info>
  Giới hạn tối đa **3 trường** trên mỗi form. Số trường ít hơn thường dẫn đến tỷ lệ điền form cao hơn — chỉ hỏi những gì thực sự cần thiết.
</Info>

### Tin nhắn sau khi gửi

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/agent/actions-collect-leads-messages.png" alt="Tin nhắn xác nhận" />
</Frame>

Tùy chỉnh nội dung agent phản hồi trong 2 tình huống:

| Tình huống         | Mô tả                          | Ví dụ                                                     |
| ------------------ | ------------------------------ | --------------------------------------------------------- |
| **Gửi thành công** | Khách hàng đã điền và gửi form | "Cảm ơn! Chúng tôi sẽ liên hệ với bạn trong vòng 24 giờ." |
| **Bỏ qua form**    | Khách hàng nhấn nút bỏ qua     | "Không sao! Bạn có thể để lại thông tin bất kỳ lúc nào."  |

## Xem và quản lý leads

Tất cả leads thu thập được hiển thị tại **Hoạt động → Leads**.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/agent/actions-collect-leads-list.png" alt="Danh sách leads" />
</Frame>

Từ trang Leads, bạn có thể:

* Xem danh sách đầy đủ với thông tin liên hệ và thời gian gửi.
* Lọc theo khoảng thời gian.
* **Xuất CSV** để import vào CRM, Google Sheets, hoặc công cụ marketing.
* Nhấn vào từng lead để xem cuộc hội thoại liên quan.

## Tích hợp với hệ thống ngoài

Dùng **Webhooks** (trong **Cài đặt Agent → Webhooks**) để tự động đẩy lead mới đến hệ thống của bạn ngay lập tức khi khách hàng gửi form.

**Dữ liệu webhook gửi đi:**

```json theme={null}
{
  "conversationId": "conv_abc123",
  "lead": {
    "name": "Nguyễn Văn A",
    "email": "nguyenvana@example.com",
    "phone": "0901234567"
  }
}
```

**Ví dụ ứng dụng:**

* Tự động thêm vào Google Sheets
* Gửi email chào mừng qua Mailchimp
* Tạo contact trong HubSpot, Salesforce
* Gửi thông báo Slack cho team sales

## Mẹo sử dụng hiệu quả

<CardGroup cols={2}>
  <Card title="Đúng thời điểm" icon="clock">
    Form xuất hiện quá sớm (trước khi tạo giá trị) làm khách hàng thoát ngay. Đúng thời điểm là khi khách đã tỏ ra quan tâm rõ ràng.
  </Card>

  <Card title="Ít trường hơn, tỷ lệ điền cao hơn" icon="sliders">
    Chỉ hỏi email và tên nếu chỉ cần vậy. Thêm số điện thoại khi thực sự cần để liên hệ trực tiếp.
  </Card>

  <Card title="Tin nhắn xác nhận rõ ràng" icon="check-circle">
    Nói rõ bước tiếp theo sau khi khách gửi form: "Chúng tôi sẽ gọi lại trong 30 phút" thuyết phục hơn "Cảm ơn bạn đã liên hệ".
  </Card>

  <Card title="Kiểm tra trong Playground" icon="flask">
    Thử kịch bản khách hàng từ chối form để đảm bảo agent xử lý mượt mà và không hỏi lại.
  </Card>
</CardGroup>