waMarketing

🥈Silver

Python script that automates sending bulk WhatsApp messages to contacts listed in an Excel file, using Selenium to control WhatsApp Web and pandas to read contact data.

1030Updated 1mo ago

Intermediate30min to implementmarketing

Saves ~30 min per use

Quick InstallView Source

git clone https://github.com/python-togo/waMarketing.git

Works with:

Claude

Overview

About This Skill

waMarketing is a Python-based automation script that sends bulk WhatsApp messages by reading contact details from an Excel (.xlsx) file and controlling WhatsApp Web through Selenium. Originally built for IndabaX Togo to message event attendees, it eliminates the manual effort of sending individual WhatsApp messages to large contact lists. The script requires Python 3.6+, a Chrome browser, and ChromeDriver, making it straightforward to set up on any standard development environment. It is well-suited for event organizers, community managers, and marketers who need to reach many WhatsApp contacts efficiently without a paid API.

How to Use

Clone the repository and run 'pip install -r requirements.txt' to install dependencies. Download ChromeDriver matching your Chrome version and place it in the project directory. Populate the included clients.xlsx file with your contact details, then execute waMarketing.py to start sending messages through WhatsApp Web.

Use Cases

Sending event invitations or reminders to a list of attendees stored in Excel

Distributing bulk announcements to community members via WhatsApp Web

Notifying clients or customers about updates using contact data from a spreadsheet

Automating post-event follow-up messages to conference participants

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/python-togo/waMarketing

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

I need to send bulk WhatsApp messages for [COMPANY] in the [INDUSTRY] sector. I have a list of [NUMBER] contacts and want to send a promotional message about [PRODUCT/SERVICE]. Can you help me draft a compelling message and provide guidance on best practices for bulk WhatsApp marketing?

Example Output

# WhatsApp Bulk Messaging Strategy for [COMPANY]

## Draft Message

**Subject:** Exclusive Offer Just for You!

Hi [First Name],

We're excited to share an exclusive offer with you! As a valued customer in the [INDUSTRY] sector, we'd like to introduce our new [PRODUCT/SERVICE]. Here's what makes it special:

- **Feature 1**: [Description]
- **Feature 2**: [Description]
- **Feature 3**: [Description]

Use code **WA20** at checkout to get 20% off your first purchase. This offer is valid until [DATE].

[Call-to-Action Button: Shop Now]

## Best Practices

1. **Segment Your List**: Ensure your contacts are interested in [PRODUCT/SERVICE] to improve engagement.
2. **Timing Matters**: Send messages during business hours (9 AM - 5 PM) for better response rates.
3. **Personalize**: Use merge tags like [First Name] to make messages feel personal.
4. **Comply with Regulations**: Ensure you have consent to message contacts and provide an easy opt-out option.
5. **Monitor Performance**: Track open rates and responses to refine future campaigns.