Realtor Listings Webhook Tool Guide

What is the Realtor Listings Tool?

The Realtor Listings webhook tool allows your conversational AI agents to access and discuss your property listings during phone or web conversations. When callers ask about available properties, your agent can instantly provide detailed information about listings, including addresses, prices, features, and more.

Use Cases:

• Real Estate Agents: Let your agent handle initial property inquiries while you focus on showings and closings
• Property Managers: Provide instant information about available rentals to prospective tenants
• Real Estate Brokerages: Enable all your agents’ AI assistants to access your entire listing portfolio
• Listing Services: Offer 24/7 property information to interested buyers and renters

Prerequisites

Before you can use the Realtor Listings tool, you need:

1. Listing Concierge Service: This service must be enabled for your account (contact support if needed)
2. At Least One Agent: You must have created at least one conversational AI agent in TriLuna
3. Property Listings: You need to have added real estate listings to the system

Step 1: Add Your Property Listings

Before enabling the tool for your agent, you need to add your property listings to the database.

Adding a New Listing:

1. Log into your TriLuna dashboard
2. Navigate to Realtor Listings from the main menu
3. Click ”+ Add Listing”
4. Fill in the required information:
   • Address: Full street address of the property
   • City, State, ZIP: Location details
   • Property Type: House, condo, townhouse, apartment, land, etc.
   • Bedrooms & Bathrooms: Number of each
   • Square Footage: Total living space
   • Listing Price: Current asking price
   • Status: Active, pending, or sold
   • Description: Detailed description of the property and features
   • MLS Number: (Optional) Multiple Listing Service number
5. Click “Save Listing”

Step 2: Enable the Tool for Your Agent

Once you have listings added, you can enable the Realtor Listings tool for your agent.

Enabling the Tool:

1. Navigate to My Agents from the main menu
2. Click on the agent you want to configure
3. Scroll down to the Webhook Integrations section
4. Find “Realtor Listings” in the list of available tools
5. Click the toggle switch or “Configure” button to enable it
6. Save your changes

Step 3: Test the Integration

After enabling the tool, test it to make sure everything is working correctly.

Testing with Web Conversation:

1. Navigate to your agent’s test page: My Agents > [Your Agent] > Test
2. Start a web conversation with your agent
3. Ask questions like:
   • “What listings do you have in Vancouver?”
   • “Show me two bedroom condos”
   • “Tell me about properties under $1.2 million”
   • “Do you have any houses for sale?”
4. Your agent should respond with information about your listings

Testing with Phone Call:

1. Call your agent’s phone number
2. Ask about available properties
3. Your agent will search and discuss listings in real-time

How Your Agent Uses the Tool

Natural Language Understanding:

Your agent understands natural language queries about properties. When a caller asks about listings, the agent:

1. Extracts Key Information: Identifies the city name mentioned in the query
2. Searches Listings: Finds all active listings in that city
3. Presents Results: Discusses properties with the caller, providing details like:
   • Address and location
   • Property type (house, condo, etc.)
   • Number of bedrooms and bathrooms
   • Square footage
   • Listing price
   • Key features and description highlights
4. Answers Follow-up Questions: Can provide more details about specific properties

Example Conversation:

Caller: “Hi, what properties do you have available in Vancouver?”

Agent: “I have one property available in Vancouver. It’s a 2-bedroom, 2-bathroom condo located at 205 5782 Berton Avenue. The property is 850 square feet and is listed at $1,088,000. Would you like to hear more details about this property?”

Caller: “Yes, tell me more about it.”

Agent: “This is a modern condo in a great Vancouver location. It features 2 bedrooms and 2 bathrooms with 850 square feet of living space. The listing is currently active. Would you like me to provide the MLS number or any other specific information?”

Managing Your Listings

Updating Listings:

1. Go to Realtor Listings
2. Find the listing you want to update
3. Click “Edit”
4. Make your changes
5. Click “Save”

Changes take effect immediately - your agent will have the updated information in the next conversation.

Changing Listing Status:

When a property sells or goes under contract:

1. Edit the listing
2. Change Status to “Pending” or “Sold”
3. Save the changes

Your agent will automatically stop mentioning sold or pending properties (unless specifically asked about past listings).

Removing Listings:

1. Go to Realtor Listings
2. Find the listing
3. Click “Delete” or set status to “Sold”
4. Confirm the action

Best Practices

Listing Descriptions:

• Be Detailed: Include key features, recent upgrades, neighborhood information
• Highlight Benefits: “Walking distance to schools” or “Recently renovated kitchen”
• Use Clear Language: Write descriptions as if explaining to a potential buyer
• Keep Updated: Remove sold properties and update prices promptly

Agent Instructions:

Consider adding instructions to your agent’s behavior to handle listings appropriately:

“When discussing property listings, always mention the price, number of bedrooms and bathrooms, and location. If someone seems interested, offer to connect them with me for a showing.”

Follow-up Process:

Train your agent to capture lead information:

“After discussing listings, ask if they’d like me to call them back to schedule a showing. Collect their name and phone number.”

Troubleshooting

Agent Says “No Listings Found”:

• Check Listing Status: Ensure listings are marked as “Active” in the database
• Verify City Name: The agent searches by city name - make sure the caller mentioned a city where you have listings
• Check Service Status: Confirm Listing Concierge service is enabled
• Test in Dashboard: Go to Realtor Listings and verify your properties are visible

”Tool Not Enabled” Error:

• Go to Agent Details > Webhook Integrations
• Verify the “Realtor Listings” toggle is turned ON
• Save the agent configuration
• Wait 1-2 minutes for changes to sync

”Service Not Enabled” Error:

• Contact TriLuna support to enable Listing Concierge service
• This is a service-level requirement and cannot be enabled by users

Agent Not Mentioning Specific Properties:

• Check Search Logic: Currently, the tool searches by city name only
• Ensure Correct City: Property must be in the city the caller mentions
• Review Listings: Verify the property is in your database and marked active

Privacy and Access

Who Can See Your Listings?

Property listings are accessible to any caller who talks to an agent with the Realtor Listings tool enabled, regardless of whether they’re authenticated or anonymous. This is intentional - you want potential buyers to be able to learn about your properties.

Data Storage:

• Listings are stored securely in your TriLuna database
• Only active listings are returned to callers by default
• Conversations about listings are logged for your review
• Webhook calls are tracked in the system for debugging and analytics

Technical Details

Webhook Endpoint:

POST /api/realtor-listings/webhook

Request Format:

{
  "conversation_id": "conv_...",
  "action": "search",
  "query": "Vancouver two bedroom condo",
  "filters": {}
}

Response Format:

{
  "success": true,
  "action": "search",
  "query": "Vancouver two bedroom condo",
  "detected_city": "Vancouver",
  "count": 1,
  "listings": [
    {
      "id": 5,
      "mls": "R2934567",
      "address": "205 5782 Berton Avenue",
      "city": "Vancouver",
      "type": "condo",
      "beds": 2,
      "baths": 2,
      "sqft": 850,
      "price": 1088000,
      "status": "active"
    }
  ]
}

Supported Actions:

• search: Search listings by natural language query (city-based)
• list_active: List all active listings with optional filters
• get_details: Get detailed information about a specific listing by ID

Need Help?

If you’re having trouble with the Realtor Listings tool or need assistance:

• Email our support team
• Use the chat widget on your dashboard
• Browse our other help articles
• Check webhook logs on your agent’s details page for diagnostic information