⚙ Cấu hình kênh

← Về Hộp thư

Với mỗi kênh: ① tạo app trên trang developer của nền tảng, ② dán khóa app vào đây và bấm Lưu, ③ bấm Kết nối để mở trang cấp quyền — đăng nhập và đồng ý là xong, token sẽ tự lưu và tự gia hạn.

Zalo Official Account

Đã kết nối: OA 2280877775480068085 · token hết hạn 08:56 08/07 (tự gia hạn)

📖 Cách lấy App ID và Secret Key

Cần có Zalo Official Account đã xác thực (tạo tại oa.zalo.me — cần giấy tờ doanh nghiệp/hộ kinh doanh).
Vào developers.zalo.me, đăng nhập bằng Zalo → Thêm ứng dụng mới, điền tên rồi tạo.
Trong trang ứng dụng, xem mục thông tin app: copy ID ứng dụng (App ID) và Khóa bí mật (Secret Key) → dán vào 2 ô bên dưới.
Vào mục Official Account trong app → Liên kết OA của bạn với ứng dụng.
Vào mục Cài đặt → khai báo Callback URL bằng đúng URL hiển thị bên dưới.
Vào mục Webhook → nhập Webhook URL bên dưới, đăng ký sự kiện user_send_text (người dùng gửi tin nhắn).
Bấm Lưu rồi Kết nối Zalo → đăng nhập tài khoản quản trị OA và đồng ý cấp quyền.

App ID Secret Key

Callback URL (khai báo trong app Zalo): https://chat.chumchumbakery.com/oauth/zalo/callback

Webhook URL (khai báo trong app Zalo): https://chat.chumchumbakery.com/webhooks/zalo

Kết nối Zalo

Facebook Messenger

Chưa kết nối

📖 Cách lấy App ID và App Secret

Cần có Fanpage và bạn là quản trị viên của page đó.
Vào developers.facebook.com → My Apps → Create App → chọn loại Business.
Trong app: App Settings → Basic → copy App ID và App Secret (bấm Show) → dán vào 2 ô bên dưới.
Bấm Add Product → thêm Facebook Login for Business → vào Settings của nó → ô Valid OAuth Redirect URIs: dán Redirect URI bên dưới.
Thêm tiếp sản phẩm Messenger → mục Webhooks: dán Webhook URL bên dưới + nhập Verify Token trùng với ô bên dưới → Verify and Save → subscribe trường messages.
Bấm Lưu rồi Kết nối Facebook → đăng nhập, chọn Fanpage muốn nhận tin.
Lưu ý: app ở chế độ Development vẫn dùng được ngay với tài khoản admin của app; muốn nhân viên khác (không phải admin app) nhắn thử thì thêm họ vào mục Roles, hoặc submit App Review (quyền pages_messaging) khi dùng chính thức.

App ID App Secret Verify Token

Redirect URI hợp lệ (khai báo trong Facebook Login): https://chat.chumchumbakery.com/oauth/messenger/callback

Webhook URL + Verify Token (khai báo trong sản phẩm Messenger): https://chat.chumchumbakery.com/webhooks/messenger

Kết nối Facebook

Shopee

Chưa kết nối

📖 Cách lấy Partner ID và Partner Key

Vào open.shopee.com → Register đăng ký tài khoản developer (Shopee duyệt hồ sơ, có thể mất vài ngày).
Sau khi được duyệt: vào Console → Create App, chọn loại app phù hợp (Seller In-House nếu chỉ dùng cho shop của mình).
Trong App Information: copy Partner ID và Partner Key (live key, không phải test/sandbox) → dán vào 2 ô bên dưới.
Khai báo Redirect domain bằng domain bên dưới (chỉ cần domain, không cần path).
Vào mục Push Mechanism → nhập Webhook URL bên dưới → bật sự kiện Webchat (tin nhắn chat).
Lưu ý: app mới nằm ở môi trường test — cần submit lên production thì mới kết nối được shop thật.
Bấm Lưu rồi Kết nối Shopee → đăng nhập tài khoản shop và xác nhận ủy quyền.

Partner ID Partner Key

Redirect domain (khai báo trong app Shopee): https://chat.chumchumbakery.com

Webhook URL (mục Push Mechanism, bật webchat): https://chat.chumchumbakery.com/webhooks/shopee

Kết nối Shopee

TikTok Shop

Chưa kết nối

📖 Cách lấy App Key và App Secret

Cần có TikTok Shop đang hoạt động (tài khoản seller).
Vào partner.tiktokshop.com → đăng ký làm Partner, chọn loại Developer (chọn Self Developer nếu chỉ dùng cho shop của mình).
Vào App & Service → Create App, điền thông tin, chọn khu vực có Việt Nam.
Trong trang app: copy App Key và App Secret → dán vào 2 ô bên dưới.
Khai báo Redirect URL bằng đúng URL bên dưới.
Trong phần cấu hình app, chọn quyền (scope) Customer Service / Buyer Messages, và ở mục Webhook nhập Webhook URL bên dưới cho sự kiện tin nhắn mới.
Bấm Lưu rồi Kết nối TikTok → đăng nhập tài khoản seller và đồng ý ủy quyền.

App Key App Secret

Redirect URL (khai báo trong app TikTok): https://chat.chumchumbakery.com/oauth/tiktok/callback

Webhook URL (sự kiện tin nhắn CSKH): https://chat.chumchumbakery.com/webhooks/tiktok

Kết nối TikTok

Trello — tạo thẻ khi chốt đơn

Đã cấu hình

📖 Cách lấy API Key, Token và List ID

Vào trello.com/power-ups/admin → New tạo một Power-Up (điền tên tùy ý, workspace của bạn) → mở tab API key → Generate a new API key → copy API Key.
Ngay cạnh API key có link Token (hoặc mở link sau, thay YOUR_KEY):
https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=ChumChat&key=YOUR_KEY
→ bấm Allow → copy chuỗi token hiện ra.
Lấy List ID (ID của cột sẽ nhận thẻ, VD cột "Đơn mới"): mở board trên trình duyệt, URL dạng trello.com/b/XXXX/ten-board — mở tiếp địa chỉ sau (thay XXXX, KEY, TOKEN):
https://api.trello.com/1/boards/XXXX/lists?key=KEY&token=TOKEN
→ hiện danh sách các cột kèm "id" — copy id của cột muốn dùng.
Dán cả 3 giá trị vào các ô bên dưới → Lưu. Xong: trong Hộp thư, mỗi hội thoại có nút 📋 Tạo thẻ Trello.

API Key Token List ID

⚠ Nút Kết nối chỉ hoạt động khi app chạy trên domain HTTPS công khai (đã deploy), vì các nền tảng sẽ chuyển hướng về đúng URL đã khai báo. Khi chạy localhost hãy dùng ngrok.