1export const messagingTelegramIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'messaging.telegram',
4		version: '1.0.0',
5		category: 'messaging',
6		title: 'Telegram Bot API',
7		description:
8			'Telegram messaging integration for inbound webhook updates, threaded topic messages, and outbound bot replies.',
9		domain: 'communications',
10		owners: ['platform.messaging'],
11		tags: ['messaging', 'telegram'],
12		stability: StabilityEnum.Beta,
13	},
14	supportedModes: ['managed', 'byok'],
15	transports: [
16		{ type: 'rest', baseUrl: 'https://api.telegram.org' },
17		{
18			type: 'webhook',
19			inbound: {
20				signatureHeader: 'x-telegram-bot-api-secret-token',
21				signingAlgorithm: 'hmac-sha256',
22			},
23		},
24	],
25	preferredTransport: 'rest',
26	capabilities: {
27		provides: [
28			{ key: 'messaging.inbound', version: '1.0.0' },
29			{ key: 'messaging.outbound', version: '1.0.0' },
30		],
31	},
32	configSchema: {
33		schema: {
34			type: 'object',
35			properties: {
36				defaultChatId: {
37					type: 'string',
38					description:
39						'Optional default Telegram chat ID used for outbound sends when no chat target is provided.',
40				},
41				apiBaseUrl: {
42					type: 'string',
43					description:
44						'Optional Telegram Bot API base URL override for proxies or self-hosted gateways.',
45				},
46			},
47		},
48		example: {
49			defaultChatId: '-1001234567890',
50			apiBaseUrl: 'https://api.telegram.org',
51		},
52	},
53	secretSchema: {
54		schema: {
55			type: 'object',
56			required: ['botToken', 'secretToken'],
57			properties: {
58				botToken: {
59					type: 'string',
60					description:
61						'Telegram bot token used for sendMessage and webhook registration.',
62				},
63				secretToken: {
64					type: 'string',
65					description:
66						'Webhook secret token expected in the X-Telegram-Bot-Api-Secret-Token header.',
67				},
68			},
69		},
70		example: {
71			botToken: '123456789:AA***',
72			secretToken: 'contractspec-telegram-webhook',
73		},
74	},
75	healthCheck: {
76		method: 'custom',
77		timeoutMs: 4000,
78	},
79	docsUrl: 'https://core.telegram.org/bots/api',
80	constraints: {
81		rateLimit: {
82			rpm: 180,
83		},
84	},
85	byokSetup: {
86		setupInstructions:
87			'Create a Telegram bot with BotFather, set a webhook with a secret token, then provide the bot token and secret token.',
88		keyRotationSupported: true,
89		quotaTrackingSupported: false,
90	},
91});