Skip to main content

Send WhatsApp bulk messages from Google Sheets

Workflow preview

Workflow preview
100%
Send WhatsApp bulk messages from Google Sheets preview
Open on n8n.io

Important notice

This workflow is provided as-is. Please review and test before using in production.

1. Workflow Overview

WhatsApp Bulk Message Broadcast via Google Sheets (n8n Workflow) Use Case This workflow enables automated bulk WhatsApp message broadcasting using the WhatsApp Business Cloud API. It pulls recipien...

Best for

  • Social Media automation workflows
  • intermediate n8n builders looking for reusable templates

Tools used

n8n-nodes-base.googlesheets, n8n-nodes-base.limit, n8n-nodes-base.splitinbatches, n8n-nodes-base.whatsapp, n8n-nodes-base.code, n8n-nodes-base.stickynote, n8n-nodes-base.scheduletrigger

Source and attribution

This workflow is cataloged by N8N Workflows and links back to its original n8n.io source page by SpaGreen Creative.

Original n8n.io source

1.1 Workflow description

Title
Send WhatsApp bulk messages from Google Sheets
Workflow name
Send WhatsApp bulk messages from Google Sheets

WhatsApp Bulk Message Broadcast via Google Sheets (n8n Workflow)

Use Case

This workflow enables automated bulk WhatsApp message broadcasting using the WhatsApp Business Cloud API. It pulls recipient and message data from a Google Sheet, sends templated messages (optionally with image headers), and updates the sheet with the message status. It is ideal for marketing teams, support agents, and businesses handling high-volume outreach.


Who Is This For?

  • Businesses conducting WhatsApp marketing or outreach campaigns
  • Customer support or notification teams
  • Administrators seeking an automated, no-code message distribution system using Google Sheets

What This Workflow Does

  • Triggers automatically every minute to scan for pending messages
  • Fetches unsent entries from a Google Sheet
  • Limits the number of messages processed per execution to comply with API usage guidelines
  • Sanitizes WhatsApp numbers for proper formatting
  • Sends messages using a pre-approved WhatsApp template (text and optional image)
  • Marks the row as "Sent" in the sheet upon successful delivery

Workflow Breakdown (Node by Node)

1. Trigger Every 5 Minutes

Initiates the workflow every minute using a scheduled trigger to continuously monitor pending rows.

2. Fetch All Pending Queries for Messaging

Reads rows from a Google Sheet where the Status column is empty, indicating they haven’t been processed yet.

3. Limit

Restricts processing to 2 rows per execution to manage API throughput.

4. Loop Over Items

Uses SplitInBatches to iterate through each row individually.

5. Clean WhatsApp Number

A code node that strips non-numeric characters from the WhatsApp No field, ensuring the format is valid for the API.

6. Send Message to 300 Phone No

Sends a WhatsApp message using the WhatsApp Cloud API and a pre-approved template.
Template includes:

  • An image from the Image URL column (as header, optional)
  • Dynamic variables for the recipient's Name and Message fields

Template variables must be pre-defined and approved in the Meta Developer Portal, such as {{1}}, {{2}}.

7. Change State of Rows in Sent1

Updates the Status column to Sent for each successfully processed row using the row number as a reference.


Google Sheet Format

Structure your Google Sheet as shown below:

WhatsApp No Name Message Image URL Status
+8801XXXXXXX John Doe Hello, your order shipped https://.../img.jpg

Leave the Status column empty for rows that need to be processed.


Requirements

  • WhatsApp Business Cloud API access via Meta for Developers
  • A properly structured Google Sheet as described above
  • Active OAuth2 credentials configured in n8n for:
    • googleSheetsOAuth2Api
    • whatsAppApi

Customization Options

  • Update the Limit node to control how many rows are processed in each run
  • Adjust the trigger schedule (e.g., change to every 5 minutes)
  • Replace the message template ID with your own custom-approved one from Meta
  • Add error-handling logic (e.g., IF or Try/Catch nodes) to log failures or set Status = Failed

Sample Sheet Template

View Sample Google Sheet


Workflow Highlights

  • Automated execution every 1 minute
  • Reads and processes only pending records
  • Verifies WhatsApp numbers and delivers templated messages
  • Updates Google Sheet after each attempt

Support & Community

Need help setting up or customizing the workflow?

1.2 Logical Blocks

This catalog entry is organized from the workflow JSON. The node-level section below shows the executable blocks available for review before importing the template.

2. Block-by-Block Analysis

Block 1 - Fetch All Pending Queries for Messaging

Type / Role
n8n-nodes-base.googleSheets - googleSheets
Config choices
Version 4.6

Block 2 - Limit

Type / Role
n8n-nodes-base.limit - limit
Config choices
Version 1

Block 3 - Loop Over Items

Type / Role
n8n-nodes-base.splitInBatches - splitInBatches
Config choices
Version 3

Block 4 - Change State of Rows in Sent1

Type / Role
n8n-nodes-base.googleSheets - googleSheets
Config choices
Version 4.6

Block 5 - Send Message to 100 Phone No1

Type / Role
n8n-nodes-base.whatsApp - whatsApp
Config choices
Version 1

Block 6 - Clean WhatsApp Number

Type / Role
n8n-nodes-base.code - code
Config choices
Version 2

Block 7 - Sticky Note1

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 8 - Trigger Every 5 Minute

Type / Role
n8n-nodes-base.scheduleTrigger - scheduleTrigger
Config choices
Version 1.2

3. Summary Table

Workflow Send WhatsApp bulk messages from Google Sheets
Complexity intermediate
Nodes 8
Categories Social Media
Author SpaGreen Creative
Published 21 Jul 2025

4. Reproducing the Workflow from Scratch

  1. 1. Download the workflow JSON

    Use the JSON export at /data/workflows/6237/6237.json as the source template for this automation.

  2. 2. Import the template into n8n

    Open n8n, import the downloaded JSON, and review each node before activating the workflow.

  3. 3. Configure credentials and variables

    Replace placeholder credentials, API keys, webhook URLs, account IDs, and environment-specific values with your own settings.

  4. 4. Test with sample data

    Run the workflow manually or in a staging workspace, inspect node output, and confirm downstream systems receive the expected data.

  5. 5. Activate and monitor

    Enable the workflow only after testing, then monitor executions, errors, and rate limits during the first production runs.

5. General Notes & Resources

Review imported nodes carefully before activation. This catalog entry is intended to help you inspect the workflow structure, understand required services, and find related templates faster.

Node names, credentials, schedules, webhook paths, and external service limits may need adjustment for your workspace.

Frequently asked questions

What does Send WhatsApp bulk messages from Google Sheets do?

WhatsApp Bulk Message Broadcast via Google Sheets (n8n Workflow) Use Case This workflow enables automated bulk WhatsApp message broadcasting using the WhatsApp Business Cloud API. It pulls recipien...

What do I need before importing this workflow?

Review the workflow JSON, configure any required credentials in n8n, and test the automation in a safe workspace before using it in production.

Can I customize this workflow?

Yes. Use the block-by-block analysis and the downloadable JSON to inspect each node, then adjust credentials, prompts, schedules, filters, or destinations for your Social Media use case.