Cơ sở kiến thức GetMyBot

Tích hợp

Kết nối bot với Google Sheets, Drive, GetCourse hoặc AI: lưu thông tin truy cập rồi chọn hành động trong phản ứng.

Trên trang này

Tích hợp giúp bot làm việc với dịch vụ khác, chẳng hạn thêm yêu cầu vào Google Sheets hoặc chuyển khách hàng sang GetCourse. Bạn cần làm hai việc: lưu kết nối trước, rồi chọn kết nối đó trong hành động của phản ứng.

Mở Tích hợp → Thêm tích hợp, chọn dịch vụ và điền thông tin. Dữ liệu truy cập được mã hóa khi lưu. Trên thẻ kết nối, bạn có thể bật, tắt hoặc mở Cài đặt.

Dịch vụ khả dụng

  • AI — mô hình ngôn ngữ (API tương thích OpenAI). Xem Phản hồi AI.
  • Google Sheets — thêm, đọc, tìm và cập nhật dòng theo tên cột (xem Hành động).
  • Google Drive — tải file vào thư mục.
  • GetCourse — tạo, cập nhật và xuất người dùng, giao dịch và nhóm.
  • Webhook — gửi dữ liệu qua HTTP đến bất kỳ dịch vụ nào.
  • Bộ xử lý bên ngoài — kết nối backend của bạn qua WebSocket: phản ứng được xử lý bởi server của bạn. Xem Bộ xử lý bên ngoài.

Google Calendar cũng kết nối được, nhưng qua AI → Lịch bằng OAuth, không qua màn hình này. Tại đó bạn cũng thiết lập loại cuộc hẹn. Xem Cuộc hẹn và Google Calendar.

Các CRM amoCRM/Kommo, Bitrix24, RetailCRM và OzmaCRM có mục riêng Tích hợp → CRM. Tại đó bạn kết nối hệ thống, ghép các trường với GetMyBot, xem trước dữ liệu, xem nhật ký đồng bộ và xử lý xung đột. Dữ liệu đi hai chiều. amoCRM/Kommo dùng OAuth, RetailCRM dùng API key, OzmaCRM dùng OIDC, Bitrix24 dùng webhook đến của cổng. Xem Tích hợp CRM.

Cài đặt

Khi thêm, chọn Dịch vụ, đặt Tên và các trường cấu hình tùy theo loại:

Webhook

  • URL webhook — địa chỉ của người nhận.
  • Chữ ký HMAC (bí mật) — để xác minh tính xác thực; yêu cầu được ký với header X-Signature: sha256=....

GetCourse

  • Tài khoản: tên trường học, chẳng hạn myschool, và Khóa bí mật API.
  • Đối tượng: Người dùng hoặc Giao dịch.

Hành động GetCourse có hai loại công việc.

Gửi dữ liệu đến GetCourse. Các trường chia theo phần như API của GetCourse: Người dùng (email, phone, first_name, last_name, city, country, group_name), Thiết lập nhập (như refresh_if_exists), Nguồn truy cập (utm_source, utm_campaign, referer), Giao dịch (offer_code, deal_cost, deal_status, deal_is_paid) và Trường bổ sung. Bạn có thể lấy giá trị từ khách, như email = {{param.email}}, hoặc nhập giá trị cố định như utm_source = telegram. Gợi ý tên nhóm và trường bổ sung lấy từ tài khoản GetCourse của bạn; nếu không tải được, có thể nhập tên bằng tay. Hành động cũ dùng một danh sách trường vẫn hoạt động. Nút Chuyển thành các phần đặt khóa đã biết vào đúng phần, khóa còn lại vào trường bổ sung.

Nếu GetCourse trả HTTP 200 nhưng nội dung là success: false, hành động vẫn thất bại và hiển thị error_message. Khi thành công, các ID {user_id, deal_id, lead_id} được lưu trong dữ liệu tạm của phản ứng; giá trị không có là số không.

Lấy dữ liệu từ GetCourse. Các thao tác Xuất người dùng, Xuất giao dịch, Xuất nhóm bắt đầu quá trình xuất ở GetCourse và chờ tối đa 25 giây. Nếu chưa có kết quả, hành động báo export_not_ready: hãy thử lại sau hoặc thu hẹp bộ lọc. Bộ lọc gồm các dòng “khóa, kiểu, giá trị”, ví dụ created_at[from] = 2026-10-01; khóa không nhận diện được vẫn được gửi nguyên. Mỗi lần trả tối đa 1.000 dòng, mặc định 50; tên trường theo tài khoản GetCourse. has_more trong Thông tin trang cho biết còn trang sau. GetCourse giới hạn tần suất xuất, nên dùng kịch bản chạy thưa hoặc theo lịch, không xuất sau mỗi tin nhắn.

Google Sheets

  • Liên kết bảng tính hoặc ID của bảng.
  • JSON tài khoản dịch vụ (bí mật): khóa của tài khoản Google dành cho chương trình. Hãy cấp cho địa chỉ email của tài khoản này quyền truy cập bảng tính. Nếu thiếu, đọc và ghi sẽ báo lỗi quyền trong trình chỉnh sửa hành động và khi kiểm tra tích hợp.

Các trường được ghép với tên cột trong hàng tiêu đề; mặc định là hàng đầu nhưng có thể chọn hàng khác. Các thao tác:

  • Thêm dòng: ghi mỗi giá trị vào cột có cùng tên; thứ tự cột không quan trọng. Tên cột không tồn tại là lỗi. Kết quả {row_number, range}.
  • Đọc các dòng: trả các dòng sau hàng tiêu đề thành đối tượng có số dòng _row. Mặc định 50 dòng, tối đa 500; có thể lưu has_more và next_offset vào khóa riêng.
  • Đọc dòng cuối và Tìm dòng: đọc bảng theo trang; nếu bảng quá lớn, hành động báo lỗi thay vì trả sai dòng.
  • Cập nhật dòng: sửa ô của dòng row_number, ví dụ {{ctx.found.row_number}} sau bước tìm.

Bạn có thể ghi giá trị như khi nhập trong Google Sheets để nhận diện công thức, ngày, hoặc ghi dưới dạng văn bản. Trình chỉnh sửa cho chọn tên cột lấy từ bảng; nếu không đọc được tiêu đề, bạn có thể nhập tay. Xem trước các dòng hiển thị tối đa 20 dòng mà không sửa bảng. Kết quả xem trước giúp chọn trường cho phân tích phản hồi ở bước sau.

Google Drive

  • ID thư mục.
  • JSON tài khoản dịch vụ (bí mật). Cấp quyền chỉnh sửa thư mục cho tài khoản này.

Hành động Google Drive tải tệp với tên, kiểu MIME và nội dung. ID cùng liên kết {file_id, web_view_link} được lưu trong dữ liệu tạm, ví dụ dưới khóa upload. Sau đó dùng {{ctx.upload.web_view_link}} để chèn liên kết. Có thể thiết lập phân tích phản hồi như các hành động khác.

AI

  • Base URL, Mô hình, System prompt, API key (bí mật). Chi tiết — Phản hồi AI.

Một kết nối AI dùng cho hành động AI trong phản ứng, AI agent và việc chuẩn bị nguồn kiến thức để tìm kiếm. Khi chuẩn bị, mô hình tạo biểu diễn số của văn bản, gọi là embedding, qua cùng base URL và API key; mặc định dùng text-embedding-3-small. Nếu kết nối AI không hoạt động, nguồn kiến thức không thể chuẩn bị để tìm kiếm và agent không thể được bật.

Bộ xử lý bên ngoài

Tích hợp WebSocket: server của bạn kết nối đến GetMyBot và xử lý phản ứng, phản hồi bằng lệnh theo định dạng Telegram Bot API.

  • Địa chỉ WebSocket — nơi dịch vụ của bạn kết nối đến.
  • Token kết nối (bí mật) — hiển thị một lần khi tạo; có nút tái phát hành.

Chi tiết, giao thức và ví dụ dịch vụ — Bộ xử lý bên ngoài.

Sử dụng trong phản ứng

  • AI và Webhook có thể dùng ngay dưới dạng hành động/kênh: thêm hành động AI hoặc gửi dữ liệu bằng hành động Yêu cầu web đến địa chỉ webhook.
  • Các hành động GetCourse, Google Sheets, Google Drive có trong trình tạo phản ứng. Mỗi hành động có thể phân tích phản hồi để chọn giá trị từ kết quả và lưu vào ngữ cảnh. Nếu lỗi, hành động đi theo nhánh lỗi đã thiết lập. Nếu gói dịch vụ không có tính năng này, bước báo feature_unavailable.

Kiểm tra tích hợp

Thẻ tích hợp có nút Kiểm tra. Việc kiểm tra không ghi dữ liệu: Google Sheets đọc thông tin bảng, Google Drive đọc thông tin thư mục, GetCourse thực hiện yêu cầu đọc an toàn. Với AI, nó chỉ kiểm tra các ô đã được điền, không gọi mô hình có tính phí. Các loại còn lại không có phép kiểm tra. Kết quả cho thấy từng mục đạt hay lỗi kèm giải thích ngắn.

Bảo mật

GetMyBot không gửi yêu cầu tích hợp tới địa chỉ nội bộ và giới hạn kích thước câu trả lời. Điều này ngăn yêu cầu đến địa chỉ không dành cho truy cập bên ngoài (SSRF). Bí mật tích hợp được mã hóa khi lưu.

Việc đọc website và tệp có giới hạn riêng: chỉ URL HTTPS được phép, tôn trọng robots.txt, giới hạn chuyển hướng, kích thước và thời gian, không chạy macro, script hoặc đối tượng nhúng. Xem Nguồn kiến thức.

Bước tiếp theo

Nhận dạng giọng nói

Chọn nhà cung cấp tương thích OpenAI hoặc dịch vụ riêng, rồi nhập base URL của API, mô hình và API key. Mã ngôn ngữ tùy chọn như ru hoặc en gợi ý ngôn ngữ nói; để trống để nhà cung cấp tự xác định. Khóa và mô hình phải thuộc nhà cung cấp đã chọn.