Telegram Integration

Capture and manage from Telegram in seconds

The Clear Tangle Telegram bot lets you capture thoughts, manage tasks, and search your knowledge base from any device. It is DM-only for privacy, supports interactive inline keyboard actions, and keeps everything synced with your account.

Quick start

1Open Telegram and DM @clear_tangle_bot
2Send /link to generate a pairing code
3Enter the code in Settings → Integrations → Telegram
4Start capturing or managing tasks right away

DM-only for privacy

The Telegram integration only responds in private chats. Group chats and channels are ignored.

Telegram quick startbash

# Link your account
1) DM @clear_tangle_bot in Telegram
2) Send /link to get a pairing code
3) Enter the code in Settings → Integrations → Telegram

# Capture and manage
/capture Remember to follow up on the proposal
/tasks today
/plan new

Key capabilities

Fast capture in DMs

Send a plain message or /capture to save a thought instantly.

Interactive task actions

Inline keyboard buttons let you complete, comment, edit, or delete tasks.

Search and AI plans

Run /search for instant results or /plan to get AI-prioritized tasks.

Attachments supported

Photos, voice notes, audio, and documents are saved as captures.

Command reference

Command	Scope	Description
`/link`	DM-only	Generate a 6-digit pairing code
`/capture <text>`	DM-only	Create a new capture
`/tasks [today\|overdue\|week\|all]`	DM-only	List tasks by urgency
`/task <id>`	DM-only	View task details and actions
`/task create <title>`	DM-only	Create a task with optional priority and due date
`/search <query>`	DM-only	Search your knowledge base
`/plan [new\|last]`	DM-only	Generate or retrieve AI plans
`/projects`	DM-only	List projects
`/pages`	DM-only	List pages
`/unlink`	DM-only	Disconnect Telegram from Clear Tangle

Plain text = capture

If you send a normal message in a DM, it is automatically saved as a capture.

Interactive inline keyboard UI

Task lists are paginated (5 per page) with inline buttons for quick actions. You can complete tasks, add comments, open details, or refresh without typing extra commands.

Pagination controls with Prev/Next and page counters
Task details view with Edit, Comment, Complete, and Delete actions
Delete confirmations and reply-based edit flows for safety
Search results include View and Create Task buttons

Attachments and media

Photos, voice notes, audio files, and documents are stored as captures with secure signed download links. Images include thumbnails and audio can generate waveforms when processing is enabled.

Security and privacy

Verified webhooks

Requests are validated with a secret token header before any processing.

Short-lived pairing codes

6-digit codes expire after 10 minutes and are invalidated on success.

Private chat only

Only direct messages are accepted. Group chats are ignored.

Rate limiting

Per-user limits protect against abuse and accidental loops.