1export const messagingWhatsappTwilioIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'messaging.whatsapp.twilio',
4		version: '1.0.0',
5		category: 'messaging',
6		title: 'WhatsApp via Twilio',
7		description:
8			'Twilio-powered WhatsApp integration for inbound webhooks and outbound conversational messaging.',
9		domain: 'communications',
10		owners: ['platform.messaging'],
11		tags: ['messaging', 'whatsapp', 'twilio'],
12		stability: StabilityEnum.Beta,
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	],
25	preferredTransport: 'rest',
26	supportedAuthMethods: [{ type: 'basic' }],
27	capabilities: {
28		provides: [
29			{ key: 'messaging.inbound', version: '1.0.0' },
30			{ key: 'messaging.outbound', version: '1.0.0' },
31		],
32	},
33	configSchema: {
34		schema: {
35			type: 'object',
36			properties: {
37				fromNumber: {
38					type: 'string',
39					description:
40						'Default WhatsApp-enabled Twilio sender number (e.g. whatsapp:+15551234567).',
41				},
42			},
43		},
44		example: {
45			fromNumber: 'whatsapp:+15551234567',
46		},
47	},
48	secretSchema: {
49		schema: {
50			type: 'object',
51			required: ['accountSid', 'authToken'],
52			properties: {
53				accountSid: {
54					type: 'string',
55					description: 'Twilio account SID.',
56				},
57				authToken: {
58					type: 'string',
59					description: 'Twilio auth token.',
60				},
61			},
62		},
63		example: {
64			accountSid: 'ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
65			authToken: '***',
66		},
67	},
68	healthCheck: {
69		method: 'custom',
70		timeoutMs: 4000,
71	},
72	docsUrl: 'https://www.twilio.com/docs/whatsapp',
73	constraints: {
74		rateLimit: {
75			rpm: 200,
76		},
77	},
78	byokSetup: {
79		setupInstructions:
80			'Create a Twilio project with WhatsApp sender provisioning, then provide account SID/auth token and sender number.',
81		keyRotationSupported: true,
82		quotaTrackingSupported: false,
83	},
84});