X / Twitter Auto Messenger Actor

This Apify Actor automatically sends personalized direct messages (DMs) on X/Twitter. It reads a list of target usernames and messages from a Google Sheet and sends the DMs using the Playwright/Chromium browser.

Features

• Google Sheet Integration: Reads usernames and messages directly from a Google Sheet.
• Automated DM Sending: Uses a browser to navigate X and send messages simulating human behavior.
• Status Reporting: Automatically updates the Google Sheet with the status of each message (e.g., "Sent", "User not found", etc.).
• Authentication: Supports using raw cookie strings or specific auth_token/ct0 cookies for login.

How it works

1. The Actor reads the configured Google Sheet for rows containing a username (Column A) and a custom message (Column B).
2. It logs into X using the provided cookies.
3. For each username, it navigates to their profile and opens the DM window.
4. It types the personalized message and sends it.
5. It then writes back the status to the Google Sheet (Column C) using your Google Apps Script Web App URL and pushes the result to the Apify dataset.

Input Configuration

• Google Sheet URL: The URL of the Google Sheet containing usernames and messages.
• X.com Cookie String (or auth_token/ct0): Your authentication cookies to log into X.
• Messages Per Run: Maximum number of messages to send per execution (default: 20).
• Base Delay: Wait time between messages to avoid rate limits.
• Google Apps Script Web App URL: The URL of the deployed Apps Script that allows the Actor to write the status back to the sheet.

Output

The Actor stores its results in the default Apify Dataset. Each record includes:

• username: The target X username.
• message: The message that was sent.
• status: The result of the operation (e.g., "Sent" or an error message).
• imestamp: When the message was processed.