WhatsApp Messages Scraper

Overview

The WhatsApp Messages Scraper is an Apify actor that connects to your WhatsApp account and listens to incoming messages from private chats and group conversations. Once connected via a QR code (displayed in the actor's log), it continuously captures and stores incoming messages in real time.

This actor is ideal for developers building automation tools, service marketplaces, sentiment analysis pipelines, or real-time communication systems.

How It Works

1. When you run the actor, a QR code is displayed in the LOG tab — you must open the LOG tab to see and scan the QR code using your WhatsApp mobile app.
2. You scan the QR code using your WhatsApp mobile app.
3. Once authenticated, the actor connects to your WhatsApp account.
4. It starts listening to messages from group chats and private conversations.
5. All messages are captured and stored in the default Apify dataset for further processing.
6. To stop the actor, simply log out of the connected WhatsApp session from your phone (via WhatsApp → Linked devices → Log out).

Features

✅ Real-time message scraping from WhatsApp chats and groups

✅ Simple QR code authentication (no password or phone number needed)

✅ Outputs structured message data (sender, chat type, timestamp, content)

✅ Perfect for real-time analytics, service platforms, or data collection

✅ Compatible with both group and individual chats

Getting Started

1. Input Parameters

This actor does not require any input parameters to start. Just run the actor and follow the on-screen instructions.

Parameter	Type	Required	Description
(none)	—	—	No configuration needed to begin.

2. Running the Actor

You can run the actor directly on Apify or via API:

Using Apify Interface

1. Navigate to the actor's page on Apify.
2. Click Run to start the actor.
3. Watch the Log section for the QR code.
4. Open WhatsApp on your mobile device, tap the menu → Linked devices, and scan the QR code.
5. The actor will connect and begin capturing messages.

Using Apify API

1curl -X POST -H "Content-Type: application/json" \
2     "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs?token=YOUR_API_TOKEN"

Then open the Apify log in the browser and scan the QR code as described above.

Output Format

The output is a structured JSON dataset of WhatsApp messages:

1[
2    {
3        "messageText": "Hello World!",
4        "senderNumber": "4433556546677",
5        "senderName": "John Doe",
6        "timestamp": 1744832304,
7        "isGroupMessage": true,
8        "isPrivateMessage": false,
9        "groupName": "Test",
10        "groupId": "120363412896248312",
11        "chatId": "120363412896248312",
12        "rawMessageId": "E5C0669D75C493BD8D76DD56097EBF36",
13        "deviceType": "android",
14        "fromMe": false,
15        "isForwarded": false,
16        "hasMedia": false,
17        "isStarred": false,
18        "mentionedNumbers": [],
19        "isStatus": false,
20        "links": []
21    }
22]

Use Cases

• Real-time Service Marketplaces – Capture and respond to service requests in WhatsApp groups.
• Customer Support Automation – Log and analyze customer messages for automated handling.
• Lead Generation – Scrape group conversations to identify leads or opportunities.
• Data Collection for NLP – Collect structured text data for training chatbots or AI models.
• Market & Sentiment Analysis – Monitor real-time discussions for trends or signals.

Support & Contributions

If you encounter any issues or have feature suggestions, feel free to open an issue or fork and contribute. Let’s build better bots together! 🤖

---

Let me know if you want to include sections like FAQs or advanced configuration later!