append_customer_note
ChatGPTAppend a new general note to an existing Fielmo customer without changing previous notes. First find the correct customer ID with search_customers; ask for clarification if several match. Show the note and customer to the user before calling. This does not write visit notes.
append_visit_note
ChatGPTAppend a note to a specific Fielmo visit while preserving previous visit notes. First identify the exact visit with list_jobs or get_customer_profile and show the visit and note to the user. This is separate from general customer notes.
check_appointment_availability
ChatGPTCheck Fielmo work hours, an existing customer's strict visit restrictions, and other visits for a proposed date and exact local time. Supply customer_id when known. Use before creating or rescheduling a visit. It detects fixed-time overlaps and saved-route overlaps; flexible visits and travel still require route review. A 07:00 request outside an 08:00 workday is unavailable, not silently moved to 08:00.
create_appointment
ChatGPTCreate a one-time visit for an existing customer. Always check_appointment_availability first. For an agreed hour, supply exact_start_time in the workspace timezone; never shift it to work hours without user approval. Outside-hours and fixed conflicts are rejected. If same_day_review_required, show the other visits and obtain explicit user approval before retrying with accept_same_day_visits=true. Date-only visits remain unconfirmed. Travel and flexible visits need route review.
create_customer
ChatGPTCreate a Fielmo customer and geocode the address. Show the details first and ask whether the user wants to confirm the map pin now or later. If confirmed after preview_customer_address, supply its confirmation_token. If skipped or the map tool is unavailable, omit the token; the coordinates are saved with the address pending confirmation in Fielmo, and you must remind the user to review it there. Never invent a date, price or frequency. A first visit with a date but no confirmed time remains unconfirmed. A possible_duplicate result means no customer was created.
find_customers_to_follow_up
ChatGPTFind customers in the authenticated user's Fielmo account who have not had a completed visit within a specified number of days. Use when the user asks who to follow up with or who has been inactive.
get_customer_notes
ChatGPTGet the notes for a specific customer in the authenticated user's Fielmo account, including profile notes and visit notes from past appointments. Use when the user asks what was written about a customer or what happened in past visits.
get_customer_profile
ChatGPTGet the full profile of a specific customer in the authenticated user's Fielmo account, including recent jobs, last visit date, and notes. Use after search_customers to get details about a specific customer.
get_route_for_day
ChatGPTGet the ordered list of jobs scheduled for a specific day for the authenticated user in Fielmo. Use when the user asks about their route, stops, or daily schedule.
get_weekly_summary
ChatGPTGet a summary of the authenticated user's week in Fielmo, including total jobs scheduled, completed, estimated revenue, and top customers. Use when the user asks how their week looks or about weekly income.
list_jobs
ChatGPTList appointments and jobs for a date or date range. Use this when the user asks about their schedule, jobs, visits, or route for a specific day or week.
preview_customer_address
ChatGPTGeocode a proposed US customer address and show its pin in an in-chat map when supported. Ask whether the user wants to confirm now or later. If confirmed, create_customer may use confirmation_token. If skipped, create_customer omits the token and leaves the address pending confirmation in Fielmo. If wrong, preview a corrected address. In clients without UI, show the Google Maps link.
preview_customer_lead
ChatGPTReview a prospective Fielmo customer extracted from a pasted WhatsApp lead. Pass only facts explicitly present in the lead, leaving unknown date, frequency, price and other values absent. This read-only preview shows missing required fields, possible existing customers and the proposed map pin. The user can edit the draft and choose to confirm the pin now or create with address confirmation pending. It never creates a customer by itself.
reschedule_appointment
ChatGPTMove an existing active visit. Read it first and check_appointment_availability for the new date and exact hour. Supply its current date as expected_service_date. Never silently move a requested hour to the workday start. If same_day_review_required, show other visits and obtain explicit user approval before retrying with accept_same_day_visits=true. Fixed conflicts and outside-hours are rejected; travel and flexible visits still need route review. Visits in saved routes must be changed in Fielmo.
search_customers
ChatGPTSearch for customers in the authenticated user's Fielmo account by name or notes text. Use this when the user asks about a specific customer or wants to find customers in a city.