Skip to main content

Documentation Index

Fetch the complete documentation index at: https://documentation.uponai.com/llms.txt

Use this file to discover all available pages before exploring further.

Abuse can result in unexpected charges, degraded service, and account suspension. This page covers common abuse scenarios and how to prevent them.

Common Abuse Scenarios

ScenarioDescription
IRSF (International Revenue Sharing Fraud)Attackers trigger calls to premium international numbers to generate fraudulent revenue
Excessive outbound to non-US numbersHigh-volume outbound calls to international numbers drive up your telephony costs
SMS abuseUnauthorized SMS sending from your numbers or agents
Inbound spamBots or bad actors flood your inbound number with unwanted calls
Chat bot abuseAutomated scripts hit your web call or chat endpoints to consume LLM credits

Core Prevention Rules

1

Never expose your API key publicly

Your UponAI API key has full account access. Never include it in frontend code, public repos, or client-side apps.
  • Use your public key for any frontend or client-side integrations
  • Keep your private API key server-side only
  • If your key is exposed, rotate it immediately in the dashboard
2

Use reCAPTCHA on web-facing endpoints

Any public-facing endpoint that can initiate a call or send an SMS should be protected with reCAPTCHA or equivalent bot detection.
3

Limit regions and features

Restrict outbound calls to regions you actually operate in. Disable international calling if you don’t need it — this is your primary defense against IRSF.
4

Apply rate limiting

Implement rate limiting on your backend before calls reach UponAI. Limit by IP address, phone number, or user account.
5

Use KYC for high-risk flows

For flows that allow users to initiate calls or SMS, require identity verification (KYC) before enabling access.
6

Detect abuse in your prompts

Add instructions to your agent prompts to detect and end calls that appear abusive, spammy, or off-topic.

Protecting Outbound Calling

Choose one of the following approaches:
Route all outbound call initiation through your own backend. Your backend authenticates the user, validates the destination, and only then calls the UponAI API.This is the most secure option — your API key never leaves your server.

Protecting Inbound Calls

Use inbound webhooks to validate and block unwanted callers before they reach your agent. Your webhook receives the caller’s phone number before the call connects. Return a rejection response to block the call. See Inbound Call Webhook for implementation details.

Monitoring for Abuse

  • Review your Analytics Dashboard regularly for unusual call volume spikes
  • Set up Alerting to notify you when concurrency or call counts exceed expected thresholds
  • Check call logs for repeated short calls, which may indicate probing or automated abuse
For additional fraud protection features including rate limiting by IP/phone number and geographic restrictions per phone number, see Fraud Protection.