Quản lý Platform

Hướng dẫn toàn diện về cách quản lý các nền tảng messaging (Facebook, Telegram) đã kết nối với hệ thống.

Tổng quan

Platform là gì?

Platform (Nền tảng) là các kênh messaging mà bạn kết nối để:

• Nhận tin nhắn từ khách hàng
• Gửi tin nhắn cho khách hàng
• Tự động hóa với chatbot
• Quản lý tập trung

Platforms hỗ trợ:

• 📘 Facebook Messenger
• 📱 Telegram
• 🔜 Zalo (Coming soon)
• 🔜 WhatsApp (Coming soon)
• 🔜 LINE (Coming soon)

Phân biệt Platform vs Campaign

Khía cạnh	Platform	Campaign
Là gì	Kênh messaging	Dự án marketing
Ví dụ	Facebook Page	Campaign Tết 2024
Kết nối	1 Platform → nhiều Campaigns	1 Campaign → nhiều Platforms
Quản lý	Platform Management	Campaign Setup

Truy cập Platform Management

Cách 1: Từ Dashboard

1. Vào Dashboard
2. Tìm widget "Connected Platforms"
3. Click "Manage Platforms"

Cách 2: Từ Settings

1. Click icon Settings (⚙️)
2. Chọn "Platform Management"

Cách 3: Từ Campaign Setup

1. Vào Campaign Setup → Integration Tab
2. Click "Manage All Platforms"

Giao diện Platform Management

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

1. Platform Overview Panel

Hiển thị tổng quan:

┌─────────────────────────────────────┐
│ Platform Overview                   │
├─────────────────────────────────────┤
│ Total Platforms: 5                  │
│ • Facebook: 3 pages                 │
│ • Telegram: 2 bots                  │
│                                     │
│ Active: 4 | Inactive: 1             │
│ Total Messages: 1,234 (today)       │
└─────────────────────────────────────┘

Thông tin:

• Total Platforms: Tổng số platforms đã kết nối
• By Type: Phân loại theo loại (Facebook, Telegram)
• Status: Active/Inactive
• Messages: Số tin nhắn hôm nay

2. Platform List

Hiển thị dạng Table:

Platform	Name	Type	Status	Campaigns	Messages	Actions
📘	Shop ABC	Facebook	🟢 Active	2	456	⋮
📱	Support Bot	Telegram	🟢 Active	1	123	⋮
📘	Shop XYZ	Facebook	🔴 Inactive	0	0	⋮

Columns:

• Platform: Icon + Logo
• Name: Tên Page/Bot
• Type: Facebook/Telegram
• Status: Active/Inactive/Error
• Campaigns: Số campaigns đang dùng
• Messages: Số tin nhắn hôm nay
• Actions: Menu thao tác

Hiển thị dạng Cards:

┌─────────────────────────────────────┐
│ 📘 Shop Thời Trang ABC             │
│ Facebook Messenger                  │
├─────────────────────────────────────┤
│ Status: 🟢 Active                   │
│ Page ID: 123456789                  │
│ Campaigns: 2                        │
│ Messages today: 456                 │
│ Connected: 2024-01-01               │
├─────────────────────────────────────┤
│ [View] [Edit] [Disconnect]          │
└─────────────────────────────────────┘

3. Filter và Search

Filters:

• By Type: All / Facebook / Telegram
• By Status: All / Active / Inactive / Error
• By Campaign: All / Campaign A / Campaign B

Search:

• Tìm theo tên Page/Bot
• Tìm theo Page ID/Bot ID
• Tìm theo campaign

4. Bulk Actions

Thao tác hàng loạt:

• Select multiple platforms
• Disconnect selected
• Change status
• Export data

5. Add Platform Button

Vị trí: Góc phải trên Icon: ➕ "Add Platform" Action: Mở dialog thêm platform mới

Quản lý Facebook Pages

Xem chi tiết Facebook Page

Cách 1: Click vào Page card Cách 2: Click "View" trong Actions menu

Thông tin hiển thị:

1. Basic Information

┌─────────────────────────────────────┐
│ 📘 Shop Thời Trang ABC             │
├─────────────────────────────────────┤
│ Platform: Facebook Messenger        │
│ Page ID: 123456789012345           │
│ Category: Shopping & Retail         │
│ Followers: 10,234                   │
│ Connected: 2024-01-01 10:30        │
│ Status: 🟢 Active                   │
└─────────────────────────────────────┘

2. Connection Details

┌─────────────────────────────────────┐
│ Connection Details                  │
├─────────────────────────────────────┤
│ Access Token: Valid                 │
│ Token Expires: 2024-12-31          │
│ Permissions:                        │
│ ✅ pages_messaging                  │
│ ✅ pages_read_engagement            │
│ ✅ pages_manage_metadata            │
│                                     │
│ Webhook: Active                     │
│ Webhook URL: https://...            │
│ Last Received: 2024-01-15 14:30    │
└─────────────────────────────────────┘

3. Usage Statistics

┌─────────────────────────────────────┐
│ Usage Statistics                    │
├─────────────────────────────────────┤
│ Today:                              │
│ • Messages Received: 123            │
│ • Messages Sent: 145                │
│ • Conversations: 45                 │
│                                     │
│ This Month:                         │
│ • Messages Received: 3,456          │
│ • Messages Sent: 4,123              │
│ • Conversations: 1,234              │
└─────────────────────────────────────┘

4. Connected Campaigns

┌─────────────────────────────────────┐
│ Connected Campaigns                 │
├─────────────────────────────────────┤
│ 1. Campaign Tết 2024                │
│    Status: Active                   │
│    Messages: 456                    │
│    [View Campaign]                  │
│                                     │
│ 2. Campaign Black Friday            │
│    Status: Active                   │
│    Messages: 234                    │
│    [View Campaign]                  │
└─────────────────────────────────────┘

Chỉnh sửa Facebook Page

Cách mở: Click "Edit" trong Actions menu

Có thể chỉnh sửa:

1. Display Name

• Tên hiển thị trong hệ thống
• Không ảnh hưởng tên Page trên Facebook

2. Settings

• Auto-accept messages: Tự động chấp nhận tin nhắn
• Message tags: Tags mặc định cho tin nhắn
• Response time: Thời gian phản hồi mục tiêu

3. Notifications

• New message: Thông báo tin nhắn mới
• Connection issues: Thông báo lỗi kết nối
• Token expiring: Thông báo token sắp hết hạn

Reconnect Facebook Page

Khi nào cần reconnect:

• Token hết hạn
• Permissions bị thu hồi
• Connection bị lỗi
• Đổi Page admin

Cách reconnect:

Bước 1: Click "Reconnect" trong Actions menu Bước 2: Đăng nhập Facebook (nếu cần) Bước 3: Cấp lại permissions Bước 4: Xác nhận reconnect Bước 5: Kiểm tra connection status

Lưu ý:

• Conversations cũ vẫn giữ nguyên
• Không mất dữ liệu
• Webhook tự động re-register

Disconnect Facebook Page

Cảnh báo: Ngắt kết nối sẽ:

• ❌ Ngừng nhận tin nhắn mới
• ❌ Không gửi được tin nhắn
• ✅ Conversations cũ vẫn xem được
• ✅ Dữ liệu không bị xóa

Cách disconnect:

Bước 1: Click "Disconnect" trong Actions menu Bước 2: Dialog xác nhận hiển thị

┌─────────────────────────────────────┐
│ ⚠️ Disconnect Facebook Page?        │
├─────────────────────────────────────┤
│ Are you sure you want to disconnect │
│ "Shop Thời Trang ABC"?              │
│                                     │
│ This will:                          │
│ • Stop receiving new messages       │
│ • Remove webhook subscription       │
│ • Revoke access token               │
│                                     │
│ Connected campaigns (2):            │
│ • Campaign Tết 2024                 │
│ • Campaign Black Friday             │
│                                     │
│ These campaigns will no longer      │
│ receive messages from this Page.    │
│                                     │
│ [Cancel] [Disconnect]               │
└─────────────────────────────────────┘

Bước 3: Nhập tên Page để xác nhận Bước 4: Click "Disconnect" Bước 5: Page bị ngắt kết nối

Sau khi disconnect:

• Status chuyển thành "Disconnected"
• Không hiển thị trong campaign
• Có thể reconnect bất cứ lúc nào

Quản lý Telegram Bots

Xem chi tiết Telegram Bot

Thông tin hiển thị:

1. Basic Information

┌─────────────────────────────────────┐
│ 📱 Support Bot                      │
├─────────────────────────────────────┤
│ Platform: Telegram                  │
│ Bot Username: @support_bot          │
│ Bot ID: 123456789                   │
│ Created: 2024-01-01                 │
│ Connected: 2024-01-05               │
│ Status: 🟢 Active                   │
└─────────────────────────────────────┘

2. Bot Configuration

┌─────────────────────────────────────┐
│ Bot Configuration                   │
├─────────────────────────────────────┤
│ Bot Token: Valid                    │
│ Privacy Mode: Disabled              │
│ Webhook: Active                     │
│ Webhook URL: https://...            │
│ Last Received: 2024-01-15 14:30    │
│                                     │
│ Commands:                           │
│ /start - Start conversation         │
│ /help - Get help                    │
│ /cancel - Cancel operation          │
└─────────────────────────────────────┘

3. Usage Statistics

┌─────────────────────────────────────┐
│ Usage Statistics                    │
├─────────────────────────────────────┤
│ Today:                              │
│ • Messages Received: 67             │
│ • Messages Sent: 89                 │
│ • Users: 23                         │
│                                     │
│ This Month:                         │
│ • Messages Received: 1,234          │
│ • Messages Sent: 1,567              │
│ • Users: 456                        │
└─────────────────────────────────────┘

Chỉnh sửa Telegram Bot

Có thể chỉnh sửa:

1. Bot Information

• Display name
• Description
• Avatar

2. Bot Commands

• Add/edit/delete commands
• Command descriptions
• Command handlers

3. Settings

• Privacy Mode: Enable/Disable
• Group Mode: Allow bot in groups
• Inline Mode: Enable inline queries

Regenerate Bot Token

Khi nào cần:

• Token bị lộ
• Nghi ngờ bị hack
• Định kỳ (khuyến nghị 6 tháng)

Cách regenerate:

Bước 1: Vào @BotFather trên Telegram Bước 2: Gửi lệnh /mybots Bước 3: Chọn bot của bạn Bước 4: Chọn "API Token" Bước 5: Chọn "Revoke current token" Bước 6: BotFather tạo token mới Bước 7: Copy token mới Bước 8: Vào Platform Management Bước 9: Click "Update Token" trên bot Bước 10: Paste token mới Bước 11: Click "Save"

Lưu ý:

• Token cũ ngay lập tức không dùng được
• Phải cập nhật token mới ngay
• Nếu không, bot sẽ ngừng hoạt động

Disconnect Telegram Bot

Tương tự như disconnect Facebook Page