Nhập từ sambot
Cách chuyển phản ứng, nhãn, tệp và lịch sử trò chuyện từ sambot. Nội dung các tệp nén và khác biệt giữa chế độ thêm và thay thế.
Trên trang này
Để chuyển từ sambot.ru, trước tiên hãy tải dữ liệu của bot về một tệp nén, sau đó tải tệp này lên GetMyBot. Bạn có thể chuyển phản ứng, nhãn, hình ảnh và tệp. Lịch sử trò chuyện được tải lên bằng một tệp nén riêng.
Nếu không dùng dòng lệnh, hãy chọn tiện ích mở rộng Chrome. Để xuất tự động, có công cụ xuất bằng Python. Sau khi chuyển, hãy kiểm tra lệnh, nút và tệp trong cuộc trò chuyện với bot trước khi đưa khách hàng đến bot.
Những gì được chuyển
- Phản ứng: toàn bộ hành vi của bot.
- Nhãn: thẻ người đăng ký kèm màu sắc.
- Media: hình ảnh và tệp mà các phản ứng tham chiếu đến.
- Lịch sử hội thoại: các cuộc trò chuyện giữa bot và người dùng (trong tệp nén riêng).
Nhập tệp nén phản ứng
Tệp nén phản ứng có tên mybot-export.zip. Trong mục Phản ứng, nhấn Nhập kho lưu trữ, chọn tệp và chế độ tải lên. Với API, dùng POST /api/bots/{id}/reactions/import. Tài liệu kỹ thuật cũng gọi tệp nén này là bundle. Bên trong có:
manifest.json: phần đầu gồm phiên bản định dạng, nguồn (sambot), tên bot, ngày xuất, bộ đếm.reactions.json: mảng phản ứng (bắt buộc).labels.json: danh sách nhãn (không bắt buộc).media/<sha256>.<ext>: tệp media (không bắt buộc).
Có hai chế độ:
- Thêm (
append): phản ứng trong tệp nén được thêm vào các phản ứng hiện có. - Thay thế (
replace): các phản ứng hiện tại của bot bị xóa, sau đó phản ứng từ tệp nén được tải lên.
Tổng dung lượng các tệp sau khi giải nén tệp phản ứng được giới hạn ở 64 MiB.
Nhập lịch sử hội thoại
Lịch sử trò chuyện được chuyển bằng tệp nén riêng mybot-dialogs.zip. Tệp này chứa hồ sơ người dùng cùng tin nhắn và tệp đính kèm của họ, nên sau khi nhập, các cuộc trò chuyện cũ hiện ngay trong mục Người dùng.
Có ba cách tải tệp nén lên:
- nút "Nhập lịch sử" trong mục Người dùng, nếu bạn có quyền với hội thoại;
- qua API:
POST /api/bots/{id}/dialogs/import(multipart, trườngfile) với token cá nhân có scopesubscribers:write. Tiến độ nhập được trả về quaGET /api/bots/{id}/dialogs/import/{import_id}; - qua MCP: công cụ
import_dialogsnhận tệp nén dạng base64 tối đa 48 MB, trạng thái được trả về quaget_dialog_import.
Quá trình nhập chạy nền và không gửi gì cho ai. Tin nhắn có tg_message_id đã được tải lên trước đó sẽ bị bỏ qua, nên bạn có thể tải lại tệp nén hoặc tải theo từng phần. Lịch sử hội thoại được lưu vô thời hạn.
Tổng dung lượng các tệp sau khi giải nén tệp hội thoại được giới hạn ở 256 MiB.
Công cụ xuất (Python)
Gói tools/sambot_export đọc các trang bot của bạn trên sambot.ru, tải tệp về và tạo tệp nén ZIP. Để truy cập, cần một tệp cookie chứa dữ liệu của phiên trình duyệt đang mở. Lệnh dành cho nhà phát triển, chạy từ thư mục tools/sambot_export: python -m exporter --cookie-file cookie.txt --bot 42785 --out mybot-export.zip.
- Mặc định, công cụ xuất phản ứng, nhãn và media.
- Chế độ
--mode dialogsxuất lịch sử hội thoại vào tệpmybot-dialogs.zipriêng. - Xác thực: chỉ bằng cookie của phiên trình duyệt đang mở. Mật khẩu không dùng được vì biểu mẫu đăng nhập được bảo vệ khỏi các yêu cầu tự động.
Tiện ích mở rộng Chrome
Nếu không muốn chạy lệnh, hãy dùng tiện ích Chrome "GetMyBot: xuất từ sambot". Tiện ích xuất bot ngay từ trang sambot.ru: yêu cầu quyền truy cập thẻ đang mở và mục tải xuống, hoạt động với https://sambot.ru/*, và cookie phiên không rời khỏi trình duyệt. Tiện ích tạo ra cùng loại tệp nén ZIP để nhập vào GetMyBot.
Trình tự chuyển đổi
- Xuất bot bằng công cụ xuất hoặc tiện ích mở rộng: bạn sẽ nhận được
mybot-export.zip(vàmybot-dialogs.zipnếu cần). - Nhập tệp nén phản ứng vào bot (chế độ "Thêm" hoặc "Thay thế").
- Nếu cần, nhập lịch sử hội thoại.
- Kiểm tra phản ứng và nhãn. Nếu đã chuyển tệp, hãy kiểm tra thư viện tệp.
Bước tiếp theo
- Phản ứng: kiến thức cơ bản: nhập và xuất từng phản ứng.
- Người dùng (CRM): nơi lịch sử hội thoại đã nhập xuất hiện.
- Thư viện tệp: nơi lưu media đã chuyển.
- Dự án và kênh: kết nối bot trước khi nhập.