telegram.*

Méthodes du pont Telegram. Nécessite un jeton de bot configuré — voir Pont Telegram.

Méthode	Params	Résultat
telegram.status	{}	{ bot: { username, firstName }, polling: boolean, lastError?: string, accessPolicy: "open"|"dm-only"|"allowlist", approvedChats: number, pendingPairings: number }
telegram.list_chats	{}	{ chats: Array<{ id, kind: "private"|"group", title, lastMessageAt, lastMessagePreview }> }
telegram.read	{ chatId: string|number, limit?: number, beforeMessageId?: number }	{ messages: Array<{ id, ts, fromId, fromName, text, replyToId? }> }
telegram.send	{ chatId: string|number, text: string, silent?: boolean, replyToId?: number }	{ messageId }
telegram.settings	{}	sous-arbre complet des paramètres Telegram (jeton occulté)

Équivalents CLI

Méthode	CLI
telegram.status	ht telegram status
telegram.list_chats	ht telegram chats
telegram.read	ht telegram read --chat <id> --limit N
telegram.send	ht telegram send --chat <id> "<text>"
telegram.settings	(panneau de paramètres uniquement)

Côté lecture

Méthode	Params	Résultat
telegram.chats	{}	{ chats: [{ id, name?, lastMessageAt }] } — plus récent d’abord
telegram.history	{ chat_id, limit?, before? }	{ messages: TelegramWireMessage[] }
telegram.restart	{}	"OK" — recrée le service de long-poll

telegram.history lit le journal SQLite (~/Library/Application Support/hyperterm-canvas/telegram.db) : il fonctionne donc même quand le polling est désactivé. before est un timestamp de message pour la pagination.

telegram.restart est le remède à un token renouvelé ou à une panne API transitoire — sans redémarrer l’application.