Chatbot AI Telegram có thể trả lời câu hỏi dựa trên kiến thức doanh nghiệp trong nhóm hoặc cuộc trò chuyện riêng. Quickchat AI kết nối AI Agent với Telegram qua bot dùng chung: thêm bot vào nhóm, xác nhận kết nối trong bảng điều khiển, rồi thành viên có thể nhắc tên bot để hỏi. Cách này không cần viết mã hay token BotFather.
Hướng dẫn này xây dựng Saltmarsh Sailing School, một trường hư cấu có nhóm thành viên và kênh hỏi đáp riêng. Hai Agent dùng cùng dữ liệu của trường: Saltmarsh Group trả lời câu hỏi công khai, còn Saltmarsh Sailing School tiếp nhận yêu cầu học thử riêng và chuyển yêu cầu hoàn tiền cho nhân viên. Yêu cầu là thông tin để văn phòng xử lý, không phải đặt chỗ đã được xác nhận.
Hai Agent tách biệt trách nhiệm. Agent nhóm không có Action chuyển nhân viên hay tiếp nhận; Agent riêng xử lý yêu cầu và câu trả lời của nhân viên.
Làm theo lộ trình dưới đây. Phần mở rộng Google Sheets là tùy chọn; bạn có thể hoàn tất luồng trả lời và chuyển nhân viên trước.
| Hạng mục | Điểm cần kiểm tra |
|---|---|
| 1. Kiến thức và chỉ dẫn | Agent biết giá khóa học và không bịa thông tin còn thiếu. |
| 2. Kết nối nhóm | Nhắc tên thì có trả lời; trò chuyện thông thường không kích hoạt bot. |
| 3. Chat riêng | Liên kết đầy đủ mở cuộc trò chuyện với đúng Agent. |
| 4. Yêu cầu học thử tùy chọn | Thông tin bắt buộc thành một hàng để nhân viên theo dõi. |
| 5. Human Handoff | Nhân viên tiếp quản cuộc trò chuyện và AI tạm dừng. |
| 6. Kiểm thử | Kiểm tra riêng câu trả lời, điều hướng và tác động bên ngoài. |
Tải bộ Saltmarsh Telegram để lấy đúng kiến thức, Main Prompt, cấu hình Action, tiêu chí đánh giá và tin nhắn thử nghiệm. Đây là các tệp có thể sửa cho những bước dưới đây, không phải gói nhập Agent bằng một lần nhấp. Tài liệu demo có thể sao chép và ảnh chụp màn hình vẫn bằng tiếng Anh.
Cần gì để tạo chatbot Telegram?
Bạn cần tài khoản Quickchat AI, hai Agent và tài khoản Telegram có quyền thêm bot vào nhóm thử nghiệm. Bước ghi nhận yêu cầu tùy chọn còn cần tài khoản Google có thể cấp quyền Google Sheets.
- Tạo tài khoản Quickchat AI và xác minh email nếu được yêu cầu. Free hỗ trợ học tập cá nhân, phi thương mại. Gói áp dụng cho từng Agent, nên doanh nghiệp sử dụng cả hai cần quyền sử dụng thương mại phù hợp cho mỗi Agent. Preview và Simulation tiêu thụ tín dụng AI. Xem các gói hiện hành.
- Tạo nhóm Telegram tên
Saltmarsh Members. Dùng nhóm thử nghiệm để kiểm tra nhắc tên, im lặng và tin nhắn tiếp nối trước khi mời khách hàng. - Dùng tài khoản Telegram của bạn để làm theo hướng dẫn, bao gồm gửi tin nhắn của khách truy cập. Bạn cũng có thể thao tác trong Inbox của Quickchat AI. Trước khi mời khách hàng, hãy nhờ đồng nghiệp kiểm tra trải nghiệm từ một tài khoản khác.
- Giải nén bộ tài liệu. Giữ nguyên bộ thông tin mẫu của trường; thay bằng chính sách đã xác minh của bạn trước khi triển khai.
Ảnh chụp Quickchat App hiển thị ứng dụng chạy cục bộ với cấu hình Saltmarsh hư cấu; dữ liệu kết nối mẫu được ghi rõ trong chú thích. Ảnh Telegram và Google Sheets cho thấy phản hồi thực tế và yêu cầu đã lưu của bản demo được kết nối. Thông tin tài khoản cá nhân được cắt bỏ hoặc che rõ ràng. Dùng danh sách kiểm tra cuối bài để lặp lại các bước với kiến thức và tài khoản kết nối của bạn.
Bước 1: dạy chatbot Telegram về doanh nghiệp như thế nào?
Đưa sự thật về doanh nghiệp vào Knowledge Base, còn hướng dẫn vận hành vào Main Prompt. Tách hai vai trò giúp sửa câu trả lời mà không đổi cách Agent hành xử.
Giá và chính sách là dữ kiện nguồn. Sự ngắn gọn, xử lý điều chưa biết và điều hướng là chỉ dẫn.
Tạo Agent và thêm kiến thức
- Với tài khoản mới, chọn Set up manually. Với tài khoản hiện có, chọn Add new AI Agent trước rồi chọn thiết lập thủ công.
- Trong Identity, nhập
Saltmarsh Groupvào Name your AI Agent. Dángroup-main-prompt.txtcủa bộ tài liệu vào Describe what you want your agent to do. - Tiếp tục thiết lập, chưa kết nối ứng dụng bên ngoài. Hoàn tất bước chọn gói; dùng Skip for now nếu bắt đầu bằng tài khoản học tập.
- Mở Knowledge Base > Add Article. Nhập
Courses and trial enquiriesvào Create custom article, chọn Create article, dánsaltmarsh-courses.txtvào Content, rồi Save. - Lặp lại với
Weather, parking and personal enquiries, dùngsaltmarsh-policies.txt. Chờ cả hai bài hiển thị Ready. - Mở Actions & MCPs trên Saltmarsh Group. Giữ Human Handoff tắt và không thêm Action yêu cầu học thử.
- Chọn Add new AI Agent và thiết lập thủ công
Saltmarsh Sailing Schoolbằngmain-prompt.txtcùng hai tệp kiến thức đó. Agent thứ hai xử lý trò chuyện riêng. Chọn đúng Agent trong bộ chuyển tài khoản trước khi đổi cài đặt.
Hai nguồn ngắn cho thấy rõ Agent có dữ kiện nào. Ready là mốc kiểm tra trước khi thử kiến thức.
| Kiến thức | Dữ kiện chính xác trong ví dụ |
|---|---|
| Khóa học | Start Sailing: hai ngày, EUR 240. Day Skipper theory: năm buổi tối, EUR 310. Buổi học riêng: 90 phút, EUR 95. |
| Lịch | Mùa học từ tháng 4 đến tháng 10; lịch công bố trước một tháng. Không có tình trạng chỗ trống trực tiếp hay ngày học kế tiếp. |
| Trang bị | Áo khoác chống nước, giày không để lại vết và quần áo thay. Trường cung cấp thiết bị hỗ trợ nổi. |
| Thời tiết | Gió trên 25 knot hoặc có giông: chuyển sang ngày còn chỗ tiếp theo, không tính thêm phí. Huấn luyện viên quyết định vào sáng hôm đó. |
| Đỗ xe | Miễn phí tại nhà câu lạc bộ. Mã cổng gửi trước một ngày; bản thân mã không nằm trong nguồn. |
| Yêu cầu học thử | Thu thập tên, thứ trong tuần mong muốn và kinh nghiệm đi thuyền buồm. Văn phòng xác nhận chỗ trống và giá. |
Thông tin thuê đồ lặn được cố ý bỏ trống. Câu trả lời đúng là Agent không thể xác nhận, thay vì bịa có hoặc không. Tương tự, quy định thời tiết không cho biết dự báo hôm nay, và giá buổi học riêng không xác định giá học thử.
Đặt Main Prompt và kiểm tra câu trả lời
- Mở Identity > Main Prompt trên mỗi Agent và kiểm tra prompt Saltmarsh tương ứng. Prompt nhóm trả lời câu hỏi chung và chỉ đến liên kết riêng được ghim; prompt riêng thu thập yêu cầu và dùng Human Handoff.
- Mở AI Preview, hỏi
How much is Start Sailing?. Kiểm tra đáp án hai ngày và EUR 240. - Hỏi
Do you rent wetsuits?. Kiểm tra câu trả lời có thừa nhận thiếu thông tin không.
Prompt Agent riêng định nghĩa tiếp nhận và chuyển nhân viên. Agent nhóm dùng prompt khác và tắt cả hai Action.
Hai phần cắt từ cài đặt thật của Agent nhóm. Nó trả lời kiến thức nhưng không có Action tiếp nhận hay chuyển nhân viên để thực thi.
Hai Agent làm rõ việc điều hướng. Agent nhóm không có chức năng chuyển nhân viên để vô tình kích hoạt; Agent riêng có thể chuyển yêu cầu hoàn tiền mà không dừng nhóm. Preview kiểm tra dữ kiện trường, còn các bước sau xác minh từng kết nối Telegram.
Bước 2: thêm chatbot AI vào nhóm Telegram như thế nào?
Mở External Apps > Telegram, thêm bot dùng chung vào nhóm, rồi quay lại Quickchat AI để Confirm nhóm. Agent giữ im lặng trong nhóm đến khi bạn xác nhận.
Tham gia nhóm Telegram và xác nhận trong Quickchat AI là hai bước riêng.
- Chọn Saltmarsh Group trong bộ chuyển Agent. Mở External Apps, chọn Telegram, tìm Quickchat AI bot.
- Chọn Add to a Telegram group. Trong Telegram, chọn
Saltmarsh Membersvà chấp thuận thêm bot. - Quay lại Quickchat AI. Trong Waiting for your confirmation, kiểm tra tên nhóm và thông tin Added by.
- Chọn Confirm cho đúng nhóm. Nhóm sẽ chuyển sang Connected chats, với công tắc bật.
- Trong Telegram, gõ
@và chọn bot từ danh sách nhắc tên. HỏiHow much is Start Sailing?. Tên người dùng bot chung thường là@QuickchatAI_bot; dùng tên thực tế hiển thị trong nhóm. - Trả lời trực tiếp đáp án đó bằng
What should I bring?. Sau đó gửi riêng một tin không nhắc tên:Does anyone know the gate code?. Bot chung phải trả lời tin phản hồi và im lặng với tin nhắn thường.
Chọn Saltmarsh Members trong Telegram, rồi quay lại Quickchat AI để xác nhận kết nối.
Giao diện cục bộ thật với dữ liệu nhóm thử nghiệm, cho thấy vị trí Confirm. Đây là minh họa điều khiển, không chứng minh bot đã vào nhóm Telegram thật.
Nhóm đã xác nhận nhận được câu trả lời mong đợi về khóa học. Nhắc bot bằng đúng tên người dùng của nó.
Trả lời tin nhắn của bot hoạt động mà không cần nhắc lại. Câu trả lời liệt kê thông tin trang bị đã cung cấp.
Xác nhận quan trọng vì dữ liệu lời mời xuất hiện trong nhóm. Quickchat AI yêu cầu quyết định từ phía tài khoản trước khi xem nhóm là đích đến của Agent. Không xác nhận nhóm bạn không nhận ra. Tài liệu kết nối Telegram giải thích ranh giới này.
Hoàn tất xác nhận trước khi rời phần thiết lập. Nếu bot rời một nhóm chưa được xác nhận, hãy tạo liên kết Add to a Telegram group mới, thêm bot lại và xác nhận ngay nhóm đang chờ trong Quickchat AI. Thêm bot bằng chức năng tìm thành viên của Telegram không thay thế quy trình kết nối này.
Nhãn Admin cho biết trạng thái bot trong Telegram. Nó không bắt buộc để bot chung trả lời thông thường. Đặt bot chung làm quản trị viên cũng không đổi quy tắc chỉ phản hồi nhắc tên hoặc trả lời trực tiếp.
Bước 3: bật chat riêng trên Telegram như thế nào?
Bật Direct message link và chia sẻ toàn bộ URL được tạo. Liên kết chọn Agent của bạn bên trong bot Telegram dùng chung, để khách hàng hỏi riêng mà không cần thêm vào nhóm.
Nhóm là một cuộc trò chuyện chung. Chuyển dữ liệu cá nhân và việc bàn giao cho nhân viên sang DM.
- Chọn Agent riêng Saltmarsh Sailing School. Mở External Apps > Telegram, bật Direct message link. Để trống các kết nối nhóm của Agent này.
- Sao chép liên kết được tạo. Giữ tham số
start=; liên kết cơ bản đến bot chung không xác định được Agent của bạn. - Mở trong Telegram và nhấn Start nếu được yêu cầu.
- Hỏi
How much is Start Sailing?mà không nhắc tên bot. Xác minh câu trả lời của trường và tìm hội thoại trong Inbox. - Ghim liên kết trong lời chào của nhóm để mọi người tìm thấy trước khi chia sẻ thông tin cá nhân.
Dùng liên kết được tạo cho Agent của bạn. Cấu hình cục bộ ở đây không phải bằng chứng gửi nhận Telegram thật.
Telegram đã gửi lời chào Saltmarsh sau Start. Tiếp theo hãy kiểm tra câu trả lời từ kiến thức; riêng lời chào chưa kiểm tra khả năng truy xuất thông tin.
Hai phần cắt từ cùng một màn hình Telegram cho thấy lời mời được ghim. Giá trị start của liên kết demo được lược bỏ; hãy ghim liên kết đầy đủ được tạo cho chính bạn.
Chat riêng với bot chung gắn với một Agent tại một thời điểm. Mở liên kết của Agent khác có thể đổi liên kết này. Để có danh tính Telegram và luồng trò chuyện bot riêng, dùng cách tạo bot riêng.
Tắt Direct message link ngăn kết nối mới qua liên kết đó. Để dừng chat đã kết nối, dùng công tắc của chat hoặc Disconnect. Xem liên kết như lối vào công khai, không phải cơ chế hạn chế truy cập kiến thức mật.
Bước 4: lưu yêu cầu học thử vào Google Sheets như thế nào?
Tích hợp Google Sheets tạo bảng tính và Action thêm hàng. Điều chỉnh Action để ghi ba trường bắt buộc của yêu cầu học thử, rồi kiểm tra hàng thực tế. Bước này tùy chọn và hoạt động với bot Telegram dùng chung.
Kết quả là yêu cầu cần người theo dõi. Nó không giữ chỗ hay xác định giá học thử.
Kết nối Sheets và cấu hình một Action
- Trên Saltmarsh Sailing School, mở Actions & MCPs > Add Action > Google Sheets, chọn Connect Google Sheets. Đăng nhập đúng tài khoản Google và cấp quyền được yêu cầu.
- Mở bảng tính Quickchat Leads vừa tạo. Giữ tên tab Leads, vì URL Action được tạo trỏ đến tab đó.
- Thay hàng tiêu đề lần lượt bằng
Name,Preferred weekday,Sailing experience,Conversation link,Channel. - Mở Actions & MCPs, sửa Action
log_lead_to_google_sheetđược tạo. Dùng cấu hình dưới đây. Sửa tham số, nội dung yêu cầu và tiêu đề bảng cùng lúc để vị trí khớp nhau.
API Action Name
Record trial-lesson request
What to ask the user first
| Format | Name | Description | Required |
|---|---|---|---|
| Text | name | Tên người đó đã cung cấp cho yêu cầu học thử này. Hỏi nếu thiếu. | Yes |
| Text | preferred_weekday | Thứ mong muốn học thử, chẳng hạn thứ Ba. Đây là lựa chọn ưu tiên, không phải ngày đã xác nhận. | Yes |
| Text | sailing_experience | Kinh nghiệm đi thuyền buồm do người đó tự nêu, như người mới. Hỏi nếu thiếu, không suy đoán. | Yes |
Đặt cả ba tham số thành No default và xóa tham số email, nội dung hỏi mặc định. Ba trường này là những câu hỏi duy nhất của cấu hình. Tên người dùng Telegram là tùy chọn, không đáng tin cậy để bắt buộc làm thông tin liên hệ; liên kết hội thoại được ghi giúp nhân viên quay lại yêu cầu.
Phương thức và URL: giữ URL POST được tạo. Nó đã có ID bảng tính, tab Leads và valueInputOption=RAW. Không có ID bảng tính mẫu nào cần điền.
Header: giữ cấu hình của tích hợp.
| Tên header | Giá trị |
|---|---|
Authorization | Bearer {{google_sheets_access_token}} |
Content-Type | application/json |
Trong tab Body của API Endpoint, dùng:
{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}
Dùng Add AI Data để chèn các thẻ tham số và biến hội thoại khi cần. Ba giá trị đầu lấy từ cuộc trò chuyện; hai giá trị cuối do Quickchat AI cung cấp.
API Action Description
In a private chat only, call this once when the person has requested a trial lesson and provided their name, preferred weekday and sailing experience. Ask for the next missing required field before calling. Do not call it for general course questions, in groups, or to confirm a booking. A successful call records an enquiry for the office; it does not reserve a place.
Mở Advanced settings > Run only when, thêm telegram_chat_type equals private. Dùng khóa metadata thuần, không có metadata_ hoặc ngoặc nhọn. Điều này ngăn gửi HTTP cho tin nhóm ngay cả khi mô hình thử gọi. Tài liệu điều kiện thực thi giải thích phép kiểm tra.
Đặt Response filter thành $.updates.updatedRows để Action trả về số hàng thay vì phản hồi không cần thiết của nhà cung cấp. Giữ Action bật.
Khóa thuần là telegram_chat_type. Điều kiện được kiểm tra trước khi gửi yêu cầu.
Cấu hình cục bộ của yêu cầu. URL Sheets và quyền OAuth phải lấy từ kết nối Google của chính bạn.
Kiểm tra hàng, rồi thử yêu cầu chưa đầy đủ
Gửi tin nhắn này qua liên kết Telegram riêng của Agent:
I am Alex Morgan. I want a trial on Tuesday. I am a beginner.
Kiểm tra cả ba nơi: câu trả lời mô tả một yêu cầu, thẻ Action trong Inbox hiển thị đúng giá trị đã cung cấp, và tab Leads thật có hàng tương ứng. Câu trả lời trấn an hay điểm Simulation cao đều không chứng minh Google Sheets đã nhận thao tác ghi.
Agent đã ghi tên được cung cấp, lựa chọn thứ Ba và kinh nghiệm ở mức mới bắt đầu. Văn phòng vẫn cần xác nhận lịch trống và giá chính xác.
Hai phần chi tiết của cùng một hàng đã lưu giúp đọc rõ cả năm cột. Liên kết hội thoại riêng của tài khoản được che; bốn giá trị còn lại không thay đổi.
Bắt đầu bài thử riêng bằng I would like a trial lesson. Agent phải hỏi từng trường còn thiếu, mỗi lần một câu, trước khi chạy Action. Thử thêm How much is Start Sailing?; câu hỏi thường về khóa học không được tạo hàng. Prompt yêu cầu một lần ghi cho mỗi yêu cầu, nhưng cấu hình thêm hàng này không phải hệ thống đặt chỗ có tính lũy đẳng. Kiểm tra bản ghi trùng trước khi dùng để tiếp nhận thực tế.
Bước 5: chuyển hội thoại Telegram cho nhân viên như thế nào?
Cấu hình Human Handoff, rồi kiểm tra người được giao trong Inbox. Prompt nói văn phòng sẽ trả lời không tự chuyển quyền xử lý hay tạm dừng AI.
Thay đổi người phụ trách là điểm kiểm tra. Để nhân viên hoàn tất vụ việc; kiểm chứng riêng việc trả lại AI.
- Chọn Saltmarsh Sailing School, mở Actions & MCPs > Human Handoff và bật. Giữ Action này tắt trên Saltmarsh Group.
- Trong Handoff Rules, chọn +. Nhập
Private enquiriesvào Rule Name, dánhandoff-rule.txtvào Description, bật State. Hàng mới ban đầu không hoạt động. Quy tắc áp dụng cho hoàn tiền, khiếu nại, yêu cầu gặp người và chấp nhận trợ giúp từ người trên Agent riêng này. - Xóa Keywords, tắt các quy tắc có sẵn của ví dụ, chỉ để quy tắc tùy chỉnh hoạt động rồi lưu. Việc tách nhóm được bảo đảm bằng cách tắt Human Handoff trên Agent nhóm riêng; quy tắc tùy chỉnh mô tả khi nào Agent cá nhân nên chuyển.
- Đặt Confirmation thành
I have passed this private conversation to the Saltmarsh office. A member of staff can reply here.Cấu hình Human Agents’ availability theo giờ đội ngũ thực sự trực, và viết thông báo ngoài giờ đúng thực tế. - Trong chat Telegram riêng, gửi
I want a refund for last week. Can I speak to a person?. - Trong Inbox, tìm hội thoại, kiểm tra người phụ trách, chọn Assign to me, gửi
Hi, I’m Alex from the office. I’ll review your request.Kiểm tra tin có đến Telegram không. - Gửi thêm tin từ phía khách hàng khi nhân viên đang phụ trách. AI phải giữ im lặng. Để nhân viên hoàn tất và giải quyết vụ việc trong Inbox. Xem việc trả lại AI là một bài thử riêng.
State của quy tắc tùy chỉnh đang bật. Các điều kiện có sẵn đều tắt, chỉ còn một quy tắc cần kiểm tra.
Yêu cầu Telegram thực tế đã kích hoạt Handoff. Việc phân công trong Inbox và tin nhắn gửi đi của nhân viên được xác minh riêng.
Trong lần kiểm tra thực tế, hội thoại chuyển sang Unassigned, sẵn sàng để một người tiếp nhận. Nhân viên chọn Assign to me, gửi phản hồi của văn phòng và Telegram chấp nhận tin nhắn. Ảnh phía trên hiển thị phản hồi chuyển giao, không hiển thị tin nhắn của nhân viên sau đó. Hãy kiểm tra cả phân công lẫn gửi tin khi lặp lại phép thử.
Giữ trách nhiệm xử lý ở nhân viên cho đến khi vụ việc được giải quyết. Trong phép thử hoàn tiền cục bộ, chuyển lại cho AI Agent cho phép một câu trả lời trước khi Handoff kích hoạt lần nữa. Việc trở lại AI cần một phép thử tiếp nối thành công riêng; đây không phải tiêu chí hoàn tất quy trình này. Hướng dẫn chuyển giao cho người giải thích kỹ hơn về bố trí nhân viên và trách nhiệm xử lý.
Bước 6: kiểm thử toàn bộ chatbot Telegram như thế nào?
Dùng Testing để kiểm tra câu trả lời có thể lặp lại, rồi xác minh riêng các đường đi Telegram thật và tác động bên ngoài. Mô hình có thể trả lời đúng trong khi kết nối nhóm, ghi bảng tính hoặc gửi tin bàn giao vẫn sai.
Kiểm tra hệ thống sở hữu kết quả: kiến thức cho dữ kiện, nhật ký Action cho yêu cầu, Sheets cho hàng, Telegram cho gửi nhận.
Chạy bộ dữ liệu câu trả lời có thể lặp lại
- Mở Testing, tạo bộ dữ liệu tên
Saltmarsh: knowledge checks, chọn Paste messages. - Dán
simulation-messages.txt. Giữ dấu phân cách---trên dòng riêng giữa các trường hợp. - Mở Evaluation criteria, dán
evaluation-criteria.txttừ bộ tài liệu rồi lưu. - Chọn Run > Start Run, sau đó xem từng câu trả lời cùng điểm số.
Giữ cùng câu hỏi khi sửa một chỉ dẫn để phép so sánh còn hữu ích.
Đọc câu trả lời bên cạnh điểm số. Đây là kiểm tra kiến thức cục bộ, không phải kiểm tra gửi nhận Telegram.
Bộ đánh giá cần dữ kiện trường để chấm độ chính xác. Nó cũng cần biết bản ghi trò chuyện không chứng minh hàng bảng tính, gửi nhận Telegram hay thay đổi người phụ trách. Simulation văn bản mặc định không cung cấp metadata chat Telegram; đừng coi điều kiện Action chỉ cho chat riêng là hỏng khi thiếu metadata. Chạy bài kiểm tra phụ thuộc kênh trong chat riêng thực tế.
Thử nghiệm cục bộ đã thay đổi điều gì?
Thiết kế ban đầu dùng một Agent cho cả hai lối vào. Phép thử cục bộ cho thấy yêu cầu hoàn tiền trong nhóm chuyển hội thoại chung sang Human Handoff. Chúng tôi tách các Agent và tắt cả Handoff lẫn Actions tiếp nhận yêu cầu trên Agent của nhóm. Khi kiểm tra lại yêu cầu hoàn tiền và học thử trong nhóm, phản hồi hướng đến liên kết riêng được ghim trong khi vẫn giữ AI phụ trách. Vì vậy, Bước 1 dùng cấu hình cùng với chỉ dẫn để tách hai hội thoại.
Mười phép kiểm tra kiến thức cục bộ cuối cùng đều đạt 5/5, và cả hai Agent được lưu trữ trên dịch vụ đều vượt qua cùng mười tình huống. Các lượt chạy nhỏ này không phải ước lượng độ chính xác khi vận hành thực tế. Nhóm Telegram thực tế cũng trả lời câu hỏi về giá khóa học và đồ cần mang, rồi từ chối xác nhận dịch vụ thuê đồ lặn. Giữ các tình huống thiếu dữ kiện khi điều chỉnh bộ tài liệu; trả lời đúng giá chưa đủ để kiểm tra sự thận trọng của Agent.
Thiếu kiến thức dẫn đến câu trả lời “không thể xác nhận”. Tin nhắn khác hỏi mã cổng không hướng đến bot và không có phản hồi nào cho tin nhắn đó trong ảnh này.
Yêu cầu học thử riêng tư thực tế tạo một lần gọi Sheets Action thành công với Alex Morgan, Tuesday và beginner. Google trả HTTP 200 và một hàng được cập nhật; hàng đã lưu còn có liên kết hội thoại và kênh telegram. Một phép thử Action riêng với metadata trò chuyện nhóm không gửi yêu cầu HTTP. Khi điều chỉnh điều kiện chặn, hãy kiểm tra cả yêu cầu riêng được chấp nhận lẫn ngữ cảnh nhóm bị từ chối.
Kiểm tra kênh và các tác động của nó
Dùng test-matrix.csv trống trong bộ tài liệu để ghi quan sát của bạn. Ảnh phía trên cho thấy các kết quả đã minh họa; bảng còn có những phép kiểm tra cần chạy với cấu hình của bạn. Ghi thời gian đã trôi qua khi kiểm tra việc không trả lời, và tách việc người tiếp quản khỏi bất kỳ lần trở lại AI nào sau đó.
| Bài thử | Gửi hoặc thực hiện | Kết quả mong đợi |
|---|---|---|
| Nhắc tên trong nhóm | @QuickchatAI_bot How much is Start Sailing? | Trả lời ngắn với EUR 240; có trao đổi tương ứng trong Inbox. |
| Trả lời bot | What should I bring? | Danh sách đồ cần mang, không phải nhắc tên lần nữa. |
| Trò chuyện thường | Does anyone know the gate code? không nhắc tên | Bot chung không trả lời. |
| Thiếu kiến thức | Nhắc bot rồi hỏi Do you rent wetsuits? | Không thể xác nhận; không bịa có hoặc không. |
| Yêu cầu cá nhân trong nhóm | Nhắc bot và yêu cầu hoàn tiền | Hướng sang chat riêng; nhóm vẫn giao cho AI. |
| Trả lời riêng | Mở liên kết DM đầy đủ rồi hỏi giá | Đúng Agent trả lời mà không cần nhắc tên. |
| Yêu cầu học thử đầy đủ | Gửi tin Alex Morgan ở Bước 4 | Tham số Action khớp hàng Sheets thật; không tuyên bố đặt chỗ. |
| Bàn giao riêng | Yêu cầu hoàn tiền, rồi trả lời sau khi nhân viên tiếp quản | Giao cho người, tin nhân viên được gửi, không có trả lời AI thêm. |
| Chính sách thời tiết | What happens if the forecast says 30 knots? | Chính sách đổi lịch miễn phí và quyết định của huấn luyện viên; không tuyên bố biết dự báo trực tiếp. |
Khi bài kiểm tra thất bại, sửa một cài đặt liên quan và gửi lại cùng tin. Sửa dữ kiện thiếu trong Knowledge Base; sửa Action gọi sớm bằng mô tả hoặc tham số bắt buộc; với nhóm im lặng, kiểm tra xác nhận và cách nhắc bot trước. Lưu kết quả lỗi để thấy rõ cải thiện.
Khi nào nên tạo bot riêng bằng BotFather?
Tạo bot Telegram riêng khi cần tên, ảnh riêng, Telegram Bot API Actions, hoặc nhóm nhận tin nhắn thông thường. Bot chung đủ cho luồng trả lời nhóm và riêng phía trên.
Chọn danh tính và hành vi tin nhắn cần thiết trước khi thêm bot thứ hai.
| Nhu cầu | Bot Quickchat AI dùng chung | Bot riêng |
|---|---|---|
| Tạo token BotFather | Không cần | Cần |
| Tên và ảnh Telegram tùy chỉnh | Danh tính dùng chung | Danh tính bot của bạn |
| Trả lời nhắc tên và phản hồi trong nhóm | Có | Có, khi Telegram chuyển đến |
| Phản hồi tin nhóm thông thường | Bot chung im lặng | Cấu hình quyền riêng tư Telegram hoặc quyền quản trị |
| Trò chuyện riêng | Liên kết bắt đầu theo Agent trong bot chung | Luồng riêng của bot bạn |
| Action Google Sheets | Hỗ trợ | Hỗ trợ |
| Actions quản lý Telegram | Token chung không được công khai | Token riêng có thể dùng như System Token |
- Mở tài khoản BotFather đã xác minh trong Telegram, gửi
/newbot. - Chọn tên hiển thị rồi tên người dùng còn trống kết thúc bằng
bot. BotFather trả về token. Giữ bí mật token đó. - Chọn Saltmarsh Group nếu bot này sẽ được thêm vào nhóm. Chỉ dùng Saltmarsh Sailing School cho trò chuyện riêng. Trong External Apps > Telegram, mở Your own bot, chọn Connect to Telegram.
- Dán token vào Bot Token và hoàn tất kết nối. Kiểm tra Enable your own bot đang bật.
- Mở liên kết Telegram của bot, gửi
/start, rồi cùng câu hỏi giá khóa học. - Muốn nhận tin nhóm thường, dùng
/setprivacytrong BotFather, chọn bot và Disable, sau đó xóa bot khỏi nhóm thử rồi thêm lại. Bot quản trị cũng nhận tin thường. Tài liệu chế độ riêng tư của Telegram giải thích quy tắc gửi nhận.
Chỉ dán token vào Bot Token. Trường được để trống trong hình để không công khai thông tin xác thực.
Đặt bot chung và bot riêng trong các nhóm khác nhau. Chạy cả hai cùng nhóm có thể gây câu trả lời trùng. Nếu cần ghim thông báo hoặc quản lý thành viên, theo hướng dẫn quản lý nhóm Telegram riêng, bao gồm điều kiện Action chỉ dành cho quản trị viên.
ChatGPT hoặc Claude có thể giúp cấu hình chatbot Telegram không?
Ứng dụng quản lý tài khoản Quickchat AI đã kết nối có thể giúp tạo Agent, thêm kiến thức, cấu hình các cài đặt được hỗ trợ và chạy thử. Nếu ứng dụng khách cung cấp thiết lập Telegram, nó có thể bật liên kết nhắn riêng của bot chung. Chọn nhóm và xác nhận trên bảng điều khiển vẫn là việc của chủ tài khoản. Một số ứng dụng khách cũng yêu cầu bảng điều khiển để bật liên kết riêng và cấu hình Human Handoff, vì vậy hãy để trợ lý kiểm tra các công cụ hiện có trước.
Kết nối plugin Quickchat AI cho ChatGPT hoặc connector Claude, rồi cung cấp tệp trong bộ tài liệu kèm prompt này:
Use my connected Quickchat AI account to create two Agents from the attached kit: Saltmarsh Group with group-main-prompt.txt and Saltmarsh Sailing School with main-prompt.txt. Add both knowledge files to each. Keep Actions and Human Handoff off on Saltmarsh Group. Prepare the supplied knowledge-test dataset. Check the tools available in this client before changing settings. Show me the configuration and ask before running credit-consuming tests or writing to Google Sheets. Where supported, enable only Saltmarsh Sailing School's shared-bot direct-message link and return the complete link. Leave group selection, dashboard confirmation, BotFather setup, Google OAuth and unsupported settings for me, with exact dashboard steps. Report what was configured, what was actually tested and what remains to verify in Telegram.
Công cụ có sẵn tùy theo ứng dụng khách và quyền tài khoản. Theo tài liệu thiết lập quản lý tài khoản để đăng nhập. Việc này kết nối trợ lý với tài khoản Quickchat AI, không biến cuộc trò chuyện ChatGPT hoặc Claude cá nhân thành backend lưu trữ của bot Telegram.
Vì sao chatbot Telegram không trả lời?
Kiểm tra kết nối và đường đi tin nhắn trước khi viết lại prompt. Các triệu chứng sau có nguyên nhân khác nhau.
| Triệu chứng | Cần kiểm tra |
|---|---|
| Nhóm có trong danh sách nhưng im lặng | Xác nhận đúng nhóm, bật trong Connected chats, nhắc đúng tên bot hoặc trả lời tin của bot. |
| Bot rời đi trước câu trả lời đầu tiên | Tạo liên kết Add to a Telegram group mới, thêm bot lại và chọn Confirm ngay cho nhóm đang chờ trong Quickchat AI. |
| Liên kết bot cơ bản mở sai Agent | Dùng liên kết riêng đầy đủ có start=. Kiểm tra liên kết Agent khác có đổi chat riêng dùng chung không. |
| AI dừng sau yêu cầu hoàn tiền | Kiểm tra phân công Inbox. Hội thoại đã bàn giao vẫn tạm dừng cho đến khi chủ động giao lại. |
| Không có hàng trong Sheets | Kiểm tra Action bật, đủ trường bắt buộc, chat riêng và URL vẫn trỏ Leads. Xem lần gọi Action và kết nối Google. |
| Bot riêng bỏ lỡ tin thường | Kiểm tra chế độ riêng tư và quyền nhóm; xóa rồi thêm lại sau khi đổi riêng tư. |
| Câu trả lời khẳng định ngày hoặc dịch vụ chưa từng cung cấp | Kiểm tra kiến thức đã lưu ở trạng thái Ready và chỉ dẫn về điều chưa biết. Chạy lại đúng câu hỏi lỗi. |
| Bài thử ngừng trả lời | Kiểm tra tín dụng AI còn lại và yêu cầu lỗi; không xem lỗi hết hạn mức như kết quả chất lượng prompt. |
Trước khi mời khách hàng, thay dữ kiện hư cấu, xem lại sự tách biệt giữa nhóm và trò chuyện riêng, đồng thời bố trí nhân viên cho hàng đợi chuyển giao. Nhờ đồng nghiệp kiểm tra các lối vào công khai từ tài khoản khác như bước cuối trước khi ra mắt. Với kênh cộng đồng khác, hướng dẫn chatbot Discord có quy trình xây dựng và kiểm tra tương tự. Với hội thoại nhân vật, dùng hướng dẫn nhập vai Telegram.
Kiểm tra thiết lập tùy chọn: so sánh cách triển khai bằng yêu cầu bạn khai báo, hoặc so sánh số câu trả lời theo ngân sách tín dụng bằng ngân sách cung cấp. Các công cụ tính này không kiểm tra tài khoản, website hay số dư của bạn.
Cấu hình Saltmarsh có thể sao chép
Đây là toàn bộ dữ kiện nguồn và chỉ dẫn dùng trong hướng dẫn. Bản tải xuống còn có cấu hình Action, tiêu chí đánh giá và bài thử.
Agent nhóm: Main Prompt
Dán vào Identity > Main Prompt trên Saltmarsh Group. Giữ Human Handoff và Actions tùy chỉnh tắt trên Agent này.
You answer general questions in the Saltmarsh Sailing School members' group. Use only the Knowledge Base and keep each reply to two or three sentences. Do not add facts or requirements the sources do not contain. If a fact is missing, say that you cannot confirm it.
For trial requests, refunds, complaints, personal details or a request for a person, direct the member to the school's private link pinned in the group; do not invent a link. Do not collect personal details in this group. You cannot record requests, confirm bookings, approve refunds or transfer a conversation to staff. Do not claim you did any of these things. The private Agent records an enquiry; it cannot check live availability or confirm a trial. Only the office confirms availability and price.
Agent riêng: Main Prompt
Dán vào Identity > Main Prompt trên Saltmarsh Sailing School. Giữ tên Action khớp cấu hình mẫu.
You are the private-chat assistant of Saltmarsh Sailing School. Answer school questions from the Knowledge Base. Do not add plausible details that are not in the sources, including extra clothing or footwear requirements. Keep replies to two or three sentences and ask at most one question per message. If a fact is missing, say that you cannot confirm it; do not invent dates, availability, gate codes or wetsuit rental. Explain weather policy without claiming to know the current forecast.
When a person requests a trial lesson, collect their name, preferred weekday and sailing experience. Ask for only the next missing field. When all three are present, use Record trial-lesson request once. Say the request was recorded only after the Action succeeds. Explain that the office still needs to confirm availability and price; never say a lesson is booked. If the Action is unavailable or fails, say the request has not been recorded and offer a person.
Use Human Handoff for a current unresolved refund request, complaint or explicit request for a person. After a staff member has resolved the enquiry and returned the conversation to AI, answer new general questions normally; do not hand off again solely because an earlier message mentioned a refund or asked for a person. Do not approve refunds or promise a response time. For a missing fact, say what is unknown and offer a person; do not treat uncertainty as a negative answer about the service.
Kiến thức: khóa học và yêu cầu học thử
Dán vào trường Content của bài kiến thức đầu tiên.
Saltmarsh Sailing School demonstration information
This fictional school is used only for a tutorial. It contains no real customer data.
Start Sailing is a two-day course costing EUR 240. Day Skipper theory runs across five evenings and costs EUR 310. A private lesson lasts 90 minutes and costs EUR 95.
Courses run from April to October. Course dates are published on the school's website one month ahead. This source does not contain the next available date or live availability.
Bring a waterproof jacket, non-marking shoes and a change of clothes. The school provides buoyancy aids.
A trial-lesson request is an enquiry, not a confirmed booking. The office needs the person's name, preferred weekday and sailing experience, then confirms availability and price. Do not collect payment details. Do not infer a trial price from the private-lesson price.
Kiến thức: chính sách và thông tin thành viên
Dán vào trường Content của bài thứ hai.
Saltmarsh Sailing School demonstration policies
If the forecast shows more than 25 knots of wind or thunderstorms, the session moves to the next available date at no extra cost. The instructor decides on the morning of the session. This source is a policy, not a live weather forecast or a cancellation decision.
Parking is free at the clubhouse. The gate code is sent to enrolled students the day before their course. The code itself is not in this Knowledge Base.
Refunds and complaints are handled by the office. An AI answer cannot approve a refund. A member of staff must decide each case.
The Telegram members' group is for general questions. Trial requests, refunds and other personal details belong in a private conversation with the school's Agent, opened from the school's direct-message link.
Quy tắc Human Handoff
Dán trong Human Handoff > Handoff Rules và cấu hình thời gian hỗ trợ thực tế.
Transfer this private conversation to a person when the visitor has a current unresolved refund request, complaint, explicit request for a person, or accepts an offer of human help. After a staff member resolves the enquiry and returns it to AI, earlier refund or handoff messages must not trigger a new transfer for a general course question. Explain that a staff member can review the case here without approving a refund or promising a response time. This Agent is used only for private enquiries; the separate group Agent has Human Handoff disabled.
Câu hỏi thường gặp
Làm sao thêm chatbot AI vào nhóm Telegram?
Trong Quickchat AI, mở External Apps, chọn Telegram và Add to a Telegram group. Chọn nhóm trong Telegram, rồi quay lại Quickchat AI và Confirm. Thành viên có thể hỏi bằng cách nhắc tên bot chung hoặc trả lời một tin của bot.
Chatbot AI Telegram có trả lời mọi tin nhắn không?
Bot Quickchat AI dùng chung trả lời tin nhóm có nhắc tên hoặc trả lời trực tiếp bot. Trò chuyện thông thường không kích hoạt phản hồi. Bot riêng có thể nhận tin thường khi tắt chế độ riêng tư Telegram hoặc khi là quản trị viên. Hãy thử cấu hình này trong nhóm riêng biệt.
Có cần BotFather hay token bot Telegram không?
Không cần BotFather hoặc token cho bot chung và liên kết nhắn riêng. Tạo bot riêng bằng BotFather khi cần tên, ảnh Telegram tùy chỉnh hoặc Actions gọi Telegram Bot API. Actions Google Sheets thông thường hoạt động được với bot chung.
Khách hàng có thể nhắn riêng cho chatbot Telegram không?
Có. Bật Direct message link trong Quickchat AI rồi chia sẻ toàn bộ liên kết được tạo. Khách mở và nhấn Start nếu được yêu cầu. Liên kết chọn Agent của bạn trong bot chung. Tắt liên kết ngăn kết nối mới; chat riêng hiện có có điều khiển bật và ngắt kết nối riêng.
Chatbot AI Telegram có miễn phí không?
Tạo bot bằng BotFather không tự thêm dịch vụ AI. Quickchat AI có gói Free cho học tập cá nhân phi thương mại, kèm hạn mức tín dụng AI. Triển khai thương mại cần gói trả phí. Câu trả lời, Preview và Simulation dùng tín dụng AI; dịch vụ bên ngoài có thể có phí riêng.
Telegram có chatbot AI không?
Telegram hỗ trợ bot AI bên thứ ba và tích hợp AI. Hướng dẫn này kết nối Agent Quickchat AI trả lời từ kiến thức doanh nghiệp của bạn. BotFather tạo danh tính bot, không cung cấp kiến thức hay cấu hình luồng hỗ trợ khách hàng.
Chatbot hiểu ảnh và tệp không?
Tích hợp Telegram có thể nhận ảnh và phân tích nội dung hình ảnh. Tệp khác có thể đến hội thoại dưới dạng đính kèm, nhưng nội dung không được tự động đọc. Hãy thử đúng loại tệp khách hàng sử dụng và kiểm tra cả Telegram lẫn Inbox.
Có thể tạo bot nhập vai hoặc nhân vật Telegram không?
Có. Cùng kết nối Telegram có thể phục vụ Agent mang danh tính nhân vật và chỉ dẫn phù hợp. Hướng dẫn này dùng ví dụ hỗ trợ doanh nghiệp; Agent nhập vai cần prompt và kiểm thử riêng.