Calltouch API: GET /calls-service/RestAPI/requests — Журнал заявок

Пример:

Параметр	Где	Тип	Обяз.	Описание
clientApiId	query	string	да	API-токен
siteId	query	integer	да	ID личного кабинета
dateFrom	query	string	нет	Начало, mm/dd/yyyy (обязателен, если нет requestId/requestNumber)
dateTo	query	string	нет	Конец, mm/dd/yyyy
requestId	query	string	нет	ID заявок в Calltouch через запятую
requestNumber	query	string	нет	Внешние ID заявок
attribution	query	integer	нет	Модель атрибуции
bindTo	query	string	нет	request (по умолчанию) или session
subject	query	string	нет	Название формы
withRequestTags	query	boolean	нет	Выгрузить теги
withMapVisits	query	boolean	нет	Выгрузить историю посещений
withCustomFields	query	boolean	нет	Выгрузить пользовательские поля

Пример запроса:

https://api.calltouch.ru/calls-service/RestAPI/requests/?clientApiId=<TOKEN>&requestId=79825254

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

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

• Передать заявку с сайта в Calltouch

---

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