AI Caller help center
Setup guides and answers. Can't find something? Contact your account manager or the platform support email.
Getting started (5 minutes)
- Sign up — you get a starter agent “Riya” and free trial credit (after verifying your email).
- Open Agents → Riya. Change the greeting, instructions and business info, or pick a template. Upload your FAQ / price list under Knowledge documents.
- Click 🎙️ Start talking to talk to the agent from your browser — no phone line needed. Afterwards open the call to see transcript, AI summary and recording.
- Connect a phone line (see below) or ask your platform admin which lines are available, then use Test phone call.
- For bulk calling save your Contacts (or import a CSV), then create a Campaign and pick who to call. For your app, create an API key.
Use your landline (Airtel / BSNL / any phone line)
Your landline can make and receive AI calls through a small FXO gateway that turns the phone line into an internet (SIP) connection. One landline = one call at a time. For more parallel calls use a SIP trunk or Exotel.
You need
| Item | Why | Approx. |
| Grandstream HT813 (or HT503 / any FXO gateway) | Connects the phone line to the internet | ₹5,000–7,000 |
| RJ11 phone cable | Router/line PHONE port → gateway LINE (FXO) port | ₹100 |
| LAN cable + internet | Gateway → your router | ₹100 |
Step 1 — Dashboard
- Go to Integrations → Landline (FXO gateway), choose which agent answers incoming calls, click Create gateway login.
- Note the SIP server, User ID and Password shown (click “Show” for the password).
- Set your agent's Telephony to Landline / SIP trunk and save.
Step 2 — Wiring
- Phone cable from your router's PHONE / TEL port (or the wall socket) → gateway LINE (FXO) port.
- LAN cable from the gateway WAN port → your router.
- Find the gateway's IP in your router's device list and open it in a browser (default login is printed on the box).
Step 3 — Gateway settings (HT813 → FXO Port page)
| Setting | Value |
| Primary SIP Server | the SIP server from the dashboard |
| SIP User ID / Authenticate ID | the User ID from the dashboard |
| Authenticate Password | the Password from the dashboard |
| Stage Method (1/2) | 1 — dial the number straight on the line |
| Unconditional Call Forward to VoIP | User ID = s, server = the SIP server (incoming calls go to the AI) |
| Number of Rings | 1–2 |
| PSTN Disconnect Tone / Current Disconnect | On (otherwise the line can stay busy after a call) |
| DTMF Method | In-audio (needed for keypad OTP entry) |
| Caller ID Scheme / Use P-Asserted-Identity | Enable (so the caller's number shows in your call log) |
| Preferred Vocoder | PCMU, PCMA |
Step 4 — Test
- On the gateway's Status page the FXO port shows Registered. In the dashboard, Integrations → Landline → Test connection says “online”.
- Incoming: call your landline number from a mobile — the agent answers. The call appears under Calls with transcript, summary and recording.
- Outgoing: open the agent → Test phone call → enter your mobile number. Your mobile rings and shows your landline number.
Troubleshooting
- Not registered: re-check the 3 values; make sure the gateway has internet; the platform's SIP port (UDP 5060) must be reachable.
- One-way / no audio: enable NAT traversal = Keep-alive on the gateway; ask your admin to check the server's external IP setting.
- Line stays busy after calls: turn on PSTN disconnect detection (current or tone).
- Keypad digits not detected: set DTMF Method to In-audio.
Business SIP line (Airtel IQ, Tata Tele, Jio Business…)
- Get your assigned number, SBC/termination hostname, port, transport and inbound source addresses from the carrier. Confirm REGISTER, credentials without REGISTER or IP authentication. A purchased number or dashboard API token alone is not enough.
- The SIP integration includes official guides for Twilio Elastic SIP, Plivo Zentrunk, Telnyx, Airtel Business, Tata, JioBusiness, Vonage, SignalWire, DIDWW and Bandwidth. Native Twilio Programmable Voice and Exotel use their own integration cards.
- Enter them in Integrations → SIP trunk, pick the agent for incoming calls, Connect, then Test connection.
- Set your agent's Telephony to Landline / SIP trunk. Parallel calls = what your SIP plan allows (and your plan's call limit).
- For IP authentication, allowlist this server at the carrier and configure the carrier's approved inbound source addresses. Some business trunks need private carrier connectivity.
- A Saved integration is not a verified connection. Resolve any Asterisk apply warning, test the connection, then make an inbound and outbound test call for caller ID and two-way audio. The form supports UDP/TCP and G.711; TLS/SRTP or custom headers need additional setup.
- One SIP trunk and one inbound DID are configurable per customer. If both SIP and analog gateway integrations are enabled, outbound calls prefer SIP.
- For promotional calling, complete DLT registration with your provider and use their approved headers/numbers.
Exotel (Indian virtual numbers)
Option A — platform's Exotel: ask your admin to assign you an ExoPhone; then pick it as the agent's number.
Option B — your own Exotel account (Exotel bills you; we charge only the platform fee):
- In Exotel: complete KYC, buy an ExoPhone, and ask Exotel support to enable Voicebot / AgentStream (bidirectional streaming).
- From Exotel Settings → API copy Account SID, API key, API token and your cluster (
api.in.exotel.comfor Mumbai). - Enter them in Integrations → Exotel with your ExoPhone, Connect, Test connection.
- Incoming calls: click Show Voicebot applet URL, create an Exotel flow with the Voicebot applet using that URL, attach the flow to your ExoPhone.
- Set the agent's Telephony to Exotel and its number to your ExoPhone. Dial numbers as
98XXXXXXXX.
Plivo (Indian numbers, low cost)
- Sign up at Plivo, choose Build Your Voice Agent Programmatically → Custom stack, complete KYC and rent an Indian voice number.
- Copy the Auth ID and Auth Token from the Plivo console home page.
- Enter them with the number in Integrations → Plivo (format
+918012345678), Connect, Test. - For incoming calls: in Plivo → Voice → Applications create an XML application, set its Answer URL (POST) to the URL shown on the Integrations card, and attach your number to it.
- Set the agent's Telephony to Plivo with that number. Dial numbers like
+919876543210. A Plivo free trial can only call numbers you have verified with Plivo.
Twilio (international numbers)
- In Twilio buy a voice number and copy the Account SID and Auth Token.
- Enter them with the number in Integrations → Twilio (format
+14155550100), Connect, Test. - In Twilio → your number → Voice: “A call comes in” = the webhook URL shown on the Integrations card, “Call status changes” = the status URL.
- Set the agent's Telephony to Twilio with that number. Dial numbers in international format (
+919876543210). Calls to India from Twilio are international calls (higher cost).
Use your own AI keys
Optional. Add your own keys under Integrations → AI keys; your calls then use your accounts:
| Key | Used for | Get it at |
| Claude (Anthropic) | Understanding & replying, call summaries | console.anthropic.com |
| Deepgram | Speech-to-text | console.deepgram.com |
| Sarvam AI | Hindi / Indian-language voice | dashboard.sarvam.ai |
| Or: Azure Speech (key + region) | Speech-to-text and voice with one key, instead of Deepgram + Sarvam | portal.azure.com → Speech resource |
Keys are encrypted and never shown in full again. Leave a key empty to keep using the platform's.
Contacts, campaigns & CSV format
Save contacts on the Contacts page: add them one by one, or click Download template, fill it in Excel, save as CSV and import. Then create a campaign and tick the contacts to call (or add all).
CSV with a phone (or mobile) column. name and any other columns are given to the AI and can be used in the greeting as {name}, {order_id} …
phone,name,city,order_id 9876543210,Amit,Pune,A101 9123456780,Riya,Delhi,A102
- Invalid numbers are skipped; a number already in your contacts is updated, not duplicated. Numbers on your Do-Not-Call list are never called.
- Calls happen only inside the calling window (IST); unanswered numbers are retried after the retry gap.
- The campaign pauses itself with a reason if the wallet runs out or the phone line is down — fix it and click Resume.
- Export results (status, outcome, summary) as CSV any time.
Voice OTP
- Speak: the AI reads the code twice (press 1 to repeat); your app checks it with
POST /otp/verify. - Collect: show the code in your app; the AI calls and the user types it on the keypad (or says it). Result via webhook.
- Codes are stored hashed, expire in 5 minutes by default, max 3 attempts, max 3 OTP calls per number per 10 minutes. OTP calls are never recorded.
- Webhooks are signed with your account's secret (Settings → Webhook).
Recordings, transcripts & summaries
- Open any call under Calls: play/download the recording (customer on the left channel, AI on the right), read the transcript and the AI summary with outcome and lead score.
- Turn recording off under Settings → Call recording. Recordings are deleted automatically after the retention period; you can delete one any time.
- Tell callers the call may be recorded — e.g. add it to the agent's greeting.
Billing, plans & invoices
- Prepaid wallet: recharge with Razorpay (UPI, cards, netbanking). 18% GST is added and a GST invoice is issued — add your GSTIN under Billing → Invoice details.
- Monthly plans include minutes; after that calls are charged per started minute. Calls over your own Exotel/Twilio/SIP/landline are charged only the platform fee.
- Upgrades start immediately; downgrades at the end of the period. If the wallet can't pay a renewal, calls pause until you recharge (it then renews automatically).
API & webhooks (for developers)
Create a key under API keys and send it as Authorization: Bearer ak_…. Full interactive docs are at /docs on the API server.
curl -X POST https://api.yourdomain.com/calls \
-H "Authorization: Bearer ak_..." -H "Content-Type: application/json" \
-d '{"agent_id":"...","to_number":"9876543210","context":{"name":"Amit","order_id":"A101"}}'Webhook events: call.completed (transcript, summary, outcome, cost), campaign.completed. Verify X-AICaller-Signature = HMAC-SHA256 of the raw body with your webhook secret.
Team & security
- Roles: owner (everything), admin (everything except owners), viewer (read-only). Invites get a temporary password that must be changed at first login.
- Forgot your password? Use “Forgot password?” on the login page. Changing your password logs out your other devices; Settings → “Log out of all devices” does it on demand.
Acceptable use & compliance (India)
- Promotional calls need TRAI DLT registration (via your telecom provider), DND scrubbing and must be made between 9 am and 9 pm.
- Only call people who expect it or consented. Honour “don't call me” — the platform adds such numbers to your Do-Not-Call list automatically.
- Never use the AI to ask for bank/UPI PINs, passwords, card numbers or other companies' OTPs, or to impersonate banks, government or other businesses. Accounts that do are suspended.
- The AI introduces itself as an AI assistant.
Troubleshooting
| Message | What to do |
| “Wallet balance … Please recharge” / 402 | Recharge under Billing, or wait for plan minutes to renew. |
| “… isn't set up. Add your account under Integrations” | Connect that telephony in Integrations, or ask your admin. |
| “This caller ID isn't one of your numbers” | Use your own integration's number or one assigned to you by the admin. |
| “Your … plan allows N call(s) at a time” | Wait for calls to finish or upgrade your plan. |
| Campaign “Outside calling hours” | It resumes automatically inside the window. |
| Echo instead of an AI voice | No AI keys available — add them in Integrations or ask your admin. |