Phone Number

Configure a Plivo phone number to receive calls and route them to a voice agent.

Prerequisites

• A Plivo account with at least one purchased phone number
• Plivo Auth ID and Auth Token (from your Plivo console)

---

What is Plivo?

Plivo is the telephony provider Swiftsell uses for AI voice agent calls. When a caller dials your Plivo number, Plivo routes the call to Swiftsell, which hands it off to the configured voice agent.

---

Step 1 — Get your Plivo credentials

1. Log in to your Plivo Console.
2. On the dashboard, note your Auth ID and Auth Token.
3. Go to Phone Numbers in the console and note the phone number you want to use (in E.164 format, e.g., [phone]).

---

Step 2 — Add the phone number to Swiftsell

1. In Swiftsell, go to Settings → Phone Number.
2. Click Add Phone Number.
3. Enter:
   • Plivo Auth ID
   • Plivo Auth Token
   • Phone Number (E.164 format)
4. Click Save.

---

Step 3 — Configure the Plivo webhook

For Plivo to route incoming calls to Swiftsell, you need to set the answer URL in Plivo.

1. In the Plivo Console, go to Phone Numbers → Your Numbers.
2. Click on the phone number you’re configuring.
3. Under Inbound Call Settings, set the Answer URL to the webhook URL shown in Swiftsell (Settings → Phone Number → Webhook URL).
4. Set the method to POST.
5. Save the changes in Plivo.

---

Step 4 — Assign to a voice agent

After the phone number is saved in Swiftsell, assign it to a voice agent:

1. Go to Voice Agents and open (or create) the agent that should handle calls from this number.
2. In the agent’s configuration, select the phone number from the Phone Number dropdown.
3. Save the agent.

Incoming calls to that number now route to the selected agent.

---

Managing multiple numbers

You can add multiple Plivo phone numbers to Swiftsell — each with its own Plivo credentials if they’re on different Plivo accounts. Each number is assigned to one voice agent at a time.

---

Troubleshooting

Problem	Check
Calls not reaching the agent	Confirm the Answer URL in Plivo matches the webhook URL in Swiftsell
Authentication errors	Verify the Auth ID and Auth Token are correct
Agent not responding	Confirm a voice agent is assigned to the phone number
Poor audio quality	This is typically a Plivo infrastructure issue — check Plivo’s status page

---

Related pages

• Voice Agents Overview — understand the full call flow
• Create a Voice Agent — set up an agent to handle calls