Docs

Configuring your first voice calling agent

The one part of setup that happens outside Svarloop. About 20 minutes, once, ever.

← All docs

Read step 3 before you start Sarvam asks new accounts which product they want. If you pick Sarvam API you land on the speech API console, and the keys there will not work with Svarloop. You want Voice Agents. This is the single thing people get wrong.

What you need before you begin

1. Log in to Sarvam

Open agents.sarvam.ai. Continue with Google, Microsoft, Apple, phone, or email. If you already have an account this link takes you straight to your agents and you can skip to step 6.

Sarvam login screen with buttons to continue with Google, Microsoft, Apple or phone, and an email field below.Sign in any way you like
Any of these work. Use whichever account you want the billing to sit under.

2. Choose Developer

A new account is asked which role describes you best. Choose Developer. The others route you to different parts of the product.

Sarvam onboarding asking which role describes you best, with options including Developer, Founder and Product manager.Choose Developer
Developer is the one that leads to the Voice Agents console.

3. Choose Voice Agents

Next it asks what you want to get started with, and this is the step that matters. Choose Voice Agents, described as "Deploy phone voice agents".

Sarvam onboarding asking what to get started with: Sarvam API, Code, Cowork, Voice Agents, Content Studio and Doc Agents.Voice Agents
This is the fork. Sarvam API at the top is the wrong one for Svarloop, and its keys are rejected later with no explanation.
Not Sarvam API Sarvam API is the speech and language product. Its keys look similar and are not interchangeable with Voice Agents keys, so a key from there will be rejected by Svarloop with no obvious reason why. If you have already gone down that path, go back to agents.sarvam.ai and pick Voice Agents.

4. Phone number and volume

Sarvam asks for a phone number to set up your voice agent, with no verification needed, and then for your expected monthly call minutes. Both can be skipped with Skip for now and neither affects what follows.

Sarvam asking for your phone number, with a Skip for now link underneath.Skip is fine
Nothing downstream depends on this answer.
Sarvam asking for expected monthly call volume, with ranges from under 1,000 minutes to over 5 lakh, and a Skip for now button.Skip is fine
Answer if you know, skip if you do not. It gates nothing.

5. Accept your free credits

New accounts start with 100 free credits for building and testing. Click Continue to Voice Agents and you land on the Voice Agents home.

Sarvam showing 100 free credits to build and test voice agents, with a Continue to Voice Agents button.Continue
Enough to build an agent and make test calls before spending anything.

6. Rent a phone number first

In the left sidebar under Deploy, open Phone numbers. You have two options:

Voice Agents home with a sidebar containing Home, Build with Agents and Workflows, and Deploy with Phone numbers, Inbound calls, Outbound campaigns and Deploy with code.Phone numbers
The sidebar is how you move around for the rest of this guide. Everything you need is under Build and Deploy.
Take your agent live, offering to rent a number from Sarvam or to connect your own telephony provider.Rent from Sarvam
Renting from Sarvam is the shorter path. Bring your own if you already have numbers and rates worth keeping.
Do this before step 11, not after The code block you copy at the end contains your connection and your phone number. With no number rented, those fields come out empty and Svarloop has nothing to read. Renting first is what makes that copy worth anything.

7. Create the agent

Go to Agents in the sidebar and click Create from scratch at the top right. Sarvam asks you to name it first. Give it a name you will recognise later, then click Create agent.

The Agents page showing template cards such as Appointment management and Sales discovery, with a Create from scratch button at the top right.Create from scratch
Ignore the templates. Svarloop gives you the prompt, so start from scratch.
A Name your agent dialog with a text field and a Create agent button.Give it a name
Name it after the job it does. You will be picking it out of a list later.

8. Paste your Svarloop prompt into Genie

The agent opens with an empty greeting and empty instructions, and a panel on the right called Genie.

In Svarloop, go to Calling setup and copy the ready made prompt shown there. Paste it into the Genie box and send it. Genie writes the agent out for you: persona, environment, objective, speaking style, and the variables the prompt refers to. You are not writing prompt engineering here, only pasting.

Read what it produced before moving on. Genie is generating, so it can add or reword things. The greeting and the speaking rules are worth a look.

A newly created agent with an empty greeting and empty instructions, and the Genie panel open on the right.Paste the Svarloop prompt here
Empty on the left, Genie on the right. Paste into Genie, not into the instructions field.
The same agent after Genie has filled in a greeting and instructions covering persona, environment, objective and speaking style.
Genie writes the persona, environment, objective and speaking style, and registers the variables the prompt refers to.

9. Commit the agent

A draft cannot be called. Click v1 · Draft next to the agent name at the top, then Commit agent. Add a short note about what changed and click Commit.

This is what turns the draft into a version Svarloop can dial. Every time you edit the agent later, commit again, or your calls keep using the older version.

The v1 Draft dropdown open next to the agent name, showing a Commit agent option.Commit agent
Click v1 Draft beside the agent name, then Commit agent.
A Commit version dialog asking for a version note, with Cancel and Commit buttons.Commit
The note is for you, later, when you are looking at three versions wondering which is which.

10. Generate your API key

In the sidebar under Deploy, open Deploy with code, then click Generate API key. Name it something like Svarloop and click Create key.

Copy the key and paste it into the API key field on Svarloop's Calling setup screen. Sarvam shows a key once, so paste it before closing that dialog.

The Build voice agents with code page, with a Generate API key button and cards for Instant outbound, Batch outbound calling and Inbound deployments.Generate API key
This one page does two jobs: it mints your key, and it prints the campaign block you need in step 12.
A Create an API key dialog, warning that Voice Agents API keys are separate from Sarvam API keys and are not interchangeable.Create key, then copy it
Sarvam says it here too: this key is not a Sarvam API key. Copy it before you close this dialog.
Two kinds of key Sarvam says it plainly on that dialog: Voice Agents API keys are separate from Sarvam API keys and are not interchangeable. Svarloop needs the Voice Agents one, generated on this screen. Platform keys begin with sk_samvaad_.

11. Open Batch outbound calling

Still on Deploy with code, click the Batch outbound calling card, described as "Run outbound calling campaigns at scale".

The Deploy with APIs section showing an Instant outbound card and a Batch outbound calling card.Batch outbound calling
Batch outbound calling is the one Svarloop reads. Instant outbound places a single call and does not carry the fields Svarloop needs.

12. Fill in the quickstart, then copy the block

The quickstart panel on the left has four fields. Fill them in from the top down, because each one unlocks the next:

  1. Agent — the one you just created.
  2. Version — v1, or whichever version you committed.
  3. Connection — the telephony connection from step 6. If it says "No connections yet", go back and rent a number.
  4. Phone number — stays greyed out until a connection is chosen.

As you fill these in, the create-campaign code sample on the right rewrites itself with your real identifiers. Copy that entire block with the Copy button, not one line of it.

Batch outbound calling quickstart with no agent selected, showing No connections yet and a Set up a connection button.No number yet? Go back to step 6
This is what it looks like before a number exists. Copying now hands you a block with empty fields in it.
The same quickstart with an agent and version chosen, and the create-campaign code sample filled in on the right with a Copy button.Copy the whole block
With the fields filled in, the block on the right carries your real org, workspace, agent, version, connection and number.

13. Paste it into Svarloop

Back in Svarloop's Calling setup, paste the whole block into the code box. Svarloop reads it and fills in six fields for you: organisation ID, workspace ID, agent ID, agent version, connection ID, and phone number. You will see each one confirmed as it is found.

Click Save and Connect. That is the whole thing.

You are done

Your agent is configured and ready. From here everything happens inside Svarloop: find businesses, save them to a list, and call. You only need to come back to Sarvam to edit the agent itself, add a number, or top up credits.

Test it before you point it at real leads. Open your agent in Svarloop, use Send a test call to your own number, and hear it work. That costs one call and tells you more than any amount of reading.

Useful links

Stuck on any step? Email svarloop@s8n.in and tell us which number you are on.