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

Базовые 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://www.calltouch.ru/support/api-metod-vygruzki-zhurnala-zvonkov/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/calltouch.md