Cách kết nối Odoo với BOTS4.me: hướng dẫn cài đặt trình kết nối (Odoo 13–19)

🧭 Trước tiên, Chọn Con đường Của Bạn: Odoo Của Bạn Chạy Ở Đâu?

Có hai con đường cài đặt, và điều duy nhất quyết định bạn đi đường nào là hình thức lưu trữ Odoo của bạn. Cả hai đều dẫn đến cùng một đích: một kết nối phục vụ mọi ứng dụng BOTS4.me làm việc với Odoo.

Chưa chắc bạn đang dùng loại lưu trữ nào — hoặc vẫn đang chọn? Xem Odoo Online so với Odoo.sh so với on-premise: bạn có thể tự động hóa loại nào?

Lưu ý về gói: Odoo Online cần gói Custom của Odoo để truy cập API; Odoo.sh và on-premise hoạt động với mọi gói.

🔌 Con đường A: Odoo.sh & On-Premise — Kết nối Một chạm

• Bước 1 — Tạo tài khoản BOTS4.me. Đăng ký tại bots4.me/bots, hoặc bỏ qua bước này và tạo tài khoản bên trong Odoo ở Bước 3. Sau đó, mỗi ứng dụng bắt đầu miễn phí đều khởi đầu bằng một tháng Discovery miễn phí.
• Bước 2 — Cài đặt “BOTS4.me Connect”. Trên apps.odoo.com, mở BOTS4.me Connect, chọn phiên bản Odoo của bạn (13.0 đến 19.0) và tải xuống tệp zip miễn phí; tệp chứa một thư mục duy nhất, b4m_connect. On-premise: đặt thư mục đó vào một thư mục nằm trong addons path của bạn, khởi động lại dịch vụ Odoo, bật chế độ nhà phát triển, mở Apps → Update Apps List, tìm “BOTS4.me Connect” và nhấp Activate (Install trên các phiên bản cũ hơn). Odoo.sh: commit thư mục vào repository của bạn (hãy thử trên nhánh staging trước) rồi push; khi bản build có màu xanh, cài đặt nó từ Apps trong cơ sở dữ liệu của bản build đó. Các module một ứng dụng trên cửa hàng (ví dụ “Mail2ERP by BOTS4.me”) được cài đặt theo cùng cách và chỉ hiển thị ứng dụng của riêng chúng. Mã nguồn theo giấy phép LGPL-3, nên bạn hoặc đơn vị tích hợp của bạn có thể đọc từng dòng trước khi cài đặt.
• Bước 3 — Chạy trình hướng dẫn kết nối. Với tư cách quản trị viên Odoo, mở BOTS4.me Connect → Cài đặt và nhấp Kết nối. Chọn “Tạo tài khoản mới tại www.bots4.me” (nhập email của bạn; nếu một đối tác BOTS4.me đã giới thiệu chúng tôi, hãy nhập mã của họ vào Mã đối tác) hoặc “Tôi đã có tài khoản tại www.bots4.me” (email và mật khẩu). Sau đó nhập mã 6 chữ số từ email của bạn, hoặc từ ứng dụng xác thực nếu bạn dùng. Trình hướng dẫn giao tiếp trực tiếp với bots4.me qua HTTPS; không có thông tin đăng nhập nào được nhập vào màn hình của bên thứ ba.
• Bước 4 — Key được tạo sẵn cho bạn. Khi đăng nhập thành công, BOTS4.me cấp một API key và một khóa bí mật ký HMAC dành riêng cho cơ sở dữ liệu Odoo này, và module tạo một người dùng kỹ thuật cục bộ, “BOTS4.me Connect”, để các bot đọc và ghi bản ghi Odoo qua XML-RPC bằng danh tính riêng của chúng, không bao giờ bằng thông tin đăng nhập quản trị cá nhân của bạn. Người dùng đó chỉ nhận các quyền Odoo của những ứng dụng bạn kích hoạt. Giống như mọi người dùng nội bộ, nó được tính vào gói đăng ký Odoo Enterprise theo người dùng. Trên Odoo 18 trở lên, Odoo giới hạn thời hạn hiệu lực của API key: khi module hiển thị “API key sắp hết hạn”, hãy nhấp Ngắt kết nối, sau đó Kết nối, và không có cài đặt ứng dụng nào bị mất.
• Bước 5 — Biểu mẫu thiết lập được điền sẵn. Trình kết nối gửi siêu dữ liệu của Odoo (URL, UUID cơ sở dữ liệu, thông tin xuất hóa đơn của công ty, địa chỉ máy chủ thư IMAP) để điền sẵn các biểu mẫu thiết lập của BOTS4.me. Mật khẩu thư vẫn nằm trong Odoo của bạn cho đến khi bạn giao một hộp thư cho một ứng dụng, bằng + Email IMAP của tôi (1 lần nhấp) hoặc bằng cách nhấp Bắt đầu tháng Discovery miễn phí trên một ứng dụng đọc email. Chúng được mã hóa trước khi rời khỏi Odoo của bạn.
• Bước 6 — Kích hoạt ứng dụng đầu tiên. Trong Ứng dụng, mỗi ứng dụng hiển thị trạng thái của nó (Chưa kích hoạt, Cần thiết lập, Đang hoạt động, Đã cấu hình). Nhấp Hãy hoàn tất thông tin thanh toán trước một lần, điền thông tin thanh toán trên bots4.me, sau đó nhấp Bắt đầu tháng Discovery miễn phí trên ứng dụng bạn muốn. Một lần nhấp đó kích hoạt ứng dụng, kết nối Odoo này làm ERP của nó và, với các ứng dụng đọc email, giao hộp thư IMAP Odoo của bạn. Bất cứ thứ gì còn thiếu đều có nút riêng trên ứng dụng: + Odoo này làm ERP (1 lần nhấp), + Email IMAP của tôi (1 lần nhấp), + Mailbox (Gmail, Microsoft 365) hoặc + Lưu trữ Cloud. Dashboard, Nhật ký và Cài đặt mở bots4.me ở trạng thái đã đăng nhập.

☁️ Con đường B: Odoo Online — Thiết lập Không cần Mã bằng API Key

Odoo Online (phiên bản SaaS tại odoo.com) không cho phép các module Python tùy chỉnh — đó là quy tắc của nền tảng, không phải giới hạn của BOTS4.me. Vì vậy, con đường Online sử dụng một module trợ giúp XML không cần mã cùng với một API key tiêu chuẩn của Odoo mà bạn tự tạo (quyền truy cập API bên ngoài là một phần của gói Custom của Odoo):

• Bước 1 — Tạo tài khoản BOTS4.me của bạn tại bots4.me/bots.
• Bước 2 — Tạo một API key của Odoo. Trong cơ sở dữ liệu Odoo Online của bạn, vào Settings → Users & Companies → Users → người dùng của bạn → Account Security (bật chế độ nhà phát triển nếu tab bị ẩn) và nhấp New API Key. Đặt tên là “BOTS4.me”, chọn thời hạn hiệu lực (Odoo 18 trở lên sẽ hỏi) và sao chép key; Odoo chỉ hiển thị nó một lần duy nhất. Trước khi key hết hạn, hãy tạo key mới và dán vào cùng kết nối Odoo đó tại bots4.me (Chỉnh sửa → Cập nhật tài khoản ERP).
• Bước 3 — Khởi động ứng dụng và dán key tại bots4.me. Đăng nhập tại bots4.me/bots, nhấp Bắt đầu tháng Discovery miễn phí trên thẻ của ứng dụng và chấp nhận Điều khoản một lần — không cần thẻ tín dụng. Sau đó mở Cài đặt (bánh răng) → ứng dụng → Trình quản lý truy cập, nhấp Thêm Đích đến hoặc Thêm Nguồn (ứng dụng hiển thị nút mà nó cần), chọn ERP → Odoo và điền Odoo URL (với https://yourcompany.odoo.com, Tên Cơ sở dữ liệu sẽ tự điền), email đăng nhập của bạn vào Tên đăng nhập, và API key vào Mật khẩu hoặc API Key. Nhấp Thêm tài khoản ERP.
• Bước 4 — Thêm module trợ giúp không cần mã (tùy chọn). Module “BOTS4.me for Odoo Online” trên apps.odoo.com chỉ chứa bản ghi dữ liệu, không có Python, nên Odoo Online chấp nhận nó. Nó thêm một ứng dụng BOTS4.me vào Odoo của bạn với Kết nối / Dashboard, Hướng dẫn thiết lập và Cách tạo API Key. Dù thế nào, các bot cũng kết nối qua API bên ngoài tiêu chuẩn của Odoo.
• Bước 5 — Xác minh ở DEMO. Trong tab Điều khiển của ứng dụng, bật Công tắc bot và để Chế độ ở DEMO. Sau lần chạy đầu tiên, bạn nhận được email báo cáo DEMO liệt kê những gì bot đã đọc và những gì nó sẽ ghi, và tab Nhật ký hiển thị mọi quyết định; không có gì thay đổi trong Odoo. Khi báo cáo DEMO trông đúng, hãy đặt Chế độ thành LIVE trên tab Điều khiển — tùy chọn này được mở khóa sau email báo cáo DEMO đầu tiên.

🧭 Dùng thử trong tháng Discovery miễn phí

Tháng đầu tiên của mỗi ứng dụng bắt đầu miễn phí là tháng Discovery miễn phí: hạn mức sử dụng của gói Personal, với nhiều tính năng Family và Business được mở khóa để dùng thử, và không cần thẻ tín dụng. Đây là con đường ngắn nhất từ “đã kết nối” đến kết quả đầu tiên trong Odoo.

• 1 — Khởi động ứng dụng. Trong Odoo (Odoo.sh, on-premise): BOTS4.me Connect → Cài đặt, nhấp Hãy hoàn tất thông tin thanh toán trước một lần, sau đó nhấp Bắt đầu tháng Discovery miễn phí trên ứng dụng. Trên Odoo Online: đăng nhập tại bots4.me/bots, nhấp Bắt đầu tháng Discovery miễn phí trên thẻ của ứng dụng và chấp nhận Điều khoản một lần — không cần thẻ tín dụng. Dù theo cách nào, Dashboard sau đó cũng hiển thị “Tháng Discovery miễn phí — còn N ngày”.
• 2 — Kết nối những gì ứng dụng cần. Trong Odoo, việc khởi động ứng dụng đã kết nối Odoo này và, nếu Odoo của bạn có máy chủ thư IMAP, cả hộp thư của nó. Dùng + Odoo này làm ERP (1 lần nhấp) hoặc + Mailbox (Gmail, Microsoft 365) cho bất cứ thứ gì còn thiếu. Trên Odoo Online, thêm kết nối Odoo trong Trình quản lý truy cập như mô tả ở Con đường B, và hộp thư bằng Thêm Nguồn.
• 3 — Chạy ở DEMO. Mở tab Điều khiển của ứng dụng (hoặc Điều khiển nhanh trong Odoo), bật Công tắc bot và để Chế độ ở DEMO. Các công tắc có nhãn Discovery trên tab Điều khiển đã bao gồm trong tháng miễn phí của bạn và mặc định ở trạng thái tắt — hãy bật những công tắc bạn muốn dùng thử.
• 4 — Kiểm tra kết quả. Đọc email báo cáo DEMO sau lần chạy đầu tiên và tab Nhật ký: mọi tài liệu bot đã đọc, và những gì nó sẽ tạo hoặc thay đổi trong Odoo.
• 5 — Chuyển sang LIVE. Khi báo cáo DEMO trông đúng, hãy đặt Chế độ thành LIVE trên tab Điều khiển — tùy chọn này được mở khóa sau email báo cáo DEMO đầu tiên. Giờ đây bot ghi vào Odoo thông qua kết nối bạn đã thiết lập, với quyền của người dùng Odoo của nó.
• 6 — Sau tháng đầu tiên. Khi tháng kết thúc, ứng dụng tự động tiếp tục trên gói miễn phí với một hạn mức hàng tháng nhỏ: khi dùng hết, các mục mới sẽ chờ đến tháng sau hoặc cho đến khi bạn chọn một gói, và mục đã bắt đầu luôn được hoàn tất. Hãy chọn một gói để giữ tất cả tính năng — xem bảng gói trên trang sản phẩm của ứng dụng.

🔒 Mô hình Bảo mật, Giải thích Trung thực

Bạn đang cấp cho một dịch vụ bên ngoài quyền truy cập vào ERP của mình, vì vậy bạn nên yêu cầu những thông tin cụ thể — chứ không chỉ một nhãn “bảo mật cấp ngân hàng” chung chung. Sau đây là chính xác cách BOTS4.me Connect được xây dựng:

• Chỉ HTTPS, được mã hóa cứng. Endpoint API được cố định là https://bots4.me trong mã nguồn của module — đây không phải là một trường cài đặt có thể chỉnh sửa, nên một bản ghi cấu hình bị xâm nhập không thể chuyển hướng lưu lượng API của bạn đến một máy chủ độc hại. Mọi URL do API trả về đều được xác minh trước khi trình duyệt của bạn mở nó; các phản hồi không phải HTTPS hoặc không đúng host sẽ bị từ chối.
• Ký yêu cầu bằng HMAC-SHA256. Mọi lệnh gọi mà module thực hiện đến BOTS4.me đều được ký bằng mã bí mật riêng của từng cơ sở dữ liệu, nên các yêu cầu không thể bị giả mạo hoặc bị can thiệp trong quá trình truyền tải.
• Thông tin đăng nhập chỉ dành cho admin. Các trường API key, mã bí mật ký, và người dùng kỹ thuật có quyền truy cập theo từng trường dữ liệu, giới hạn cho nhóm admin của Odoo (base.group_system). Người dùng nội bộ thông thường có thể thấy launchpad và trạng thái ứng dụng, nhưng các thông tin bí mật không bao giờ xuất hiện trong bất kỳ lần đọc bản ghi nào mà họ có thể thực hiện — và mọi hành động kết nối/ngắt kết nối/cấu hình đều chỉ dành cho admin.
• Mã nguồn mở, LGPL-3. Toàn bộ mã nguồn nằm trong tệp zip bạn tải xuống từ apps.odoo.com, nên đơn vị tích hợp của bạn có thể kiểm tra chính xác những gì rời khỏi máy chủ của bạn: siêu dữ liệu để điền sẵn biểu mẫu, mật khẩu hộp thư chỉ khi bạn giao hộp thư đó cho một ứng dụng (được mã hóa trước khi rời đi), và không bao giờ là tài liệu kinh doanh của bạn.
• Dấu vết kiểm toán ở cả hai phía. Module lưu một nhật ký sự kiện cục bộ về các lần kết nối, thay đổi cấu hình và lỗi ngay trong Odoo; bảng điều khiển BOTS4.me lưu đầy đủ nhật ký quyết định cho từng lần chạy.
• Tự động làm mới quyền sử dụng. Một tác vụ cron theo lịch sẽ thường xuyên kiểm tra lại gói đăng ký của bạn, để trạng thái ứng dụng trong launchpad luôn được cập nhật — và một ứng dụng đã hủy sẽ nhanh chóng ngừng được phục vụ.

Tìm hiểu thêm về bảo mật nền tảng và quyền truy cập theo cấp độ: bots4.me/security và cấp độ truy cập. Nền tảng được lưu trữ tại EU, được thiết kế để đáp ứng GDPR, và 2FA có sẵn trên mọi tài khoản.

✅ Sau khi kết nối: một kết nối cho mọi ứng dụng Odoo

Bạn chỉ cài connector đúng một lần; không cần cài thêm gì cho từng ứng dụng. Một kết nối duy nhất phục vụ mọi ứng dụng BOTS4.me làm việc với Odoo: Mail2ERP, AutoERP, Pay2ERP, Supplier2ERP và AutoCASH, cùng AutoSTOCK, AutoPURCHASE và ClientFACTORY. AutoSPAM, Mail2CLOUD và Mail2KNOW chỉ cần một hộp thư, và connector có thể chuyển hộp thư đó từ Odoo của bạn chỉ bằng một cú nhấp. Bạn khởi động từng ứng dụng riêng biệt, từ dòng của nó trong Odoo hoặc thẻ của nó tại bots4.me/bots.

Mỗi ứng dụng bắt đầu ở DEMO: nó đọc, ra quyết định và gửi email báo cáo DEMO cho bạn, nhưng không ghi gì cả. Khi báo cáo DEMO trông đúng, hãy đặt Chế độ thành LIVE trên tab Điều khiển — tùy chọn này được mở khóa sau email báo cáo DEMO đầu tiên. Trên bots4.me, tab Điều khiển của mỗi ứng dụng chứa Công tắc bot, Chế độ, Chế độ AI (Tắt, Essential AI, Premium AI hoặc Ultra, tùy ứng dụng), Lịch chạy và Giờ hoạt động với những ứng dụng có các mục này, và các công tắc tính năng. Tab Nhật ký hiển thị mọi quyết định. Trong Odoo, Điều khiển nhanh trên dòng ứng dụng bao gồm Công tắc bot, Lịch chạy, Chế độ Demo và Chế độ AI. Để biết nên tự động hóa gì trước, hãy xem hướng dẫn tổng quan: Cách tự động hóa Odoo từ đầu đến cuối.

📚 Hướng dẫn liên quan

• Bắt đầu tại đây: Cách tự động hóa Odoo từ đầu đến cuối: từ đơn hàng email đến hóa đơn đã thanh toán
• Lưu trữ: Odoo Online so với Odoo.sh so với on-premise: bạn có thể tự động hóa loại nào?
• Các bot đầu tiên nên kết nối: Nhập đơn hàng email vào Odoo · Tự động đối chiếu thanh toán ngân hàng với hóa đơn
• Dành cho đơn vị tích hợp: Kiếm doanh thu định kỳ với tư cách đối tác Odoo

🔗 Nguồn và tài liệu đọc thêm

Tài liệu chính thức và các tiêu chuẩn được tham chiếu trong bài hướng dẫn này. Các đường link bên ngoài sẽ mở trong một tab mới.

• Odoo 18 developer reference — External API and API keys
• BOTS4.me Connect on the Odoo Apps Store
• Odoo 18 documentation — Access rights
• Odoo — Supported versions