fieldcommerce.ai

Book local home service businesses (pest control, lawn care, exterior cleaning, plumbing, HVAC and more) that use FieldCommerce. No payment is taken through this connection: the customer confirms each booking from an emailed link. Flow: ask for the customer's ZIP code first, find_businesses with it, get_services, check_availability, then show the customer the price, the deposit (if any), the business's cancellation policy and, when requiresSignedAgreement is true, that the business will send an agreement to sign after booking. Book only after the customer explicitly approves. When a service has photoEstimate: true, the customer can instead get a free quote from photos or a video (book_service with mode 'photo_estimate', no day): give them the returned photoEstimate.uploadUrl to open on their phone. After book_service: 'confirmed' = booked. 'awaiting_business' = the deposit is held (not charged) until the business confirms by holdExpiresAt, so tell the customer the request is sent and they are only charged if the business confirms. 'pending_confirmation' = the customer was emailed a confirm link and the booking is made when they click it (it lapses after 24 hours), so tell them to check their email. 'estimate_requested' = a photo/video estimate request was sent; give the customer photoEstimate.uploadUrl and say the business will reply with a quote. 'processing' = paid, the job is still being created (check get_booking). 'failed' = nothing was booked; retry with a NEW idempotencyKey. Keep the returned bookingToken for get_booking, cancel_booking and answer_proposal. When get_booking shows proposal.status 'pending', tell the customer the business proposed another time and relay their answer with answer_proposal. Cancel or answer a proposal only when the customer asks. US only.