ChatVeo — Kênh nhắn tin

Hướng dẫn kết nối Facebook / Telegram / Zalo

Làm theo từng bước dưới đây để lấy Token, sau đó quay lại trang Kênh nhắn tin trong ChatVeo (app.chatveo.com) để dán vào và kết nối.

✈️ Kết nối Telegram Bot

Cần: 1 tài khoản Telegram bất kỳ. Không tốn phí, làm xong trong 2 phút.

  1. Mở Telegram, tìm kiếm tài khoản tên @BotFather (có dấu tích xanh) và bắt đầu trò chuyện.
  2. Gõ lệnh /newbot rồi Enter.
  3. BotFather hỏi tên hiển thị của bot (VD: Noci88 Support) — gõ tên rồi Enter.
  4. BotFather hỏi tiếp username của bot — phải là chữ không dấu, không khoảng trắng và bắt buộc kết thúc bằng chữ "bot" (VD: noci88_support_bot).
  5. BotFather trả về một đoạn Token dạng: 123456789:AAExampleTokenStringHere. Bấm giữ để copy toàn bộ.
⚠️ Token này giống như mật khẩu của bot — chỉ dán vào đúng ô "Bot Token" trong ChatVeo, không chia sẻ cho ai khác.

Dán vào ChatVeo

Nền tảngTelegram
Bot Tokenđoạn Token vừa copy ở bước 5
✅ Sau khi bấm "Kết nối" trong ChatVeo, hệ thống tự động đăng ký webhook — không cần làm gì thêm trên Telegram. Tin nhắn khách gửi cho bot sẽ đổ ngay vào Hộp thư ChatVeo.
📖 Tài liệu chính thức: core.telegram.org/bots/tutorial ↗

📘 Kết nối Facebook Messenger

Cần: 1 Fanpage Facebook đã có sẵn + 1 tài khoản Meta for Developers (dùng chung tài khoản Facebook cá nhân để đăng nhập).

  1. Vào developers.facebook.com → đăng nhập bằng Facebook cá nhân (tài khoản quản trị Fanpage) → Tạo ứng dụng (Create App) → chọn loại "Doanh nghiệp" (Business).
  2. Trong Dashboard của ứng dụng vừa tạo, tìm mục Thêm sản phẩm → chọn Messenger → Thiết lập (Set up).
  3. Ở phần Access Tokens của Messenger, bấm Add or Remove Pages, đăng nhập và chọn đúng Fanpage cần kết nối, cấp quyền.
  4. Sau khi thêm Trang xong, bấm Generate Token cạnh tên Trang đó → copy đoạn Page Access Token hiện ra (dạng bắt đầu bằng EAAG...).
  5. Lấy App Secret: vào Cài đặt ứng dụng → Cơ bản (App Settings → Basic), tìm dòng "App Secret" → bấm Show (Facebook sẽ yêu cầu nhập lại mật khẩu) → copy.

Dán vào ChatVeo

Nền tảngFacebook Messenger
Page Access Tokenđoạn token bước 4
App Secretđoạn secret bước 5 (không bắt buộc, nhưng nên điền để xác thực webhook an toàn hơn)
✅ Sau khi bấm "Kết nối" trong ChatVeo, hệ thống sẽ hiện ra Callback URL và Verify Token ngay bên dưới form. Quay lại app Facebook: Messenger → Settings → Webhooks → Add Callback URL, dán 2 giá trị đó vào, rồi tick chọn các trường (fields) messages và messaging_postbacks để subscribe.
⚠️ Nếu chỉ tài khoản quản trị ứng dụng Meta kết nối được, hãy kiểm tra chế độ Live (nếu Meta hiển thị công tắc này) và các quyền pages_show_list, pages_manage_metadata, pages_messaging đã được cấp Advanced Access qua App Review cho người dùng ngoài vai trò ứng dụng. Chỉ chuyển sang Live không tự cấp các quyền này. Trong Development mode hoặc khi quyền còn Standard Access, chỉ tài khoản có vai trò phù hợp mới thử được.

💬 Kết nối Zalo Official Account (OA)

Cần: 1 Zalo OA đã được Zalo duyệt và đang hoạt động.

  1. Vào developers.zalo.me → đăng nhập bằng tài khoản Zalo đang quản trị OA.
  2. Vào mục Quản lý OA (OA Manager), chọn đúng OA cần kết nối.
  3. Tìm mục Công cụ quản lý → Kết nối API (API kết nối OA) — nếu OA chưa có ứng dụng liên kết, tạo 1 App mới trong phần Ứng dụng của tôi và liên kết App đó với OA.
  4. Trong App vừa tạo, vào tab Cấu hình / OA Access Token → lấy Access Token hiện tại.
  5. Lấy Secret Key ở tab Cài đặt ứng dụng → Secret key.

Dán vào ChatVeo

Nền tảngZalo OA
Access Tokenđoạn token bước 4
Secret Keyđoạn secret bước 5 (không bắt buộc, nhưng nên điền để xác thực webhook)
✅ Sau khi bấm "Kết nối" trong ChatVeo, hệ thống hiện ra Callback URL. Quay lại App trên developers.zalo.me → mục Webhook, dán Callback URL đó vào và bật (subscribe) sự kiện Người dùng gửi tin nhắn văn bản.
⚠️ Access Token của Zalo OA thường chỉ có hạn khoảng 25 giờ. Hệ thống ChatVeo hiện chưa tự động làm mới token — nếu sau một thời gian kênh Zalo ngừng gửi được tin, hãy quay lại developers.zalo.me lấy Access Token mới rồi vào ChatVeo ngắt kết nối cũ và kết nối lại với token mới.
📖 Tài liệu chính thức: developers.zalo.me/docs/official-account ↗