Kênh: Telegram, WhatsApp, VK
Kết nối Telegram, WhatsApp và VK với một dự án; xem khả năng của từng kênh và nơi bot gửi câu trả lời.
Trên trang này
Một dự án GetMyBot có thể trả lời qua Telegram, WhatsApp và VK. Ví dụ, cùng một quy tắc về lịch học dùng được trong cả ba ứng dụng. Bot trả lời ngay tại kênh mà người dùng đã liên hệ.
Khi thêm ứng dụng nhắn tin khác, hãy kiểm tra nút và hành động: mỗi nền tảng hỗ trợ những tính năng khác nhau. Dưới đây là điểm khác biệt và cách kết nối.
Kênh là gì?
Kênh là một nơi giao tiếp đã kết nối: một bot Telegram cụ thể, số WhatsApp Business hoặc cộng đồng VK. Một bot GetMyBot có thể có nhiều kênh. Các phản ứng dùng chung: khi người đăng ký viết qua WhatsApp, cùng các phản ứng như ở Telegram sẽ xử lý sự kiện, rồi câu trả lời được gửi trở lại WhatsApp.
Nút, định dạng văn bản và hành động không có mặt trên mọi ứng dụng. Trình tạo bot có thể ẩn tùy chọn không được hỗ trợ hoặc chuyển sang cách hiển thị phù hợp. Hãy thử tin nhắn trên từng kênh trước khi đưa vào sử dụng.
Kênh chính (primary_channel)
Mỗi bot có một kênh chính (primary_channel), tức nền tảng gắn với bot trước tiên. Thông thường là Telegram, nhưng bạn cũng có thể tạo bot bắt đầu bằng WhatsApp hoặc VK mà không kết nối Telegram. Kênh chính được xác định khi tạo bot và hiển thị trong danh sách bot. Các kênh khác có thể thêm sau.
Khả năng của từng kênh
Đây là những tính năng được hỗ trợ. API cũng cung cấp bảng khả năng ở dạng máy đọc được: GET /api/channels/capabilities.
Telegram có đầy đủ: nút inline và bàn phím trả lời, callback (nhấn nút để chạy phản ứng), phản ứng emoji, liên kết /start, sửa, xóa và chuyển tiếp tin nhắn, kích hoạt bằng câu trả lời, sự kiện thành viên, quyền và kiểm duyệt. Các thẻ ảnh có thể chuyển bằng nút trong cùng một tin nhắn nếu đủ điều kiện về file_id như mô tả bên dưới. Định dạng: Plain / HTML / Markdown. Telegram không cần mẫu tin nhắn, danh sách tương tác hoặc giới hạn phiên nhắn tin.
WhatsApp qua WhatsApp Cloud API hỗ trợ nút inline, callback, phản ứng emoji, liên kết /start, mẫu tin nhắn, danh sách tương tác và cửa sổ phiên 24 giờ. Định dạng: Plain / Markdown. Kênh này không hỗ trợ bàn phím trả lời, sửa, xóa, chuyển tiếp tin nhắn, kích hoạt bằng câu trả lời, sự kiện thành viên, quyền/kiểm duyệt hoặc chuyển thẻ ảnh trong một tin nhắn. Xem WhatsApp.
VK hỗ trợ tin nhắn và tệp đính kèm, nút inline và bàn phím trả lời, callback, phản ứng emoji, liên kết /start, sửa, xóa và chuyển tiếp tin nhắn, sự kiện thành viên, cấm/bỏ cấm, chấp thuận yêu cầu gia nhập cộng đồng kín đã được gửi, và sự kiện thuê bao trả phí VK Donut. Chỉ có văn bản thuần: HTML/Markdown được loại bỏ khi hiển thị. VK không có mẫu WhatsApp, danh sách tương tác, chuyển thẻ ảnh trong một tin nhắn hay cửa sổ phiên.
Cả ba kênh đều hỗ trợ nút inline, callback, phản ứng emoji và liên kết /start. Khối ảnh nhiều thẻ dùng được ở các kênh hỗ trợ ảnh. Trong Telegram, các thẻ chuyển trong một tin nhắn chỉ khi mọi ảnh có file_id phù hợp. Nếu thiếu ID phù hợp cho dù chỉ một ảnh, toàn bộ thẻ sẽ được gửi thành các tin nhắn ảnh riêng. WhatsApp và VK cũng gửi từng thẻ riêng. Xem Tin nhắn và nút.
VK Donut
Nếu cộng đồng bật VK Donut, bot nhận các sự kiện hệ thống về thuê bao trả phí:
| Sự kiện trong trình tạo | Khóa | Giá trị có thể chèn |
|---|---|---|
| VK Donut: bắt đầu | donut_subscription_created | {{event.donut_amount}}, {{event.donut_amount_without_fee}} |
| VK Donut: gia hạn | donut_subscription_prolonged | {{event.donut_amount}}, {{event.donut_amount_without_fee}} |
| VK Donut: hết hạn | donut_subscription_expired | Không có |
| VK Donut: hủy | donut_subscription_cancelled | Không có |
{{event.donut_amount}} là số tiền thanh toán; {{event.donut_amount_without_fee}} là số tiền sau khi trừ phí VK. Sự kiện hết hạn và hủy không có số tiền: kết thúc một kỳ đã trả phí không cho biết khoản thu nào vừa xảy ra. Lấy lại số tiền của kỳ trước sẽ tạo ra thông tin sai.
Đây là sự kiện về người đăng ký, không phải tin nhắn từ họ. Nó không đánh dấu cuộc trò chuyện là có thể nhắn riêng, không bỏ trạng thái chặn, không cập nhật “hoạt động gần nhất” và không tăng số tin nhắn. Việc trừ tiền từ thẻ không có nghĩa người đó vừa viết cho bot. Nếu người đăng ký chưa có trên nền tảng, hệ thống sẽ tạo hồ sơ để có thể áp dụng nhãn và quyền.
Ví dụ về câu lạc bộ thuê bao:
- Phản ứng với VK Donut: bắt đầu và gia hạn: dùng Đổi nhãn để thêm nhãn “Câu lạc bộ”, đặt
ttl_days = 31; gửi liên kết đến cộng đồng kín và mời người dùng nộp yêu cầu tham gia. - Chấp thuận là bước riêng, sau khi người dùng đã nộp yêu cầu. Đổi quyền → Chấp thuận yêu cầu chỉ xử lý yêu cầu đã gửi (
groups.approveRequest). Khi chưa có yêu cầu, bot không có gì để chấp thuận. Đặt hành động này trong phản ứng xảy ra sau bước 1, chẳng hạn khi người dùng nhấn “Tôi đã gửi yêu cầu” hoặc ở sự kiện gia hạn tiếp theo. - Với Nhãn hết hạn (
label_expired), dùng Đổi quyền → Loại khỏi cộng đồng. Nhờ vậy, người dùng rời câu lạc bộ đúng lúc nhãn hết hạn, kể cả khi VK chưa gửi sự kiện thuê bao kết thúc. Xem Trình kích hoạt: nhãn hết hạn. - Với VK Donut: hủy và hết hạn, dùng Đổi nhãn → xóa “Câu lạc bộ” và, nếu cần, Loại khỏi cộng đồng ngay.
Trong các hành động quản lý quyền của VK, ô Cuộc trò chuyện (chat_id) phải là ID của cộng đồng VK đã kết nối. Đây là số hiển thị cạnh kênh VK trong danh sách kênh. VK chỉ cho bot quản lý thành viên của chính cộng đồng đó. ID khác sẽ bị từ chối trước khi gửi sang VK. Muốn quản lý cộng đồng khác, hãy kết nối nó thành kênh riêng.
Bật sự kiện bằng cách:
- Long Poll: bot tự đăng ký khi kết nối kênh và mỗi lần nền tảng khởi động. Cộng đồng đã kết nối không cần thao tác thêm.
- Callback API: vào cài đặt cộng đồng, mở Làm việc với API → Callback API → Loại sự kiện → VK Donut và bật cả bốn sự kiện trong bảng.
Kết nối kênh
Thêm kênh trên trang Dự án.
- Mở Dự án và tìm dự án cần dùng.
- Nhấn Thêm kênh trên thẻ dự án.
- Chọn Telegram, WhatsApp hoặc VK.
- Nhập thông tin kết nối: token cho Telegram, thông tin Meta cho WhatsApp, thông tin cộng đồng cho VK.
- Nhấn Kiểm tra để nền tảng xác minh thông tin với ứng dụng nhắn tin.
- Nhấn Kết nối.
Sau khi kết nối WhatsApp hoặc VK, kênh hiển thị địa chỉ webhook (biểu tượng 🔗). Bạn phải đăng ký địa chỉ này trên nền tảng tương ứng – trong ứng dụng Meta đối với WhatsApp hoặc cài đặt cộng đồng đối với VK – để bot nhận sự kiện. Xem WhatsApp: thiết lập webhook.
Tiếp theo
- WhatsApp: kết nối, webhook, cửa sổ phiên và mẫu tin nhắn.
- Dự án và kênh: cách kết nối bot cơ bản.
- Cơ bản về phản ứng: thiết lập chung cho tất cả kênh.
Thông tin xác thực của kênh
Telegram dùng toàn bộ token BotFather. VK cần token cộng đồng và ID cộng đồng dạng số; Callback API còn cần chuỗi bí mật và mã xác nhận. WhatsApp cần Phone Number ID, ID tài khoản WhatsApp Business, token có quyền truy cập tài khoản, Verify Token của webhook và App Secret của ứng dụng Meta.
Hãy kiểm tra thông tin trước khi kết nối. Khi đổi khóa, cập nhật thiết lập tương ứng ở nhà cung cấp: Verify Token xác nhận địa chỉ webhook, App Secret kiểm tra chữ ký của sự kiện đến. Cả hai không thay thế token truy cập API.
Sự kiện đến và địa chỉ webhook
Với VK Callback API, đăng ký địa chỉ MyBot hiển thị trong cài đặt máy chủ của cộng đồng; chuỗi bí mật và mã xác nhận phải khớp ở hai bên. Long Poll không cần địa chỉ công khai hoặc hai giá trị này. Với WhatsApp, đăng ký địa chỉ trong ứng dụng Meta, nhập cùng Verify Token và đăng ký các sự kiện tin nhắn cần nhận. Chỉ nhập thông tin để gửi tin vẫn chưa đủ để nhận tin.
Cấp quyền cho Instagram và Messenger
Trình kết nối mở quy trình cấp quyền của Meta. Đăng nhập bằng tài khoản quản lý trang Facebook hoặc tài khoản Instagram chuyên nghiệp cần dùng, cấp các quyền được yêu cầu, rồi chọn tài khoản cho dự án. Trình hướng dẫn kiểm tra quyền, đăng ký webhook và khả năng giao tin; hãy xử lý những mục kiểm tra thất bại trước khi dùng kênh. Với kết nối đã có, bạn có thể xem lại các tài khoản được chọn.