Cơ sở kiến thức GetMyBot

Người dùng (CRM)

Tìm khách hàng, xem trò chuyện, gắn nhãn và lưu số điện thoại hoặc thông tin khác. Hồ sơ, bộ lọc và xuất dữ liệu.

Trên trang này

Mục Người dùng lưu những khách hàng đã nhắn cho bot. Mở hồ sơ để xem cuộc trò chuyện, tệp và thông tin đã lưu như số điện thoại, khóa học quan tâm hoặc trạng thái thanh toán. Hồ sơ được tạo và cập nhật tự động theo sự kiện.

Cơ sở khách hàng này còn gọi là CRM. Nhãn giúp chọn nhanh một nhóm như “Đã thanh toán”; tham số lưu một giá trị cụ thể như phone hoặc order_id.

Danh sách người dùng

Bảng hiển thị tên, Telegram ID, nhãn và hoạt động gần đây, kể cả việc người đó chặn bot. Bạn có thể tìm theo tên hoặc ID và dùng các nút lọc Tất cả, VIP, Đã thanh toán, Mới, Hủy đăng ký. Mỗi nút có số người tương ứng. Nhấn một hàng để mở cuộc trò chuyện.

Nút Đã chặn bot chỉ hiện những người đã chặn bot; ngày chặn nằm trong hồ sơ. Xuất CSV tải danh sách sau khi áp dụng tìm kiếm và bộ lọc, tối đa 10.000 hàng. Tệp mở được bằng bảng tính. Các cột là tg_user_id, name, username, platform, is_blocked, blocked_at, first_seen, last_seen, labels; nhãn cách nhau bằng ;, ngày ở định dạng RFC3339. Ô văn bản được bảo vệ khỏi việc chạy như công thức. Nếu chạm giới hạn, API trả header X-Export-Truncated: true. Nếu dùng API: GET /api/bots/{botID}/users?is_blocked=true&format=csv. Tham số is_blocked=true|false cũng dùng được với danh sách JSON; người đã chặn bot có trường blocked_at.

Những gì được lưu về người dùng

Thẻ người dùng chứa: avatar, tên, @username, liên kết "Mở trong Telegram", bộ đếm (tin nhắn, đối thoại đầu tiên và cuối cùng), nhãn và tham số toàn cục. Cũng được ghi chú nếu người dùng đã chặn bot hoặc đang chờ phản hồi của người điều hành.

Nguồn người đăng ký cho biết liên kết nào đã đưa khách đến bot lần đầu. Chẳng hạn, một liên kết riêng cho quảng cáo mùa xuân giúp phân biệt khách từ chiến dịch đó. Các giá trị nhận diện nguồn quảng cáo gọi là nhãn UTM. Trong Telegram, phần sau start= của liên kết gọi là payload hoặc nhãn khởi động.

Ví dụ về liên kết:

  • Telegram: t.me/<bot>?start=utm_source-vk__utm_medium-cpc__utm_campaign-spring. Telegram chỉ cho chữ, số, _ và - trong payload; các cặp cách nhau bằng __, tên và giá trị cách nhau bằng dấu - đầu tiên.
  • VK: vk.me/<group>?ref=utm_source=vk&utm_medium=post.
  • Giới thiệu: t.me/<bot>?start=ref_<ID của người giới thiệu>. Hồ sơ và {{referrals.count}} cho biết người đó đã mời bao nhiêu người. ref=<ID> và ref_<ID> được xử lý riêng với UTM.

Năm trường được lưu là utm_source, utm_medium, utm_campaign, utm_content, utm_term. Mỗi trường lấy giá trị không rỗng đầu tiên. Chúng có trong biến thay thế và nhóm người dùng dưới dạng attribution.utm_source … utm_term.

Nguồn được ghi theo liên kết khởi động đầu tiên có nhãn không rỗng, gọi là first-touch. Những lần /start sau không đổi nguồn hoặc thêm UTM từ liên kết mới. Nếu nhãn đầu chỉ là giá trị tùy ý hoặc mã giới thiệu, UTM vẫn rỗng. Liên kết không có nhãn không ghi nguồn.

Trong nhóm người dùng, UTM từ liên kết được ưu tiên hơn nhãn cùng tên lấy từ lượt truy cập website. Trường không có trong liên kết được lấy từ dữ liệu web; liên kết không có UTM không xóa dữ liệu web. Nguồn gắn với kênh của lần khởi động đầu và chỉ xuất hiện trong nhóm sau khi tính lại, nếu người đăng ký có cùng ID trên kênh đó.

Nhãn

Nhãn giúp chọn một nhóm người đăng ký, chẳng hạn “VIP”, “Đã thanh toán”, “Mới” hoặc “Hủy đăng ký”. Bạn có thể tạo nhãn riêng và chọn màu. Gắn nhãn bằng tay hoặc hành động Thay đổi nhãn, rồi dùng nó trong điều kiện và chọn người nhận gửi hàng loạt.

Nhãn có thể tồn tại lâu dài hoặc chỉ trong một số ngày. Khi hết hạn, nó tự được gỡ và bot nhận sự kiện Nhãn hết hạn. Nếu dùng API: POST /api/bots/{botID}/users/{tgUserID}/labels với UUID chuẩn label_id và ttl_days tùy chọn từ 0 đến 106751. ttl_days: 0 nghĩa là nhãn không hết hạn; hạn của nhãn tạm nằm trong label_expires_at của danh sách người dùng.

Tham số

Tham số lưu giá trị gắn với một người, như tên, email, tổng tiền, trạng thái đơn hàng hoặc điểm. Hành động Thay đổi tham số, Lưu tin nhắn và bước hội thoại điền các giá trị này. Sau đó dùng trong biến thay thế như {{param.key}} và trong điều kiện. Nhờ vậy bot có hồ sơ đơn giản cho từng khách hàng mà không cần cơ sở dữ liệu ngoài.

Đối thoại

Cuộc trò chuyện hiển thị văn bản, ảnh, video, tin nhắn thoại, tài liệu, nút và trạng thái giao tin. Các phản ứng đã gửi hiện thành thẻ riêng. Ở dưới, bạn có thể viết câu trả lời, đính kèm tệp hoặc gửi phản ứng từ danh sách.

Tệp đính kèm

Nút Tệp đính kèm mở thư viện tất cả tệp trong cuộc trò chuyện với bộ lọc Ảnh, Tệp, Giọng nói, Liên kết và nút Tải tất cả.

Lịch sử trò chuyện và nhập dữ liệu

Cuộc trò chuyện giữ toàn bộ lịch sử với người dùng. Tin cũ được tải thêm khi cuộn lên, nên bạn không phải chờ tải hết lịch sử dài. Tin mới xuất hiện ngay trong cuộc trò chuyện đang mở, như trong hộp thư nhân viên.

Nếu chuyển bot từ sambot, lịch sử được nhập cùng người dùng. Sau khi nhập, hồ sơ hiển thị ngay cuộc trò chuyện và tệp trước đó. Xem Nhập từ sambot.

Hồ sơ khách hàng và thao tác hàng loạt

Hồ sơ kết hợp thông tin cá nhân, dòng sự kiện (timeline), nhóm người dùng, cuộc trò chuyện và ghi chú của nhân viên. Dòng sự kiện tải theo từng phần và có thể lọc theo loại, nguồn và thời gian. Sau khi sửa thông tin hoặc nhãn, hãy lưu: thay đổi sẽ vào nhật ký và bắt đầu cập nhật nhóm người dùng.

Trong danh sách, bạn có thể chọn nhiều khách và áp dụng cùng một thông tin cho họ. Thao tác dùng danh sách người đã chọn được lưu tại thời điểm bắt đầu, tối đa 5.000 người và an toàn nếu gửi lại cùng yêu cầu. Xuất CSV tạo thao tác lưu riêng, có thể hủy trước khi tải xuống. Thay đổi hàng loạt đã áp dụng không thể hoàn tác từng phần.

Hợp nhất hồ sơ

Chủ dự án có thể chọn hai người trên cùng một trang danh sách và chọn Hợp nhất hồ sơ. Kiểm tra thông tin liên hệ và kênh, chọn hồ sơ chính rồi xác nhận. Lịch sử và dữ liệu được hợp nhất; khi có xung đột, hồ sơ chính được ưu tiên. Không thể hoàn tác thao tác này.

Hãy hoàn tất hoặc kiểm tra đồng bộ CRM hay thao tác Ozma còn dang dở. Cần xử lý trước các thông tin liên hệ mâu thuẫn và liên kết tới những bản ghi CRM khác nhau.

Email trùng nhau không tự động hợp nhất hồ sơ. Dùng identify có chữ ký để liên kết người dùng đã đăng nhập trên website; Liên kết Telegram đã xác nhận chỉ khả dụng khi tính năng được bật trong khu vực; chỉ kết nối kênh là chưa đủ.

Tiếp theo

Nhóm người dùng động

Trong mục Nhóm người dùng, chọn điều kiện và nối chúng bằng VÀ hoặc HOẶC. Xem trước nhóm trước khi lưu. Sau khi thay đổi, hãy tính lại số thành viên và kiểm tra nhóm đã sẵn sàng rồi mới dùng trong lượt gửi hàng loạt: chỉ lưu điều kiện không bảo đảm con số thành viên đã cập nhật.