Banjo

Leave a voicemail message and end the call. Use this when you have reached an answering machine or voicemail system instead of a human. Call it without saying anything first: the voicemail records everything, and it must open with the AI disclosure, which the system says for you. Provide the message as the `message` argument — the system says the disclosure, then your message, verbatim, then hangs up. Leave the disclosure out of the message, and do NOT say the message yourself: the callee would hear it twice. Never tell the callee how the message is delivered or that the call is ending.

List saved contacts, optionally filtered by category.

List the most recently updated tasks (phone calls and online bookings), most recent first. An ask call's answers saved before it ended some other way aren't included: get_task_status has them (collectedAnswers).

Place an outbound phone call to a contact to accomplish a task (e.g. book an appointment, or ask a business a question with mode 'ask'). Returns immediately with a taskId — the call itself runs asynchronously over the following minutes (or at scheduledFor, if given, to call later instead of now). Poll get_task_status with the returned taskId to learn the outcome. If this server asks the owner to approve calls first, the result says so: get_task_status then shows approval: 'waiting' until they approve (the call goes ahead) or 30 minutes pass (it's cancelled, approval: 'not_approved'). Tell the …

Send DTMF tones on the phone line, e.g. to navigate an IVR menu.

Save one answer as soon as it is settled: call this right after the other party confirms your read-back of an answer, without saying anything about it, then carry on with the call. Use the question's number in your list. If they can't or won't answer one, save it with answered: false. Saving the same number again replaces what you saved before. This does not end the call; report_answers_and_end_call still does, at the end.

Log the outcome of a task that was completed OUTSIDE the phone-call path (typically an online booking the skill completed itself via browser automation), so it appears in the same task history as phone-call tasks.

Use this to end the call once you have asked every question on your list and they have answered what they can. Record one entry per question, by its number: what they said, in a short plain sentence, or answered: false if they didn't know, wouldn't say, or you never got to it. Record only what they actually told you on this call. Never fill a gap with a guess. Answers you saved with record_answer are kept: an answer here for the same question replaces it, and answered: false here never erases one. This is the normal, successful end of this call, even if some questions went unanswered. Before c…

Use this when you reached and properly engaged with a human, but none of the times offered by either side fit the constraints of the task, and no further negotiation is possible. This is distinct from escalate_and_end_call — use this only when the call went smoothly but simply failed to reach an agreement.

Move the current caller's own active booking to a new date/time. The name on the booking carries over automatically — do not ask the caller for their name again. Fails with "no_active_booking" if they don't have one — direct them to book_appointment instead. Fails with "outside_business_hours" or "slot_unavailable" if the new time does not work; their original booking is left untouched in that case. Fails with "in_the_past" or "beyond_lookahead_window" if the requested date is out of the bookable range; their original booking is left untouched in that case too. Fails with "caller_id_unavailabl…

Hang up a call that is already in progress — the one thing cancel_task cannot do. Use this to stop a call that is going wrong or was placed in error. The task is recorded as failed with the reason given, and the usual outcome notification is sent. An agent's key can stop only calls it asked for.

Suggest a few open times on a specific day, within business hours, when the caller does not have a specific time in mind yet.

Description is built at runtime.

Description is built at runtime.

Update an existing contact — e.g. record the assistant's owner's stated preferred booking channel so future tasks for this contact skip asking again, or update notes/booking URL. Notes go into every call to the contact, and the booking URL is the page opened to book online, so only the owner's key can change either.

Use this, without saying anything first, as soon as you are in a hold queue: hold music, "please hold", "your call will be answered by the next available…", or an estimated wait time. Also use it when a phone menu says you can remain on the line and you have nothing to enter. Not after each key press, though: a menu goes on to its next prompt by itself, and you answer it faster off hold. You stay on the line silently, and you are told the moment a live person picks up, or handed back as soon as a menu asks you for something. Never use it with a person on the line.