Cách kết nối ElevenLabs agent với Telegram
Mua gói Thành viên QuanTriMang Pro để trải nghiệm website không quảng cáo và sử dụng các tiện ích AI trên QuanTriMang.
Tổng quan
Kết nối các ElevenLabs AI agent của bạn với Telegram để phản hồi những tin nhắn gửi đến bot của bạn. Tích hợp này cho phép các agent của bạn nhận tin nhắn từ những cuộc trò chuyện riêng tư và nhóm, tra cứu thông tin cuộc trò chuyện, gửi phản hồi và tương tác với các tin nhắn thông qua Telegram Bot API.

Các tính năng
| Khả năng | Hỗ trợ |
|---|---|
| Zero retention mode (ZRM) - Chế độ không lưu giữ | Không được hỗ trợ |
| File đính kèm trong các trình kích hoạt | Không được hỗ trợ - ảnh, file và các nội dung media khác trong tin nhắn gửi đến sẽ không được chuyển tiếp cho agent |
| Các file đính kèm trong công cụ | Không được hỗ trợ - các công cụ chỉ hoạt động trên văn bản |
Thiết lập
1. Tạo bot Telegram
Mở Telegram và bắt đầu cuộc trò chuyện với @BotFather. Gửi lệnh /newbot rồi làm theo hướng dẫn để chọn tên và username cho bot của bạn. BotFather sẽ phản hồi kèm theo một mã token của bot.
2. Kết nối trong ElevenLabs
Tại phần thiết lập tích hợp của ElevenLabs, hãy nhấp vào Connect và dán bot token nhận được từ BotFather vào.
3. Kích hoạt trigger
Sau khi kết nối, hãy bật trình kích hoạt Telegram Message và chọn agent sẽ xử lý các tin nhắn gửi đến. ElevenLabs sẽ tự động đăng ký một webhook với Telegram để bot của bạn bắt đầu nhận tin nhắn.
Sử dụng bot trong các nhóm
Bot không cần phải là quản trị viên (admin) của nhóm, và bạn cũng không cần tắt chế độ bảo mật của Telegram. Khi chế độ bảo mật được bật (cài đặt mặc định), Telegram chỉ chuyển tiếp các tin nhắn có đề cập trực tiếp đến bot - đây chính là những gì mà tính năng tích hợp này lắng nghe:
- Các tin nhắn có chứa @username của bot, ví dụ:
@my_bot what's the status?. - Các tin nhắn phản hồi lại chính các tin nhắn của bot, bao gồm cả các lượt trao đổi tiếp nối trong cùng một cuộc hội thoại.
Các tin nhắn không đề cập đến bot sẽ bị bỏ qua theo thiết kế. Bot cũng bỏ qua tin nhắn từ những bot khác, đồng thời không phản hồi đối với các tin nhắn đã chỉnh sửa hoặc bị xóa.
Các thay đổi về chế độ bảo mật hoặc vai trò quản trị viên trên Telegram chỉ áp dụng cho những nhóm mà bot tham gia sau khi thay đổi đó được thực hiện. Nếu trước đây bạn từng điều chỉnh chế độ bảo mật thông qua @BotFather, hoặc cấp quyền quản trị viên cho bot với hy vọng "sửa lỗi" việc đề cập (mention), hãy xóa bot khỏi nhóm rồi thêm lại để cài đặt mới có hiệu lực - thông thường, chính thao tác này mới là yếu tố giúp tính năng đề cập hoạt động, chứ không phải do vai trò admin.
Trong các cuộc trò chuyện nhóm hoặc siêu nhóm (supergroup), phản hồi của agent sẽ được gửi dưới dạng trích dẫn cho tin nhắn kích hoạt. Nhờ đó, câu trả lời vẫn gắn liền với câu hỏi, giúp người dùng dễ theo dõi ngay cả khi cuộc trò chuyện diễn ra sôi nổi. Trong các cuộc trò chuyện riêng tư (1:1), tính năng trích dẫn này sẽ không hiển thị vì không cần thiết.
Các công cụ agent
Khi bạn thêm các công cụ Telegram vào một agent, các công cụ tích hợp sẵn sau đây sẽ khả dụng:
| Công cụ | Mô tả |
|---|---|
telegram_get_chat |
Tra cứu siêu dữ liệu về cuộc trò chuyện hiện tại (như loại, tiêu đề, username và mô tả). chat_id được gắn với cuộc hội thoại hiện tại và không thể chuyển hướng sang đối tượng khác. |
telegram_send_message |
Gửi tin nhắn văn bản vào cuộc trò chuyện hiện tại. chat_id được liên kết; mô hình kiểm soát text và phần tùy chọn parse_mode (HTML, Markdown hoặc MarkdownV2). |
telegram_react_to_message |
Phản hồi lại tin nhắn kích hoạt bằng một biểu tượng cảm xúc duy nhất nằm trong tập hợp các biểu tượng được Telegram cho phép sử dụng cho bot – tính năng này hữu ích khi cần xác nhận nhanh. (👍, 🎉, ❤) tự nhiên hơn là trả lời bằng tin nhắn. Cả chat_id và message_id được gắn với lượt tương tác khởi đầu. Việc thiết lập một phản ứng mới sẽ thay thế bất kỳ phản ứng nào mà bot đã đặt trước đó trên cùng một tin nhắn. |
Một số cuộc trò chuyện giới hạn các biểu tượng cảm xúc (emoji) được phép sử dụng thông qua cài đặt Available reactions trên Telegram. Nếu một yêu cầu phản ứng bị từ chối, hãy hướng dẫn agent chuyển sang phản hồi bằng văn bản.
Các biến động (Dynamic variable)
Khi một agent chạy từ Telegram, các biến động sau đây sẽ khả dụng trong những câu lệnh (prompt) và công cụ (tool):
| Biến | Mô tả |
|---|---|
integration__telegram_chat_id |
ID cuộc trò chuyện trên Telegram, nơi diễn ra cuộc hội thoại. |
integration__telegram_message_id |
Telegram message_id của tin nhắn từ người dùng đã kích hoạt lượt phản hồi hiện tại của agent. |
integration__telegram_connection_id |
ID kết nối tích hợp ElevenLabs. |
Xem phần biến động (dynamic variable) để biết cách tham chiếu các biến này trong các câu lệnh (prompt) và lệnh gọi công cụ (tool call).
Bạn nên đọc
-
Cách kết nối ElevenLabs agent với Parallel
-
Cách kết nối Slack workspace với ElevenLabs Agents
-
Cách kết nối ElevenLabs agent với Freshdesk
-
Cách kết nối ElevenLabs AI agent với ServiceNow
-
Cách kết nối ElevenLabs AI agent với Twilio
-
Cách kết nối ElevenLabs agent với Genesys Cloud
-
Cách kết nối ElevenLabs AI agent với Perplexity
-
Cách kết nối ElevenLabs agent với Google Calendar
-
Cách kết nối ElevenLabs agent với Intercom
Theo Nghị định 147/2024/ND-CP, bạn cần xác thực tài khoản trước khi sử dụng tính năng này. Chúng tôi sẽ gửi mã xác thực qua SMS hoặc Zalo tới số điện thoại mà bạn nhập dưới đây:
Hướng dẫn AI
AI Tools
Học IT
Hàm Excel