{"name":"Calltouch API","vendor":"Calltouch","industry":"marketing","summary":"API платформы коллтрекинга и сквозной аналитики Calltouch: выгрузка журнала звонков с источниками, UTM-метками и тегами, скачивание записей разговоров, выгрузка журнала заявок и создание заявок с сайта. Доступ ограничен сегментами и правами пользователя — владельца токена; нагрузка регулируется суточными и часовыми баллами.","docsUrl":"https://www.calltouch.ru/support/api-metod-vygruzki-zhurnala-zvonkov/","coverage":{"included":[],"excluded":[]},"scenarios":[{"id":"vygruzit-zhurnal-zvonkov-s-istochnikami","title":"Выгрузить журнал звонков с источниками","summary":"Звонки с рекламными источниками, UTM-метками и тегами — в CRM или отчёт по эффективности рекламы.","steps":["Возьми 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 балла."],"code":"curl -G \"https://api.calltouch.ru/calls-service/RestAPI/<siteId>/calls-diary/calls\" \\\n  -d clientApiId=<токен> \\\n  -d dateFrom=01/10/2026 -d dateTo=23/10/2026 \\\n  -d page=1 -d limit=1000 \\\n  -d withCallTags=true -d uniqueOnly=false","language":"bash","methods":["GET /calls-service/RestAPI/{siteId}/calls-diary/calls"]},{"id":"skachat-zapis-razgovora","title":"Скачать запись разговора","summary":"Прослушать звонок или отдать запись в систему контроля качества.","steps":["Найди звонок в журнале: GET /calls-service/RestAPI/{siteId}/calls-diary/calls — нужен его callId.","Скачай запись: GET /calls-service/RestAPI/{siteId}/calls-diary/calls/{callId}/download с clientApiId. Ответ — аудиофайл.","Скачивание записи стоит 1 балл; выгружай записи только нужных звонков, например целевых (targetOnly = true в журнале)."],"code":"curl -G -o call-123456.mp3 \\\n  \"https://api.calltouch.ru/calls-service/RestAPI/<siteId>/calls-diary/calls/123456/download\" \\\n  -d clientApiId=<токен>","language":"bash","methods":["GET /calls-service/RestAPI/{siteId}/calls-diary/calls","GET /calls-service/RestAPI/{siteId}/calls-diary/calls/{callId}/download"]},{"id":"peredat-zayavku-s-sayta-v-calltouch","title":"Передать заявку с сайта в Calltouch","summary":"Заявки из форм попадают в Calltouch с источником визита — сквозная аналитика по заявкам, а не только по звонкам.","steps":["Отправь заявку: POST /calls-service/RestAPI/requests/{siteId}/register/ — form-urlencoded, одна заявка за запрос. Токен для этого метода не нужен.","Передай хотя бы одно из fio, phoneNumber (11 цифр), email, а также subject (название формы), requestNumber (твой ID заявки) и requestUrl.","Чтобы заявка связалась с визитом и рекламным источником, передай sessionId — его отдаёт скрипт Calltouch на странице: window.ct('calltracking_params', '<mod_id>').sessionId.","Проверить, что заявка дошла, можно через журнал заявок: GET /calls-service/RestAPI/requests с requestNumber. Обрати внимание: даты в журнале заявок — в формате mm/dd/yyyy."],"code":"curl -X POST \"https://api.calltouch.ru/calls-service/RestAPI/requests/<siteId>/register/\" \\\n  --data-urlencode 'subject=Заявка на расчёт' \\\n  --data-urlencode 'requestNumber=form-1042' \\\n  --data-urlencode 'fio=Иван Петров' \\\n  -d phoneNumber=79990001122 \\\n  --data-urlencode 'requestUrl=https://example.ru/calc' \\\n  -d sessionId=<sessionId из скрипта Calltouch>","language":"bash","methods":["GET /calls-service/RestAPI/requests","POST /calls-service/RestAPI/requests/{siteId}/register/"]}],"baseUrls":[{"label":"Боевой","url":"https://api.calltouch.ru"},{"label":"Методы","url":"/calls-service/RestAPI/"}],"auth":{"type":"api_key","description":"API-токен (45 символов) и `siteId` (ID личного кабинета) берутся в разделе «Интеграции» → «API». Токен передаётся параметром `clientApiId`. Для создания заявок с сайта токен не нужен.","example":"https://api.calltouch.ru/calls-service/RestAPI/{siteId}/calls-diary/calls?clientApiId={токен}&dateFrom=22/11/2016&dateTo=22/11/2016&withCallTags=true&withMapVisits=true"},"methods":[{"id":"GET /calls-service/RestAPI/{siteId}/calls-diary/calls","title":"Журнал звонков","httpMethod":"GET","path":"/calls-service/RestAPI/{siteId}/calls-diary/calls","description":"По умолчанию — выборка за один день (`dateFrom` = `dateTo`); для периода длиннее дня используйте постраничный режим (`page`, `limit`). В ответе при пагинации: `page`, `pageTotal`, `pageSize`, `recordsTotal`, `records`.\n\nВ записях: `callId`, `date`, `callerNumber`, `phoneNumber`, `duration`, `successful`, `uniqueCall`, `targetCall`, `source`, `medium`, `keyword`, UTM-метки, `city`, `sessionId`, `callTags`, `orders`, `mapVisits`, `comments`.","params":[{"name":"siteId","in":"path","type":"integer","required":true,"description":"ID сайта"},{"name":"clientApiId","in":"query","type":"string","required":true,"description":"API-токен"},{"name":"dateFrom","in":"query","type":"string","required":true,"description":"Начало, dd/mm/yyyy"},{"name":"dateTo","in":"query","type":"string","required":true,"description":"Конец, dd/mm/yyyy"},{"name":"page","in":"query","type":"integer","required":false,"description":"Страница, от 1"},{"name":"limit","in":"query","type":"integer","required":false,"description":"Записей на странице, 1–1000 (по умолчанию 1000)"},{"name":"timeFrom","in":"query","type":"string","required":false,"description":"Время с, hh:mm:ss"},{"name":"timeTo","in":"query","type":"string","required":false,"description":"Время по"},{"name":"attribution","in":"query","type":"integer","required":false,"description":"0 — последнее взаимодействие, 1 — последний непрямой (по умолчанию)"},{"name":"bindTo","in":"query","type":"string","required":false,"description":"call (по умолчанию) или session"},{"name":"callId","in":"query","type":"string","required":false,"description":"ID звонков через запятую"},{"name":"uniqueOnly","in":"query","type":"boolean","required":false,"description":"Только уникальные"},{"name":"targetOnly","in":"query","type":"boolean","required":false,"description":"Только целевые"},{"name":"callbackOnly","in":"query","type":"boolean","required":false,"description":"Только обратные звонки"},{"name":"withCallTags","in":"query","type":"boolean","required":false,"description":"Выгрузить теги"},{"name":"withMapVisits","in":"query","type":"boolean","required":false,"description":"Выгрузить историю посещений"},{"name":"withOrders","in":"query","type":"boolean","required":false,"description":"Выгрузить сделки"},{"name":"withComments","in":"query","type":"boolean","required":false,"description":"Выгрузить комментарии"},{"name":"withCustomFields","in":"query","type":"boolean","required":false,"description":"Выгрузить пользовательские поля"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /calls-service/RestAPI/{siteId}/calls-diary/calls/{callId}/download","title":"Запись разговора","httpMethod":"GET","path":"/calls-service/RestAPI/{siteId}/calls-diary/calls/{callId}/download","description":"","params":[{"name":"siteId","in":"path","type":"integer","required":true,"description":"ID сайта"},{"name":"callId","in":"path","type":"integer","required":true,"description":"ID звонка из журнала"},{"name":"clientApiId","in":"query","type":"string","required":true,"description":"API-токен"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /calls-service/RestAPI/requests","title":"Журнал заявок","httpMethod":"GET","path":"/calls-service/RestAPI/requests","description":"Пример:","params":[{"name":"clientApiId","in":"query","type":"string","required":true,"description":"API-токен"},{"name":"siteId","in":"query","type":"integer","required":true,"description":"ID личного кабинета"},{"name":"dateFrom","in":"query","type":"string","required":false,"description":"Начало, mm/dd/yyyy (обязателен, если нет requestId/requestNumber)"},{"name":"dateTo","in":"query","type":"string","required":false,"description":"Конец, mm/dd/yyyy"},{"name":"requestId","in":"query","type":"string","required":false,"description":"ID заявок в Calltouch через запятую"},{"name":"requestNumber","in":"query","type":"string","required":false,"description":"Внешние ID заявок"},{"name":"attribution","in":"query","type":"integer","required":false,"description":"Модель атрибуции"},{"name":"bindTo","in":"query","type":"string","required":false,"description":"request (по умолчанию) или session"},{"name":"subject","in":"query","type":"string","required":false,"description":"Название формы"},{"name":"withRequestTags","in":"query","type":"boolean","required":false,"description":"Выгрузить теги"},{"name":"withMapVisits","in":"query","type":"boolean","required":false,"description":"Выгрузить историю посещений"},{"name":"withCustomFields","in":"query","type":"boolean","required":false,"description":"Выгрузить пользовательские поля"}],"requestExample":"https://api.calltouch.ru/calls-service/RestAPI/requests/?clientApiId=<TOKEN>&requestId=79825254","responseExample":"","docsUrl":""},{"id":"POST /calls-service/RestAPI/requests/{siteId}/register/","title":"Создание заявки","httpMethod":"POST","path":"/calls-service/RestAPI/requests/{siteId}/register/","description":"Токен не нужен; поддерживается и GET. Тело — `application/x-www-form-urlencoded`, UTF-8, одна заявка за запрос. Нужен хотя бы один из `fio`, `phoneNumber`, `email`.","params":[{"name":"siteId","in":"path","type":"integer","required":true,"description":"ID личного кабинета"},{"name":"subject","in":"body","type":"string","required":false,"description":"Название формы, до 256 символов"},{"name":"requestNumber","in":"body","type":"string","required":false,"description":"Ваш ID заявки, до 256 символов"},{"name":"requestDate","in":"body","type":"string","required":false,"description":"dd.mm.yyyy hh:mm:ss; по умолчанию — текущее время"},{"name":"sessionId","in":"body","type":"string","required":false,"description":"ID сессии Calltouch (window.ct('calltracking_params','mod_id').sessionId)"},{"name":"fio","in":"body","type":"string","required":false,"description":"Имя клиента"},{"name":"phoneNumber","in":"body","type":"string","required":false,"description":"Телефон из 11 цифр"},{"name":"email","in":"body","type":"string","required":false,"description":"Email"},{"name":"comment","in":"body","type":"string","required":false,"description":"Комментарий"},{"name":"tags","in":"body","type":"string","required":false,"description":"Теги через запятую"},{"name":"requestUrl","in":"body","type":"string","required":false,"description":"Адрес страницы формы"},{"name":"customField[fieldName]","in":"body","type":"string","required":false,"description":"Пользовательское поле (до 100 символов)"}],"requestExample":"","responseExample":"","docsUrl":""}],"codeExamples":[],"errors":[{"code":"429","description":"Превышен лимит запросов в секунду или исчерпаны баллы"},{"code":"90001","description":"Исчерпан часовой лимит баллов по сайту"}],"limits":"- Не больше 5 запросов в секунду с одного IP.\n- Суточные баллы начисляются в 00:00 и сгорают к концу суток; часовые — в начале каждого часа. Баллы списываются только за успешные запросы.\n- Стоимость: журнал звонков — 2 балла, запись звонка — 1, создание заявки — 2 + 1 за объект, создание сделки — 8.","gotchas":["Имена параметров чувствительны к регистру.","Форматы дат различаются: журнал звонков — `dd/mm/yyyy`, журнал заявок — `mm/dd/yyyy`, создание заявки — `dd.mm.yyyy hh:mm:ss`.","Данные Яндекс Директа и Google Ads появляются на следующий день после звонка; теги Predict и Antifrod — примерно через неделю.","Каждый ответ содержит заголовок `Api-Point`: «потрачено / осталось часовых / осталось суточных», например `Api-Point: 4/5256/102368`.","Поля ответа, не описанные в документации, устарели — их нужно игнорировать."],"slug":"calltouch","version":2,"updatedAt":"2026-10-24T17:05:31.994Z","sources":[{"title":"Выгрузка журнала звонков","url":"https://www.calltouch.ru/support/api-metod-vygruzki-zhurnala-zvonkov/","kind":"research","addedAt":"2026-10-17T07:38:46.937Z"},{"title":"Выгрузка записей разговоров","url":"https://www.calltouch.ru/support/api-metod-vygruzki-zapisey-razgovorov/","kind":"research","addedAt":"2026-10-17T07:38:46.937Z"},{"title":"Выгрузка журнала заявок","url":"https://www.calltouch.ru/support/vygruzka-zhurnala-zayavok-cherez-api/","kind":"research","addedAt":"2026-10-17T07:38:46.937Z"},{"title":"Отправка заявок с сайта по API","url":"https://calltouch.kz/support/upravlenie-zayavkami-cherez-api/","kind":"research","addedAt":"2026-10-17T07:38:46.937Z"},{"title":"Система баллов API Calltouch","url":"https://www.calltouch.ru/support/opisanie-sistemy-ballov-api-calltouch/","kind":"research","addedAt":"2026-10-17T07:38:46.937Z"},{"title":"Вставленный текст","url":"","kind":"import","addedAt":"2026-10-17T07:38:46.937Z"},{"title":"scenarios-calltouch.md","url":"","kind":"import","addedAt":"2026-10-24T17:05:23.762Z"}],"logoUrl":null}