📖 Guides

Phone numbers & calling

Get a number, connect it to your AI agent, take calls, place a test call and run a call campaign — step by step, with a picture of every screen.

The pictures are drawings of the real screens, with the same labels and buttons. Numbers and names in them are examples. The 1 rings show what to click, in the order of the numbered steps beside them.

Start here

How calling works

A phone call reaches your AI agent through a phone number. With a Smoothflick number everything between the number and the agent is set up for you. With your own Twilio or Vobiz number, you create the connection — called a SIP trunk — yourself.

Smoothflick number — Voice Agent and Workflow Agent

Caller's phone

anywhere in India

⇄

Your Smoothflick number

bought in Telephony

set up for you⇄

Your AI agent

answers or calls out

No trunk to create. The moment you connect a number to an agent, the trunks and call routing are created for you.

Your own carrier — Twilio or Vobiz (Classic workflows)

Caller's phone

⇄

Your Twilio / Vobiz number

bought from the carrier

SIP trunk you create⇄

Your classic workflow

answers or calls out

You bring the number, and create the inbound and outbound trunks yourself from the workflow's Call Options.

Inbound

Someone calls your number and the agent answers.

Outbound

The agent calls one person — a test call, or a single follow-up.

Campaign

The agent calls every row of a Google Sheet, several calls at a time.

Voice Agent and Workflow Agent

Before you start: wallet, verification and a number

Done once per account, in Telephony on the left menu. Both the Voice Agent and the Workflow Agent use the numbers you buy here. Using your own Twilio or Vobiz number instead? Skip to Twilio / Vobiz trunks.
1

Add money to your wallet

Telephony → Wallet & Recharge

  1. 1Open Telephony and choose Wallet & Recharge.
  2. 2Enter the amount to add.
  3. 3Press Add money and pay in the window that opens.

Your number’s rent, call minutes and the AI agent are all paid from this balance. Each call is charged in three parts: Telephone (carrying the call), Voice class (your agent’s category — Basic, Standard, Premium or Ultra Premium) and Prompt range (per 10,000 characters of instructions).

smoothflick.com/telephony

Wallet & Recharge

Numbers, call minutes and the AI agent are all charged from this balance.

Telephone

₹ —

Carrying calls

Voice class

₹ —

Agent category

Prompt range

₹ —

Per 10k characters

Recharge amount

₹ 500
2
Add money3
2

Verify your account

Telephony → Verification

  1. 1Choose Verification.
  2. 2Fill in your Full legal name and Registered address, and attach your documents.
  3. 3Press Submit for verification.

Phone numbers in India must be issued to a verified person or business. Until your documents are approved you cannot buy a number. The status is shown on this screen and on the Telephony Overview.

smoothflick.com/telephony

Verification

Until your documents are approved, you cannot buy a number.

Full legal name

As on your ID

Registered address

Street, city, PIN
2
📎 ID proof · address proof (PDF or photo)
Not submittedSubmit for verification3
3

Buy a phone number

Telephony → Phone Number Marketplace

  1. 1Choose Phone Number Marketplace.
  2. 2Filter by region if you want a local number.
  3. 3Press Buy next to the number you want.

The setup fee and the monthly rent are shown at the top before you buy, and taken from your wallet.

smoothflick.com/telephony

Phone Number Marketplace

₹ setup + ₹ a month · charged today

All regions ▾2
+91 80 •••• 1201Buy3
+91 80 •••• 4417Buy
+91 22 •••• 0932Buy
4

Find your number

Telephony → My Phone Numbers

  1. 1Choose My Phone Numbers to see every number you own, its renewal date and monthly rent.
  2. 2The AI agent choice here connects a Voice Agent quickly. The full controls are in Connect AI Agent (next section).
  3. 3The bin icon releases the number. This cannot be undone — someone else can take it.

No trunk is needed for a Smoothflick number. Leave Trunk on — none —: connecting the number to an agent creates the trunks and routing automatically.

smoothflick.com/telephony

My Phone Numbers

Attach a trunk, point it at an agent, or release it.

+91 80 •••• 1201renews in 30 days · ₹/mo3
Trunk — none —AI agent Receptionist ▾2

Voice Agent

Connect a number to a Voice Agent

Voice agents are built under Voice Agent on the left menu and connected to numbers on the Telephony page.
V1

Build or open your agent

Left menu → Voice Agent

  1. 1Open Voice Agent.
  2. 2Open an agent, or describe a new one and create it. Write its instructions and press Save.

Calls always run the saved version of the agent.

smoothflick.com/voice-agent
1

Voice Agent

+ Create from scratch
Build a voice agent that answers customer calls…

Receptionist

Edited today

2

Lead callback

Edited yesterday

V2

Connect the number

Telephony → Connect AI Agent

  1. 1Open Telephony and choose Connect AI Agent.
  2. 2Answers incoming calls — the agent that picks up when someone calls this number.
  3. 3Calls out as this number — the agent that test calls and campaigns use when calling from this number. It can be a different agent.
  4. 4Wait for the green routed — can take calls badge. That is the trunk and routing being created for you.

To take a number off an agent, set both choices back to — none —.

smoothflick.com/telephony

Connect AI Agent

Pick which voice agent answers a number, and which one it calls out as. They can be different.

+91 80 •••• 1201routed — can take calls4
Answers incoming callsReceptionist ▾
2
Calls out as this numberLead callback ▾
3
V3

Receive a call (inbound)

Call your Smoothflick number from any phone. The agent chosen in Answers incoming calls picks up and speaks its greeting. Nothing else to set up.

V4

Place a test call (outbound)

Voice Agent editor → Test agent → Phone

  1. 1In the agent editor, press Test agent (top right).
  2. 2Choose Phone. (Voice talks through your browser, Chat is typed — neither needs a number.)
  3. 3Enter the number to call, with the country code: +91…
  4. 4Press Start Call. Your phone rings within a few seconds.
smoothflick.com/voice-agent/editor/…
← Receptionist▶ Test agent1
Instructions
Variables
Tools
Settings
Automated tests
Start campaign

Test Agent

VoiceChatPhone2

Number to call

+91 98•• ••••10
3
Start Call4
V5

Attach the sheet for a campaign

Voice Agent editor → Tools

  1. 1Open Tools.
  2. 2Press Attach a Google Sheet, sign in to Google if asked, and pick the spreadsheet and tab.

Under Variables, map the sheet’s columns to the agent’s inputs (for example name ← Name) and outputs. Inputs fill {{name}} in the greeting; outputs are written back into the same contact’s row after the call.

smoothflick.com/voice-agent/editor/…
← Receptionist▶ Test agent
Instructions
Variables
Tools1
Settings
Automated tests
Start campaign

Tools

What the agent can do mid-call.

Attach a Google Sheet — read inputs from a row, write outputs back
2

Spreadsheet

Leads — November · Sheet1

Columns: Name · Phone · City · Interest

V6

Start the campaign

Voice Agent editor → Start campaign

  1. 1Open Start campaign. The sheet’s columns and first rows are shown so you can check them.
  2. 2Pick the column under Number to dial.
  3. 3Check the count — rows without a number are skipped — and press Start campaign.
smoothflick.com/voice-agent/editor/…
← Receptionist▶ Test agent
Instructions
Variables
Tools
Settings
Automated tests
Start campaign1

Start campaign

Number to dialPhone ▾2
#NamePhone · dialCity
2Amit98•• ••••21Jaipur
3Neha99•• ••••05Pune
4Ravi97•• ••••88Indore
3 contacts will be called Start campaign3
V7

Watch it run, cancel any time

  1. 1Up to 3 calls run at once. As each call ends the next contact is rung, until every row has been tried. Each row shows Ringing, In call, Completed, No answer or Failed.
  2. 2Cancel campaign stops new calls immediately. Calls already in progress finish normally.

New calls are placed only while this page is open. Closing it pauses the campaign where it is; open it again and press Resume.

smoothflick.com/voice-agent/editor/…
← Receptionist▶ Test agent
Instructions
Variables
Tools
Settings
Automated tests
Start campaign
3 of 3 lines in use Cancel campaign2

Contacts

40

On the line

3

Completed

12

No answer

4

Failed

1

Waiting

20

1
Row 14Ringing
Row 15In call
Row 13Completed
Row 12No answer

Workflow Agent

Connect a number to a Workflow Agent

Workflow agents are built in Business Suite → Workflows. They use the same Smoothflick numbers, but are connected from inside the agent, not from the Telephony page. Do Before you start first.
W1

Open your workflow agent

Business Suite → Workflows

  1. 1Open Business Suite on the left menu.
  2. 2Choose the Workflows tile.
  3. 3Open an agent, or press Create from scratch. Write its instructions and press Save.
smoothflick.com/suite
1

Business Suite

Template

Workflows

2

Scheduler

Configuration

Workflow AgentClassic workflows+ Create from scratch3
W2

Connect the number

Workflow Agent editor → Phone number

  1. 1Open the Phone number section. Every number you own is listed.
  2. 2Turn on Answer calls for inbound, Call out for test calls and campaigns, or both.
  3. 3The number shows Connected to this agent. The trunk and routing are created for you.

Badges: Free — not in use. On another workflow agent — turning a switch on moves it to this one. On a voice agent — see the next step.

smoothflick.com/workflow-agent/editor/…
← Receptionist▶ Test agent
Instructions
Variables
Tools
Settings
Automated tests
Phone number1
Start campaign

Phone number

Choose which of your Smoothflick numbers this agent answers, and which it calls out from.

+91 80 •••• 4417Connected to this agent3
Answer calls
Call out
2
+91 22 •••• 0932Free
Answer calls
Call out
W3

If the number is on a voice agent

  1. 1A number serves one editor at a time. To use it here, go to Telephony → Connect AI Agent, set both choices for that number to — none —, then come back and switch it on.

Buying a second number is the easy way to keep one for each.

smoothflick.com/workflow-agent/editor/…
← Receptionist▶ Test agent
Instructions
Variables
Tools
Settings
Automated tests
Phone number
Start campaign

Phone number

+91 80 •••• 1201On a voice agent1

This number is connected to a voice agent. A number serves one editor at a time — disconnect it under Telephony → Connect AI Agent to use it here.

W4

Receive and place calls

Workflow Agent editor → Test agent → Phone

Inbound: call the number — the agent with Answer calls on picks up.

  1. 1Outbound: press Test agent.
  2. 2Choose Phone.
  3. 3Enter the number with its country code.
  4. 4Press Start Call. The call goes out from a number with Call out on.
smoothflick.com/workflow-agent/editor/…
← Receptionist▶ Test agent1
Instructions
Variables
Tools
Settings
Automated tests
Phone number
Start campaign

Test Agent

VoiceChatPhone2

Number to call

+91 98•• ••••10
3
Start Call4
W5

Run a campaign

Workflow Agent editor → Tools, then Start campaign

Exactly as for a voice agent: attach the Google Sheet under Tools, map columns under Variables, then in Start campaign pick Number to dial and press Start campaign (steps V5–V7). Up to 3 calls run at once, and you can cancel at any moment.

smoothflick.com/workflow-agent/editor/…
← Receptionist▶ Test agent
Instructions
Variables
Tools
Settings
Automated tests
Phone number
Start campaign1

Start campaign

Number to dialPhone ▾2
#NamePhone · dialCity
2Amit98•• ••••21Jaipur
3Neha99•• ••••05Pune
4Ravi97•• ••••88Indore
3 contacts will be called Start campaign3

Twilio and Vobiz numbers are coming to the Workflow Agent. Until then, calls on your own carrier run from Classic workflows, below.

Classic workflows · your own carrier

Create Twilio / Vobiz trunks and place calls

Already have a number with Twilio or Vobiz? Connect it to a classic workflow by creating trunks — an inbound trunk to receive calls and an outbound trunk to place them. Calls are billed by your carrier.
C1

Open the call options

Business Suite → Workflows → Classic workflows → open a workflow

  1. 1In the workflow editor, press 📞 Start Call (top right). The Call Options screen opens with two groups: Configuration (create trunks) and Execution (place calls).
smoothflick.com/workflows/editor/…
Support line workflow💬 Open Chat📞 Start Call1📤 Outbound
Start
Agent
Summary
C2

Vobiz — receive calls (inbound trunk)

Call Options → Configure · Vobiz → Inbound

  1. 1Choose Configure · Vobiz, then 📥 Inbound (receive calls).
  2. 2Enter your Auth ID and Auth Token (Vobiz console → API credentials) and a Trunk Name. Press Validate & Continue.
  3. 3Pick the Vobiz number to receive calls on and press Connect inbound trunk.

The trunk, the link from Vobiz to us and the call routing are all created in this one step. No numbers listed? Buy a number (DID) in your Vobiz console first.

Call Options → Configure · Vobiz → Inbound

🇮🇳 Vobiz (India) Setup

📥 Inbound (receive calls)1📤 Outbound (place calls)

Auth ID

MA_XXXXXXXX

Auth Token

••••••••

Trunk Name

smoothflick-vobiz
2
Validate & Continue

Select a Vobiz number to receive calls on:

◉ +91 80 •••• 7329

Connect inbound trunk3
C3

Vobiz — place calls (outbound trunk)

Call Options → Configure · Vobiz → Outbound

  1. 1Choose 📤 Outbound (place calls) and copy the details from Vobiz console → SIP Trunk → your outbound trunk → Authentication & Linking: SIP Domain, SIP Username, SIP Password, and your Caller-ID Number in +91… form.
  2. 2Press Create outbound trunk.
Call Options → Configure · Vobiz → Outbound

🇮🇳 Vobiz (India) Setup

From your Vobiz console → SIP Trunk → your outbound trunk → Authentication & Linking.

Trunk Name

smoothflick-vobiz

SIP Domain

xxxxxxxx.sip.vobiz.ai

SIP Username

your-username

SIP Password

••••••••

Caller-ID Number (E.164)

+91 80 •••• 7329
1
Create outbound trunk2
C4

Twilio — inbound or outbound trunk

Call Options → Configure · Twilio

  1. 1Choose Inbound or Outbound, then enter your Twilio Account SID, Twilio Auth Token (console.twilio.com → Dashboard) and a Trunk Name. The screen then walks you through choosing or creating the Twilio trunk, its origination URL, your Twilio number, the allowed numbers and the trunk on our side.

Outbound with Twilio needs two settings in the Twilio Console as well: a Credential List (Voice → Credential lists) attached under Termination → Authentication, and the trunk’s Termination SIP URI. The setup screen shows the exact username, password and URI to use — the trunk will not work until both are saved.

Call Options → Configure · Twilio

Twilio Integration Setup

1. Select Connection Type2. Twilio Credentials3. Select Trunk Option4. Origination URL5. Select Phone Number6. Allowed Mobile Numbers7. LiveKit Configuration

Twilio Account SID *

ACxxxxxxxx…

Twilio Auth Token *

••••••••

Trunk Name *

My Twilio Trunk
1
Outbound only: in the Twilio Console add a Credential List and set the trunk's Termination SIP URI — the screen shows the exact values.
C5

Place a single call

Call Options → Initiate Call

  1. 1Choose Initiate Call and pick the Outbound Trunk.
  2. 2Enter the Destination Number (E.164) — country code first, e.g. +9198…
  3. 3Press 📞 Place Call.
Call Options → Initiate Call

📞 Initiate Outbound Call

Outbound Trunk

smoothflick-vobiz ▾
1

Destination Number (E.164)

+91 98•• ••••10
2
📞 Place Call3
C6

Run a campaign from a sheet

Call Options → Outbound Campaign (or 📤 Outbound in the toolbar)

  1. 11. Attach Google Sheet — pick the spreadsheet and its tab.
  2. 22. Select Outbound Trunk — the trunk created in C3 or C4.
  3. 33. Contacts — call ⚡ All at once, 🔄 One by one, or only the ☑️ Selected rows, then start.
Call Options → Outbound Campaign

1. Attach Google Sheet

Leads — November · Sheet tab: Sheet1

1

2. Select Outbound Trunk

◉ smoothflick-vobiz · +91 80 •••• 7329

2

3. Contacts (3)

⚡ All at once🔄 One by one☑️ Selected
3
C7

See or remove your trunks

Configuration → Settings → Trunks & SIP

  1. 1Every trunk you have created is listed under Trunks & SIP, with its carrier and direction. The bin icon deletes one — calls using it stop working.
smoothflick.com/settings?tab=trunks
📋 Workflows📞 Trunks & SIP1🔀 Dispatch Rules💳 Billing

Trunks & SIP

smoothflick-vobizvobizoutbound
My Twilio Trunktwilioinbound
Workflow editor → 📞 Start Call

📞 Call Options

⚙️ Configuration

⚙️

Configure · Twilio

Set up Twilio / LiveKit inbound & outbound trunks

🇮🇳

Configure · Vobiz

India SIP carrier — inbound & outbound via LiveKit

📞 Execution

📞

Initiate Call

Place an outbound call using a configured trunk

📤

Outbound Campaign

Bulk-call contacts from a Google Sheet

2

The Call Options screen: create trunks under Configuration, place calls under Execution.

Voice Agent and Workflow Agent

After the call: history, recordings and charges

Every call on a Smoothflick number appears in Telephony.
A1

Call history and recordings

Telephony → Call History · Call Recordings

  1. 1Call History lists every call with its length and its three charges. Call Recordings shows the ones with audio you can play.
  2. 2Record my calls turns recording on or off. It applies to calls made after the change.

Usage & Billing totals your minutes and spending. A call of any answered length bills at least one minute; 61 seconds bills two. On a campaign, the results the agent collects are written back into that contact’s row of your Google Sheet.

smoothflick.com/telephony
Record my calls2
WhenFromSecsPhoneVoicePromptTotal
10:4298••10184₹₹₹₹
10:3197••8861₹₹₹₹

Each call shows its three charges: Phone (carrying the call), Voice (agent category) and Prompt (prompt length).

Help

If something goes wrong

The message you see on screen, and what to do about it.

“Not enough balance to start a call — top up your telephony wallet”

Add money under Telephony → Wallet & Recharge. A call needs at least one minute of balance before it is dialled; a campaign pauses by itself when the wallet runs low and waits for Resume.

“… has not approved this account’s KYC yet”

Your verification is still being reviewed. Check Telephony → Verification; numbers can be bought and called from only after approval.

“not routed yet — pick an agent below”

The number is yours but no agent answers it. In Telephony → Connect AI Agent, choose an agent for Answers incoming calls and/or Calls out as this number.

“You need your own phone number connected to an agent before you can call out”

Voice Agent: connect a number in Telephony → Connect AI Agent first (step V2).

“Connect a phone number to this agent first: open the Phone number section and switch on “Call out””

Workflow Agent: open the agent’s Phone number section and turn on Call out for one of your numbers (step W2).

“… is connected to a voice agent … one number can serve only one editor”

A number works for the Voice Agent or the Workflow Agent, not both. Free it in Telephony → Connect AI Agent by setting both choices to — none —, then connect it in the workflow agent.

“Attach a Google Sheet under Tools first”

A campaign calls the numbers in a sheet. Add one in the agent’s Tools section, then come back to Start campaign.

“Rows “have no number … and will be skipped””

Those rows are empty in the column picked as Number to dial. Pick the right column, or fill the numbers in the sheet and press Reload sheet.

“A campaign is already running for this agent”

Only one campaign runs per agent. Open Start campaign — it shows the running one — and finish or cancel it first.

“No outbound trunks configured for this workflow / No outbound trunks found”

Classic workflows: create an outbound trunk first with Configure · Twilio or Configure · Vobiz (steps C2–C4).

“KYC pending (calls may be limited until Vobiz verifies)”

Your Vobiz account itself is still under Vobiz’s review. Finish it in the Vobiz console.

Ready to make your first call?

Start with a number, then connect it to your agent.

Phone numbers & calling guide | Smoothflick