# Calltouch API: GET /calls-service/RestAPI/{siteId}/calls-diary/calls/{callId}/download — Запись разговора

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `siteId` | path | integer | да | ID сайта |
| `callId` | path | integer | да | ID звонка из журнала |
| `clientApiId` | query | string | да | API-токен |

## Базовые URL

- Боевой: `https://api.calltouch.ru`
- Методы: `/calls-service/RestAPI/`

## Авторизация

Тип: API-ключ

API-токен (45 символов) и `siteId` (ID личного кабинета) берутся в разделе «Интеграции» → «API». Токен передаётся параметром `clientApiId`. Для создания заявок с сайта токен не нужен.

```
https://api.calltouch.ru/calls-service/RestAPI/{siteId}/calls-diary/calls?clientApiId={токен}&dateFrom=22/11/2016&dateTo=22/11/2016&withCallTags=true&withMapVisits=true
```

## Нюансы

- Имена параметров чувствительны к регистру.
- Форматы дат различаются: журнал звонков — `dd/mm/yyyy`, журнал заявок — `mm/dd/yyyy`, создание заявки — `dd.mm.yyyy hh:mm:ss`.
- Данные Яндекс Директа и Google Ads появляются на следующий день после звонка; теги Predict и Antifrod — примерно через неделю.
- Каждый ответ содержит заголовок `Api-Point`: «потрачено / осталось часовых / осталось суточных», например `Api-Point: 4/5256/102368`.
- Поля ответа, не описанные в документации, устарели — их нужно игнорировать.

## Сценарии с этим методом

- [Скачать запись разговора](https://mcp-everything.ru/integrations/calltouch/scenarios/skachat-zapis-razgovora.md)

---

Если этого недостаточно — официальная документация: https://www.calltouch.ru/support/api-metod-vygruzki-zhurnala-zvonkov/
Вся интеграция одним документом: https://mcp-everything.ru/integrations/calltouch.md
