Home Services

To configure Industry Signals for Home Services, you will need to:


Configuring Sub-Industry

Home Services Industry Signals enables you to define a Sub-Industry, allowing for the identification of industry-specific value indicators within your conversations.

If no value is specified the 'Default' industry will be automatically assigned.

To configure this value, the GroupOwner can be passed the sub_industry field

{  
  "name": "ABC Electric",  
  "zip": "10183",  
  "sub_industry": "Home System Services",  
  "client_id": "2bf1465d-060c-42cd-9b14-c14ad661763e"  
}

Click here for a list of supported sub-industries


Enabling Industry Signals on Numbers

To configure your Tracking Numbers and Number Pools to use the Home Services Industry signals, you will need to enable the following features in the call record feature submitting the following fields in your create/update Number and Number Pool requests:

  • lead_outcome_enabled - Track qualified leads and booked appointments to measure sales funnel performance and assess interaction effectiveness with potential customers. Analyze conversation outcomes to understand why leads convert or fail, enabling targeted improvements.
  • lead_value_enabled - Evaluate the potential value of a lead, enabling your team to prioritize high-impact opportunities.
  • topics_enabled - Organize customer inquiries by themes to reveal leading indicators of common needs and recurring pattern.

POST https://edgeapi.marchex.io/marketingedge/v5/api/groups/{group_id}/numbers

{
    "name": "Home Services",
    "group_id": 15068550,
    "status": "Active",
    "phone_number_request": {
        "match_type": "TollFree"
    },
    "call_routes": {
        "route_type": "Basic",
        "route": {
            "termination_number": "9056372046",
            "features": {
                "call_record": {
                    "enabled": true,
                    "record": true,
                    "lead_outcome_enabled": true,
                    "lead_value_enabled": true,
                    "topics_enabled": true
                }
            }
        }
    }
}

Reporting Details

When Industry signals have been enabled, you will be able to review the Industry Signal results in the conversation_analytics portion of the call details (lead_outcome, lead_value, topics).

GET https://edgeapi.marchex.io/marketingedge/v5/api/calls

{
    "id": 2429343567,
    "call_type_id": 1,
    "call_type": "Standard",
    "number_id": 13168801,
    "group_id": 15035414,
    "group_name": "Home Services",
    "time_zone_id": 2,
    "time_zone_name": "Eastern",
    "group_owner_id": 7077404,
    "study_name": "water heater repair",
    "group_owner_name": "HomeSystemServices",
    "billing_group_id": 14860,
    "billing_group_name": "Group1",
    "caller_identity": 441811483,
    "organization_id": 4483,
    "answer_status_id": 1,
    "answer_status": "answered",
    "ring_duration": 2,
    "call_duration": 39,
    "registered_DNC": false,
    "tracking_number": "8338539911",
    "caller_number": "2347485834",
    "termination_number": "3433384491",
    "conversation_analytics": {
        "call_record_file": "44c78361-be77-4d06-94ea-705bc23b29ce",
        "call_record_redaction": false,
        "voice_link": "https://stgwebservice.telmetrics.com/filedownload.ashx/35F3B648-D7C4-43B0-8DE9-9E82978B95D1/2429343567.mp3",
        "call_summary": "",
        "industry": "Home Services",
        "sub_industry": "Home System Services",
        "lead_outcome": {
            "lead_reason": "Other",
            "lead": "n/a",
            "appointment": "n/a"
        },
        "lead_value": {
            "customer_type": "new",
            "age_over_10_years": "n/a",
            "maintenance_or_new_system": "n/a",
            "product_or_service": [
                "bathroom or kitchen remodel plumbing"
            ],
            "service_line": "plumbing"
        },
        "topics": {
            "pricing_discussed": "false",
            "scheduling_discussed": "true",
            "other_topics": []
        }
        
    },
    "start_time": "2025-01-29T18:15:05.000",
    "answer_time": "2025-01-29T18:15:13.000",
    "end_time": "2025-01-29T18:15:52.000",
    "start_time_utc": "2025-01-29T23:15:05.000Z",
    "answer_time_utc": "2025-01-29T23:15:13.000Z",
    "end_time_utc": "2025-01-29T23:15:52.000Z",
    "status": "complete"
}


Sub-Industries

The following Sub-Industries can be selected when setting up your GroupOwner. This selection helps Marchex Industry Signals focus on detecting the most relevant and valuable areas of conversation for the chosen Sub-Industry.

Sub-Industries
Home System Services
Interior
Exterior
Moving and Storage
Home Improvement
Specialty
Default


Lead Outcome

The following details related to lead outcome will be present in your request to retrieve call details:

Field DescriptionAPI fieldPossible Values
Lead - Was the call a leadleadtrue, false, n/a
Lead Reason - Why was the call considered a leadlead_reasonAppointment Booked
Appointment Not Available
Appointment Not Booked
Call Quality Issue
Price Issue
Appointment Cancelled
Appointment - Confirming
Appointment - Rescheduling
Call for or by Employee (non-Sales)
Customer Concern
Call for Human Resources or Employment Related
Not The Homeowner/Decision Maker
Remove From Mail Or Call List
Service Not Offered / Outside Service Area
Telemarketer/Vendor/Solicitor
Other
Billing/Account Question
n/a
Appointment - Was an appointment bookedappointmenttrue, false, n/a


Lead Value

This set of fields contains indicators of value found in a conversation:

Field DescriptionAPI FieldPossible Values
Customer Type - new or existing customercustomer_typenew, existing, n/a
Product or Service - product or services discussed during callproduct_or_servicedependent upon the Sub-Industry defined for the GroupOwner and service line detected See possible values below
Other Product or Service - generative list of products or services discussed during the callother_product_or_servicegenerative list of results detected during the conversation
Service Line - type of service detected for the conversationservice_lineelectrical
plumbing
hvac
Maintenance or New System - call is regarding maintenance or new systemmaintenance_or_new_systemtrue, false, n/a
Age Over 10 Years - is the conversation regarding something related to home services that is older than 10 years of ageage_over_10_yearstrue, false, n/a

Topics

This set of fields contains details related to the topics discussed during the conversation:

Pricing Discussed - was pricing discussed during the conversationpricing_discussedtrue, false, n/a
Scheduling Discussed - was scheduling discussed during the conversationscheduling_discussedtrue, false, n/a


Product Or Service

The following values may be returned in the product_or_service field from the lead_value portion of the conversation_analytics section of API reporting response:

Sub-Industry Product Or Service
Sub-Industry: Home System ServicesService Line - Electrical

basic troubleshooting
electrical safety inspections
light fixture replacement
minor repairs (wiring, outlets, switches)
outlet and switch replacement/installation
single circuit breaker replacement
ceiling fan installation
circuit breaker replacement (multiple)
electrical panel inspections and tune-ups
indoor/outdoor lighting system installation
installing or upgrading dedicated circuits (e.g., for appliances)
backup battery system and solar power integration
electric vehicle (ev) charger installation
electrical panel upgrade
home generator installation
smart home automation system setup
whole-home rewiring
whole-house surge protection installation

Service Line - Plumbing

faucet repair/replacement
fixing minor leaks (e.g., under sinks)
garbage disposal repair/replacement
toilet repair
unclogging drains
installing or replacing sump pumps
pipe leak repair
shower or bathtub installation/replacement
toilet replacement
water filtration system installation
water heater repair
bathroom or kitchen remodel plumbing
main water line installation/replacement
re-piping a house
septic system installation or replacement
sewer line repair/replacement
tankless water heater installation
water heater replacement (standard tank)

Service Line - HVAC

air filter replacement
basic hvac system tune-ups and maintenance
capacitor and fan motor replacement
cleaning evaporator and condenser coils
minor duct sealing and repairs
thermostat replacement/installation
air duct cleaning
air purifier or humidifier installation
ductwork repair or minor installation
heat pump repairs
mini-split a/c system installation (for individual rooms)
repairing furnace or a/c blower motor
thermostat upgrade (programmable/smart thermostats)
central air conditioning replacement
full ductwork installation (for new construction or replacement)
full hvac system installation (heating and cooling)
furnace replacement (gas or electric)
geothermal heating/cooling system installation
heat pump installation or replacement
whole-home energy efficiency upgrades (hvac focus)
zoning system installation for hvac
Sub-Industry:Garage Doorgarage door opener remote or keypad
garage door safety sensors
lubricants and minor hardware
small parts like rollers, hinges, screws
garage door cables and hardware
garage door tracks and brackets
rollers and brackets (nylon or steel)
single garage door panel (wood, steel, aluminum)
torsion or extension springs
3+ garage doors
complete garage door system (panels, tracks, springs)
crash door (vehicle has crashed into door)
custom garage door materials (wood, glass, specialty metals)
door stuck (open or closed)
heavy-duty garage door motor, stronger drive system
hung door
insulated door panels, weather stripping
new door install
smart garage door opener with wi-fi integration
Sub-Industry:Funeral Servicesat-need
pre-need
Sub-Industry:Moving And Storagemoving
packing
unpacking
storage
trucking
furniture rental and leasing
Sub-Industry:Interiorappliance repair
blinds
cabinets
carpentry
cleaning
countertops
flooring
carpet
painting
security systems
Sub-Industry:Exteriorconcrete
construction materials and supplies
construction services
doors
foundation repair
garage doors
gutters
hardscape
landscaping
lawn care
painting
roofing
siding
sprinklers
swimming pools
tree services
windows
Sub-Industry:Specialtya/v
dog walking
fire/water restoration
junk removal
locksmith
pet waste management
pest control
cleaning services
swimming pool maintenance
pet grooming
Sub-Industry:Home Improvementgeneral maintenance or repair (handyman)
kitchen remodeling
bathroom remodeling
basement finishing