---
title: "Ask the demo to call"
description: "The website's \"Llámame\": the demo agent calls the visitor's phone from\nQomni's demo number, in test mode, for at most `max_duration_seconds`.\nNo key: Cloudflare Turnstile proves a person asked (`turnstile_token`),\nand the limits are the demo session's per IP plus one call per number\na day and the same daily budget. Only numbers of Colombia, Mexico,\nBrazil and the US/Canada (`+57`, `+52`, `+55`, `+1`).\n"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.qomni.ai/llms.txt
> Use this file to discover all available pages before exploring further.

Path: Qomni Agents API › Realtime

`POST /demo_calls`

The website's "Llámame": the demo agent calls the visitor's phone from
Qomni's demo number, in test mode, for at most `max_duration_seconds`.
No key: Cloudflare Turnstile proves a person asked (`turnstile_token`),
and the limits are the demo session's per IP plus one call per number
a day and the same daily budget. Only numbers of Colombia, Mexico,
Brazil and the US/Canada (`+57`, `+52`, `+55`, `+1`).

## Request body

_Required._

- `phone` (`createDemoCall.phone`; string, required) — The number to call, E.164.
  - pattern `^\+(57|52|55|1)[0-9]{7,12}$`
- `turnstile_token` (`createDemoCall.turnstile_token`; string, required) — The token Cloudflare Turnstile gave the website's form.
  - maxLength 2048
- `name` (`createDemoCall.name`; string, optional) — How the agent greets the person; optional.
  - maxLength 80
- `language` (`createDemoCall.language`; string, optional)
  - one of `"es"`, `"en"`, `"pt-br"`; default `"en"`
- `agent` (`createDemoCall.agent`; string, optional) — Which demo agent answers - a receptionist, appointment booking, lead qualification, first-level support, collections or appointment reminders.
  - one of `"reception"`, `"scheduling"`, `"qualification"`, `"support"`, `"collections"`, `"reminders"`; default `"reception"`

## Example request

```json
{
  "phone": "string",
  "name": "string",
  "language": "es",
  "agent": "reception",
  "turnstile_token": "string"
}
```

## Code samples

### TypeScript

```typescript
import { Qomni } from "@qomni/sdk";

const qomni = new Qomni({ apiKey: process.env.QOMNI_KEY! });

const demoCall = await qomni.agents.createDemoCall({
  phone: "<phone>",
  turnstile_token: "<turnstile_token>",
  name: "<name>"
});
console.log(demoCall);

```

### cURL

```bash
curl --request POST \
  --url https://api.qomni.ai/agents/v1/demo_calls \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone": "string",
  "name": "string",
  "language": "es",
  "agent": "reception",
  "turnstile_token": "string"
}
'
```

### Python

```python
import requests

url = "https://api.qomni.ai/agents/v1/demo_calls"

payload = {
    "phone": "string",
    "name": "string",
    "language": "es",
    "agent": "reception",
    "turnstile_token": "string"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
```

## Responses

### 202

The call is being placed; the phone rings within seconds.

#### Example

```json
{
  "call": "string",
  "max_duration_seconds": 0
}
```

- `call` (`createDemoCall.response.202.call`; string, required)
  - pattern `^call_[0-9a-z]+$`
- `max_duration_seconds` (`createDemoCall.response.202.max_duration_seconds`; integer, required)

### 403

Turnstile did not confirm a person (`captcha_failed`), or the request came from another site (`origin_not_allowed`).

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string",
    "fields": {
      "property1": [
        "string"
      ],
      "property2": [
        "string"
      ]
    }
  }
}
```

- `error` (`createDemoCall.response.403.error`; object, required)
  - `code` (`createDemoCall.response.403.error.code`; string, required) — Stable, machine-readable; each operation lists the codes it can return.
    - pattern `^[a-z][a-z0-9_]*$`
  - `message` (`createDemoCall.response.403.error.message`; string, required) — For people; may change at any time.
  - `request_id` (`createDemoCall.response.403.error.request_id`; string, optional)
  - `fields` (`createDemoCall.response.403.error.fields`; map<array<string>>, optional) — Only for validation_failed, the messages per field.

### 422

The request does not match the contract (`validation_failed`).

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string",
    "fields": {
      "property1": [
        "string"
      ],
      "property2": [
        "string"
      ]
    }
  }
}
```

- `error` (`createDemoCall.response.422.error`; object, required)
  - `code` (`createDemoCall.response.422.error.code`; string, required) — Stable, machine-readable; each operation lists the codes it can return.
    - pattern `^[a-z][a-z0-9_]*$`
  - `message` (`createDemoCall.response.422.error.message`; string, required) — For people; may change at any time.
  - `request_id` (`createDemoCall.response.422.error.request_id`; string, optional)
  - `fields` (`createDemoCall.response.422.error.fields`; map<array<string>>, optional) — Only for validation_failed, the messages per field.

### 429

This address or this number has used the demo (`rate_limited`); retry after `Retry-After` seconds.

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string",
    "fields": {
      "property1": [
        "string"
      ],
      "property2": [
        "string"
      ]
    }
  }
}
```

- `error` (`createDemoCall.response.429.error`; object, required)
  - `code` (`createDemoCall.response.429.error.code`; string, required) — Stable, machine-readable; each operation lists the codes it can return.
    - pattern `^[a-z][a-z0-9_]*$`
  - `message` (`createDemoCall.response.429.error.message`; string, required) — For people; may change at any time.
  - `request_id` (`createDemoCall.response.429.error.request_id`; string, optional)
  - `fields` (`createDemoCall.response.429.error.fields`; map<array<string>>, optional) — Only for validation_failed, the messages per field.

### 503

The demo has used today's minutes, or places no calls in this environment (`demo_unavailable`).

#### Example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string",
    "fields": {
      "property1": [
        "string"
      ],
      "property2": [
        "string"
      ]
    }
  }
}
```

- `error` (`createDemoCall.response.503.error`; object, required)
  - `code` (`createDemoCall.response.503.error.code`; string, required) — Stable, machine-readable; each operation lists the codes it can return.
    - pattern `^[a-z][a-z0-9_]*$`
  - `message` (`createDemoCall.response.503.error.message`; string, required) — For people; may change at any time.
  - `request_id` (`createDemoCall.response.503.error.request_id`; string, optional)
  - `fields` (`createDemoCall.response.503.error.fields`; map<array<string>>, optional) — Only for validation_failed, the messages per field.


Source: https://docs.qomni.ai/agents-api/demo-calls/create/index.md
