
# Odoo

> **Dành cho ai?** Các doanh nghiệp đang vận hành Odoo — danh mục sản phẩm, quy trình CRM, đơn hàng bán — và muốn AI Agent của họ sử dụng trực tiếp trong trò chuyện. Nếu bạn không sử dụng Odoo, bạn có thể bỏ qua trang này.
>
> Sử dụng CRM hoặc ERP khác? Bất kỳ hệ thống nào có API đều có thể kết nối: xem [Kết nối một công cụ mà chúng tôi không liệt kê](connecting-other-tools.md).

Odoo là một bộ ứng dụng doanh nghiệp: Bán hàng, CRM, Kho vận, Hóa đơn và nhiều ứng dụng khác, tất cả hoạt động trên một cơ sở dữ liệu duy nhất. Kết nối Odoo với <span data-t="appName">DM Champ</span> cho phép AI Agent của bạn thực hiện ba việc trong một cuộc trò chuyện thông thường mà không cần ai phải xây dựng webhook hoặc hàm tùy chỉnh:

- **Trả lời các câu hỏi về sản phẩm từ danh mục của bạn.** Tên, giá cả với đúng loại tiền tệ và thuế, hàng tồn kho, mô tả, tất cả đều được đọc trực tiếp từ Odoo.
- **Chuyển khách hàng tiềm năng cho đội ngũ bán hàng của bạn.** Khi khách hàng thể hiện sự quan tâm mua hàng, AI sẽ tạo một khách hàng tiềm năng (hoặc cơ hội) trong Odoo CRM của bạn kèm theo bản tóm tắt những gì họ muốn.
- **Thông báo cho khách hàng về tình trạng đơn hàng của họ.** Trạng thái, các mặt hàng, hóa đơn và tiến độ giao hàng cho các đơn hàng của chính khách hàng đó.

---

## Những gì bạn cần

- Odoo **14 trở lên**: Odoo Online, Odoo.sh hoặc máy chủ của riêng bạn.
- Một **người dùng** Odoo mà AI sẽ đóng vai. Những gì người dùng đó có thể xem và thực hiện trong Odoo chính là giới hạn những gì AI có thể xem và thực hiện. Một người dùng chuyên dụng có quyền truy cập vào Bán hàng, CRM và Kho vận là tốt nhất; bạn không cần quyền quản trị viên.
- **Khóa API** của người dùng đó. Trong Odoo, nhấp vào tên người dùng (góc trên bên phải) → **Tùy chọn** → **Bảo mật tài khoản** → **Khóa API mới**. Đặt tên cho nó như "AI agent" và sao chép khóa: Odoo chỉ hiển thị nó một lần.

---

## Kết nối Odoo

1. Trong thanh bên trái, nhấp vào **Settings** (biểu tượng bánh răng).
2. Trong thanh bên Settings, dưới nhóm **Integrations**, nhấp vào **CRM & ERP**.
3. Trên thẻ **Odoo**, nhấp vào **Connect**.

::: master-only
<figure><img src="../.gitbook/assets/v2-settings-odoo.png" alt="Phần cài đặt CRM &amp; ERP với thẻ Available hiển thị ô Odoo và nút Connect, cùng lưu ý rằng tính năng này hoạt động với Odoo 14 trở lên bằng cách sử dụng khóa API của một trong những người dùng Odoo của bạn"><figcaption><p>Settings → CRM &amp; ERP trước khi kết nối: một nút Connect và lời nhắc rằng những gì người dùng Odoo được kết nối có thể thấy cũng chính là những gì AI có thể thấy.</p></figcaption></figure>
:::

4. Điền **Địa chỉ Odoo**: địa chỉ bạn dùng để đăng nhập, ví dụ `https://acme.odoo.com`. Bạn có thể dán toàn bộ địa chỉ từ trình duyệt của mình.
5. **Cơ sở dữ liệu** là tùy chọn. Để trống nếu máy chủ của bạn chỉ có một cơ sở dữ liệu. Nếu máy chủ của bạn có nhiều cơ sở dữ liệu, hoặc ẩn danh sách, hãy nhập tên: trên Odoo Online, đó thường là phần đầu tiên trong địa chỉ của bạn (`acme` cho `acme.odoo.com`).
6. Điền **Tên đăng nhập người dùng Odoo** (email mà người dùng đó dùng để đăng nhập) và **Khóa API** từ bước trên.
7. Nhấp vào **Kết nối**.

::: master-only
<figure><img src="../.gitbook/assets/v2-odoo-connect-modal.png" alt="Hộp thoại Kết nối Odoo với các trường cho địa chỉ Odoo, Cơ sở dữ liệu, tên đăng nhập người dùng Odoo và khóa API, mỗi trường đều có gợi ý bên dưới, cùng với các nút Hủy và Kết nối"><figcaption><p>Mọi thứ cần thiết cho kết nối, trên một màn hình: địa chỉ bạn dùng để đăng nhập, cơ sở dữ liệu (tùy chọn), người dùng Odoo mà AI sẽ đóng vai, và khóa API của người dùng đó.</p></figcaption></figure>
:::

### Kiểm tra thông tin xác thực

Không có gì được lưu cho đến khi Odoo xác nhận. Khi bạn nhấp vào **Kết nối**, chúng tôi kiểm tra xem địa chỉ đó có thực sự là máy chủ Odoo hay không, đăng nhập bằng tên đăng nhập và khóa API trên cơ sở dữ liệu đó, và đọc lại những gì người dùng có thể truy cập trong các ứng dụng Sản phẩm, CRM, Bán hàng và Kho vận. Địa chỉ sai, cơ sở dữ liệu sai, tên đăng nhập hoặc khóa sai, hoặc người dùng không có quyền truy cập sẽ bị từ chối ngay tại đó, với lý do hiển thị trên màn hình.

Khi kết nối thành công, thẻ đã kết nối sẽ hiển thị công ty và phiên bản Odoo, cơ sở dữ liệu mà AI được kết nối, và người dùng mà nó đóng vai.

Khóa API của bạn được lưu trữ dưới dạng mã hóa và không bao giờ được hiển thị lại — không phải cho bạn, cũng không phải cho nhóm của bạn. Nếu làm mất? Hãy tạo khóa mới trong Odoo và kết nối lại.

### Những gì AI có thể làm

Thẻ đã kết nối có ba công tắc. Cả ba đều được bật sau khi kết nối; hãy tắt những gì bạn không muốn AI can thiệp:

- **Trả lời từ danh mục sản phẩm** — tên sản phẩm, giá cả, thuế, hàng tồn kho và mô tả.
- **Tạo khách hàng tiềm năng trong CRM** — khách hàng tiềm năng hoặc cơ hội mới từ các cuộc hội thoại.
- **Tra cứu đơn hàng của khách hàng** — trạng thái đơn hàng và giao hàng.

Các thiết lập này áp dụng cho mọi tác nhân (agent) đã bật Odoo. Nếu người dùng được kết nối không thể truy cập một trong các ứng dụng khi bạn kết nối (ví dụ: Inventory chưa được cài đặt), thẻ sẽ hiển thị thông báo đó bên dưới công tắc tương ứng.

### Tạm dừng hoặc Ngắt kết nối

- **Tạm dừng** sẽ ngăn mọi tác nhân sử dụng Odoo trong khi vẫn giữ nguyên thiết lập kết nối. **Kích hoạt** sẽ bật lại tính năng này.
- **Ngắt kết nối** sẽ xóa hoàn toàn kết nối. Các khách hàng tiềm năng mà AI đã tạo vẫn sẽ tồn tại trong Odoo. Bạn có thể kết nối lại sau với cùng thông tin chi tiết.

---

## Bật Odoo cho một Tác nhân AI

Việc kết nối Odoo chưa làm thay đổi hành vi của AI ngay lập tức. Bạn cần bật tính năng này cho từng tác nhân:

1. Nhấp vào **AI Agents** trong thanh bên và mở Tác nhân đó.
2. Đi đến bước **AI Abilities** và cuộn xuống thẻ **Odoo**. Thẻ này chỉ xuất hiện sau khi Odoo đã được kết nối.
3. Bật **Use Odoo in this agent's conversations**. Hệ thống sẽ tự động lưu lại.

Thẻ này liệt kê những gì tác nhân này hiện có thể thực hiện, dựa trên các công tắc trong Settings → CRM & ERP. Một nhân viên hỗ trợ và một nhân viên kinh doanh trên cùng một tài khoản có thể khác nhau: hãy bật công tắc cho người cần sử dụng Odoo.

---

## Những gì AI có thể làm

### Câu hỏi về sản phẩm

Khi khách hàng hỏi về sản phẩm, giá cả, tình trạng còn hàng hoặc "bạn có bán X không", AI sẽ tìm kiếm trong danh mục Odoo của bạn trước khi trả lời. AI sẽ tìm các sản phẩm được đánh dấu **Can be Sold** (Có thể bán) trong Odoo, khớp theo tên sản phẩm, mã tham chiếu nội bộ và mã vạch, sau đó trả lời kèm theo giá, loại tiền tệ, thông tin thuế, mức tồn kho đối với các sản phẩm có thể lưu kho và mô tả bán hàng. Nếu không tìm thấy kết quả khớp, AI sẽ yêu cầu khách hàng cung cấp tên hoặc mã sản phẩm khác thay vì đoán mò.

### Khách hàng tiềm năng

Khi khách hàng thể hiện sự quan tâm mua hàng thực sự — yêu cầu báo giá, muốn được gọi lại, muốn đặt hàng những thứ mà AI không thể hoàn tất trong trò chuyện, yêu cầu bản demo — AI sẽ thu thập những thông tin mà đội ngũ bán hàng của bạn cần (chính xác là gì, số lượng bao nhiêu, khi nào, ngân sách nếu có, tên và email của họ) và tạo một bản ghi trong Odoo CRM của bạn:

- Một **khách hàng tiềm năng (lead)** nếu CRM của bạn sử dụng giai đoạn Leads (CRM → Configuration → Settings → Leads), nếu không thì sẽ là một **cơ hội (opportunity)** trong quy trình bán hàng của bạn.
- Số điện thoại, email và tên của khách hàng được lấy từ liên hệ trong <span data-t="appName">DM Champ</span>, và bản ghi sẽ được liên kết với khách hàng tương ứng trong Odoo nếu đã tồn tại.
- Nếu khách hàng đó đã có một khách hàng tiềm năng hoặc cơ hội đang mở, AI sẽ thêm yêu cầu mới dưới dạng ghi chú thay vì tạo bản ghi trùng lặp.

Bản ghi sẽ có tiêu đề như "Báo giá cho 20 ghế văn phòng" và bản tóm tắt được viết cho đội ngũ của bạn, cùng với ghi chú về kênh mà cuộc hội thoại bắt nguồn.

Việc kiểm thử tác nhân trong môi trường playground sẽ không tạo ra bất kỳ dữ liệu nào trong Odoo: AI sẽ chỉ thông báo cho bạn những gì nó sẽ tạo ra.

### Trạng thái đơn hàng

Khi khách hàng hỏi về tình trạng đơn hàng, những gì họ đã đặt hoặc liệu đơn hàng đã được giao hay chưa, AI sẽ tra cứu đơn hàng của họ trong Odoo và trả lời kèm theo mã tham chiếu đơn hàng, trạng thái (báo giá, đã xác nhận, đã hoàn thành hoặc đã hủy), ngày tháng, tổng tiền, các mặt hàng, thông tin hóa đơn và tiến độ giao hàng cùng với số vận đơn nếu đơn vị vận chuyển của bạn cung cấp.

AI chỉ hiển thị cho khách hàng các đơn hàng **của chính họ**:

- Trên WhatsApp, SMS và các kênh điện thoại khác, đơn hàng được đối chiếu với số điện thoại mà khách hàng đang sử dụng để nhắn tin (và email trong thông tin liên hệ của họ, nếu có).
- Trên khung chat của trang web, nơi danh tính của người dùng chưa được xác minh, AI sẽ yêu cầu **cả** mã tham chiếu đơn hàng và địa chỉ email đã dùng để đặt hàng, và chỉ hiển thị đơn hàng khi cả hai thông tin này khớp nhau.

AI không có cách nào để liệt kê đơn hàng của người khác hoặc tra cứu đơn hàng chỉ bằng mã tham chiếu.

---

## Những điều cần biết

- **Mỗi tài khoản một Odoo.** Nếu bạn vận hành nhiều công ty trong các cơ sở dữ liệu Odoo riêng biệt, hãy kết nối cơ sở dữ liệu mà Đại lý (Agent) của bạn cần sử dụng.
- **Người dùng Odoo là giới hạn.** AI chỉ nhìn thấy chính xác những gì người dùng đó có thể thấy. Hãy cấp quyền truy cập vào các ứng dụng Bán hàng, CRM và Kho hàng trong Odoo cho người dùng này, và không cấp quyền cho bất kỳ thứ gì mà AI không nên can thiệp.
- **Odoo luôn là nguồn dữ liệu chính xác.** Không có thông tin nào từ Odoo được sao chép vào <span data-t="appName">DM Champ</span>; mọi câu trả lời đều được AI đọc trực tiếp từ Odoo tại thời điểm đó.
- **Số điện thoại được đối chiếu linh hoạt.** Một khách hàng có số điện thoại được lưu trong Odoo là `06 12 34 56 78` vẫn sẽ được tìm thấy khi họ nhắn tin từ `+31 6 12345678`.
- **Odoo không thể truy cập?** AI sẽ xin lỗi, trả lời những gì có thể từ cơ sở kiến thức của bạn và thông báo cho đội ngũ của bạn nếu khách hàng cần câu trả lời ngay lập tức.

---

## Các bước tiếp theo

- [Đại lý AI](../ai-agents/ai-agents.md) — thiết lập Đại lý sẽ sử dụng Odoo.
- [Cơ sở kiến thức](../ai-automation/faq-management.md) — thêm các chính sách, thời gian giao hàng và quy định đổi trả để AI có thể trả lời các câu hỏi ngoài danh mục sản phẩm.
- [Kết nối một công cụ không có trong danh sách](connecting-other-tools.md) — dành cho bất kỳ vấn đề nào liên quan đến Odoo mà ba khả năng trên không đáp ứng được (các hàm tùy chỉnh, webhook, API).
