WhatsApp Cloud TS

Typed Bulk Sending

Send personalized messages to multiple recipients with built-in rate-limiting delays.

When you need to broadcast a template to hundreds or thousands of users, doing it concurrently can hit WhatsApp's rate limits. The sendBulkTyped method handles queuing and delays for you automatically, while keeping everything strictly typed.

Usage

const results = await client.sendBulkTyped(
  orderTemplate,
  [
    {
      to: "919876543210",
      params: { customerName: "Rahul", orderId: "#123", header: { url: "..." } },
    },
    {
      to: "919876543211",
      params: { customerName: "Priya", orderId: "#124", header: { url: "..." } },
    },
  ],
  { delayMs: 500 } // 500ms delay between requests (default is 300ms)
);

console.log(`Successful sends: ${results.filter(r => r.success).length}`);

Benefits

  • Strictly Typed Parameters: TypeScript ensures you provide the correct parameters for each user based on the template definition.
  • Rate Limit Protection: Built-in configurable delays prevent you from being blocked by Meta.
  • Result Tracking: Returns an array of results indicating success or failure for each recipient.