Trestle

Overview

Trestle, now part of Cotality (formerly CoreLogic), brings one of the largest RESO-standard MLS data feeds in the country into ChatSpark. Visitors describe what they're looking for, your AI agent searches and responds in the same conversation. Connect your Client ID and Client Secret from the Cotality developer portal and you are live.

Prerequisites

Before setting up the Trestle integration, you'll need:

• An active Trestle account with approved API access
• Your Client ID from the Cotality developer portal
• Your Client Secret from the Cotality developer portal
• Your website URL
• Your listing URL path (the URL structure for listing detail pages on your site)
• Your Originating System Name, if your account has more than one MLS board connected

Trestle access requires MLS board approval. If you do not yet have API access, visit the Cotality developer portal to apply.

Setup Instructions

Step 1: Get Your Credentials

1. Log in to the Cotality developer portal
2. Navigate to your application or credentials section
3. Copy your Client ID and Client Secret

Step 2: Enable in ChatSpark

1. In ChatSpark, go to AI Actions
2. Find Trestle in the Library and click Enable
3. Select the AI Agent(s) that should have access
4. Enter your Client ID and Client Secret
5. If your account covers multiple MLS boards, enter your Originating System Name
6. Enter your Website URL and Listing URL Path
7. Click Test in Sandbox & Save

Configuration Fields

Search Capabilities

Visitors can search by any combination of the following:

• Location: City, state, ZIP code, street 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, and more
• Square footage: Min/max interior size
• Status: Active, Pending, Coming Soon

Example Queries

• “Show me 3-bedroom homes in Nashville under $500,000”
• “Find condos in Brentwood with at least 2 baths”
• “What homes are available in Franklin under $600k?”
• “Search for properties between $700k and $1M near Green Hills”

Each result displays as a property card with a photo, price, address, beds/baths/sqft, and a link to the full listing.

Testing Your Integration

Open your AI Agent widget and ask: “Show me homes for sale in [your area].” You should see matching listings returned. If no results appear, verify that your credentials are correct and that your MLS board has active listings accessible through Trestle.

Adding Ask AI Buttons to Listings

Add a button to any listing page and turn property views into conversations. When a visitor clicks, ChatSpark opens with that address pre-filled, your AI agent pulls the listing details from Trestle, and can capture their contact details as the conversation continues.

Add the cs-trigger-agent class and a data-triggerattribute to any HTML element on your listing pages:

<button class="cs-trigger-agent" data-trigger="Tell me about 456 Willow Way, Nashville, TN 37202">
  Ask AI
</button>

Use the full street address as it appears in your MLS data. See AI Agent Triggers for full setup options.

Multiple MLS Boards

Trestle is designed to aggregate data across multiple MLS boards under a single account. By default, a search will return listings from all boards your account has access to.

If you want to limit searches to one specific board, add the Originating System Name for that board in the AI Action configuration. You can find this value in the Cotality developer portal or by reviewing the data returned from your feed. It is typically a short identifier such as MRED or CARETS.

Troubleshooting

Invalid credentials

If the credential test fails:

• Wrong Client ID or Secret: Copy them again directly from the Cotality developer portal
• Extra whitespace: Make sure no spaces were added when copying
• Access not approved: Confirm your Trestle application has been approved by your MLS board
• Subscription inactive: Verify your Trestle subscription is still active in the developer portal

No results returned

If searches return no results:

• Check that your MLS board feeds data through Trestle in the areas you are searching
• Try a broader search with fewer filters
• Verify the city name is spelled correctly and matches MLS data

Results include listings from the wrong MLS board

If your Trestle account covers more than one board and results are pulling from the wrong one, add your Originating System Name to the AI Action configuration to scope all searches to the correct board.

Listing links are not working

Make sure both your Website URL and Listing URL Path are set in the AI Action configuration. The Listing URL Path must include the {mls_id} variable to generate valid links.

API errors during search

A 401 or 403 error means the credentials could not authenticate. Re-enter your Client ID and Client Secret in the AI Action configuration. A 400 error may indicate a search filter issue. Try simplifying your query.