Lower My Bill

A call script to lower a bill. For requests like "help me lower my Comcast bill", "get my BT broadband cheaper", "lower my Council Tax", "script to get a better phone plan", "how do I negotiate my car insurance?", "lower my credit card interest", "I pay for too many streaming services". Give the bill type, the provider, or both. If the provider doesn't sell that bill, provider_note says so and the general script is returned.

{
  "type": "object",
  "properties": {
    "bill": {
      "type": "string",
      "description": "Bill: internet (or broadband), mobile, tv, streaming, car insurance, home insurance, electricity (or energy, gas), water, credit card, gym or council tax (UK). Up to 60 characters."
    },
    "provider": {
      "type": "string",
      "description": "Company name, for example Comcast, Xfinity, Spectrum, AT&T, Verizon, Frontier, T-Mobile, Cox, Optimum, Mediacom, Astound, DIRECTV, DISH, GEICO, Progressive, State Farm, Allstate, USAA; UK: BT, Sky, Virgin Media, TalkTalk, Vodafone, EE, O2, Three, Plusnet, NOW Broadband, Hyperoptic, British Gas, Octopus, EDF, E.ON Next, OVO, ScottishPower. Up to 60 characters."
    },
    "state": {
      "type": "string",
      "description": "US state name or two-letter code. For electricity, adds the state's energy discount programme where there is one. England, Scotland, Wales, Northern Ireland or UK gives the UK answer."
    },
    "deal_ends": {
      "type": "string",
      "format": "date",
      "description": "The date the current promotional price, contract or insurance policy ends, YYYY-MM-DD. Adds call_by (about 30 days earlier, on a weekday, or today if that has passed) and add_to_calendar, a link to a calendar reminder with the script."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. GB (or UK) gives UK scripts, schemes and complaint routes; otherwise it picks the Amazon store in own_modem (US by default; IE uses amazon.co.uk). Defaults to the caller's country."
    }
  },
  "required": [],
  "additionalProperties": false
}

Calendar reminder to call before a deal ends. Returns a calendar file (.ics) with an all-day event about 30 days before the deal ends, holding the full script, offers to ask for and a confirm-in-writing message, with alerts at 9am the day before and on the day. Nothing is stored. get_bill_script gives this link as add_to_calendar when deal_ends is given.

{
  "type": "object",
  "properties": {
    "bill": {
      "type": "string",
      "description": "Bill type, as for get_bill_script. Give bill, provider or both."
    },
    "provider": {
      "type": "string",
      "description": "Company name, as for get_bill_script."
    },
    "deal_ends": {
      "type": "string",
      "format": "date",
      "description": "The date the current price or policy ends, YYYY-MM-DD."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. GB (or UK) gives the UK script when no provider is named. Defaults to the caller's country, else US."
    }
  },
  "required": [
    "deal_ends"
  ],
  "additionalProperties": false
}

Official help programmes for a bill. For requests like "is there help paying my internet bill?", "is there a broadband social tariff?", "help with my energy bill in the UK", "help with my electric bill", "cheap internet for low income", "does Xfinity have a low-income plan?". Returns programmes with who qualifies and how to apply.

{
  "type": "object",
  "properties": {
    "bill": {
      "type": "string",
      "description": "Bill: internet, mobile, electricity (or heating, gas), water, tv, streaming, car insurance, home insurance, credit card, council tax (UK), or a provider name. Up to 60 characters."
    },
    "state": {
      "type": "string",
      "description": "US state name or two-letter code. For electricity, adds the state's energy discount programme (California, New York, Ohio, New Jersey, Pennsylvania, Georgia). England, Scotland, Wales, Northern Ireland or UK gives the UK answer."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code. GB (or UK) gives UK schemes (Ofcom social tariffs, Warm Home Discount, WaterSure, Council Tax Reduction). Defaults to the caller's country, else US."
    }
  },
  "required": [
    "bill"
  ],
  "additionalProperties": false
}