add_rule
ChatGPTAdd a screening rule for the user's incoming calls. text, prompt and emoji are required; tag each person it is about in mentions. Call it FIRST without confirmed and read the confirmation_required change back to the user; call again with confirmed:true only after they say yes. If it is refused with name_detected_pending_confirmation, follow its nextStep.
cancel_scheduled_call
ChatGPTUse this when the user wants to cancel a call OsmO has booked for later. Pass a callId from list_scheduled_calls. Calls booked together are cancelled together, so call it FIRST without confirmed: it answers confirmation_required naming every call it will cancel. Call again with confirmed:true only after the user says yes. Do not use it for a call that is already happening or done.
delete_rule
ChatGPTPermanently delete one of the user's screening rules. Call it FIRST without confirmed and read the confirmation_required change back to the user; call again with confirmed:true only after they say yes.
find_business
ChatGPTUse this when the user wants to find a business to call or visit, e.g. "pharmacy near Indiranagar". Returns up to 5 Google Maps listings in the user's own country: name, address, phone number and rating. It does not know whether a place is open now — never say it is. Do not use it for a company's customer care line, or for a person.
find_contact
ChatGPTFind someone in the user's call history by name, to get the contact before placing a call. Each match returns a contactId plus a MASKED number and when they last spoke. PASS THE contactId STRAIGHT TO place_call to ring that person — the masked number is only for showing the user which contact is meant, and you never need the full number. Do not use to browse contacts; use it when a call is intended.
find_customer_care
ChatGPTUse this when the user wants to reach a company's customer care or helpline, e.g. "HDFC customer care". Returns the numbers found for the user's own country, where each was found, and callable: true when OsmO can call it with place_call. A number marked callable:false is for the user to dial, or to call from the OsmO app's Call a business. Do not use it for a shop or place near the user (use find_business), or for a person.
get_account_status
ChatGPTUse this when the user asks about their OsmO account: their plan and when it renews or the trial ends, their assistant's name, the OsmO number their calls forward to, whether forwarding is working, the last screening check, and how many calls OsmO handled today and this week. Never shows payment details. Do not use it to change anything; plans are changed in the OsmO app.
get_assistant
ChatGPTThe user's current assistant and language, and every assistant they can switch to, each with its ringgId, languages and a voiceUrl sample to share.
get_call
ChatGPTOne call by id, with its status and summary. Never the transcript or recording. Do not use to place a call or change any setting.
get_call_status
ChatGPTWhere a call has got to. Pass the callId place_call returned. While resultState is in_progress or pending, wait pollAfterSeconds and call again; when it is ready, tell the user who answered, the outcome and the summary.
get_chat
ChatGPTOne OsmO chat by conversationId: its messages and the calls it placed, with full numbers and summaries. Never a recording.
get_connections
ChatGPTWhether Google Calendar, Calendly and Google Drive are connected. Status only; connecting, disconnecting and transcript email are done in the OsmO app.
get_facts
ChatGPTThe Facts the user's assistant answers callers from: website, summary, documents and their status. Facts are changed in the OsmO app, not here.
get_settings
ChatGPTThe user's call settings: transferMode, isAiAnsweringPaused, liveCallAlerts, extraPolite, skipAllContacts, deviceScreeningMode, and the VIP and block lists.
list_bookings
ChatGPTThe user's bookings, newest first: caller number, slot, and whether it was booked or cancelled. Pass nextCursor back as cursor for more. One booking's detail is in the OsmO app.
list_calls
ChatGPTThe user's calls, newest first, 10 per page, with full numbers, reason and summary. Pass nextCursor back as cursor for the next page; hasMore false means that was the last page. Do not use to place a call.
list_chats
ChatGPTThe user's chats with the OsmO assistant in the app, newest first. Pass a conversationId to get_chat.
list_recent_calls
ChatGPTThe user's recent calls with status and a short summary. Never transcripts or recordings. Do not use to place a call or change any setting.
list_rules
ChatGPTThe user's screening rules: what each says, whether it is on, and the people (name and number) it is for. Pass a ruleId to update_rule or delete_rule.
list_scheduled_calls
ChatGPTUse this when the user asks which calls OsmO will make later: up to 20 calls booked for a later time that have not been placed yet, soonest first, each with who, the number, when and the reason. Do not use it for calls that already happened (use list_calls).
osmo_help
ChatGPTExplains what this OsmO integration can and cannot do. Read this before telling the user something is impossible. When a response carries openInOsmoUrl, SHOW that link to the user so they can open the OsmO app — it is the only way back to OsmO from this conversation. Do not use for placing calls or retrieving recordings.
osmo_support
ChatGPTUse this when the user asks how OsmO works or needs help: forwarding codes for their carrier, their carrier's customer care number, what each plan includes, privacy, how to delete their account, which languages the assistant speaks, or how to contact OsmO. Answers for the user's own country. Do not use it to make a call, to change a plan, or to delete the account — those are done in the OsmO app.
place_call
ChatGPTPlace a phone call on the user's behalf. OsmO's assistant makes the call and speaks the reason. To call someone from find_contact, pass their contactId — that is all you need, and it works even though you only saw a masked number. Pass phoneNumber instead only when the user gives you a number directly. Never decline because a number looks masked or incomplete; pass the contactId and OsmO resolves it. ALWAYS confirm who is being called and why with the user before calling this. Do not use to send a message or read call history.
search_contacts
ChatGPTSearch the user's phone book (the contacts synced from their phone) by name; each match has the name and full number. Use it when find_contact has nobody. If this has nobody either, ask the user for the number; never guess one. Pass the number to place_call as phoneNumber.
update_assistant
ChatGPTSwitch the user's assistant to one listed by get_assistant, and/or its language. Call it FIRST without confirmed and read the confirmation_required change back to the user; call again with confirmed:true only after they say yes.
update_rule
ChatGPTChange one of the user's screening rules. Pass the ruleId and only the fields to change. Call it FIRST without confirmed and read the confirmation_required change back to the user; call again with confirmed:true only after they say yes.
update_settings
ChatGPTChange the user's call settings. Pass only the settings to change. Names, the greeting and the voice are changed in the OsmO app, not here. Call it FIRST without confirmed and read the confirmation_required change back to the user; call again with confirmed:true only after they say yes.