Updater Internet Store

Verifies a US street address and returns it standardized, with a verification status ("Valid", "Invalid", "Apartment Number Needed" or "Unknown") and a classification ("Residential", "Commercial", "Military" or "Unknown"). Plan availability is determined per household, so it needs the exact street address, including any unit number; a ZIP code alone is not enough. Calling it also starts loading plan availability for the address in the background, which takes about a minute. When to use: when the customer gives the address where they want TV or internet service. It is the first step before search_plans. If the address is already verified in this conversation, there is no need to call it again. After it returns: - Valid and Residential: a good moment to ask two or three short preference questions (budget, main internet use, whether they want TV bundled) before calling search_plans. - Commercial or Military: plans can still be searched, though some providers have different requirements at these locations. Our team can help with business or military service at (844) 882-3802. - Invalid or Apartment Number Needed: let the customer know and offer to correct the address. If they confirm it as given, search_plans can still be called with it. - Unknown classification: no need to mention it.

search_address

Opens the plan widget for a plan the customer has chosen. It shows the plan details and a form for the customer's name, email and phone. When the customer submits, the widget calls reserve_plan to create the reservation, and the same widget then shows the confirmation with the reservation number. When to use: once the customer has picked a plan from the search_plans results, either by clicking "Select this plan" in the widget or by naming it in chat. Each selection creates one reservation. If the widget state already shows a completed reservation (status "reservation_complete", flowComplete true, or a reservationNumber), or a [RESERVATION_COMPLETE] note appears in the conversation, the flow is finished: share that reservation number and the next steps rather than calling this tool again. Identifying the plan from chat: plan numbers count from 1, so "plan 2" or "the second one" is plans[1], and "the first one", "the best one" or "the recommended one" is plans[0]. The customer may also refer to a plan by provider, speed or price. If more than one plan matches, ask which they mean. Any returned plan can be selected, not only the two in the carousel. Inputs: - requestId: request.id from the search_plans result - address: request.address from the search_plans result - plan: the plan object from search_plans, passed as received, including fullDetails (the reservation needs it) - selectionSource: "widget" if the plan was chosen in the widget, "chat" if it was named in conversation. "chat" opens the full plan details alongside the form. The widget collects the contact details, so there is no need to ask for them in chat. If the form submission fails, the customer can call (844) 882-3802 to complete the reservation by phone. Mention the provider, plan name and price so they have them to hand.

select_plan

📋 WHAT THIS TOOL DOES: Creates the reservation for a selected plan from the customer's contact details. The select_plan widget calls this tool when the customer submits its form, so it isn't called from conversation; to start a reservation, use select_plan. What happens: - Receives customer information from widget form submission - Creates reservation with plan details and customer contact information - Returns reservationNumber and confirmationPhoneNumber - For plans with isBuyflowEligible=true: Also returns completionCheckoutLink (short URL) for online order completion 🎯 NEXT STEPS - Tell the customer: 1. If completionCheckoutLink exists (non-null): → PRIORITIZE the online link: "Complete your order online at: [short URL]" → The link is shortened and user-friendly to share → Also mention phone option as backup: "Or call [phone] with reservation #[number]" → Share the actual link URL so user can save/access it later 2. If completionCheckoutLink is null: → Tell customer to call confirmationPhoneNumber with reservation number 🚨 ERROR HANDLING - If reservation creation fails: 1. Explain: "I'm having trouble creating your reservation right now." 2. Provide fallback: "You can call (844) 882-3802 to complete your reservation over the phone." 3. Provide plan details (provider, plan name, price) so they can reference when calling 📞 CANCELLATIONS AND CHANGES - This reservation is sold and fulfilled by our team, so our support team handles any cancellation or change to it. → Always give the customer our support number for this: (844) 882-3802 → Say: "We handle your reservation, so to cancel or change it, please call our support team." Note: This tool is invoked by the widget, not by the AI directly.

reserve_plan

Searches the TV and internet plans available at a service address and returns up to 15 plans ranked for the customer's preferences, plus which providers do and don't serve the address. The results render in a carousel widget that shows the top 2 plans (inCarousel: true); every returned plan can be discussed and selected. Inputs: - address: the address returned by search_address. - preferences (optional): - productType ("internet", "internet-tv", "internet-phone", "internet-tv-phone"): only plans of that type are returned. If none exist at the address, internet-only plans are returned instead. - maxPrice, minDownloadSpeed, minUploadSpeed, preferConnectionType, maxContractMonths: plans that match rank higher. Plans outside them are not removed, so results can include plans above budget or below the requested speed. - excludeProviders: plans from these providers move to the end of the list rather than being removed. Useful when the customer prefers one provider. Typical values: streaming → minDownloadSpeed 50; gaming or working from home → 100; basic browsing → 25; month-to-month → maxContractMonths 0. When to use: after search_address, once you know what matters to the customer. Two or three short questions (budget, main internet use, whether they want TV bundled) give better-ranked results, and give the background availability lookup started by search_address time to finish. If the customer would rather skip questions, call it without preferences. When the customer wants different options (cheaper, faster, a different bundle), call it again with updated preferences; earlier results are not re-ranked on their own. Results: - plans: most relevant first. planPosition is 1-based, so "plan 2" or "the second one" is plans[1]. plans[0] is shown with a "Recommended" badge. - contractTermsHumanReadable describes each plan's term; use it as written. - Each plan includes fullDetails, which select_plan needs unchanged. - unavailableProviders lists providers that don't serve the address. - If plans is empty, shopUrl (when present) links to the provider's own site, pre-filled with the address; share it as given. Next steps: when the customer chooses a plan, call select_plan with it. select_plan collects their contact details in the widget and then calls reserve_plan, which creates the reservation. Our team then calls the customer to complete activation, or they can call us with their order number. If no plans are found or the search fails, the customer can call (844) 882-3802 for help finding a plan. 📞 CANCELLATIONS AND CHANGES - Orders placed through this service are sold and fulfilled by our team, so our support team handles any cancellation or change to them. → Always give the customer our support number for this: (844) 882-3802 → Say: "We handle your order, so to cancel or change it, please call our support team." NOTE: The "No contract, cancel anytime" highlight describes the plan's terms, not a self-service cancellation process.

search_plans