MapapropChatAI - Configuration Guide


Summary

Activating MapapropChatAI on your website requires 3 main steps:

  1. βœ… Have the Mapaprop Business or Business Manager plan
  2. βœ… Activate your API Token
  3. βœ… Activate Chat AI in your website console

Once activated, you can customize the chat and start receiving prospects.


Step 1: Subscribe to Mapaprop Business

MapapropChatAI is available in the Mapaprop Business and Business Manager plans.

How to subscribe?

  1. Enter My Account
  2. Go to Subscription
  3. Select the Business plan
  4. Complete the payment process

What does Business include?

  • MapapropChatAI (AI chat)
  • API Token (programmatic access)
  • AI description generator
  • Higher amount of monthly tokens

πŸ“Œ See more: Mapaprop Business


Step 2: Activate API Token

The API Token enables the artificial intelligence services, including MapapropChatAI.

How to activate?

  1. Enter Menu > Settings
  2. Go to API Token
  3. Click Activate Token
  4. Copy and save your token in a safe place

Why is it necessary?

The token connects your account with Mapaprop's AI services. Without an active token, the chat cannot work.

πŸ“Œ See more: API Token


Step 3: Activate Chat AI on your Website

Now that you have Business and the active token, you can activate the chat on your site.

How to activate?

  1. Enter Website from the main menu
  2. Select your website
  3. Enter the Website Console
  4. Look for the Mapaprop Chat AI section
  5. Turn on the Enable Chat AI switch

What happens when I activate?

The chat widget will appear automatically on your website. Visitors will be able to interact with the virtual assistant immediately.

πŸ“Œ See more: Mapaprop Chat AI for Website


Step 4: Configure the Chat (Optional)

You can customize how the chat presents itself to your visitors.

Available configurations

ConfigurationWhat it doesRecommendation
Assistant nameThe name the chat displaysUse a friendly name ("MarΓ­a", "Virtual Assistant")
Welcome messageFirst message the visitor seesPersonalize it with the name of your real estate agency
Tokens per responseLength of the responsesLeave the default value (2000)
Tokens per conversationTotal limit per sessionLeave the default value (30000)

How to configure?

  1. From the Website Console
  2. Mapaprop Chat AI section
  3. Edit the fields you want to customize
  4. Save the changes

Tip: If you don't know what to put, leave the default values. They work well for most real estate agencies.

Customize logo and colors

The chat automatically uses the logo and colors configured on your website. To customize them:

  1. Enter Website from the main menu
  2. Select your website
  3. Go to Design
  4. Configure your logo and color palette (primary and secondary)
  5. Save the changes

The chat will show your logo in the header and use your brand colors in buttons and interactive elements.

πŸ“Œ See more: Edit website design (colors, images)


Step 5: Read the Chats in the Inbox


The messages and inquiries from your visitors arrive in the Messages Inbox.

How to access?

  1. Enter Inbox from the main menu
  2. You will see all the messages received
  3. Each message includes:
    • Contact details (name, email, phone)
    • Message content
    • Date and time
    • Reference to the property (if applicable)

What to do with the messages?

  • Review the inbox periodically (we recommend 2-3 times per day)
  • Respond to the contacts you are interested in
  • Prioritize according to the contact's activity (favorites, searches)

πŸ“Œ See more: Messages / Leads Inbox


Step 6: View the Complete Contact Profile

To thoroughly understand what each visitor is looking for, access their profile in Contacts.

How to access?

  1. From the Inbox, click the contact's name
  2. Or enter Contacts from the main menu
  3. Search for the contact by name or email

What information does the profile have?

SectionWhat it shows
Contact detailsName, email, phone
Searches performedWhat filters they used (area, price, type)
Favorite propertiesThe ones they marked with ❀️
Consulted propertiesThe ones they asked questions about
Message historyAll the conversations

How to use this information?

This information allows you to:

  • Prioritize contacts: Someone with 5 favorites and 3 searches is "hotter" than someone without activity
  • Personalize the contact: "Hi Juan, I saw that you were interested in apartments in Palermo..."
  • Prepare proposals: You know exactly what to show them

πŸ“Œ See more: Contacts


Activation Checklist

Use this list to verify that everything is configured:

  • I have an active Mapaprop Business or Business Manager plan
  • My API Token is activated
  • Chat AI is enabled on my website
  • (Optional) I customized the assistant's name
  • (Optional) I customized the welcome message
  • I tested the chat by visiting my website
  • I know how to access the Inbox to see messages
  • I know how to access Contacts to see profiles

Common problems

The chat does not appear on my site

Check:

  1. Do you have an active Business plan?
  2. Is your API Token activated?
  3. Is the Chat AI enabled in the console?
  4. Did you clear the browser cache?

The chat says "service unavailable"

Possible causes:

  • Your Business plan expired
  • Your API Token was deactivated
  • The month's tokens ran out

Solution: Check the status of your subscription in My Account.

I don't receive messages in the Inbox

Check:

  • Did the visitor complete the registration (name, email, phone)?
  • Did the visitor send a message or just browse?

Note: Only contacts who complete the initial form are registered.


What happens to my Chat AI if I downgrade my plan or cancel?

If you change from Business to a lower plan (Pro+, Plus, or Free), or cancel your subscription, the Chat AI widget turns off automatically on your website. Visitors no longer see the chat button.

Your configuration is NOT lost:

  • βœ… Assistant name
  • βœ… Welcome message
  • βœ… Custom instructions (prompt)
  • βœ… Configured token limits

All that data remains saved. If later you subscribe to Mapaprop Business again, the widget is reactivated with the same configuration, without you having to reconfigure anything.

The Inbox historical messages are also preserved β€” all the conversations and leads the chat generated remain accessible in your account.

πŸ“Œ This logic applies both to voluntary cancellation and to automatic cancellation due to non-payment.


Need help?

If you have problems configuring MapapropChatAI, write to us at soporte@mapaprop.com.


MapapropChatAI - Step-by-step configuration.


Feedback about the Mapaprop Chat AI system

Your feedback is important to us. You can send us your suggestions or error reports here

  • Feedback Mapaprop Chat AI

Activate and Manage Chat AI for Website

Activating and managing Chat AI for Website consists of a few simple steps:

  1. Subscribe to Mapaprop Business
  2. Activate API Token (this will give you access to the MapapropChatAi API Token)
  3. Activate Chat AI from the Website section > Website Console > Mapaprop Chat AI for Website
  4. Configure parameters, such as the Chat name and introduction text.
  5. Read the Chats from the Messages / Leads Inbox
  6. Access the Contact to learn in detail about their Searches, Questions, and Favorite Properties

πŸ’‘ Do you need help writing the agent's prompts and topics? Follow the guide How to configure your Chat AI agent (complete example), with a case ready to copy and adapt.