WhatsApp Lead Hunter

Automated lead generation pipeline: Google Maps → Lead Database → Personalized Pitch → WAHA WhatsApp Delivery.

How It Works

1. Scrape — Use browser tool to search Google Maps for businesses by sector + location
Extract — Pull name, phone, rating, reviews, website, Instagram from each listing
Store — Save leads as JSON in organized directory structure
Pitch — Generate personalized messages based on business profile (rating, website presence, pain points)
Send — Deliver via WAHA WhatsApp API with configurable delays between messages
Protect — Add all outreach numbers to bot ignore list (prevents auto-reply conflicts)

Prerequisites

- WAHA running (WhatsApp HTTP API) — Docker container with active WhatsApp session
Browser tool — For Google Maps scraping
WhatsApp Business number connected to WAHA

Quick Start

1. Search for Leads

Use the browser tool to navigate to Google Maps:

CODEBLOCK0

Examples:
CODEBLOCK1

Click each listing to extract: name, phone, rating, reviews, website, Instagram, hours.

2. Store Leads

Save as JSON:

CODEBLOCK2

Directory structure:
CODEBLOCK3

3. Craft Pitch Messages

Personalize based on business profile. See references/pitch-templates.md for sector-specific templates.

Key personalization signals:

- No website → "online presence" angle
Low rating → "customer satisfaction improvement" angle
High reviews → "you're already popular, scale it" angle
Has Instagram but no website → "convert followers to customers" angle

4. Send via WAHA

CODEBLOCK4

Sending rules:

- Minimum 2 minutes between messages (avoid WhatsApp spam detection)
Maximum 15-20 messages per batch
Send during business hours (09:00-18:00 local time)
Never send the same template to the same number twice

5. Protect Against Bot Auto-Reply

If you have a WhatsApp bot (like a customer service bot), add all outreach numbers to an ignore list so the bot doesn't reply with irrelevant messages.

File-based ignore list (recommended):

Create data/outreach_ignore_lids.txt:
CODEBLOCK5

Webhook filter in your bot:

CODEBLOCK6

Important: WAHA uses @lid format internally which differs from phone numbers. Always add BOTH the lid ID and the phone number to your ignore list.

Batch Send Script

For automated batch sending, use scripts/batch_send.sh:

CODEBLOCK7

Sector-Specific Angles

See references/pitch-templates.md for full templates. Quick reference:

Sector	Pain Point	Our Solution
Salon/Kuaför	Missed calls during service	WhatsApp auto-appointment
Veteriner

Security

- No credentials in skill files — WAHA key passed as parameter or environment variable
No direct config access — Uses OpenClaw CLI for any gateway operations
Rate limiting built-in — Configurable delays prevent WhatsApp spam flags
Ignore list is append-only — New outreach targets are added, never removed
Admin notifications — All outreach replies forwarded to admin (Telegram/SMS/etc)

Tips

- Start with 10-15 leads per batch, scale up after testing response rates
Personalized messages get 3-5x more replies than generic templates
Best days: Tuesday-Thursday. Best times: 10:00-12:00, 14:00-16:00
Follow up non-responders after 3-5 days with a shorter message
Track conversion: lead → reply → demo → customer

WhatsApp Lead Hunter

自动化潜在客户生成流程：谷歌地图 → 潜在客户数据库 → 个性化推介 → WAHA WhatsApp 发送。

工作原理

1. 抓取 — 使用浏览器工具按行业+地点在谷歌地图上搜索商家
提取 — 从每个列表中提取名称、电话、评分、评论、网站、Instagram
存储 — 将潜在客户以JSON格式保存在有序的目录结构中
推介 — 根据商家资料（评分、网站存在感、痛点）生成个性化消息
发送 — 通过WAHA WhatsApp API发送，消息间可配置延迟
保护 — 将所有外联号码添加到机器人忽略列表（防止自动回复冲突）

前提条件

- WAHA 运行中（WhatsApp HTTP API）— 具有活跃WhatsApp会话的Docker容器
浏览器工具 — 用于谷歌地图抓取
WhatsApp Business号码 连接到WAHA

快速开始

1. 搜索潜在客户

使用浏览器工具导航到谷歌地图：

https://www.google.com/maps/search/{行业}+{地点}

示例：

https://www.google.com/maps/search/veteriner+uşak
https://www.google.com/maps/search/kuaför+simav+kütahya
https://www.google.com/maps/search/diş+kliniği+istanbul
https://www.google.com/maps/search/auto+repair+london

点击每个列表以提取：名称、电话、评分、评论、网站、Instagram、营业时间。

2. 存储潜在客户

保存为JSON：

json
[
{
name: 商家名称,
phone: 905551234567,
rating: 4.8,
reviews: 120,
website: example.com,
instagram: instagram.com/handle,
hours: 营业中 · 晚上8点关门,
notes: 关键观察
}
]

目录结构：

leads/
├── {城市}/
│ ├── {行业}.json
│ ├── veteriner.json
│ ├── dis_klinigi.json
│ └── kuafor.json

3. 撰写推介消息

根据商家资料个性化定制。参见 references/pitch-templates.md 获取行业特定模板。

关键个性化信号：

- 无网站 → 在线存在感角度
低评分 → 客户满意度提升角度
高评论数 → 你已经很受欢迎，扩大规模角度
有Instagram但无网站 → 将粉丝转化为客户角度

4. 通过WAHA发送

bash
curl -X POST http://localhost:3000/api/sendText \
-H X-Api-Key: YOURWAHAKEY \
-H Content-Type: application/json \
-d {
session: default,
chatId: 905551234567@c.us,
text: 您的个性化消息在此
}

发送规则：

- 消息间至少间隔2分钟（避免WhatsApp垃圾邮件检测）
每批次最多15-20条消息
在营业时间内发送（当地时间09:00-18:00）
切勿向同一号码发送两次相同模板

5. 防止机器人自动回复

如果您有WhatsApp机器人（如客服机器人），请将所有外联号码添加到忽略列表，以免机器人回复不相关的消息。

基于文件的忽略列表（推荐）：

创建 data/outreachignorelids.txt：

外联目标 - 机器人不会自动回复

同时添加@lid ID和电话号码

905551234567 127517595824360

机器人中的Webhook过滤器：

python

在您的WhatsApp webhook处理器中，在处理之前：

ignorefile = data/outreachignore_lids.txt
if os.path.exists(ignore_file):
with open(ignore_file) as f:
ignore_ids = {line.strip() for line in f if line.strip() and not line.startswith(#)}
cleanid = fromid.replace(@lid,).replace(@c.us,)
if cleanid in ignoreids:
# 不自动回复，但通知管理员
notifyadmin(f来自 {fromid} 的外联回复: {message})
return

重要提示： WAHA内部使用@lid格式，与电话号码不同。请始终将lid ID和电话号码都添加到忽略列表中。

批量发送脚本

对于自动批量发送，使用 scripts/batch_send.sh：

bash
scripts/batch_send.sh \
--leads leads/usak/veteriner.json \
--template references/pitch-templates.md \
--sector veteriner \
--waha-url http://localhost:3000 \
--waha-key YOUR_KEY \
--delay 120 \
--ignore-file data/outreachignorelids.txt

行业特定角度

参见 references/pitch-templates.md 获取完整模板。快速参考：

行业	痛点	我们的解决方案
沙龙/美发店	服务期间错过电话	WhatsApp自动预约
兽医

安全性

- 技能文件中无凭据 — WAHA密钥作为参数或环境变量传递
无直接配置访问 — 使用OpenClaw CLI进行任何网关操作
内置速率限制 — 可配置延迟防止WhatsApp垃圾邮件标记
忽略列表仅追加 — 添加新的外联目标，从不删除
管理员通知 — 所有外联回复转发给管理员（Telegram/SMS等）

提示

- 每批次从10-15个潜在客户开始，测试回复率后扩大规模
个性化消息的回复率比通用模板高3-5倍
最佳日期：周二至周四。最佳时间：10:00-12:00，14:00-16:00
3-5天后用更短的消息跟进未回复者
跟踪转化：潜在客户 → 回复 → 演示 → 客户

whatsapp-lead-hunterWhatsApp线索猎手