Change how your Saperly phone assistant works

Choose the Saperly phone number you recognize, then say what you want changed: the assistant’s name, language or voice; what it says during calls; what callers hear before speaking; whether it answers text messages; or whether it can end a call or press phone keys.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use update-phone-number-saperly only when the user clearly asks to change settings for one existing Saperly phone number they own. Ask which full phone number shown in their Saperly account they want to change. If list-your-phone-numbers-saperly is available, use its actual reply to find that number. Continue only if the reply shows one exact matching number and the information needed to identify its assistant settings. If it does not, ask the user to connect Saperly or choose the number in their account; never guess or ask them for information they cannot see in their Saperly account. Ask only which changes they want, in everyday words. Match a requested language or voice to one exact choice shown by Saperly; if unclear, let the user choose from the choices shown in their account. Change only the settings they asked to change. Keep their exact wording for what the assistant should say during calls or before the conversation starts. Do not add or remove an opening message unless they ask; if they ask to remove one, explain which message will be removed and wait for their explicit confirmation. Follow their clear choice about text-message replies, ending calls, or using the phone keypad. Ask for at least one clear change; do not send an empty request. Before sending, show the phone number and each requested change, then wait for explicit confirmation. After sending, show Saperly’s actual reply. Do not say a change is active unless Saperly confirms it, and do not assume other settings stayed the same. Reuse the existing Toolmu connection or follow https://toolmu.com/SKILL.md. Check the current price and honor the user’s authorization and budget.

Task:
For [the phone number shown in my Saperly account], change the assistant’s name to [Maya] and its language to [Spanish]. Ask it to [greet each caller and ask how it can help]. Show me what will change and wait for my confirmation before sending the request.

Paste into your connected AI's conversation.

Connection guide

Free

Saperly

Change how your Saperly phone assistant works

Choose the Saperly phone number you recognize, then say what you want changed: the assistant’s name, language or voice; what it says during calls; what callers hear before speaking; whether it answers text messages; or whether it can end a call or press phone keys.

You receive

Submit the changes you choose for one Saperly phone number, then review Saperly’s actual reply.

Start with your task

For [the phone number shown in my Saperly account], change the assistant’s name to [Maya] and its language to [Spanish]. Ask it to [greet each caller and ask how it can help]. Show me what will change and wait for my confirmation before sending the request.

What to know

The reply may not confirm every change or show every setting. Check your Saperly account before relying on the new behavior.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
body`body`	`object`	Required	Required fields `numberId, connection`
Number resource ID`body.numberId`	`string`	Required	Required nonempty resource ID of the Saperly number you own and want to update. It is not the dialable phone number. Minimum length `1`
Assistant settings object`body.connection`	`object`	Required	Required object containing the assistant settings you want to submit. Each individual setting is optional; only include the values you choose.
llm`body.connection.llm`	`object`	Optional	The model the hosted assistant runs. Required fields `model`
Assistant model`body.connection.llm.model`	`string`	Optional	Optional managed-model selection, such as openai/gpt-4o. If llm is supplied, a nonempty model is required. Minimum length `1`
tts`body.connection.tts`	`object`	Optional	Text-to-speech voice selection. Required fields `voiceId`
Assistant voice ID`body.connection.tts.voiceId`	`string`	Optional	Optional text-to-speech voice selection using an id from the voice list. If tts is supplied, a nonempty voiceId is required. Minimum length `1`
Assistant name`body.connection.name`	`string`	Optional	Optional readable assistant name; 1–120 characters. Minimum length `1` Maximum length `120`
Assistant language`body.connection.language`	`string`	Optional	Optional BCP-47 language tag, such as en or es; 2–35 characters. Refer to the language list when selecting a code. Minimum length `2` Maximum length `35`
Opening disclosure text`body.connection.disclosure`	`string`	Optional	Optional AI/TCPA notice text for use when disclosure is enabled; at most 1,000 characters. An empty string requests the standard organization-named notice. Maximum length `1000`
callControl`body.connection.callControl`	`object`	Optional	Which live-call actions the assistant may take (signaling only).
Allow assistant hang-up`body.connection.callControl.endCall`	`boolean`	Optional	Optional boolean requesting permission for the assistant to signal a call hang-up when true.
Allow keypad signaling`body.connection.callControl.sendDtmf`	`boolean`	Optional	Optional boolean requesting permission for the assistant to send keypad digits, for example to navigate an automated phone menu.
Assistant instructions`body.connection.instructions`	`string`	Optional	Optional system prompt describing how the assistant should speak and behave on calls; 1–10,000 characters. Include any opening line in this text. Minimum length `1` Maximum length `10000`
SMS auto-reply setting`body.connection.smsAutoReply`	`boolean`	Optional	Optional boolean requesting assistant replies to incoming SMS when true. Supplying it does not confirm SMS service readiness.
Opening disclosure setting`body.connection.complianceEnabled`	`boolean`	Optional	Optional boolean requesting opening, uninterruptible disclosure and the do-not-message option when true.

View raw JSON

{
  "type": "object",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "numberId",
        "connection"
      ],
      "~standard": {
        "vendor": "zod",
        "version": 1,
        "jsonSchema": {}
      },
      "properties": {
        "numberId": {
          "type": "string",
          "minLength": 1,
          "description": "The id of a phone number YOU OWN."
        },
        "connection": {
          "type": "object",
          "properties": {
            "llm": {
              "type": "object",
              "required": [
                "model"
              ],
              "properties": {
                "model": {
                  "type": "string",
                  "minLength": 1,
                  "description": "Managed LLM (e.g. \"openai/gpt-4o\")."
                }
              },
              "description": "The model the hosted assistant runs.",
              "additionalProperties": false
            },
            "tts": {
              "type": "object",
              "required": [
                "voiceId"
              ],
              "properties": {
                "voiceId": {
                  "type": "string",
                  "minLength": 1,
                  "description": "TTS voice — an `id` from /list-voices."
                }
              },
              "description": "Text-to-speech voice selection.",
              "additionalProperties": false
            },
            "name": {
              "type": "string",
              "maxLength": 120,
              "minLength": 1,
              "description": "Human-readable persona name (1–120 characters)."
            },
            "language": {
              "type": "string",
              "maxLength": 35,
              "minLength": 2,
              "description": "BCP-47 language tag (e.g. \"en\", \"es\") — see /list-languages."
            },
            "disclosure": {
              "type": "string",
              "maxLength": 1000,
              "description": "The AI/TCPA notice spoken first when compliance is on. Leave empty and a standard org-named default is used."
            },
            "callControl": {
              "type": "object",
              "properties": {
                "endCall": {
                  "type": "boolean",
                  "description": "Allow the assistant to hang up the call (default on)."
                },
                "sendDtmf": {
                  "type": "boolean",
                  "description": "Allow the assistant to press keypad digits, e.g. to navigate an IVR (default on)."
                }
              },
              "description": "Which live-call actions the assistant may take (signaling only).",
              "additionalProperties": false
            },
            "instructions": {
              "type": "string",
              "maxLength": 10000,
              "minLength": 1,
              "description": "System prompt for the number's AI persona — how it speaks and what it does on calls. Put any opening line here."
            },
            "smsAutoReply": {
              "type": "boolean",
              "description": "Auto-answer inbound SMS with the assistant (default off)."
            },
            "complianceEnabled": {
              "type": "boolean",
              "description": "When true (the default), the disclosure is spoken as the line's first, uninterruptible utterance and the do-not-message tool is exposed."
            }
          },
          "additionalProperties": false
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

Saperly’s Connections guide explains the settings available for a phone assistant connected to a number.