​
Configuring Numbers

Once you have purchased a number, you can configure it with an inbound agent to set its prompt, voice, and actions.

​
Pick your Number

First, list your numbers and pick the number you want to configure.

numbers = vocode_client.numbers.list_numbers()

​
Changing the Prompt

All phone numbers come with the default agent configuration. Let’s change the prompt so the AI responds like Yoda.

from vocode import AgentUpdateParams

yoda_prompt = "I want you to act as Yoda. Respond as Yoda would."
number = vocode_client.numbers.update_number(
    phone_number="YOUR_NUMBER", inbound_agent=AgentUpdateParams(prompt=yoda_prompt)
)

​
Changing the Voice

Our prompt has been updated. Now let’s use a voice provided by other API providers.

​
Rime

from vocode import RimeVoiceParams, VoiceType

rime_voice = RimeVoiceParams(
    type=VoiceType.VOICE_RIME,
    speaker="RIME_SPEAKER",
)
voice = vocode_client.voices.create_voice(request=rime_voice)

​
Play.ht

from vocode import PlayHtVoiceParams, VoiceType

play_ht_voice = PlayHtVoiceParams(
    type=VoiceType.VOICE_PLAY_HT,
    voice_id="PLAY_HT_VOICE_ID",
    api_user_id="PLAY_HT_USER_ID",
    api_key="PLAY_HT_API_KEY",
)
voice = vocode_client.voices.create_voice(request=play_ht_voice)

​
ElevenLabs

We will use the rachel voice from ElevenLabs. Instead of updating our existing agent directly, we’ll create a new voice config and set the agent to use it.

from vocode import ElevenLabsVoiceParams, VoiceType

elevenlabs_voice = ElevenLabsVoiceParams(
    type=VoiceType.VOICE_ELEVEN_LABS,
    voice_id="ELEVEN_LABS_VOICE_ID",
    api_key="ELEVEN_LABS_API_KEY",
)
voice = vocode_client.voices.create_voice(request=elevenlabs_voice)

Now, we have our voice_id and can update our agent to use it.

from vocode import AgentUpdateParams

agent = vocode_client.agents.update_agent(
    id="AGENT_ID",
    request=AgentUpdateParams(voice="VOICE_ID"),
)

​
Adding an Initial Message

The initial message will be spoken as soon as the call starts before the user says anything. Let’s make our agent say “Hello, I am Yoda” when the call starts.

from vocode import AgentUpdateParams

number = vocode_client.numbers.update_number(
    phone_number="YOUR_NUMBER", inbound_agent=AgentUpdateParams(initial_message="Hello, I am Yoda.")
)