Chuyển tới nội dung chính

Integration Tab - Tích hợp Nền tảng

Integration Tab là nơi bạn kết nối các kênh truyền thông (Facebook Messenger, Telegram) với campaign để nhận và gửi tin nhắn.

Tổng quan​

Mục đích: Kết nối campaign với các nền tảng messaging để:

  • Nhận tin nhắn từ khách hàng
  • Gửi tin nhắn cho khách hàng
  • Đồng bộ dữ liệu khách hàng
  • Quản lý webhook

Các nền tảng hỗ trợ:

  • ✅ Facebook Messenger
  • ✅ Telegram Bot
  • 🔜 Zalo (Coming soon)
  • 🔜 WhatsApp (Coming soon)

Truy cập Integration Tab​

  1. Vào Campaigns → Chọn campaign
  2. Click "Settings" (⚙️)
  3. Chọn tab "Integration"

Giao diện Integration Tab​

Các thành phần chính​

1. Platform Cards​

Hiển thị các nền tảng có thể kết nối:

  • Facebook Messenger Card

    • Logo Facebook
    • Trạng thái: Not Connected / Connected
    • Nút "Connect Facebook"

  • Telegram Card

    • Logo Telegram
    • Trạng thái: Not Connected / Connected
    • Nút "Connect Telegram"

2. Connected Platforms List​

Danh sách các kết nối đã thiết lập:

  • Platform icon
  • Platform name
  • Page/Bot name
  • Connection status (Active/Inactive)
  • Connected date
  • Actions (Edit, Disconnect, Test)

3. Webhook Status Panel​

Hiển thị trạng thái webhook:

  • Webhook URL
  • Status (Active/Inactive/Error)
  • Last received message time
  • Test webhook button

Kết nối Facebook Messenger​

Yêu cầu trước khi kết nối​

Bạn cần có:

  • ✅ Tài khoản Facebook cá nhân
  • ✅ Facebook Page (phải là Admin hoặc Editor)
  • ✅ Page đã được publish (không phải draft)

Quyền cần thiết:

  • pages_messaging - Gửi/nhận tin nhắn
  • pages_read_engagement - Đọc tương tác
  • pages_manage_metadata - Quản lý metadata
  • pages_show_list - Hiển thị danh sách pages

Bước 1: Bắt đầu kết nối​

  1. Trong Integration Tab, tìm Facebook Messenger Card
  2. Click nút "Connect Facebook"
  3. Popup OAuth sẽ mở ra

Bước 2: Đăng nhập Facebook​

  1. Nhập email/SĐT và mật khẩu Facebook
  2. Click "Đăng nhập"
  3. Nếu đã đăng nhập, bỏ qua bước này
Mẹo

Nếu bạn quản lý nhiều tài khoản Facebook, đảm bảo đăng nhập đúng tài khoản có quyền Admin Page.

Bước 3: Cấp quyền cho App​

Màn hình xin quyền sẽ hiển thị:

Quyền được yêu cầu:

  • ✅ Quản lý và truy cập tin nhắn Page

    • Cho phép đọc và gửi tin nhắn

  • ✅ Hiển thị danh sách Pages bạn quản lý

    • Cho phép chọn Page để kết nối

  • ✅ Đọc tương tác trên Page

    • Cho phép xem comments, reactions

Thao tác:

  1. Review các quyền
  2. Click "Tiếp tục" hoặc "Continue"
Lưu ý

Nếu bạn không cấp đủ quyền, kết nối sẽ thất bại. Phải cấp tất cả quyền được yêu cầu.

Bước 4: Chọn Facebook Page​

  1. Danh sách Pages bạn quản lý sẽ hiển thị
  2. Chọn Page muốn kết nối (có thể chọn nhiều)
  3. Click "Next" hoặc "Tiếp theo"

Thông tin hiển thị cho mỗi Page:

  • Avatar Page
  • Tên Page
  • Page ID
  • Số lượng followers
  • Checkbox để chọn
Không thấy Page?

Nếu không thấy Page của bạn:

  • Kiểm tra bạn có quyền Admin/Editor trên Page đó không
  • Page phải được publish (không phải draft)
  • Thử đăng xuất và đăng nhập lại

Bước 5: Xác nhận kết nối​

  1. Review Page đã chọn
  2. Click "Kết nối" hoặc "Connect"
  3. Hệ thống sẽ:
    • Lưu access token
    • Đăng ký webhook với Facebook
    • Kiểm tra kết nối
    • Hiển thị kết quả

Bước 6: Kiểm tra kết nối thành công​

Dấu hiệu kết nối thành công:

  • ✅ Hiển thị thông báo "Connected successfully"
  • ✅ Page xuất hiện trong Connected Platforms List
  • ✅ Connection Status = Active (màu xanh)
  • ✅ Webhook Status = Active

Thông tin hiển thị:

  • Platform: Facebook Messenger
  • Page Name: Tên Page của bạn
  • Page ID: ID của Page
  • Connected Date: Ngày kết nối
  • Status: Active

Các chức năng sau khi kết nối​

1. View Connection Details​

Click vào connection để xem chi tiết:

  • Page information
  • Access token status
  • Webhook subscription status
  • Permissions granted
  • Last sync time

2. Edit Connection​

Click "Edit" để:

  • Đổi Page khác
  • Cập nhật permissions
  • Reconnect nếu token hết hạn

3. Test Connection​

Click "Test" để:

  • Gửi tin nhắn test
  • Kiểm tra webhook
  • Verify permissions

4. Disconnect​

Click "Disconnect" để:

  • Ngắt kết nối với Page
  • Xóa access token
  • Hủy webhook subscription
Cảnh báo

Disconnect sẽ ngừng nhận tin nhắn từ Page này. Conversations cũ vẫn giữ nguyên.

Kết nối Telegram Bot​

Yêu cầu trước khi kết nối​

Bạn cần có:

  • ✅ Tài khoản Telegram
  • ✅ Telegram Bot (tạo qua @BotFather)
  • ✅ Bot Token

Bước 1: Tạo Telegram Bot​

Nếu chưa có bot, làm theo các bước sau:

1.1. Mở Telegram và tìm @BotFather​

  1. Mở app Telegram
  2. Tìm kiếm @BotFather
  3. Click "Start"

1.2. Tạo bot mới​

  1. Gửi lệnh: /newbot
  2. BotFather sẽ hỏi tên bot
  3. Nhập tên bot (VD: "Shop ABC Bot")
  4. BotFather sẽ hỏi username bot
  5. Nhập username (phải kết thúc bằng "bot", VD: "shopabc_bot")

1.3. Lấy Bot Token​

BotFather sẽ trả về:

Done! Congratulations on your new bot.
You will find it at t.me/shopabc_bot
You can now add a description...

Use this token to access the HTTP API:
1234567890:ABCdefGHIjklMNOpqrsTUVwxyz

Lưu lại Bot Token này!

Mẹo

Bot Token có dạng: {bot_id}:{random_string} VD: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz

1.4. Tắt Privacy Mode (Quan trọng!)​

Để bot nhận được tất cả tin nhắn trong group:

  1. Gửi lệnh cho @BotFather: /setprivacy
  2. Chọn bot của bạn
  3. Chọn "Disable"
  4. BotFather xác nhận: "Privacy mode is disabled"
Quan trọng

Nếu không tắt Privacy Mode, bot chỉ nhận tin nhắn có mention (@bot) hoặc tin nhắn riêng.

Bước 2: Kết nối Bot với Campaign​

2.1. Mở form kết nối​

  1. Trong Integration Tab, tìm Telegram Card
  2. Click "Connect Telegram"
  3. Form nhập token sẽ hiển thị

2.2. Nhập Bot Token​

  1. Paste Bot Token vào ô "Bot Token"
  2. Nhập Bot Username (optional, để dễ nhận diện)
  3. Click "Connect"

Form fields:

  • Bot Token (required): Token từ BotFather
  • Bot Username (optional): Username của bot (VD: shopabc_bot)
  • Bot Name (optional): Tên hiển thị (VD: Shop ABC Bot)

2.3. Xác nhận kết nối​

Hệ thống sẽ:

  1. Validate bot token
  2. Lấy thông tin bot từ Telegram API
  3. Đăng ký webhook
  4. Test gửi tin nhắn
  5. Hiển thị kết quả

Bước 3: Kiểm tra kết nối thành công​

Dấu hiệu thành công:

  • ✅ Thông báo "Telegram bot connected successfully"
  • ✅ Bot xuất hiện trong Connected Platforms List
  • ✅ Connection Status = Active
  • ✅ Webhook Status = Active

Thông tin hiển thị:

  • Platform: Telegram
  • Bot Name: Tên bot
  • Bot Username: @username
  • Bot ID: ID của bot
  • Connected Date: Ngày kết nối
  • Status: Active

Bước 4: Test Bot​

4.1. Gửi tin nhắn test​

  1. Mở Telegram
  2. Tìm bot của bạn (VD: @shopabc_bot)
  3. Click "Start"
  4. Gửi tin nhắn: "Hello"

4.2. Kiểm tra trong hệ thống​

  1. Vào Live Chat
  2. Kiểm tra có conversation mới không
  3. Tin nhắn "Hello" phải hiển thị
Test thành công

Nếu thấy conversation mới với tin nhắn "Hello", bot đã hoạt động!

Các chức năng sau khi kết nối​

1. View Bot Info​

Click vào connection để xem:

  • Bot information
  • Webhook URL
  • Webhook status
  • Last message received
  • Bot commands

2. Edit Bot​

Click "Edit" để:

  • Đổi bot token (nếu regenerate)
  • Cập nhật bot name
  • Reconnect webhook

3. Test Bot​

Click "Test" để:

  • Gửi tin nhắn test
  • Kiểm tra webhook
  • Verify bot permissions

4. Disconnect Bot​

Click "Disconnect" để:

  • Ngắt kết nối bot
  • Xóa webhook
  • Dừng nhận tin nhắn

Quản lý Connections​

Xem danh sách Connections​

Connected Platforms List hiển thị:

PlatformNameStatusConnected DateActions
FacebookShop ABC🟢 Active2024-01-15⋮
Telegram@shopabc_bot🟢 Active2024-01-15⋮

Thông tin mỗi connection:

  • Platform Icon: Logo Facebook/Telegram
  • Platform Name: Facebook Messenger / Telegram
  • Name: Tên Page/Bot
  • Status:
    • 🟢 Active - Đang hoạt động
    • 🔴 Inactive - Không hoạt động
    • 🟡 Error - Có lỗi
  • Connected Date: Ngày kết nối
  • Actions: Menu thao tác

Connection Status​

🟢 Active (Hoạt động)​

  • Kết nối đang hoạt động bình thường
  • Nhận và gửi tin nhắn được
  • Webhook đang active

🔴 Inactive (Không hoạt động)​

  • Kết nối bị tạm dừng
  • Không nhận tin nhắn mới
  • Cần reconnect

Nguyên nhân:

  • Token hết hạn
  • Page/Bot bị xóa
  • Permissions bị thu hồi
  • Webhook bị lỗi

🟡 Error (Lỗi)​

  • Có lỗi xảy ra
  • Cần kiểm tra và sửa

Nguyên nhân:

  • Token invalid
  • Webhook failed
  • API error
  • Network error

Actions với Connection​

1. View Details​

Click vào connection hoặc icon 👁️:

  • Xem thông tin chi tiết
  • Kiểm tra status
  • Xem logs

2. Edit Connection​

Click icon ✏️:

  • Đổi Page/Bot khác
  • Cập nhật settings
  • Reconnect

3. Test Connection​

Click icon 🧪:

  • Gửi tin nhắn test
  • Kiểm tra webhook
  • Verify permissions

4. Reconnect​

Click icon 🔄:

  • Kết nối lại
  • Refresh token
  • Re-register webhook

5. Disconnect​

Click icon 🔌:

  • Ngắt kết nối
  • Xóa token
  • Hủy webhook

Webhook Management​

Webhook là gì?​

Webhook là URL mà Facebook/Telegram gửi tin nhắn đến khi có sự kiện mới.

Cách hoạt động:

  1. Khách gửi tin nhắn trên Facebook/Telegram
  2. Facebook/Telegram gửi webhook đến hệ thống
  3. Hệ thống nhận và xử lý tin nhắn
  4. Tin nhắn hiển thị trong Live Chat

Webhook Status Panel​

Thông tin hiển thị:

  • Webhook URL: URL nhận webhook
  • Status: Active/Inactive/Error
  • Last Received: Thời gian nhận webhook cuối
  • Total Received: Tổng số webhook đã nhận
  • Error Count: Số lỗi

Kiểm tra Webhook Status​

✅ Active​

  • Webhook đang hoạt động
  • Nhận tin nhắn bình thường
  • Không có lỗi

❌ Inactive​

  • Webhook chưa được đăng ký
  • Hoặc đã bị hủy
  • Cần re-register

⚠️ Error​

  • Webhook có lỗi
  • Không nhận được tin nhắn
  • Cần troubleshoot

Test Webhook​

Cách test:

  1. Click "Test Webhook"
  2. Hệ thống gửi test event
  3. Kiểm tra response
  4. Hiển thị kết quả

Kết quả test:

  • ✅ Success: Webhook hoạt động tốt
  • ❌ Failed: Có lỗi, xem error message

Webhook Logs​

Click "View Logs" để xem:

  • Danh sách webhooks đã nhận
  • Timestamp
  • Event type
  • Payload
  • Response status
  • Error (nếu có)

Troubleshooting​

Facebook Connection Issues​

Lỗi: "Failed to connect Facebook Page"​

Nguyên nhân:

  • Không đủ quyền trên Page
  • Page chưa được publish
  • Token invalid

Giải pháp:

  1. Kiểm tra bạn là Admin/Editor của Page
  2. Kiểm tra Page đã publish chưa
  3. Thử disconnect và connect lại
  4. Clear browser cache và thử lại

Lỗi: "Webhook subscription failed"​

Nguyên nhân:

  • Facebook App chưa được approve
  • Webhook URL không accessible
  • SSL certificate invalid

Giải pháp:

  1. Kiểm tra Facebook App status
  2. Verify webhook URL accessible
  3. Kiểm tra SSL certificate
  4. Liên hệ support

Lỗi: "Page not found in list"​

Nguyên nhân:

  • Không có quyền Admin/Editor
  • Page bị unpublish
  • Đăng nhập sai tài khoản

Giải pháp:

  1. Kiểm tra quyền trên Page
  2. Kiểm tra Page status
  3. Đăng xuất và đăng nhập lại đúng tài khoản

Telegram Connection Issues​

Lỗi: "Invalid bot token"​

Nguyên nhân:

  • Bot token sai
  • Bot đã bị xóa
  • Token đã bị revoke

Giải pháp:

  1. Kiểm tra lại bot token
  2. Copy chính xác từ BotFather
  3. Tạo bot mới nếu cần

Lỗi: "Bot not receiving messages"​

Nguyên nhân:

  • Privacy Mode chưa tắt
  • Webhook chưa được đăng ký
  • Bot bị block

Giải pháp:

  1. Tắt Privacy Mode qua @BotFather
  2. Reconnect bot
  3. Kiểm tra webhook status
  4. Unblock bot nếu đã block

Lỗi: "Webhook registration failed"​

Nguyên nhân:

  • Webhook URL không accessible
  • SSL certificate invalid
  • Telegram API error

Giải pháp:

  1. Kiểm tra webhook URL
  2. Verify SSL certificate
  3. Thử lại sau vài phút
  4. Liên hệ support

Webhook Issues​

Không nhận được tin nhắn​

Kiểm tra:

  1. Connection Status = Active?
  2. Webhook Status = Active?
  3. Gửi tin nhắn test
  4. Xem webhook logs

Giải pháp:

  1. Reconnect platform
  2. Re-register webhook
  3. Kiểm tra firewall/network
  4. Liên hệ support

Nhận tin nhắn chậm​

Nguyên nhân:

  • Server overload
  • Network latency
  • Webhook queue đầy

Giải pháp:

  1. Kiểm tra server status
  2. Kiểm tra network
  3. Clear webhook queue
  4. Upgrade server nếu cần

Best Practices​

Kết nối Facebook​

✅ Nên:

  • Kết nối Page chính thức của doanh nghiệp
  • Cấp đủ quyền khi được yêu cầu
  • Test kỹ sau khi kết nối
  • Theo dõi webhook status thường xuyên

❌ Không nên:

  • Kết nối Page cá nhân
  • Từ chối cấp quyền cần thiết
  • Kết nối nhiều Page không cần thiết
  • Bỏ qua lỗi webhook

Kết nối Telegram​

✅ Nên:

  • Tạo bot riêng cho mỗi campaign
  • Tắt Privacy Mode
  • Đặt tên bot dễ nhớ
  • Backup bot token

❌ Không nên:

  • Dùng chung bot cho nhiều campaigns
  • Quên tắt Privacy Mode
  • Share bot token công khai
  • Xóa bot khi đang dùng

Quản lý Connections​

✅ Nên:

  • Kiểm tra status hàng ngày
  • Test webhook định kỳ
  • Xem logs khi có vấn đề
  • Disconnect connections không dùng

❌ Không nên:

  • Bỏ qua status error
  • Không test sau khi kết nối
  • Giữ connections không dùng
  • Disconnect khi đang có conversations active

FAQ​

Tôi có thể kết nối bao nhiêu Pages/Bots?​

Trả lời: Không giới hạn. Bạn có thể kết nối nhiều Pages và Bots vào một campaign.

Kết nối có hết hạn không?​

Trả lời:

  • Facebook: Token có thể hết hạn sau 60 ngày. Hệ thống tự động refresh.
  • Telegram: Token không hết hạn trừ khi bạn revoke.

Tôi có thể kết nối cùng Page vào nhiều campaigns không?​

Trả lời: Không. Một Page chỉ có thể kết nối vào một campaign tại một thời điểm.

Disconnect có xóa conversations cũ không?​

Trả lời: Không. Conversations và messages cũ vẫn được giữ nguyên. Chỉ ngừng nhận tin nhắn mới.

Làm sao biết webhook đang hoạt động?​

Trả lời: Kiểm tra:

  1. Webhook Status = Active
  2. Last Received time gần đây
  3. Gửi tin nhắn test và xem có nhận không

Tôi có thể đổi Page/Bot sau khi kết nối không?​

Trả lời: Có. Click "Edit" trên connection và chọn Page/Bot khác.

Tiếp theo​

Sau khi kết nối platforms thành công, hãy tiếp tục cấu hình:

  • Chatbot Tab - Thiết lập chatbot tự động trả lời
  • Team Tab - Thêm members vào team
  • Tags Tab - Tạo tags để phân loại conversations