Quickstart — Samwad Docs

What is Samwad

Samwad is a voice AI agent platform. You describe how a conversation should go, and an agent handles inbound and outbound phone calls for you — answering questions, qualifying leads, booking appointments, or routing to a human, in Hindi, English, or code-mixed conversation.

This guide gets your first agent live. For a deeper look at scripting and knowledge bases, see Building an Agent.

Prerequisites

A Samwad account — sign up from the dashboard.
A business phone number you want the agent to use, or a new number provisioned through Samwad.
Basic idea of what the agent should say and do — even a rough script is enough to start.

Create your first agent

1

Open the agent builder

From the dashboard, go to Agents → New Agent.

2

Pick a starting point

Give it a name and pick a starting template close to your use case (support, sales, appointments) — or start from blank.

3

Write the script

Write the opening line and a few core instructions in the script editor. Keep the first version simple; you can refine tone and edge cases after your first test calls.

4

Choose voice & language

Select the voice and language — Hindi, English, or code-mixed.

Start narrow. An agent that handles one job well (e.g. booking a demo) beats one trying to do everything on day one.

Connect a phone number

Under Numbers, either port an existing business number or provision a new one. Assign the number to the agent you just created, and set whether it handles inbound calls, outbound campaigns, or both.

If you're porting an existing number, keep it active on your current provider until Samwad confirms the port is complete — this can take a few business days depending on your carrier.

Test your agent

Use the built-in test call from the agent editor to talk to your agent before it goes live. You can also trigger a test call via the API:

cURL

curl -X POST https://api.samwad.ai/v1/calls \
  -H "Authorization: Bearer $SAMWAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agt_123",
    "to": "+919876543210",
    "test": true
  }'

Listen for natural pacing, correct handling of interruptions, and whether it sticks to the script under off-topic questions. Iterate on the script until it feels right, then flip the agent to Live.

Next steps

Building an Agent

Knowledge bases, call flow, and voice tuning in depth.

Integrations

Connect your CRM, calendar, and webhooks.

API Reference

Automate agent and call management.