# Tài liệu Telegram-Auto

> Hướng dẫn dùng Telegram-Auto từ đầu đến nâng cao: hộp thư, tài khoản, máy chạy, proxy, chiến dịch, API, MCP và webhook.

- Trang chủ tài liệu: https://tlg.builera.app/docs
- Full text: https://tlg.builera.app/docs/llms-full.txt
- Docs MCP (read-only, no sign-in): https://tlg.builera.app/api/public/docs-mcp
- OpenAPI: https://tlg.builera.app/api/public/v2/openapi.json
- MCP catalog: https://tlg.builera.app/docs/contracts/mcp-catalog.json
- Event catalog: https://tlg.builera.app/docs/contracts/events.json
- English: https://tlg.builera.app/en/docs/llms.txt

## Bắt đầu

- [Telegram-Auto là gì?](https://tlg.builera.app/docs/start/overview.md): Telegram-Auto giúp một đội vận hành nhiều tài khoản Telegram cá nhân từ một hộp thư chung, với cửa an toàn cho mọi việc gửi đi.
- [Bắt đầu trong 10 phút](https://tlg.builera.app/docs/start/quickstart.md): Tạo workspace, kết nối máy, thêm proxy và đăng nhập Telegram để trả lời hội thoại đầu tiên.
- [Chọn web, REST API, MCP hay webhook](https://tlg.builera.app/docs/start/choose-interface.md): 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.
- [Chuẩn bị trước khi bắt đầu](https://tlg.builera.app/docs/start/prepare.md): Chuẩn bị tài khoản Telegram, proxy riêng, máy chạy và quyền của đội trước khi thiết lập workspace.

## Khái niệm

- [Workspace, thành viên và vai trò](https://tlg.builera.app/docs/concepts/workspace-and-roles.md)
- [Tài khoản Telegram cá nhân và phiên đăng nhập](https://tlg.builera.app/docs/concepts/personal-accounts.md)
- [Máy chạy tài khoản](https://tlg.builera.app/docs/concepts/machines.md)
- [Proxy riêng cho từng tài khoản](https://tlg.builera.app/docs/concepts/proxies.md)
- [Tự do và An toàn](https://tlg.builera.app/docs/concepts/free-and-safe.md)
- [Hạn mức và làm ấm](https://tlg.builera.app/docs/concepts/limits-and-warmup.md)
- [Trạng thái an toàn của tài khoản](https://tlg.builera.app/docs/concepts/safety-states.md)
- [STOP và danh sách không liên hệ](https://tlg.builera.app/docs/concepts/do-not-contact.md)
- [Tài khoản Nội bộ](https://tlg.builera.app/docs/concepts/internal-accounts.md)
- [Công việc, hàng đợi và trạng thái](https://tlg.builera.app/docs/concepts/jobs-and-states.md)
- [Nhóm và kênh nào vào Hộp thư?](https://tlg.builera.app/docs/concepts/inbox-groups.md)
- [Xác nhận trước thao tác nguy hiểm](https://tlg.builera.app/docs/concepts/confirmations.md)

## Hướng dẫn

- [Xử lý tin nhắn trong Hộp thư](https://tlg.builera.app/docs/guides/inbox.md)
- [Tạo và dùng câu trả lời mẫu](https://tlg.builera.app/docs/guides/templates.md)
- [Tạo và chạy chiến dịch](https://tlg.builera.app/docs/guides/campaigns.md)
- [Đọc kết quả và tiến độ chiến dịch](https://tlg.builera.app/docs/guides/campaign-results.md)
- [Tìm nhóm và khách tiềm năng](https://tlg.builera.app/docs/guides/discover.md)
- [Quản lý khách và giai đoạn chăm sóc](https://tlg.builera.app/docs/guides/people.md)
- [Theo dõi tín hiệu từ khoá](https://tlg.builera.app/docs/guides/signals.md)
- [Nhập danh sách khách từ tệp](https://tlg.builera.app/docs/guides/people-import.md)
- [Tự động hoá bằng gói, lịch việc và luật](https://tlg.builera.app/docs/guides/automation.md)
- [Quản lý danh sách nhóm và kênh](https://tlg.builera.app/docs/guides/chats.md)
- [Quản trị nhóm và kênh](https://tlg.builera.app/docs/guides/group-admin.md)
- [Tạo và quản lý bot](https://tlg.builera.app/docs/guides/bots.md)
- [Đăng và quản lý story](https://tlg.builera.app/docs/guides/stories.md)
- [Đọc và xử lý cảnh báo](https://tlg.builera.app/docs/guides/alerts.md)
- [Đọc nhật ký và chạy lại việc lỗi](https://tlg.builera.app/docs/guides/logs.md)
- [Đọc thống kê vận hành](https://tlg.builera.app/docs/guides/stats.md)
- [Cài đặt hồ sơ và workspace](https://tlg.builera.app/docs/guides/settings.md)
- [Mời thành viên và phân quyền](https://tlg.builera.app/docs/guides/members.md)
- [Thêm tài khoản Telegram bằng mã QR](https://tlg.builera.app/docs/guides/accounts-add-qr.md)
- [Thêm tài khoản bằng số điện thoại](https://tlg.builera.app/docs/guides/accounts-add-phone.md)
- [Quản lý tài khoản Telegram](https://tlg.builera.app/docs/guides/accounts-manage.md)
- [Đặt hạn mức và lịch chạy tài khoản](https://tlg.builera.app/docs/guides/accounts-limits-schedule.md)
- [Thiết lập nuôi tài khoản và lịch chạy](https://tlg.builera.app/docs/guides/nurture.md)
- [Kết nối Hetzner và mở máy chạy tài khoản](https://tlg.builera.app/docs/guides/nodes-hetzner.md)
- [Thêm máy Windows chạy tài khoản](https://tlg.builera.app/docs/guides/nodes-windows.md)
- [Thêm, kiểm tra và thay proxy](https://tlg.builera.app/docs/guides/proxies.md)

## Tích hợp

- [Kết nối trợ lý AI bên ngoài](https://tlg.builera.app/docs/integrations/ai-connections.md)
- [Tạo và theo dõi webhook](https://tlg.builera.app/docs/integrations/webhooks.md)
- [Kiểm chữ ký và xử lý webhook bên nhận](https://tlg.builera.app/docs/integrations/webhook-receivers.md)
- [Đẩy sự kiện vào Google Sheets](https://tlg.builera.app/docs/integrations/google-sheets.md)

## Sổ tay cho AI agent

- [Kiểm tra sức khoẻ tài khoản chỉ đọc](https://tlg.builera.app/docs/agent-playbooks/check-accounts.md): Thu thập trạng thái tài khoản trong phạm vi kết nối và báo cáo điểm cần người xử lý mà không thay đổi cấu hình.
- [Xử lý hội thoại đang chờ trả lời](https://tlg.builera.app/docs/agent-playbooks/handle-inbox.md): Đọc ngữ cảnh, giữ hội thoại và trả lời trong phạm vi được phép mà không vượt khoá hay danh sách không liên hệ.
- [Chuẩn bị bản nháp chiến dịch](https://tlg.builera.app/docs/agent-playbooks/prepare-campaign.md): Tạo và kiểm tra bản nháp chiến dịch theo yêu cầu của người mà không tự xuất bản hoặc bắt đầu chạy.
- [Điều tra việc lỗi hoặc chưa rõ kết quả](https://tlg.builera.app/docs/agent-playbooks/investigate-failed-job.md): Đọc bằng chứng của thao tác, phân biệt việc bị giữ với việc lỗi và chỉ chạy lại khi có căn cứ cùng xác nhận cần thiết.
- [Phối hợp xoay bí mật webhook](https://tlg.builera.app/docs/agent-playbooks/rotate-webhook-secret.md): Agent chuẩn bị và kiểm tra việc đổi bí mật, còn người thực hiện bước xoay trên web.
- [Gửi một tin nhắn an toàn](https://tlg.builera.app/docs/agent-playbooks/send-safely.md): Gửi một nội dung đã được phép tới một người, chống trùng và theo dõi kết quả qua cổng an toàn.
- [Agent tự tạo và kiểm tra webhook](https://tlg.builera.app/docs/agent-playbooks/set-up-webhook.md): Tạo webhook thuộc chính kết nối, thu hẹp sự kiện và xác nhận đường nhận trước khi dùng thật.

## An toàn

- [Thao tác nguy hiểm và xác nhận](https://tlg.builera.app/docs/safety/dangerous-actions.md): Nhận biết thao tác có thể làm mất dữ liệu, đổi quyền hoặc tạo lại tác động trên Telegram trước khi xác nhận.
- [Sử dụng có trách nhiệm](https://tlg.builera.app/docs/safety/acceptable-use.md): Dùng tài khoản và dữ liệu được phép, tôn trọng người nhận và không dùng tự động hoá để gửi nội dung gây phiền.
- [Giới hạn và hạn chế từ Telegram](https://tlg.builera.app/docs/safety/telegram-limits.md): Phân biệt yêu cầu chờ của Telegram với hạn mức của app và biết cách xử lý tài khoản bị hạn chế.
- [Giữ bí mật truy cập](https://tlg.builera.app/docs/safety/keep-secrets.md): Nhận biết dữ liệu truy cập nhạy cảm, cách app bảo vệ chúng và các bước cần làm khi nghi có rò rỉ.

## Xử lý sự cố

- [Không đăng nhập được Telegram](https://tlg.builera.app/docs/troubleshooting/telegram-login.md)
- [Tài khoản bị yêu cầu chờ hoặc giảm tốc](https://tlg.builera.app/docs/troubleshooting/flood-wait.md)
- [Tin nhắn chưa rõ đã gửi hay chưa](https://tlg.builera.app/docs/troubleshooting/unverified-send.md)
- [Webhook không tới hoặc bị từ chối](https://tlg.builera.app/docs/troubleshooting/webhook-failures.md)
- [Máy chủ mất kết nối](https://tlg.builera.app/docs/troubleshooting/machine-offline.md)
- [Proxy lỗi, chậm hoặc đổi IP](https://tlg.builera.app/docs/troubleshooting/proxy-failed.md)
- [Câu hỏi thường gặp](https://tlg.builera.app/docs/troubleshooting/faq.md)

## Tham chiếu

- [Tham chiếu](https://tlg.builera.app/docs/reference.md): Tham chiếu sinh tự động từ mã nguồn: REST, MCP, sự kiện, lỗi, quyền, hạn mức và trạng thái.
- [REST API v2](https://tlg.builera.app/docs/reference/rest.md): Mọi thao tác của app qua HTTP, cùng cửa an toàn như giao diện.
- [MCP](https://tlg.builera.app/docs/reference/mcp.md): Máy chủ MCP của Telegram-Auto: profile, tool có tên, tìm & chạy mọi thao tác, xác nhận việc nguy hiểm.
- [Sự kiện](https://tlg.builera.app/docs/reference/events.md): Danh mục sự kiện webhook / luồng sự kiện: nhóm, scope, bộ lọc, schema và payload mẫu.
- [Mã lỗi](https://tlg.builera.app/docs/reference/errors.md): Mọi mã lỗi REST v2 / MCP: ý nghĩa, mã HTTP, có thử lại được không và nên làm gì.
- [Scope & vai trò](https://tlg.builera.app/docs/reference/scopes.md): Các nhóm việc (scope), mẫu quyền nhanh, profile MCP và cách giới hạn theo vai trò.
- [Hạn mức](https://tlg.builera.app/docs/reference/limits.md): Chế độ Tự do / An toàn, mức mặc định mỗi ngày, làm ấm và ý nghĩa của trống, null và 0.
- [Trạng thái](https://tlg.builera.app/docs/reference/states.md): Trạng thái tài khoản, việc chạy, máy chạy, proxy và tín hiệu an toàn — mã và cách app hiển thị.
- [Bản đồ app ↔ API ↔ MCP](https://tlg.builera.app/docs/reference/map.md): Mỗi thao tác của app ứng với thao tác REST và tool MCP nào.

## Thuật ngữ

- [Thuật ngữ Telegram-Auto](https://tlg.builera.app/docs/glossary.md)

## Nhật ký thay đổi

- [Nhật ký thay đổi](https://tlg.builera.app/docs/changelog.md)