.png){kind=logo}
Introduction
vaaadai.com is an AI-powered calling agent platform for businesses, freelancers, and developers who want to automate voice-based outreach, customer interactions, and lead engagement.
This documentation covers:
- How to keep your AI agents running without bans or restrictions
- Ethical guidelines every user on this platform must follow
- How to complete your KYC verification using your PAN card
- Error codes, troubleshooting, and support contacts
Keeping Your AI Agents Restriction-Free & Ban-Free
Running AI calling agents without interruption requires following best practices. Violations can result in your agents being flagged, restricted, or permanently banned by telecom providers and regulatory authorities.
1. Stay Within Permitted Calling Hours
Only make outgoing calls within the government-approved marketing call window:
| Day | Allowed Window |
|---|---|
| Monday to Sunday | 9:00 AM to 9:00 PM IST |
Calls made outside this window are a direct violation of TRAI guidelines and can lead to immediate blacklisting of your number.
2. Respect Call Frequency Limits
Do not call the same number more than once per day if there is no response or the call is rejected. Repeated calls trigger spam detection and can result in:
- Your number being flagged as spam
- Carrier-level blocking of your agent's outbound lines
- Platform-level suspension of your account
3. Never Call DND / NDNC Numbers
The Do Not Disturb (DND) and National Do Not Call (NDNC) Registry lists are maintained by TRAI. Calling any registered number for promotional purposes is illegal in India.
- Scrub your contact list against the NDNC/DND registry
- Use Vaaad AI's built-in DND filter
- Keep records of your scrubbing process
4. Avoid Prohibited Content
Your AI agent must not promote or discuss:
- Fraudulent schemes or investment scams
- Illegal drugs or controlled substances
- Unlicensed financial services
- Any content illegal under Indian law
5. Use Verified Sender IDs
Your outbound caller ID must be registered with your telecom provider, associated with a verified business identity, and must never mask or spoof another number.
6. Monitor Agent Performance
Track these metrics to catch issues early:
- Call drop rates (high drops signal poor number health)
- Call rejection rates (pause campaigns if rejections exceed 30%)
- Spam reports (trigger an immediate review if any come in)
AI Ethics Guidelines
Using AI to interact with real people carries responsibility. These are not just suggestions; they define responsible AI deployment on our platform.
Disclose That the Caller Is AI
When your AI agent initiates a call, inform the person they're speaking with AI. Suggested phrase: “Hi, this is an automated AI assistant calling on behalf of [Your Business Name]...”
No Harmful or Illegal Content
| Prohibited Category | Examples |
|---|---|
| Financial Fraud | Ponzi schemes, fake investments, phishing |
| Illegal Substances | Drugs, narcotics, unlicensed pharma |
| Unlicensed Gambling | Illegal betting, offshore gambling |
| Misinformation | False health claims, political misinformation |
| Harassment | Threatening language, personal targeting |
No Spam Calling
If someone does not answer, rejects the call, or asks not to be called again, do not call them again on the same day. Calling 3-4 times in a single day is spam calling.
- Maximum 1 attempt per day per number
- Minimum 24-hour gap between retries
- After 2 rejections, remove the contact from your active campaign
KYC Verification
To activate your Vaaad AI account and access full platform features, complete KYC verification using your PAN card. PAN verification is instant and unlocks outbound calling, campaigns, and phone number purchase.
What You Need
| Document | Details |
|---|---|
| PAN Card | 10-character alphanumeric PAN (e.g. ABCDE1234F). Must match your registered name. |
PAN verification runs against government records instantly. No document upload is required.
Step-by-Step
- Go to Settings: Settings > KYC Verification
- Enter your PAN: type your 10-character PAN in the format
ABCDE1234F - Submit for verification: click Verify PAN
- Confirmation: verification is instant and your account is unlocked immediately on success
If verification fails, check for spaces or lowercase letters in the PAN. Persistent failures may mean the PAN is not yet in government records. Contact support if this happens.
Error Codes
These are the real error codes and messages returned by the Vaaad AI platform. Campaign errors appear in the campaign run panel. Call errors appear in the Calls log.
Account and Wallet Errors
| Code / Message | What it means | How to fix it |
|---|---|---|
Insufficient wallet balance | Wallet is below ₹5, which is the minimum needed to initiate any call | Top up your wallet in Settings > Billing |
low_wallet | Wallet is below ₹20. Campaigns need at least ₹20 to start | Add at least ₹20 before launching a campaign |
insufficient_wallet | Wallet balance is too low for even one call at the current rate (₹5/min) | Top up wallet in Settings > Billing |
low_wallet_paused | A running campaign was auto-paused because the wallet dropped below ₹20 | Top up wallet and re-launch the campaign |
inbound_budget_exhausted | Your dedicated inbound budget is empty, so inbound calls are not being accepted | Recharge your inbound budget in Settings > Billing |
insufficient_main_wallet | No dedicated inbound budget is set, and the main wallet is too low for inbound calls (minimum ₹8) | Top up your main wallet to at least ₹8 |
Your free trial has ended | Trial is over and no phone number is assigned to your account | Purchase a number in Settings > Phone Numbers |
Agent and Campaign Errors
| Code | What it means | How to fix it |
|---|---|---|
agent_not_active | The agent linked to this campaign is not active | Open the Agents page, find the agent, and set its status to Active |
agent_no_system_prompt | The agent has no system prompt. Calls cannot be made without one | Edit the agent and add a system prompt before running the campaign |
campaign_not_running | Campaign is not in running status | Click Launch on the campaign first, then use Run Now |
outside_calling_window | Current time is outside the campaign's configured calling window | Adjust the campaign's calling hours, or wait for the 9 AM to 9 PM IST window |
inactive_day | Today is not in the campaign's active days | Update the campaign's active days to include today |
not_started_yet | Campaign start date has not been reached yet | Wait for the start date, or edit the campaign and set an earlier start date |
end_date_passed | Campaign end date has already passed | Edit the campaign and extend or remove the end date |
daily_limit_reached | The campaign's daily call limit has been hit for today | Wait until tomorrow, or increase the daily limit in campaign settings |
no_pending_contacts | All contacts in the campaign have already been called | Add new contacts to the campaign or reset contact statuses |
concurrency_cap_reached | All concurrent call slots are full | Wait for an active call to finish, or reduce the concurrency limit in campaign settings |
user_not_onboarded | Account onboarding is not complete | Finish the onboarding steps in Settings or contact support |
no_sip_trunk | No phone trunk is configured, so outbound calls cannot be made | Purchase a phone number in Settings > Phone Numbers |
Validation and Input Errors
| Message | What it means | How to fix it |
|---|---|---|
Invalid phone number use international format e.g. +919876543210 | Phone number is not in E.164 format | Use the format +919876543210 (country code followed by number, no spaces or dashes) |
Invalid PAN format. Example: ABCDE1234F | PAN does not match the required pattern | PAN must be exactly 10 characters: 5 uppercase letters, 4 digits, 1 letter |
A contact with this phone number already exists | A duplicate contact is being added to the same list | Check your list for duplicates before importing |
You already own this number | The phone number you are trying to buy is already on your account | Check Phone Numbers to see your existing numbers |
Rate Limit and System Errors
| Status / Message | What it means | How to fix it |
|---|---|---|
429 Too Many Requests | More than 5 outbound calls were dispatched per minute from your account | Use campaign mode for bulk calling instead of triggering calls manually in quick succession |
Payment verification failed | Razorpay payment signature did not verify. The payment did not complete | Retry with the same or a different payment method. Contact support if it keeps failing |
500 Internal Server Error | An unexpected error occurred on the server | Retry the action. If it keeps happening, contact support@vaaadai.com with the time and what you were doing |
Troubleshooting
Campaign shows agent_not_active or agent_no_system_prompt
- Go to the Agents page and open the agent linked to the campaign
- Set the agent status to Active
- Make sure the System Prompt field is filled in. An empty prompt blocks all calls
Campaign keeps showing outside_calling_window
- Vaaad AI blocks calls outside the 9 AM to 9 PM IST window regardless of campaign settings
- Open campaign settings and confirm the Calling Hours are within 9 AM to 9 PM IST
- The server uses IST. Your local timezone does not affect the check
Call drops immediately after connecting
- Check that the agent's initial greeting is not too long (over 15 seconds can trigger carrier drops)
- Verify the caller ID is your registered Vaaad AI phone number. Unregistered numbers get rejected
- Test with a different recipient number to rule out a number-specific block
Agent responds in the wrong language
- Check the Language and Voice settings in the agent config
- For Hinglish, write the greeting in transliterated text. Devanagari script in the system prompt will cause issues
KB documents not being used
- Uploading a document to the Knowledge Base does not attach it to an agent. You need to link it in the agent's settings separately
- Scanned PDFs need OCR processing first. Plain image PDFs are not searchable
- Test with specific direct questions. Vague queries may not retrieve relevant content
Transfer not working
- Make sure the transfer number includes the country code:
+91XXXXXXXXXX - Test with common trigger phrases like “transfer me” or “connect me to an agent”
- Confirm the destination phone is not on DND
Wallet top-up not reflecting
- Successful Razorpay payments update your wallet immediately. Refresh Settings > Billing to check
- If the payment went through but the balance did not change, the signature verification may have failed. Contact support with your Razorpay order ID
Recordings not playing
- Wait 30 to 60 seconds after the call ends. Recording upload happens after the call closes
- Try Chrome if another browser is not playing it
- Contact support if the recording shows as failed in the Calls log
Wallet and Rates
Vaaad AI uses a prepaid wallet. Calls are billed per minute at a flat rate.
| Item | Rate / Threshold |
|---|---|
| Calling rate | ₹5 per minute (outbound and inbound) |
| Minimum balance to start a call | ₹5 |
| Minimum balance to run a campaign | ₹20 (campaigns auto-pause if balance drops below this) |
| Minimum inbound budget for a new call | ₹7.50 (1.5x buffer applied automatically) |
If a campaign drops below ₹20 mid-run, it will be auto-paused with the
low_wallet_paused error. Top up and re-launch to resume.Support
- Email: support@vaaadai.com
- Response time: 4-6 hours (Pro users get 1-2 hour priority response)
- Docs: you're here
- Blog: Updates and tutorials
© 2026 vaaadai.com. All rights reserved. Documentation is subject to change.