Overview
The CT IDX Pro+ integration brings real-time MLS listing search to your AI agent. Website visitors can describe what they're looking for in natural language, and your AI Agent will search available properties and present matching listings.
This is perfect for real estate agents and brokerages using CT IDX Pro+ who want to provide an interactive property search experience directly through chat.
This integration requires an active CT IDX Pro+ license. It will not work with other IDX providers.
Prerequisites
Before setting up the CT IDX Pro+ integration, you'll need:
- An active CT IDX Pro+ license
- Your CT IDX Pro+ License Key
- Your CT IDX Pro+ API Key
- Your numerical MLS ID(s). Open the Help Center and start a conversation with “Live agent”. We will provide the MLS ID you need for setup.
- Your website URL (for license verification)
Setup Instructions
Step 1: Gather Your Credentials
- Log in to your CT IDX Pro+ account
- Navigate to your account settings or API section
- Locate your License Key and API Key
- For MLS ID(s), open the Help Center and start a conversation with “Live agent”. We will provide your numerical MLS ID(s) for this field. Separate multiple IDs with commas.
ChatSpark verifies your CT IDX Pro+ license before enabling the integration. The verification checks that your license is active and valid for your website.
Step 2: Enable in ChatSpark
- In ChatSpark, go to AI Actions
- Find CT IDX Pro+ in the Library and click Enable
- Select the AI Agent(s) that should have access
- Enter your License Key, API Key, the numerical MLS ID(s), and Website URL
- Click Test in Sandbox & Save
ChatSpark will verify your license with CT IDX Pro+. This verification is cached for 12 hours to ensure fast response times.
Configuration Fields
| Field | Description | Example |
|---|
| License Key | Your CT IDX Pro+ license key | CTIDX-XXXXX-XXXXX |
| API Key | Your CT IDX Pro+ API key | xxxxx... |
| MLS ID(s) | Numerical MLS ID we provide when you open a conversation with “Live agent” in the Help Center. Use a comma between multiple values. | 12345 or 12345,67890 |
| Website URL | Your website URL (must match license) | https://yourrealestatesite.com |
Search Capabilities
Your AI agent can search properties using natural language queries. Supported search criteria include:
- Location: City, neighborhood, ZIP code, address
- Price range: Min/max price, “under $500k”
- Bedrooms: Number of beds, “at least 3 bedrooms”
- Bathrooms: Number of baths
- Property type: Single family, condo, townhouse, etc.
- Square footage: Min/max size
- Features: Pool, garage, waterfront, etc.
Example Queries
- “Show me 3-bedroom homes in San Diego under $800,000”
- “Find condos in La Jolla with ocean views and at least 2 baths”
- “What homes are available in Carlsbad with a pool?”
- “Search for properties between $600k and $900k in Encinitas”
Results Display
Search results are displayed as property cards showing:
- Property photo
- Price
- Address
- Beds/baths/square footage
- Link to full listing
Testing Your Integration
After setup, test the search:
- Open your AI Agent widget
- Ask: “Show me homes for sale in [your area]”
- The AI should return matching MLS listings
Try various search criteria to ensure the integration is working properly.
Troubleshooting
License verification failed
Common causes:
- Expired license: Renew your CT IDX Pro+ subscription
- Wrong website URL: Ensure the URL matches your license
- Invalid license key: Double-check the key from your account
- Revoked access: Contact CT IDX Pro+ support
No results returned
If searches return no results:
- Verify your MLS ID matches what we provided
- Check that the MLS has active listings in the searched area
- Try a broader search with fewer filters
API errors
If you see API errors, verify your API key is correct and your account is in good standing with CT IDX Pro+.
For CT IDX Pro+ product issues, contact their support. For ChatSpark integration issues, contact our support team.