Kết nối WhatsApp Business
Xem dạng Markdown
Kênh **WhatsApp** (`/{slug}/channels/whatsapp`) cho phép kết nối số điện thoại **WhatsApp Business Cloud API** (WABA) vào Workspace để tiếp nhận, phản hồi tin nhắn và triển khai Bot AI tự động.
:::note[Quyền truy cập]
- **Xem danh sách số WhatsApp**: Cần **`nick:read:all`** (hiển thị mục điều hướng khi có `nick:read:all`, `nick:connect` hoặc `nick:operate`).
- **Kết nối số WhatsApp**: Cần **`nick:connect`**.
- **Cập nhật cài đặt kênh**: Cần **`nick:operate`**.
- **Ngắt kết nối số WhatsApp**: Cần **`nick:delete`**.
- **Gửi tin nhắn thủ công trong hộp thư**: Cần **`inbox:reply`**.
- **Gán Bot AI & Bật/tắt AI**: Cần **`workspace:manage`**.
:::
## Điều kiện trước khi kết nối
- Có tài khoản **Meta Business / WhatsApp Business Account (WABA)** đã đăng ký ít nhất một số điện thoại trên WhatsApp Cloud API.
- Trình duyệt cho phép mở cửa sổ bật lên (**popup**) để đăng nhập Meta OAuth.
## Các bước kết nối WhatsApp Business
1. Truy cập **Kênh kết nối → WhatsApp** (hoặc **Tất cả kênh**), nhấn **Thêm kênh** và chọn **WhatsApp**.
2. Kiểm tra **Meta App ID** ở cuối hộp thoại (mặc định hệ thống tự tải từ cấu hình sẵn có; bạn có thể nhấn vào App ID nếu cần đổi sang Meta App riêng).
3. Nhấn **Kết nối ngay** để mở cửa sổ **Meta OAuth (v21.0)** và cấp hai quyền:
- `whatsapp_business_management`
- `whatsapp_business_messaging`
4. Sau khi xác thực thành công, OmnyBot tự động lấy danh sách các số điện thoại thuộc tài khoản WABA của bạn (hiển thị số điện thoại, tên đã xác minh và Phone Number ID).
5. Chọn số điện thoại muốn kết nối và nhấn **Xác nhận kết nối**.
:::tip[Nhập mã xác thực thủ công]
Tương tự kênh Facebook, nếu cửa sổ popup không tự truyền lại mã xác thực về ứng dụng, bạn có thể dán trực tiếp URL callback (có tham số `code=...`) hoặc mã `code` vào ô nhập thủ công trong hộp thoại để tải danh sách số điện thoại.
:::
## Quản lý kênh WhatsApp
- **Gán Bot AI & Bật/tắt AI**: Thực hiện trực tiếp trên bảng danh sách kênh (yêu cầu quyền `workspace:manage`).
- **Mở hộp thư kênh**: Nhấn vào tên kênh WhatsApp để mở giao diện hội thoại dành riêng cho số điện thoại đó.
- **Ngắt kết nối WhatsApp**: Nhấn menu **`⋮`** ở cuối dòng kênh và chọn **Ngắt kết nối** (yêu cầu quyền `nick:delete`).
:::caution[Ngắt kết nối số WhatsApp]
Khi ngắt kết nối, Workspace sẽ ngừng nhận và gửi tin nhắn qua số điện thoại WhatsApp Business này cho tới khi bạn kết nối lại.
:::
## Tài liệu liên quan
- [Tổng quan kênh kết nối](/channels/overview/)
- [Kết nối Facebook Messenger](/channels/facebook/)
Kênh WhatsApp (/{slug}/channels/whatsapp) cho phép kết nối số điện thoại WhatsApp Business Cloud API (WABA) vào Workspace để tiếp nhận, phản hồi tin nhắn và triển khai Bot AI tự động.
Điều kiện trước khi kết nối
Phần tiêu đề “Điều kiện trước khi kết nối”- Có tài khoản Meta Business / WhatsApp Business Account (WABA) đã đăng ký ít nhất một số điện thoại trên WhatsApp Cloud API.
- Trình duyệt cho phép mở cửa sổ bật lên (popup) để đăng nhập Meta OAuth.
Các bước kết nối WhatsApp Business
Phần tiêu đề “Các bước kết nối WhatsApp Business”- Truy cập Kênh kết nối → WhatsApp (hoặc Tất cả kênh), nhấn Thêm kênh và chọn WhatsApp.
- Kiểm tra Meta App ID ở cuối hộp thoại (mặc định hệ thống tự tải từ cấu hình sẵn có; bạn có thể nhấn vào App ID nếu cần đổi sang Meta App riêng).
- Nhấn Kết nối ngay để mở cửa sổ Meta OAuth (v21.0) và cấp hai quyền:
whatsapp_business_managementwhatsapp_business_messaging
- Sau khi xác thực thành công, OmnyBot tự động lấy danh sách các số điện thoại thuộc tài khoản WABA của bạn (hiển thị số điện thoại, tên đã xác minh và Phone Number ID).
- Chọn số điện thoại muốn kết nối và nhấn Xác nhận kết nối.
Quản lý kênh WhatsApp
Phần tiêu đề “Quản lý kênh WhatsApp”- Gán Bot AI & Bật/tắt AI: Thực hiện trực tiếp trên bảng danh sách kênh (yêu cầu quyền
workspace:manage). - Mở hộp thư kênh: Nhấn vào tên kênh WhatsApp để mở giao diện hội thoại dành riêng cho số điện thoại đó.
- Ngắt kết nối WhatsApp: Nhấn menu
⋮ở cuối dòng kênh và chọn Ngắt kết nối (yêu cầu quyềnnick:delete).