book-appointment
ChatGPTBook a REAL appointment with a contractor found by get-available-contractors. This creates an actual job in the contractor's scheduling system, and shares the homeowner's name, phone number, email and service address with that contractor and with HOMH. Only call this tool after all of the following: 1. The user picked one specific arrival window (its slotRef) from get-available-contractors results. For a contractor marked requiresQuestions, get-booking-questions returned the slotRef of the time the user picked: the window it confirmed, or another of the contractor's times it listed. 2. You collected the homeowner's first and last name, email, phone number, the full street address of the home needing service, and a short description of the problem. 3. You showed the user a summary (contractor, dispatch fee, arrival window with its time zone, service address and contact details) together with the consent text below, word for word. 4. The user explicitly said yes. Never call this tool speculatively, and never retry it automatically after a failure: a retry can create a duplicate appointment. If it fails, tell the user what happened and follow the instructions in the error. Consent text to show the user, word for word, before booking: By confirming this booking, you agree to the HOMH Terms of Service (https://homh.com/legal/terms-of-use) and Privacy Policy (https://homh.com/legal/privacy-policy), and consent to receive booking confirmations and updates via SMS from Homh, and to be contacted by your selected service provider (including by call or SMS) regarding your booking.
cancel-booking
ChatGPTCancel an appointment booked with book-appointment. Only call this tool after the user explicitly confirmed they want to cancel that appointment. Requires the bookingId and bookingToken that book-appointment returned. If you don't have them from this conversation, don't ask the user for a token; point them to the manage-booking link in their confirmation email or SMS. Only appointments that are still pending can be canceled, and not once the technician has been dispatched.
get-available-contractors
ChatGPTSearch for HVAC, plumbing, or electrical companies that can service a residential problem. Requires a description of the homeowner's problem and the service location. Location requirements: - For same-day availability, a full street address is required because availability depends on travel time and routing. - For tomorrow or later, a ZIP code is sufficient and returns approximate availability. - A full address may always be provided and will produce more precise results. Use this tool when the user wants to find or book a company for a home HVAC, plumbing, or electrical issue.
get-booking-questions
ChatGPTAsk the questions a contractor needs answered before it can be booked, and check its true availability for the job. Only for a contractor that get-available-contractors marked requiresQuestions, with its schedulingRef. This tool never books anything. Call it first with just the schedulingRef. Each call returns one step (its status): - question: if the conversation already makes the answer clear (for example, the user described the problem), pick that option yourself and call again right away, without asking. Otherwise ask the user this question, as given, with its options, and wait for their answer; when more than one option could fit, ask. Then call this tool again with the same schedulingRef and answers: the option ids of every answer so far, in order, the new one last. - confirmed: the contractor confirmed the arrival window the user picked. It can be booked with book-appointment and the slotRef this returns, after the usual summary (which also lists the answers used, so the user can correct them) and consent. The contractor's other times, listed with it, can be booked the same way. - original-time-unavailable: the contractor doesn't have that window for this job. The other times listed can be booked the same way, each with its own slotRef, once the user picks one. - dead-end: the contractor can't book this job online. - unavailable: the questions or the availability couldn't be checked, right now or for that window. Follow the instructions that come with each step.
get-booking-status
ChatGPTGet the current status of an appointment booked with book-appointment: whether it's still scheduled, completed or canceled, its arrival window, and the technician's status once one is assigned. Requires the bookingId and bookingToken that book-appointment returned. If you don't have them from this conversation, don't ask the user for a token; point them to the manage-booking link in their confirmation email or SMS.
book-appointment
ClaudeBook a REAL appointment with a contractor found by get-available-contractors. This creates an actual job in the contractor's scheduling system, and shares the homeowner's name, phone number, email and service address with that contractor and with HOMH. Only call this tool after all of the following: 1. The user picked one specific arrival window (its slotRef) from get-available-contractors results. For a contractor marked requiresQuestions, get-booking-questions returned the slotRef of the time the user picked: the window it confirmed, or another of the contractor's times it listed. 2. You collected the homeowner's first and last name, email, phone number, the full street address of the home needing service, and a short description of the problem. 3. You showed the user a summary (contractor, dispatch fee, arrival window with its time zone, service address and contact details) together with the consent text below, word for word. 4. The user explicitly said yes. Never call this tool speculatively, and never retry it automatically after a failure: a retry can create a duplicate appointment. If it fails, tell the user what happened and follow the instructions in the error. Consent text to show the user, word for word, before booking: By confirming this booking, you agree to the HOMH Terms of Service (https://homh.com/legal/terms-of-use) and Privacy Policy (https://homh.com/legal/privacy-policy), and consent to receive booking confirmations and updates via SMS from Homh, and to be contacted by your selected service provider (including by call or SMS) regarding your booking.
cancel-booking
ClaudeCancel an appointment booked with book-appointment. Only call this tool after the user explicitly confirmed they want to cancel that appointment. Requires the bookingId and bookingToken that book-appointment returned. If you don't have them from this conversation, don't ask the user for a token; point them to the manage-booking link in their confirmation email or SMS. Only appointments that are still pending can be canceled, and not once the technician has been dispatched.
get-available-contractors
ClaudeSearch for HVAC, plumbing, or electrical companies that can service a residential problem. Requires a description of the homeowner's problem and the service location. Location requirements: - For same-day availability, a full street address is required because availability depends on travel time and routing. - For tomorrow or later, a ZIP code is sufficient and returns approximate availability. - A full address may always be provided and will produce more precise results. Use this tool when the user wants to find or book a company for a home HVAC, plumbing, or electrical issue.
get-booking-questions
ClaudeAsk the questions a contractor needs answered before it can be booked, and check its true availability for the job. Only for a contractor that get-available-contractors marked requiresQuestions, with its schedulingRef. This tool never books anything. Call it first with just the schedulingRef. Each call returns one step (its status): - question: if the conversation already makes the answer clear (for example, the user described the problem), pick that option yourself and call again right away, without asking. Otherwise ask the user this question, as given, with its options, and wait for their answer; when more than one option could fit, ask. Then call this tool again with the same schedulingRef and answers: the option ids of every answer so far, in order, the new one last. - confirmed: the contractor confirmed the arrival window the user picked. It can be booked with book-appointment and the slotRef this returns, after the usual summary (which also lists the answers used, so the user can correct them) and consent. The contractor's other times, listed with it, can be booked the same way. - original-time-unavailable: the contractor doesn't have that window for this job. The other times listed can be booked the same way, each with its own slotRef, once the user picks one. - dead-end: the contractor can't book this job online. - unavailable: the questions or the availability couldn't be checked, right now or for that window. Follow the instructions that come with each step.
get-booking-status
ClaudeGet the current status of an appointment booked with book-appointment: whether it's still scheduled, completed or canceled, its arrival window, and the technician's status once one is assigned. Requires the bookingId and bookingToken that book-appointment returned. If you don't have them from this conversation, don't ask the user for a token; point them to the manage-booking link in their confirmation email or SMS.