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 в журнале).

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.
• Поля ответа, не описанные в документации, устарели — их нужно игнорировать.

Другие сценарии

• Выгрузить журнал звонков с источниками
• Передать заявку с сайта в Calltouch

---

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