# Calltouch API: Скачать запись разговора

Сценарий из mcp-everything. Актуально на 2026-10-24.

Прослушать звонок или отдать запись в систему контроля качества.

1. Найди звонок в журнале: GET /calls-service/RestAPI/{siteId}/calls-diary/calls — нужен его callId.
2. Скачай запись: GET /calls-service/RestAPI/{siteId}/calls-diary/calls/{callId}/download с clientApiId. Ответ — аудиофайл.
3. Скачивание записи стоит 1 балл; выгружай записи только нужных звонков, например целевых (targetOnly = true в журнале).

```bash
curl -G -o call-123456.mp3 \
  "https://api.calltouch.ru/calls-service/RestAPI/<siteId>/calls-diary/calls/123456/download" \
  -d clientApiId=<токен>
```

## Базовые 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
```

## Методы сценария

### GET /calls-service/RestAPI/{siteId}/calls-diary/calls — Журнал звонков

По умолчанию — выборка за один день (`dateFrom` = `dateTo`); для периода длиннее дня используйте постраничный режим (`page`, `limit`). В ответе при пагинации: `page`, `pageTotal`, `pageSize`, `recordsTotal`, `records`.

В записях: `callId`, `date`, `callerNumber`, `phoneNumber`, `duration`, `successful`, `uniqueCall`, `targetCall`, `source`, `medium`, `keyword`, UTM-метки, `city`, `sessionId`, `callTags`, `orders`, `mapVisits`, `comments`.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `siteId` | path | integer | да | ID сайта |
| `clientApiId` | query | string | да | API-токен |
| `dateFrom` | query | string | да | Начало, dd/mm/yyyy |
| `dateTo` | query | string | да | Конец, dd/mm/yyyy |
| `page` | query | integer | нет | Страница, от 1 |
| `limit` | query | integer | нет | Записей на странице, 1–1000 (по умолчанию 1000) |
| `timeFrom` | query | string | нет | Время с, hh:mm:ss |
| `timeTo` | query | string | нет | Время по |
| `attribution` | query | integer | нет | 0 — последнее взаимодействие, 1 — последний непрямой (по умолчанию) |
| `bindTo` | query | string | нет | call (по умолчанию) или session |
| `callId` | query | string | нет | ID звонков через запятую |
| `uniqueOnly` | query | boolean | нет | Только уникальные |
| `targetOnly` | query | boolean | нет | Только целевые |
| `callbackOnly` | query | boolean | нет | Только обратные звонки |
| `withCallTags` | query | boolean | нет | Выгрузить теги |
| `withMapVisits` | query | boolean | нет | Выгрузить историю посещений |
| `withOrders` | query | boolean | нет | Выгрузить сделки |
| `withComments` | query | boolean | нет | Выгрузить комментарии |
| `withCustomFields` | query | boolean | нет | Выгрузить пользовательские поля |

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

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

## Нюансы

- Имена параметров чувствительны к регистру.
- Форматы дат различаются: журнал звонков — `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/vygruzit-zhurnal-zvonkov-s-istochnikami.md)
- [Передать заявку с сайта в Calltouch](https://mcp-everything.ru/integrations/calltouch/scenarios/peredat-zayavku-s-sayta-v-calltouch.md)

---

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