Calltouch API: Выгрузить журнал звонков с источниками

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

Звонки с рекламными источниками, UTM-метками и тегами — в CRM или отчёт по эффективности рекламы.

Возьми API-токен и siteId в личном кабинете: «Интеграции» → «API». Токен передаётся параметром clientApiId.
Запроси звонки: GET /calls-service/RestAPI/{siteId}/calls-diary/calls с dateFrom и dateTo в формате dd/mm/yyyy. Для источников и тегов добавь withCallTags = true, для истории визитов — withMapVisits = true.
По умолчанию выборка за один день. Для периода длиннее дня включай постраничный режим: page (с 1) и limit (до 1000); в ответе pageTotal и recordsTotal.
В записях — callId, date, callerNumber, duration, successful, uniqueCall, targetCall, source, medium и UTM-метки. Данные Директа и Google Ads появляются на следующий день.
Следи за баллами в заголовке Api-Point («потрачено / осталось часовых / осталось суточных»); журнал звонков стоит 2 балла.

curl -G "https://api.calltouch.ru/calls-service/RestAPI/<siteId>/calls-diary/calls" \
  -d clientApiId=<токен> \
  -d dateFrom=01/10/2026 -d dateTo=23/10/2026 \
  -d page=1 -d limit=1000 \
  -d withCallTags=true -d uniqueOnly=false

Базовые 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	нет	Выгрузить пользовательские поля

Нюансы

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

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

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