Configuration

Configuration Options

Option	Type	Default	Description
`token`	`string`	Required	WhatsApp API access token
`phoneNumberId`	`string`	Required	Your WhatsApp phone number ID
`businessAccountId`	`string`	Optional	Business account ID
`version`	`string`	`'v21.0'`	API version
`appSecret`	`string`	Optional	App secret for signature verification
`webhookVerifyToken`	`string`	Optional	Token for webhook verification
`apiTimeout`	`number`	`30000`	API request timeout (ms)
`maxRetries`	`number`	`3`	Max retry attempts for failed requests
`autoMarkRead`	`boolean`	`true`	Auto-mark messages as read
`autoProcessMessages`	`boolean`	`true`	Auto-process incoming messages
`queueEnabled`	`boolean`	`true`	Enable message queue
`maxQueueSize`	`number`	`1000`	Maximum queue size

Full Configuration Example

1const whatsapp = createWhatsAppHandler({
2  token: 'YOUR_TOKEN',
3  phoneNumberId: 'YOUR_PHONE_ID',
4  businessAccountId: 'YOUR_BUSINESS_ID',
5  version: 'v21.0',
6  appSecret: 'YOUR_APP_SECRET',
7  webhookVerifyToken: 'YOUR_VERIFY_TOKEN',
8  apiTimeout: 30000,
9  maxRetries: 3,
10  autoMarkRead: true,
11  autoProcessMessages: true,
12  queueEnabled: true,
13  maxQueueSize: 1000,
14  storage: {
15    type: 'memory',
16    autoCleanup: true,
17    maxMessagesPerConversation: 1000
18  },
19  webhook: {
20    verifyToken: 'YOUR_VERIFY_TOKEN',
21    appSecret: 'YOUR_APP_SECRET',
22    autoProcess: true,
23    autoMarkRead: true,
24    verifySignature: true,
25    maxBodySize: 10485760, // 10MB
26    timeout: 30000
27  }
28});

Source captured: 2026-10-11

Configuration Options

Option	Type	Default	Description
`token`	`string`	Required	WhatsApp API access token
`phoneNumberId`	`string`	Required	Your WhatsApp phone number ID
`businessAccountId`	`string`	Optional	Business account ID
`version`	`string`	`'v21.0'`	API version
`appSecret`	`string`	Optional	App secret for signature verification
`webhookVerifyToken`	`string`	Optional	Token for webhook verification
`apiTimeout`	`number`	`30000`	API request timeout (ms)
`maxRetries`	`number`	`3`	Max retry attempts for failed requests
`autoMarkRead`	`boolean`	`true`	Auto-mark messages as read
`autoProcessMessages`	`boolean`	`true`	Auto-process incoming messages
`queueEnabled`	`boolean`	`true`	Enable message queue
`maxQueueSize`	`number`	`1000`	Maximum queue size

Full Configuration Example

1const whatsapp = createWhatsAppHandler({
2  token: 'YOUR_TOKEN',
3  phoneNumberId: 'YOUR_PHONE_ID',
4  businessAccountId: 'YOUR_BUSINESS_ID',
5  version: 'v21.0',
6  appSecret: 'YOUR_APP_SECRET',
7  webhookVerifyToken: 'YOUR_VERIFY_TOKEN',
8  apiTimeout: 30000,
9  maxRetries: 3,
10  autoMarkRead: true,
11  autoProcessMessages: true,
12  queueEnabled: true,
13  maxQueueSize: 1000,
14  storage: {
15    type: 'memory',
16    autoCleanup: true,
17    maxMessagesPerConversation: 1000
18  },
19  webhook: {
20    verifyToken: 'YOUR_VERIFY_TOKEN',
21    appSecret: 'YOUR_APP_SECRET',
22    autoProcess: true,
23    autoMarkRead: true,
24    verifySignature: true,
25    maxBodySize: 10485760, // 10MB
26    timeout: 30000
27  }
28});