Bắt đầu
Chọn web, REST API, MCP hay webhook
Chọn cách làm việc phù hợp cho người vận hành, phần mềm tích hợp và AI agent bên ngoài.
Telegram-Auto có nhiều cửa vào cùng một hệ thống thực thi. Bạn chọn cửa phù hợp với người hoặc phần mềm thực hiện công việc; không cần chuyển toàn bộ hoạt động sang API chỉ để thêm một tích hợp.
Chọn nhanh
| Cách dùng | Dành cho ai | Dùng khi nào |
|---|---|---|
| Web app | Chủ workspace, Quản lý, CSKH, người xem báo cáo | Thiết lập ban đầu, xử lý hội thoại, theo dõi trạng thái và xử lý tình huống cần người quyết định |
| REST API v2 | Lập trình viên, dịch vụ tích hợp, quy trình do bạn viết | Gọi thao tác từ mã, lấy dữ liệu và theo dõi kết quả |
| MCP | AI agent hoặc ứng dụng hỗ trợ MCP bên ngoài | Cho agent khám phá công cụ và thực hiện tác vụ trong phạm vi được cấp |
| Webhook | Hệ thống cần nhận thông báo sự kiện | Nhận sự kiện đẩy sang địa chỉ HTTPS do bạn quản lý |
Webhook không thay thế REST hoặc MCP để ra lệnh. Ngược lại, REST và MCP không bắt buộc bạn phải mở webhook nếu chưa cần nhận sự kiện.
Khi nên dùng web app
Bắt đầu bằng web nếu bạn đang tạo workspace, kết nối Hetzner hoặc đăng nhập Telegram lần đầu. Đây cũng là nơi phù hợp để kiểm tra máy, proxy và tài khoản trước khi cho tích hợp chạy.
Với đội CSKH, hộp thư trên web giúp đọc ngữ cảnh rồi quyết định câu trả lời. Người vận hành không cần tự xây màn hình từ API.
Một số thao tác chỉ dành cho người dùng trực tiếp không được công khai qua API hoặc MCP. Ví dụ, kết nối và gỡ kết nối Hetzner cần Chủ workspace thao tác trên web.
Khi nên dùng REST API v2
Chọn REST khi bạn kiểm soát mã tích hợp và muốn chủ động gọi từng thao tác. Ví dụ: đọc hội thoại, đồng bộ dữ liệu khách vào hệ thống riêng, hoặc gửi nội dung đã được quy trình của bạn duyệt.
REST v2 và MCP gọi cùng thao tác nghiệp vụ với ứng dụng web. Chúng không có đường gửi riêng để bỏ qua kiểm tra tài khoản, proxy, hạn mức hay danh sách không liên hệ.
Một thao tác được tiếp nhận chưa chắc đã hoàn tất trên Telegram. Với thao tác chạy thành việc, tích hợp cần theo dõi kết quả. Đừng xem phản hồi tiếp nhận là bằng chứng tin đã gửi.
Bắt đầu tại tham chiếu REST, rồi đọc các trạng thái và mã lỗi.
Khi nên dùng MCP
Chọn MCP khi công cụ bên ngoài của bạn hỗ trợ giao thức này. Agent có thể dùng các công cụ nghiệp vụ thay vì tự thao tác trình duyệt.
Telegram-Auto không có AI nội bộ. Việc suy luận và tạo nội dung nằm ở hệ thống bên ngoài. Agent chỉ thực hiện được những gì kết nối cho phép.
Mỗi kết nối AI có một danh tính phân quyền riêng trong workspace. Quyền hiệu lực còn phụ thuộc vào vai trò, phạm vi thao tác, tài khoản được cấp và chính sách hành động nguy hiểm. Vai trò của kết nối không được vượt vai trò người tạo.
Xem kết nối AI và tham chiếu MCP. Không giả định mọi công cụ đều xuất hiện trong mọi cấu hình MCP.
Khi nên dùng webhook
Chọn webhook khi bạn muốn hệ thống nhận thông báo thay vì liên tục hỏi xem có thay đổi hay chưa. Bên nhận cần kiểm chữ ký sự kiện và xử lý việc nhận lại cùng sự kiện.
Webhook gửi thông tin sự kiện; nó không cấp quyền thực hiện thao tác. Nếu bên nhận cần phản hồi bằng hành động, hãy dùng một kết nối REST hoặc MCP có quyền phù hợp.
Đọc tích hợp webhook và xây bên nhận.
Phối hợp các giao diện
Một cách triển khai thực tế là:
- Chủ thiết lập hạ tầng trên web.
- CSKH xử lý các hội thoại cần người.
- Dịch vụ riêng gọi REST cho công việc đã xác định rõ.
- Agent dùng MCP để hỗ trợ tác vụ trong phạm vi hẹp.
- Webhook báo thay đổi cho hệ thống liên quan.
Không chia sẻ tài khoản đăng nhập web để thay cho một kết nối tích hợp. Cũng không cấp toàn quyền chỉ vì tích hợp cần gửi tin.