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

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

Заявки из форм попадают в Calltouch с источником визита — сквозная аналитика по заявкам, а не только по звонкам.

1. Отправь заявку: POST /calls-service/RestAPI/requests/{siteId}/register/ — form-urlencoded, одна заявка за запрос. Токен для этого метода не нужен.
2. Передай хотя бы одно из fio, phoneNumber (11 цифр), email, а также subject (название формы), requestNumber (твой ID заявки) и requestUrl.
3. Чтобы заявка связалась с визитом и рекламным источником, передай sessionId — его отдаёт скрипт Calltouch на странице: window.ct('calltracking_params', '').sessionId.
4. Проверить, что заявка дошла, можно через журнал заявок: GET /calls-service/RestAPI/requests с requestNumber. Обрати внимание: даты в журнале заявок — в формате mm/dd/yyyy.

curl -X POST "https://api.calltouch.ru/calls-service/RestAPI/requests/<siteId>/register/" \
  --data-urlencode 'subject=Заявка на расчёт' \
  --data-urlencode 'requestNumber=form-1042' \
  --data-urlencode 'fio=Иван Петров' \
  -d phoneNumber=79990001122 \
  --data-urlencode 'requestUrl=https://example.ru/calc' \
  -d sessionId=<sessionId из скрипта Calltouch>

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

POST /calls-service/RestAPI/requests/{siteId}/register/ — Создание заявки

Токен не нужен; поддерживается и GET. Тело — application/x-www-form-urlencoded, UTF-8, одна заявка за запрос. Нужен хотя бы один из fio, phoneNumber, email.

Параметр	Где	Тип	Обяз.	Описание
siteId	path	integer	да	ID личного кабинета
subject	body	string	нет	Название формы, до 256 символов
requestNumber	body	string	нет	Ваш ID заявки, до 256 символов
requestDate	body	string	нет	dd.mm.yyyy hh:mm:ss; по умолчанию — текущее время
sessionId	body	string	нет	ID сессии Calltouch (window.ct('calltracking_params','mod_id').sessionId)
fio	body	string	нет	Имя клиента
phoneNumber	body	string	нет	Телефон из 11 цифр
email	body	string	нет	Email
comment	body	string	нет	Комментарий
tags	body	string	нет	Теги через запятую
requestUrl	body	string	нет	Адрес страницы формы
customField[fieldName]	body	string	нет	Пользовательское поле (до 100 символов)

Нюансы

• Имена параметров чувствительны к регистру.
• Форматы дат различаются: журнал звонков — 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