# Telegram-Auto Docs

> Learn Telegram-Auto from first steps to advanced use: inbox, accounts, worker nodes, proxies, campaigns, API, MCP and webhooks.

- Docs home: https://tlg.builera.app/en/docs
- Full text: https://tlg.builera.app/en/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
- Tiếng Việt: https://tlg.builera.app/docs/llms.txt

## Get started

- [What is Telegram-Auto?](https://tlg.builera.app/en/docs/start/overview.md): Telegram-Auto helps a team run many personal Telegram accounts from one shared inbox, with a safety gate in front of everything that goes out.
- [Get started in 10 minutes](https://tlg.builera.app/en/docs/start/quickstart.md): Create a workspace, connect a machine, add a proxy, and sign in to Telegram to reply to your first conversation.
- [Choose web, REST API, MCP, or webhooks](https://tlg.builera.app/en/docs/start/choose-interface.md): Choose the right way to work for operators, integrated software, and external AI agents.
- [Before you start](https://tlg.builera.app/en/docs/start/prepare.md): Prepare your Telegram account, dedicated proxy, machine, and team permissions before setting up a workspace.

## Concepts

- [Workspaces, members, and roles](https://tlg.builera.app/en/docs/concepts/workspace-and-roles.md)
- [Personal Telegram accounts and sign-in sessions](https://tlg.builera.app/en/docs/concepts/personal-accounts.md)
- [Machines that run accounts](https://tlg.builera.app/en/docs/concepts/machines.md)
- [A dedicated proxy for each account](https://tlg.builera.app/en/docs/concepts/proxies.md)
- [Free and Safe](https://tlg.builera.app/en/docs/concepts/free-and-safe.md)
- [Limits and warm-up](https://tlg.builera.app/en/docs/concepts/limits-and-warmup.md)
- [Account safety states](https://tlg.builera.app/en/docs/concepts/safety-states.md)
- [STOP and the do-not-contact list](https://tlg.builera.app/en/docs/concepts/do-not-contact.md)
- [Internal accounts](https://tlg.builera.app/en/docs/concepts/internal-accounts.md)
- [Jobs, queues, and states](https://tlg.builera.app/en/docs/concepts/jobs-and-states.md)
- [Which groups and channels appear in Inbox?](https://tlg.builera.app/en/docs/concepts/inbox-groups.md)
- [Confirmation before dangerous actions](https://tlg.builera.app/en/docs/concepts/confirmations.md)

## Guides

- [Handle messages in Inbox](https://tlg.builera.app/en/docs/guides/inbox.md)
- [Create and use saved replies](https://tlg.builera.app/en/docs/guides/templates.md)
- [Create and run a campaign](https://tlg.builera.app/en/docs/guides/campaigns.md)
- [Read campaign results and progress](https://tlg.builera.app/en/docs/guides/campaign-results.md)
- [Find groups and potential customers](https://tlg.builera.app/en/docs/guides/discover.md)
- [Follow keyword signals](https://tlg.builera.app/en/docs/guides/signals.md)
- [Manage people and follow-up stages](https://tlg.builera.app/en/docs/guides/people.md)
- [Import a list of people from a file](https://tlg.builera.app/en/docs/guides/people-import.md)
- [Automate with packs, routines, and rules](https://tlg.builera.app/en/docs/guides/automation.md)
- [Manage your groups and channels list](https://tlg.builera.app/en/docs/guides/chats.md)
- [Administer groups and channels](https://tlg.builera.app/en/docs/guides/group-admin.md)
- [Create and manage bots](https://tlg.builera.app/en/docs/guides/bots.md)
- [Post and manage stories](https://tlg.builera.app/en/docs/guides/stories.md)
- [Read and resolve alerts](https://tlg.builera.app/en/docs/guides/alerts.md)
- [Read logs and rerun failed jobs](https://tlg.builera.app/en/docs/guides/logs.md)
- [Read operational statistics](https://tlg.builera.app/en/docs/guides/stats.md)
- [Profile and workspace settings](https://tlg.builera.app/en/docs/guides/settings.md)
- [Invite members and assign permissions](https://tlg.builera.app/en/docs/guides/members.md)
- [Add a Telegram account with a QR code](https://tlg.builera.app/en/docs/guides/accounts-add-qr.md)
- [Add an account with a phone number](https://tlg.builera.app/en/docs/guides/accounts-add-phone.md)
- [Manage Telegram accounts](https://tlg.builera.app/en/docs/guides/accounts-manage.md)
- [Set account limits and run schedules](https://tlg.builera.app/en/docs/guides/accounts-limits-schedule.md)
- [Set up account nurture and run schedules](https://tlg.builera.app/en/docs/guides/nurture.md)
- [Connect Hetzner and launch machines for accounts](https://tlg.builera.app/en/docs/guides/nodes-hetzner.md)
- [Add a Windows machine for accounts](https://tlg.builera.app/en/docs/guides/nodes-windows.md)
- [Add, check, and replace proxies](https://tlg.builera.app/en/docs/guides/proxies.md)

## Integrations

- [Connect an external AI assistant](https://tlg.builera.app/en/docs/integrations/ai-connections.md)
- [Create and monitor webhooks](https://tlg.builera.app/en/docs/integrations/webhooks.md)
- [Verify signatures and process incoming webhooks](https://tlg.builera.app/en/docs/integrations/webhook-receivers.md)
- [Send events to Google Sheets](https://tlg.builera.app/en/docs/integrations/google-sheets.md)

## AI agent playbooks

- [Read-only account health check](https://tlg.builera.app/en/docs/agent-playbooks/check-accounts.md): Gather account status within the connection's scope and report issues that need a person without changing configuration.
- [Handle conversations awaiting a reply](https://tlg.builera.app/en/docs/agent-playbooks/handle-inbox.md): Read context, claim conversations and reply within your permitted scope without overriding locks or do-not-contact restrictions.
- [Prepare a campaign draft](https://tlg.builera.app/en/docs/agent-playbooks/prepare-campaign.md): Create and check a campaign draft at a person's request without publishing it or starting a run on your own.
- [Investigate a failed job or unclear outcome](https://tlg.builera.app/en/docs/agent-playbooks/investigate-failed-job.md): Read operation evidence, distinguish held jobs from failed jobs and retry only with supporting evidence and any required confirmation.
- [Coordinate webhook secret rotation](https://tlg.builera.app/en/docs/agent-playbooks/rotate-webhook-secret.md): The agent prepares and checks the secret change, while a person performs the rotation on the web.
- [Send one message safely](https://tlg.builera.app/en/docs/agent-playbooks/send-safely.md): Send approved content to one person, prevent duplicates and track the result through the safety gate.
- [Let an agent create and test a webhook](https://tlg.builera.app/en/docs/agent-playbooks/set-up-webhook.md): Create a webhook owned by the connection, narrow its events and verify the receiving path before using real data.

## Safety

- [Dangerous actions and confirmation](https://tlg.builera.app/en/docs/safety/dangerous-actions.md): Recognize actions that can lose data, change permissions, or repeat effects on Telegram before you confirm.
- [Responsible use](https://tlg.builera.app/en/docs/safety/acceptable-use.md): Use authorized accounts and data, respect recipients, and do not use automation to send unwanted content.
- [Telegram limits and restrictions](https://tlg.builera.app/en/docs/safety/telegram-limits.md): Distinguish Telegram's wait requirements from app quotas and learn how to handle restricted accounts.
- [Keep access secrets safe](https://tlg.builera.app/en/docs/safety/keep-secrets.md): Recognize sensitive access data, understand how the app protects it, and know what to do if you suspect a leak.

## Troubleshooting

- [Cannot sign in to Telegram](https://tlg.builera.app/en/docs/troubleshooting/telegram-login.md)
- [Account required to wait or throttled](https://tlg.builera.app/en/docs/troubleshooting/flood-wait.md)
- [Unclear whether a message was sent](https://tlg.builera.app/en/docs/troubleshooting/unverified-send.md)
- [Webhook not arriving or rejected](https://tlg.builera.app/en/docs/troubleshooting/webhook-failures.md)
- [Machine offline](https://tlg.builera.app/en/docs/troubleshooting/machine-offline.md)
- [Proxy failing, slow, or changing IP](https://tlg.builera.app/en/docs/troubleshooting/proxy-failed.md)
- [Frequently asked questions](https://tlg.builera.app/en/docs/troubleshooting/faq.md)

## Reference

- [Reference](https://tlg.builera.app/en/docs/reference.md): Reference generated from the source code: REST, MCP, events, errors, scopes, limits and states.
- [REST API v2](https://tlg.builera.app/en/docs/reference/rest.md): Every app action over HTTP, through the same safety gate as the app.
- [MCP](https://tlg.builera.app/en/docs/reference/mcp.md): Telegram-Auto's MCP server: profiles, named tools, search & run every operation, confirming dangerous actions.
- [Events](https://tlg.builera.app/en/docs/reference/events.md): Catalog of webhook / feed events: groups, scopes, filters, schemas and sample payloads.
- [Error codes](https://tlg.builera.app/en/docs/reference/errors.md): Every REST v2 / MCP error code: meaning, HTTP status, whether to retry and what to do.
- [Scopes & roles](https://tlg.builera.app/en/docs/reference/scopes.md): Scopes, quick permission presets, MCP profiles and how roles limit a connection.
- [Limits](https://tlg.builera.app/en/docs/reference/limits.md): Free / Safe modes, default daily limits, warm-up, and what empty, null and 0 mean.
- [States](https://tlg.builera.app/en/docs/reference/states.md): Account, job, node, proxy and safety-signal states — their codes and how the app shows them.
- [App ↔ API ↔ MCP map](https://tlg.builera.app/en/docs/reference/map.md): Which REST operation and MCP tool match each app action.

## Glossary

- [Telegram-Auto glossary](https://tlg.builera.app/en/docs/glossary.md)

## Changelog

- [Changelog](https://tlg.builera.app/en/docs/changelog.md)