💬 ImmoScout24 Messenger Bot — Send & Read Messages via API

The only ImmoScout24 automation tool that lets you send follow-up messages into existing conversations. No more duplicate applications — reply directly in the chat thread the landlord already sees.

Apply once. Follow up as many times as you need. Perfect for the competitive German rental market where speed and persistence win apartments.

⚡ What It Does

Mode	Description
get_conversations	Retrieve all your ImmoScout24 messenger conversations with IDs, messages, and metadata
send_message	Send a message into an existing conversation by conversationId

The Problem This Solves

Other apply bots create a brand new chat every time they "follow up" — landlords see 3 separate applications from the same person. This bot sends your follow-up inside the original conversation, just like typing in the ImmoScout24 messenger yourself.

🚀 Quick Start

1. Read Your Conversations

{
  "mode": "get_conversations",
  "username": "your@email.com",
  "password": "your-password",
  "gmailUser": "your@gmail.com",
  "gmailAppPassword": "your-app-password"
}

Returns all conversations with conversationId, participant info, last message, and linked listing (scoutId).

2. Send a Follow-Up Message

{
  "mode": "send_message",
  "username": "your@email.com",
  "password": "your-password",
  "gmailUser": "your@gmail.com",
  "gmailAppPassword": "your-app-password",
  "conversationId": "415c89f2-0fa7-4631-a21b-4c633b539a50",
  "message": "Guten Tag, ich wollte mich nochmal bezüglich der Wohnung melden. Besteht die Möglichkeit, einen Besichtigungstermin zu vereinbaren?"
}

3. Filter by Listing (Scout ID)

{
  "mode": "get_conversations",
  "username": "your@email.com",
  "password": "your-password",
  "gmailUser": "your@gmail.com",
  "gmailAppPassword": "your-app-password",
  "scoutId": "157617645"
}

Returns only the conversation linked to that specific listing.

🔧 How to Set Up Gmail for 2FA

ImmoScout24 uses email-based two-factor authentication. The bot reads the verification code automatically from your Gmail inbox.

1. Go to myaccount.google.com/apppasswords
2. Create a new App Password (name it e.g. "ImmoScout Bot")
3. Copy the 16-character password
4. Enter it as gmailAppPassword in the Actor input

Note: Your regular Gmail password won't work — Google requires App Passwords for IMAP access.

🔄 Automation Example: Zapier Follow-Up Pipeline

Combine this bot with an apply bot and Zapier for a fully automated pipeline:

1. Scraper finds new listing → creates Deal in CRM
2. Apply Bot sends initial application
3. Messenger Bot fetches conversationId → saves to Deal
4. 2 days later → Messenger Bot sends Follow-Up #1
5. 4 days later → Messenger Bot sends Follow-Up #2
6. Landlord replies → email notification → Deal updated

Each follow-up lands in the same conversation — no duplicate applications, no spam.

🔒 Security & Privacy

• Your credentials are handled as Secret Inputs — encrypted and never logged
• Login sessions are temporary and not stored between runs
• The bot uses residential proxies for reliable access
• 2FA codes are read via IMAP and never stored

📊 Output Example

get_conversations

{
  "conversationId": "415c89f2-0fa7-4631-a21b-4c633b539a50",
  "participantName": "Hausverwaltung Müller GmbH",
  "lastMessage": "Vielen Dank für Ihre Anfrage...",
  "lastMessageDate": "2026-02-21T07:03:39.722Z",
  "exposeId": "157617645",
  "exposeTitle": "Schöne 2-Zimmer Wohnung in Eimsbüttel"
}

send_message

{
  "id": "7bd77ead-805f-44f3-b7c9-5f15e4fb6c1b",
  "conversationId": "415c89f2-0fa7-4631-a21b-4c633b539a50",
  "message": "Guten Tag, ich wollte mich nochmal bezüglich der Wohnung melden...",
  "creationDateTime": "2026-02-21T23:05:57.442Z",
  "messageType": "TEXT"
}

⚠️ Requirements

• An active ImmoScout24 account
• Gmail account with App Password (for 2FA handling)
• Apify Residential Proxy (Germany) — included with paid Apify plans

💬 Support

Have questions or feature requests? Reach out:

• 💬 Issues Tab on this Actor page
• ✉️ Typically respond within 24 hours

---

Built by sosamosa 🇩🇪