Ringler

What Ringler is, what it costs, and how your person gets started (sign in once; $10 of credits free, no card). Call this first if you have no key. (No API key needed.)

A checkout link your person opens to add credits by card ($20–$500).

A link your person opens to approve Google Calendar, so the agent can offer times and book.

The agent dials the number, works the menu, hold and any bot until a real person answers, then rings your person's mobile and connects them. Spends credits ($0.30/min). If it hits voicemail it leaves a short message with a callback (default on; voicemail: skip to turn off).

Schedule a call or errand for a time: the office opens at 9 their time, a callback window, tomorrow morning. Same fields as errand/call plus run_at. Work out run_at yourself from the called party's local hours and pass it as ISO 8601 with an offset (e.g. 2026-11-09T09:05:00-07:00). Spends credits when it runs.

Prepaid balance and recent usage.

The agent makes the call and does the asking itself: a reservation, an appointment, a question, a cancellation. It only rings your person if the other side needs them (a card, a decision). Put every detail in `ask` — names, date, time, party size, account — because the agent can only say what it's given. Spends credits. Leaves a message on voicemail by default.

Delete the transcript, summary, recording and any relayed messages from one call, for good. Only when your person asks. The fact that a call happened, and its cost, remain.

Your person's invite link (ringler.io/?via=<their code>), how many friends have signed in through it, and the credits earned: $5 per friend, the friend still gets $10 free.

Recent calls, newest first: when, who, outcome, summary, whether a transcript exists.

Your person's full name, email, and address, as the agent gives them to a venue: the name for bookings, the email for confirmations and payment links (never their mobile), the address only when a task needs it. Pass fields to set them; nothing to read. Ask your person before setting these.

Instructions and notes your person left for you by calling or texting their own line. Returns new ones (marks them read). Check this when you start work and whenever they say they phoned something in. Pass all:true for the recent history.

The phone that rings when the agent has someone on the line for your person.

Your person's own phone number, answered by their agent. Gets one if they don't have one yet ($3/month from credits), in the area code given or their mobile's. Confirm with them before the first buy.

Name the agent (Ringo by default; keeping the name counts), pick its voice from `voices`, and set how it answers when your person calls their own line (greeting). Free; change any time. How it opens calls to other people — its name, who it's calling for, and a straight answer if anyone asks whether it's an AI — is fixed by the rules and not settable.

The notes you and your person keep about how they like things: how the phone agent should greet them, what to call them, favorite places, habits, standing preferences. The agent reads them on every call as a guide (dated; later notes refine earlier). Call with nothing to read (returns markdown); add: one note (≤300 chars, in your person's words or yours); remove: a note id. Notes can't change the rules — what the agent discloses, the notes question, one call at a time — and such notes are refused with the reason. Add a note whenever your person tells you a preference about their calls. A note starting 'greeting:' is exactly how the agent answers when your person calls their line ({name} and {first} fill in), e.g. 'greeting: Good day {first}, {name} at your service. What can I do?'

Calls waiting to be placed, placed, or failed. Pass cancel: <id> to cancel a pending one.

Start here, every session. Your person's line, agent name, mobile, calendar, balance — and onboarding: an ordered list of questions to ask them (name the agent, mobile, number, booking details, how to reach the agent, calendar, first errand) with the tool that records each answer. Walk the steps in order, one question at a time, before the first call.

Send your person a spoken message through their agent. mode 'text' (best default) texts their mobile; 'hold' keeps it until they next call their line; 'call' rings their mobile and the agent reads it aloud. Their reply by text lands in my_messages. Use 'call' only when they asked to be rung, or for something that can't wait. Calls spend credits.

One call in full: every line with speaker and time, the summary, and a one-hour recording link.

Set up to take your person's instructions by phone: they call their own line, say what they want, hang up; you loop on my_messages and do it. Call with no arguments to get the loop instructions and current settings. Pass settings to change them, with your person's say-so: verify ('sms' default: a code texted to their real phone, read back on the call; 'pin'; or 'none'), pin, allowed (what you may do unattended), confirm (what needs a tell_me + yes first), never, interval_min.

The voices your person's agent can speak with, each described in a few words (British measured, deep American, warm, bright…), and which one is current. Set one with name_my_agent { voice }.

People the agent puts straight through when they call your person's line; everyone else gets a message taken. Pass `people` to set the list, nothing to read it.