rtrvr.ai
Browser ExtensionStart in Chrome, on the page you're on.CloudA thousand browsers, on your schedule.RoverThe AI customer engineer for your product.Data & EvalsExpert trajectories for AI labs.
ACCESSAPI + MCPCLI & SDKTemplatesIntegrationsWhatsApp
Use cases
Vibe ScrapingLead EnrichmentWeb MonitoringForm FillingJob ApplicationsSocial MediaAI Web ContextAgentic CheckoutAll use cases
Pricing
BlogLaunches, benchmarks, deep divesDocsExtension, Cloud, API, MCP, CLICase StudiesReal teams, real runsVideosNew runs every weekChangelogWhat just shippedNewslettersProduct releases and real runs
Docs
Log inBook DemoAdd to Chrome
Log in
Menu
Add to ChromeBook a demo
ProductsBrowser ExtensionCloudRoverData & EvalsExploreUse casesPricingResourcesDocs

Opening template…

rtrvr.ai

Make every site
work for you.

Launches first, roadmap early, and the occasional trick we only share by email.

Products

Browser ExtensionCloudRoverData & Evals

Use cases

Vibe ScrapingLead EnrichmentForm FillingWeb MonitoringSocial MediaJob ApplicationsData MigrationAI Web ContextAgentic Checkout

Resources

DocsBlogData for AI LabsCase StudiesVideosNewslettersChangelogPricingAppSumoDemoAffiliate

Company

TeamContactGCP PartnerWhat We BelieveSecurityPrivacyTerms

Developers

APIMCPCLI & SDKTemplatesIntegrationsWhatsApp

Compare

ApifyBardeenBrowserbaseBrowser UseClayClaudeCometFirecrawl
Products
Browser ExtensionCloudRoverData & Evals
Use cases
Vibe ScrapingLead EnrichmentForm FillingWeb MonitoringSocial MediaJob ApplicationsData MigrationAI Web ContextAgentic Checkout
Resources
DocsBlogData for AI LabsCase StudiesVideosNewslettersChangelogPricingAppSumoDemoAffiliate
Company
TeamContactGCP PartnerWhat We BelieveSecurityPrivacyTerms
Developers
APIMCPCLI & SDKTemplatesIntegrationsWhatsApp
Compare
ApifyBardeenBrowserbaseBrowser UseClayClaudeCometFirecrawl
BACKED BYNVIDIA InceptionGoogle Cloud for StartupsBright DataNEC XSalesforce LaunchpadElevenLabs GrantsGMI CloudComposioSmallest.ai Grants
DISCOVERYllms.txtllms-full.txtagents.mdDocumentation indexSitemapOpenAPIAI Catalog
© 2026 rtrvr.ai
DiscordYouTubeInstagramTikTokLinkedInXGitHub
support@rtrvr.ai
Back to templates

RUN FROM A SPREADSHEET TEMPLATE

Send X messages from a spreadsheet

Use a Google Sheet to send a tailored X message to each account.

RUNS INYour signed-in browser
SETUPOne target or a Google Sheet
WHAT YOU GET03 PARTS
  1. 01One message per Sheet row
  2. 02Account context used
  3. 03Send status for each row
EXAMPLE INPUTDM 25 founders about partnership

SET UP YOUR RUN

Add the details. Check the result. Run it.

No code needed.
01

Choose your starting list

Run once for one target, or repeat it for every row in a Google Sheet.

Google Sheet

Choose the Sheet with one target per row.

EXPECTED COLUMNSprofile_url, name (optional), message_text (optional), context (optional)

No sheet selected. Choose one from Google Drive.

Sign in to choose a Sheet

Your run stays disabled until the Sheet is connected.

02

Tell rtrvr what to use

Required details are marked. The example text shows the expected format.

Used when the message_text cell is empty. rtrvr drafts from the row and profile.

03

Choose where it runs

Cloud uses a fresh managed browser. The extension uses the sites you are already signed into.

Your browser is required. This template needs a site where you are signed in.

Choose a browser

Pick a browser where the rtrvr extension is online.

Get the extension
Finish setup in your browser
  1. Install the extension
  2. Sign in to rtrvr
  3. Come back and choose the browser
ONE MORE STEP

Add the required details to continue.

WHAT HAPPENS NEXT

From setup to finished result.

  1. 01

    rtrvr opens the right sites. It uses Cloud or the signed-in browser you chose.

  2. 02

    The browser does the job. You can follow the run and step in if a site asks for help.

  3. 03

    You get the result. The output above is the shape to expect.

ADVANCEDRequest JSONOptional

Exact request sent to the run panel.

REQUEST.JSON
{
  "source": "retrieve",
  "template": {
    "id": "bulk_x_dm",
    "slug": "bulk-x-dm",
    "name": "Bulk X/Twitter DM Sender",
    "categoryId": "SOCIAL_SCALE"
  },
  "inputs": {
    "sheetUrl": "",
    "messageGoal": "networking",
    "messageTemplate": "",
    "__inputSource": "sheet"
  },
  "agentHint": "You are sending bulk X/Twitter DMs. Adapt completely to the actual UI you encounter.\n\n**TASK CONFIGURATION:**\n- Sheet URL: \n- Message Goal: networking\n- Message Template: \n\n---\n\n## STEP 1: LOAD SHEET DATA\n\n1. Navigate to \n2. Read all rows\n3. **Expected columns:**\n   - profile_url (REQUIRED)\n   - name (optional)\n   - message_text (optional - overrides generation)\n   - context (optional)\n4. Count valid rows for progress tracking\n\n---\n\n## STEP 2: PROCESS EACH ROW\n\nFor each valid row:\n\n### A. NAVIGATE TO PROFILE\n1. Go to the X profile_url from this row\n2. Wait for profile to fully load\n3. **Check profile status:**\n   - Profile exists? If not, log and continue\n   - Protected account? Note for DM access\n   - Account suspended? Log and continue\n\n### B. CHECK DM AVAILABILITY - CRITICAL\n**X DMs are often closed. Check carefully:**\n1. Look for message/DM icon or option on profile\n2. **Possible states:**\n   - DMs open: Message button/icon visible and clickable\n   - DMs closed: No message option (very common)\n   - Following required: May need to follow first\n   - Protected: Requires follow approval first\n3. **If DMs not available:**\n   - Log \"DMs closed\" with username\n   - Continue to next profile immediately\n   - This is EXPECTED for many accounts\n\n### C. ANALYZE THEIR PROFILE (if DMs open)\n**Gather context:**\n- Display name and handle\n- Bio content\n- Recent tweets (themes, topics, tone)\n- Pinned tweet\n- Follower count\n\n### D. PREPARE MESSAGE\n\n**IF message_text column has content:**\nUse it exactly.\n\n**VALIDATION:**\n- X DMs have 10,000 char limit but shorter is better\n- Optimal: 2-4 sentences, under 500 chars\n- If over reasonable length: Consider truncating or warn\n\n**ELSE generate message:**\n- Goal: networking\n- Template: \"\"\n- Row context: [if provided]\n- Profile personalization required\n\n**X DM culture:**\n- Be DIRECT - X users value brevity\n- Reference their tweets/work specifically\n- One clear purpose per message\n- Don't be formal/corporate\n- Get to the point in first sentence\n\n### E. SEND MESSAGE\n1. Access DM composer\n2. Enter message\n3. Send\n4. Verify message appears in conversation\n5. Log result\n\n### F. RATE LIMITING\n- Wait 30-60 seconds between DMs\n- X has rate limits on DM sends\n- **If rate limited:** Pause, report progress, wait or stop\n\n---\n\n## STEP 3: GENERATE COMPLETION REPORT\n\n```json\n{\n  \"totalRows\": <number>,\n  \"processed\": <number>,\n  \"sent\": <number>,\n  \"dmsClosed\": <number>,\n  \"protectedAccounts\": <number>,\n  \"failed\": <number>,\n  \"results\": [\n    {\n      \"rowIndex\": <number>,\n      \"profileUrl\": \"\",\n      \"username\": \"\",\n      \"dmsOpen\": true|false,\n      \"isProtected\": false,\n      \"messageSource\": \"sheet|generated\",\n      \"messagePreview\": \"\",\n      \"characterCount\": <number>,\n      \"status\": \"sent|dms_closed|protected|not_found|failed\",\n      \"error\": \"\"\n    }\n  ]\n}\n```\n\n---\n\n## IMPORTANT: EXPECT HIGH SKIP RATE\n\n**Many X accounts have DMs closed.**\n- This is normal, not an error\n- Skip rate of 50%+ is common\n- Track dmsClosed count for user\n- Don't treat closed DMs as failures",
  "userInput": "You are sending bulk X/Twitter DMs. Adapt completely to the actual UI you encounter.\n\n**TASK CONFIGURATION:**\n- Sheet URL: \n- Message Goal: networking\n- Message Template: \n\n---\n\n## STEP 1: LOAD SHEET DATA\n\n1. Navigate to \n2. Read all rows\n3. **Expected columns:**\n   - profile_url (REQUIRED)\n   - name (optional)\n   - message_text (optional - overrides generation)\n   - context (optional)\n4. Count valid rows for progress tracking\n\n---\n\n## STEP 2: PROCESS EACH ROW\n\nFor each valid row:\n\n### A. NAVIGATE TO PROFILE\n1. Go to the X profile_url from this row\n2. Wait for profile to fully load\n3. **Check profile status:**\n   - Profile exists? If not, log and continue\n   - Protected account? Note for DM access\n   - Account suspended? Log and continue\n\n### B. CHECK DM AVAILABILITY - CRITICAL\n**X DMs are often closed. Check carefully:**\n1. Look for message/DM icon or option on profile\n2. **Possible states:**\n   - DMs open: Message button/icon visible and clickable\n   - DMs closed: No message option (very common)\n   - Following required: May need to follow first\n   - Protected: Requires follow approval first\n3. **If DMs not available:**\n   - Log \"DMs closed\" with username\n   - Continue to next profile immediately\n   - This is EXPECTED for many accounts\n\n### C. ANALYZE THEIR PROFILE (if DMs open)\n**Gather context:**\n- Display name and handle\n- Bio content\n- Recent tweets (themes, topics, tone)\n- Pinned tweet\n- Follower count\n\n### D. PREPARE MESSAGE\n\n**IF message_text column has content:**\nUse it exactly.\n\n**VALIDATION:**\n- X DMs have 10,000 char limit but shorter is better\n- Optimal: 2-4 sentences, under 500 chars\n- If over reasonable length: Consider truncating or warn\n\n**ELSE generate message:**\n- Goal: networking\n- Template: \"\"\n- Row context: [if provided]\n- Profile personalization required\n\n**X DM culture:**\n- Be DIRECT - X users value brevity\n- Reference their tweets/work specifically\n- One clear purpose per message\n- Don't be formal/corporate\n- Get to the point in first sentence\n\n### E. SEND MESSAGE\n1. Access DM composer\n2. Enter message\n3. Send\n4. Verify message appears in conversation\n5. Log result\n\n### F. RATE LIMITING\n- Wait 30-60 seconds between DMs\n- X has rate limits on DM sends\n- **If rate limited:** Pause, report progress, wait or stop\n\n---\n\n## STEP 3: GENERATE COMPLETION REPORT\n\n```json\n{\n  \"totalRows\": <number>,\n  \"processed\": <number>,\n  \"sent\": <number>,\n  \"dmsClosed\": <number>,\n  \"protectedAccounts\": <number>,\n  \"failed\": <number>,\n  \"results\": [\n    {\n      \"rowIndex\": <number>,\n      \"profileUrl\": \"\",\n      \"username\": \"\",\n      \"dmsOpen\": true|false,\n      \"isProtected\": false,\n      \"messageSource\": \"sheet|generated\",\n      \"messagePreview\": \"\",\n      \"characterCount\": <number>,\n      \"status\": \"sent|dms_closed|protected|not_found|failed\",\n      \"error\": \"\"\n    }\n  ]\n}\n```\n\n---\n\n## IMPORTANT: EXPECT HIGH SKIP RATE\n\n**Many X accounts have DMs closed.**\n- This is normal, not an error\n- Skip rate of 50%+ is common\n- Track dmsClosed count for user\n- Don't treat closed DMs as failures",
  "urls": [],
  "meta": {
    "createdAt": "",
    "userAgent": ""
  },
  "execution": {
    "mode": "device",
    "deviceIds": []
  }
}

MORE STARTING POINTS

Other templates for run from a spreadsheet.

See all templates
RUN FROM A SPREADSHEETSend LinkedIn messages from a spreadsheet

Use a Google Sheet to send a tailored LinkedIn message to each profile.

RUN FROM A SPREADSHEETSend Instagram messages from a spreadsheet

Use a Google Sheet to send a tailored Instagram message to each account.

RUN FROM A SPREADSHEETSend LinkedIn requests from a spreadsheet

Use a Google Sheet to send a LinkedIn request and note to each profile.