Demo: 15-minute trial numbers

Demo numbers are the platform's "try it before you sign up" surface. A prospect clicks a button, gets called by your agent within seconds, hears the experience. No signup, no card, no friction.

When to use a demo number

For real production traffic you provision actual numbers — see Phone Numbers.

Getting a demo number

Copycurl -X POST https://api.call2me.app/v1/demo/call \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+905551234567",
    "name": "Ali"
  }'

The platform:

1. Picks an available number from the demo pool
2. Reserves it for 15 minutes
3. Places a call from that number to the phone you supplied
4. Routes the call through a default demo agent (Turkish + English)

The recipient's phone rings within seconds. The agent introduces itself, explains it's a demo, and runs through a short interactive script.

Limits & anti-abuse

To keep the pool fair:

• One call per phone_number per day — repeats return the same reservation if it's still active, otherwise refused
• 60-second cap — the call ends automatically; demos are designed to be short
• Per-IP rate limit — bursts are throttled at the edge

These limits don't apply to provisioned numbers on paid accounts.

Wiring it into your site

The pattern:

Copy<form onsubmit="callMe(event)">
  <input id="phone" placeholder="+90 555 ..." required />
  <button type="submit">Call me now</button>
</form>

<script>
async function callMe(e) {
  e.preventDefault();
  const phone = document.getElementById('phone').value;
  const r = await fetch('https://api.call2me.app/v1/demo/call', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ phone_number: phone })
  });
  if (r.ok) {
    alert('Your phone will ring in a few seconds.');
  } else {
    const err = await r.json();
    alert(err.error?.message ?? 'Try again in a moment.');
  }
}
</script>

That's the entire integration. The endpoint is rate-limited and self-protecting; you can ship it on a public page.

Demo agent customization

By default the demo agent runs the platform's standard introduction. If you want your own demo (different prompt, different voice, your brand), the dashboard's Demo → Agent page lets workspace admins override which agent the demo flow uses.

For a fully custom flow with no shared pool, mint your own agent and use the regular calls API (POST /v1/calls) — that's the production path.

What's next

• Quickstart — the post-demo signup flow
• Phone Numbers — provisioning real numbers
• Calls — the underlying API the demo uses