> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.telekesher.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.telekesher.dev/_mcp/server.

# Getting Started

#### Get Your Credentials

Ask support to provision an application with your HTTPS webhook
URL. You will receive an `app_uuid` and an `api_key`.

Authenticate API requests with:

```text
Authorization: Bearer <app_uuid>:<api_key>
```

Webhook deliveries are signed. See [Webhook Signatures](/webhooks/webhook-signatures)
for verification examples.

#### Place a Call

```bash
curl -X POST https://api.telekesher.dev/v1/sessions:dial \
  -H "Authorization: Bearer <app_uuid>:<api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+972527121102",
    "from": "+972747713001",
    "ring_timeout_sec": 30,
    "max_duration_sec": 3600
  }'
```

Save the `session_uuid` from the response and wait for the
[`call.answered`](/webhooks/call-events#callanswered) webhook.

#### Play Audio

```bash
curl -X POST https://api.telekesher.dev/v1/sessions/{session_uuid}/playback/play \
  -H "Authorization: Bearer <app_uuid>:<api_key>" \
  -H "Content-Type: application/json" \
  -d '{"type":"files","urls":["https://cdn.example.com/greeting.wav"]}'
```

Playback progress arrives through
[`playback.started`](/webhooks/playback-events#playbackstarted) and
[`playback.stopped`](/webhooks/playback-events#playbackstopped) webhooks.

## Next Steps

* [Collect DTMF digits](/api/collect-keypad-input/collect)
* [Explore webhook events](/webhooks/overview)
* [Browse the API reference](/api)