Bouygues Telecom

Use this when the user asks for help, troubleshooting, or support articles about their Bouygues Telecom service, devices, or account. Do not use for product recommendations — use get_recommendations / get_mobile_plans / get_box_internet.

get_assistance_articles

Internal data provider for the smartphone carousel widget. Returns the full detail sheet of ONE phone variant (specs, colors × storage, media, pricing standalone vs with plan, financing) for a gencode. NEVER call this tool yourself, and never use it to answer a question about a phone: the carousel widget calls it on its own when the user clicks a phone card. To show, compare or detail any smartphone, ALWAYS call get_recommendations (pass the model name as `query`) so the phone is displayed in the carousel first — the user opens the detail sheet from there.

get_phone_details

Renders mobile plans (forfaits, 5G, monthly mobile pricing) as a visual carousel. You MUST call this to DISPLAY plans to the user — never present a plan list as plain text, always render it here. BUT do NOT call it until the user has given at least ONE concrete criterion among these four: a monthly budget (`price_max`), a data need (`data_min`), a commitment preference (`sim_only`), or usage abroad (`roaming`). If the user opens the app with no request at all, do NOT call this tool: ask them, in plain text, what they are looking for (smartphone, forfait mobile ou box internet). If the user asks for plans with no criterion at all (e.g. "montre-moi vos forfaits", "quels forfaits avez-vous ?", "je cherche un forfait mobile", "show me your plans"), do NOT call this tool: first ask them, in plain text, ONE short question covering those criteria (budget mensuel, volume de data, avec ou sans engagement, usage à l'étranger), and call the tool only once they answer. ONE criterion is enough: as soon as the user gives ANY of them, call the tool immediately and NEVER ask a second question — e.g. "un forfait à moins de 15€" → call now with price_max=15; "il me faut 100 Go" → call now with data_min=100; "sans engagement" → call now with sim_only=true; "je voyage souvent" → call now with roaming=true. Exception: if the user asks to see everything or has no preference ("montre-moi toute la gamme", "tous vos forfaits", "je ne sais pas", "peu importe"), call the tool immediately with no criterion — the full range is returned. By default (sim_only omitted) the result MERGES the convergent premium range (with-mobile / Bbox advantages) with the B&YOU range (low-price, SIM-only, no commitment), so the user sees both. Set sim_only=true when the user signals a low budget or wants no commitment — "petit prix", "pas cher", "le moins cher", "budget serré", "économique", "sans engagement", "B&You" — to return the B&YOU range only; for those requests also pass sort="petits-prix". Set has_box_already=true when the customer already has a Bbox (affects convergent pricing). Do not use for fibre broadband or box internet — use get_box_internet. If the user states they are 14 years old or younger, pass `age`; if they say they are a child without giving an exact age, set `is_child: true`. Either signal makes the widget show the kid-appropriate Kids Watch offer instead of mobile plans. Likewise, if the user asks about the Kids Watch itself or a (connected) watch for a child ("kids watch", "montre pour enfant", "montre connectée enfant"), call this tool IMMEDIATELY with `kids_watch: true` — no criterion question, no catalogue search.

get_mobile_plans

Renders box internet offers (box internet, home internet, fibre broadband, FTTH fibre, 4G/5G home box, 5G box, Bbox, B&YOU fibre, "offre internet") as a visual carousel. You MUST call this to DISPLAY box internet offers to the user — never present them as plain text, always render them here. BUT do NOT call it until the user has given at least ONE concrete criterion among these: technology fibre vs 4G/5G box (`technology`), range B&YOU vs Bbox (`brand`), TV included (`with_tv`), a monthly budget (`price_max` / `price_min`), no commitment (`no_commitment`), or asking for the cheapest (`sort`). If the user opens the app with no request at all, do NOT call this tool: ask them, in plain text, what they are looking for (smartphone, forfait mobile ou box internet). If the user asks for box internet with no criterion at all (e.g. "quelles box internet avez-vous ?", "je cherche une box", "offre internet", "montre-moi vos box", "show me your internet boxes"), do NOT call this tool: first ask them, in plain text, ONE short question covering those criteria (fibre ou box 4G/5G, avec TV, budget mensuel, sans engagement), and call the tool only once they answer. ONE criterion is enough: as soon as the user gives ANY of them, call the tool immediately and NEVER ask a second question — e.g. "une box fibre à moins de 30€" → call now with technology=ftth, price_max=30; "une box 5G" → call now with technology=5g; "avec la TV" → call now with with_tv=true; "la moins chère" → call now with sort="prix-asc" (no brand filter: a 4G/5G box may be the cheapest); "B&YOU" → call now with brand=byou; "sans engagement" → call now with no_commitment=true. Exception: if the user asks to see everything or has no preference ("montre-moi toutes vos box", "toute la gamme", "je ne sais pas", "peu importe"), call the tool immediately with no criterion — the full range is returned. Do not use for mobile plans — use get_mobile_plans.

get_box_internet

Prépare un lien cliquable vers un panier Bouygues Telecom pré-rempli avec les produits demandés (téléphone, forfait, accessoire). L'utilisateur finalise la commande sur bouyguestelecom.fr. La carte SIM est ajoutée automatiquement par le site si le bundle l'exige. Le mode de financement (`financingType`) est pré-rempli dans le panier ; l'utilisateur pourra le modifier dans le tunnel de paiement Bouygues.

create_cart_link

Renders smartphone results as a visual carousel. You MUST call this to DISPLAY smartphones to the user — never present a smartphone list as plain text, always render it here. BUT do NOT call it until the user has given at least one concrete criterion: a budget, a brand/OS, or a usage (photo, gaming, basic use…). If the user opens the app with no request at all, do NOT call this tool: ask them, in plain text, what they are looking for (smartphone, forfait mobile ou box internet). If the user asks for phones with no criterion at all (e.g. "liste-moi des téléphones", "montre-moi des smartphones", "show me some phones"), do NOT call this tool: first ask them, in plain text, for at least one criterion (budget, brand/OS, or usage), and call the tool only once they answer. ONE criterion is enough: as soon as the user gives ANY of them, call the tool immediately and NEVER ask a follow-up question (no budget, brand, new/refurbished or other clarifying question, and never offer multiple-choice options) — the user refines from the carousel. E.g. "iOS phones under 1000€" → call now with os="ios", price_max=1000; "un téléphone qui fait de belles photos" → call now with usage="photo"; "un Samsung" → call now with brand="samsung". A usage with no dedicated `usage` value (gaming, autonomie, usage basique…) also counts: call now without it (best-sellers are returned). Do not use for subscription plans (use get_mobile_plans) or fibre / box internet offers (use get_box_internet). If the user states they are 14 years old or younger, pass `age`; if they say they are a child without giving an exact age, set `is_child: true`. Either signal makes the widget show the kid-appropriate Kids Watch offer instead of smartphones. Likewise, if the user asks about the Kids Watch itself or a (connected) watch for a child ("kids watch", "montre pour enfant", "montre connectée enfant"), call this tool IMMEDIATELY with `kids_watch: true` — no criterion question, no catalogue search.

get_recommendations

Vérifie l'éligibilité à la fibre fixe Bouygues Telecom à partir d'une adresse française. Outil principal pour toute question d'éligibilité fibre / couverture fixe. Si plusieurs adresses correspondent, renvoie requiresSelection=true avec une liste de candidats : NE PAS lister les adresses dans le chat, demander à l'utilisateur de choisir dans le widget. Si selectedIdAdresseBytel est fourni, le traiter comme un choix confirmé et continuer sans redemander dans le chat.

check_fiber_eligibility