Set up an After Hours answering line (prepaid minutes or resolved conversations)
set_up_answering_lineStart setting up an After Hours answering line for the signed-in owner's business: a phone assistant that answers calls forwarded from the business's own number and takes messages and bookings for the owner. Nothing is built or bought until the owner pays: this returns a Stripe checkout link for the first pack, and once it is paid the line is set up automatically and its number and forwarding codes are emailed to the account's address. Only call it after showing the owner https://odilelabs.com/terms and getting a yes (owner_confirmed_terms true). The packs and billing rules are in get_answering_line_offer; a line that already exists is read with get_answering_line and topped up with buy_pack (product 'line_minutes' or 'line_outcomes', matching its billing_mode), not set up twice. United States only: business_phone and owner_mobile take any common US format with the area code and are stored as E.164, and Canadian area codes are refused. hours keys are day names (Monday, monday or mon); a day left out is closed, and omitting hours means Monday to Friday, 9 to 5. Messages reach the owner by email and the owner console; texts stay off until the owner switches them on there. Needs a signed-in connection with the lines:manage permission; limited to 3 set-ups a day per account, and rate limited. Returns { setup_id, status: 'awaiting payment', business_name, business_phone, pack, billing_mode, minutes or outcomes, price_cents, checkout_url, then }.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | The town the business is in, e.g. "Wellington, FL". The receptionist says it when a caller asks where you are. | |
| pack | Yes | The first pack: min40: 40 minutes; min200: 200 minutes; out50: 50 resolved conversations; out200: 200 resolved conversations. Amounts and billing rules: get_answering_line_offer. | |
| extra | No | Anything else the receptionist should know. | |
| hours | No | Opening hours by day name, e.g. {"Monday": {"open": "8:00 AM", "close": "5:00 PM"}, "Sunday": "closed"}. A day left out is closed. Omit entirely for Monday to Friday, 9 to 5. | |
| country | No | Only US for now. | |
| services | No | Up to 12 services, e.g. ["drain cleaning", "water heaters"]. | |
| languages | No | Languages besides English the receptionist switches to when a caller does. | |
| description | No | What the business does, in one line; this is what it tells callers. | |
| owner_mobile | Yes | The owner's own mobile (US, with area code): their calls to the line are never charged. | |
| business_name | Yes | The business name callers should hear, e.g. "Alvarez Plumbing". | |
| business_phone | Yes | The business number callers dial today (US, with area code, any common format such as (561) 555-0123). The owner forwards it to the new line. | |
| owner_confirmed_terms | Yes | true ONLY after you showed the owner https://odilelabs.com/terms and they said yes. Anything else is refused. |