1export const twilioSmsIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'sms.twilio',
4		version: '1.0.0',
5		category: 'sms',
6		title: 'Twilio Messaging',
7		description:
8			'Twilio SMS integration for transactional and notification messaging.',
9		domain: 'communications',
10		owners: ['platform.messaging'],
11		tags: ['sms', 'messaging'],
12		stability: StabilityEnum.Stable,
13	},
14	supportedModes: ['managed', 'byok'],
15	transports: [
16		{ type: 'rest', baseUrl: 'https://api.twilio.com' },
17		{
18			type: 'webhook',
19			inbound: {
20				signatureHeader: 'x-twilio-signature',
21				signingAlgorithm: 'hmac-sha1',
22			},
23		},
24		{ type: 'sdk', packageName: 'twilio', minVersion: '5.0.0' },
25	],
26	preferredTransport: 'rest',
27	supportedAuthMethods: [{ type: 'basic' }],
28	capabilities: {
29		provides: [{ key: 'sms.outbound', version: '1.0.0' }],
30	},
31	configSchema: {
32		schema: {
33			type: 'object',
34			properties: {
35				fromNumber: {
36					type: 'string',
37					description: 'Default Twilio phone number used as sender.',
38				},
39			},
40		},
41		example: {
42			fromNumber: '+15551234567',
43		},
44	},
45	secretSchema: {
46		schema: {
47			type: 'object',
48			required: ['accountSid', 'authToken'],
49			properties: {
50				accountSid: {
51					type: 'string',
52					description: 'Twilio Account SID.',
53				},
54				authToken: {
55					type: 'string',
56					description: 'Twilio Auth Token.',
57				},
58			},
59		},
60		example: {
61			accountSid: 'ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
62			authToken: 'auth-token',
63		},
64	},
65	healthCheck: {
66		method: 'custom',
67		timeoutMs: 3000,
68	},
69	docsUrl: 'https://www.twilio.com/docs/sms/api',
70	constraints: {
71		rateLimit: {
72			rpm: 200,
73		},
74	},
75	byokSetup: {
76		setupInstructions:
77			'Provide a Twilio account SID, auth token, and verify the outbound sending numbers used by the integration.',
78		keyRotationSupported: true,
79		quotaTrackingSupported: false,
80	},
81});