1export const messagingWhatsappMetaIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'messaging.whatsapp.meta',
4		version: '1.0.0',
5		category: 'messaging',
6		title: 'WhatsApp Cloud API (Meta)',
7		description:
8			'Meta WhatsApp Cloud API integration for inbound message processing and outbound replies.',
9		domain: 'communications',
10		owners: ['platform.messaging'],
11		tags: ['messaging', 'whatsapp', 'meta'],
12		stability: StabilityEnum.Beta,
13	},
14	supportedModes: ['managed', 'byok'],
15	transports: [
16		{ type: 'rest', baseUrl: 'https://graph.facebook.com' },
17		{
18			type: 'webhook',
19			inbound: {
20				signatureHeader: 'x-hub-signature-256',
21				signingAlgorithm: 'hmac-sha256',
22			},
23		},
24	],
25	preferredTransport: 'rest',
26	supportedAuthMethods: [
27		{ type: 'bearer' },
28		{
29			type: 'webhook-signing',
30			algorithm: 'hmac-sha256',
31			signatureHeader: 'x-hub-signature-256',
32		},
33	],
34	capabilities: {
35		provides: [
36			{ key: 'messaging.inbound', version: '1.0.0' },
37			{ key: 'messaging.outbound', version: '1.0.0' },
38		],
39	},
40	configSchema: {
41		schema: {
42			type: 'object',
43			required: ['phoneNumberId'],
44			properties: {
45				phoneNumberId: {
46					type: 'string',
47					description: 'WhatsApp business phone number ID used for sends.',
48				},
49				apiVersion: {
50					type: 'string',
51					description: 'Optional Graph API version (e.g. v22.0).',
52				},
53			},
54		},
55		example: {
56			phoneNumberId: '1234567890',
57			apiVersion: 'v22.0',
58		},
59	},
60	secretSchema: {
61		schema: {
62			type: 'object',
63			required: ['accessToken', 'appSecret', 'verifyToken'],
64			properties: {
65				accessToken: {
66					type: 'string',
67					description: 'Meta access token for WhatsApp Cloud API calls.',
68				},
69				appSecret: {
70					type: 'string',
71					description: 'Meta app secret used for signature verification.',
72				},
73				verifyToken: {
74					type: 'string',
75					description: 'Webhook verify token used during challenge handshake.',
76				},
77			},
78		},
79		example: {
80			accessToken: 'EAAG***',
81			appSecret: '***',
82			verifyToken: 'contractspec-verify',
83		},
84	},
85	healthCheck: {
86		method: 'custom',
87		timeoutMs: 5000,
88	},
89	docsUrl: 'https://developers.facebook.com/docs/whatsapp',
90	constraints: {
91		rateLimit: {
92			rpm: 120,
93		},
94	},
95	byokSetup: {
96		setupInstructions:
97			'Create a Meta app with WhatsApp product enabled, add a business phone number, and provide API and webhook credentials.',
98		keyRotationSupported: false,
99		quotaTrackingSupported: false,
100	},
101});