# Подключить Calltouch: звонки и заявки

> **Коротко.** Как подключить Calltouch по ID сайта и токену API, выбрать звонки или заявки и включить ежедневное обновление с перезабором последних дней.

Адрес: https://marfor.pro/docs/data/sources/calltouch · Раздел: Данные: от таблицы до проверенного источника › Источники данных: откуда MARFOR берёт таблицу › Подключить Calltouch: звонки и заявки · Вид: Инструкция · Уровень: для начинающих · Обновлено: 2026-10-14

Calltouch даёт звонки и заявки с источником, каналом и UTM-меткой — их можно прогнозировать и связывать с расходами. Номера телефонов и имена звонящих не выгружаются: только маркетинговые данные.

## Что нужно заранее {#before}

- Доступ к личному кабинету Calltouch. Там на нужном сайте откройте «Интеграции → Отправка данных во внешние системы → API»: в этом разделе — ID сайта и токен API. Если передача данных по API выключена, включите её.
- Токен выдаётся на пользователя Calltouch. Если у пользователя ограничен доступ к сегментам трафика, часть звонков не придёт — лучше токен пользователя без таких ограничений.

## Шаги {#steps}

1. В MARFOR: «Источники данных» → блок «API Коннекторы» → карточка «Calltouch».
2. Впишите «ID сайта» и «Токен API» → «Проверить подключение». Ответ «Подключение работает: сайт …» — можно продолжать. Токен хранится на сервере MARFOR и в интерфейсе больше не показывается.
3. «Что выгружать»: «Журнал звонков» или «Заявки (формы, чаты, обратный звонок)».
4. «Вид таблицы»: для прогноза и модели — «Сводка по дням и каналам (для прогноза и MMM)». «Каждый звонок / заявка — строкой» — для разборов по отдельным звонкам.
5. «Данные с» — начало периода, по умолчанию год назад. Первая загрузка — не больше трёх лет.
6. «Обновлять автоматически каждый день» включено сразу, конец периода — вчера. «Перезабирать дней» — по умолчанию 30, от 1 до 180. Выключите автообновление, если нужен разовый срез: тогда станет доступно поле «по».
7. «Название источника» → «Подключить и загрузить». Появится «Источник создан, загрузка идёт…» — окно можно закрыть, ход загрузки виден на карточке.
8. Когда загрузка закончится, нажмите на карточке «Настроить маппинг».

## Как понять, что получилось {#result}

Карточка с типом «Calltouch» и числом строк. В сводке звонков по дням — колонки «Дата», «Источник», «Канал», «utm_campaign», «Город» и счётчики: «Звонки», «Принятые», «Уникальные», «Целевые», «Уникально-целевые» и другие. У заявок добавляется разрез «Форма». На маппинге «Дата» — «Временной ряд» → «Дата», счётчики — Metric, остальное — Dimension.

## Как обновляется {#refresh}

Каждое утро в 06:00 UTC (09:00 по Москве) MARFOR дополняет данные по вчерашний день, а последние дни из «Перезабирать дней» загружает заново. Звонок может стать целевым или получить тег задним числом — перезабор подтягивает такие правки. Зачем это нужно, на примере, — [окно перезабора](https://marfor.pro/docs/data/sources/refresh#window).

- Обновить вручную — круговые стрелки на карточке: последние дни загрузятся заново. Пока загрузка идёт, кнопка неактивна.
- «Перезабирать дней», новый токен (поле «Новый токен API (если сменили в Calltouch)») и время обновления меняют в «Настройках источника и Pipeline» → «Сохранить параметры Calltouch». Там же — «Перезагрузить весь период»: заново весь период источника.
- Прошлые загрузки — значок «История загрузок».

## Если не получилось {#troubleshooting}

- **«Введите ID сайта и токен».** Заполните оба поля.
- **«ID сайта (siteId) — это число из личного кабинета Calltouch».** В поле — только цифры.
- **«API-токен Calltouch выглядит неверно: скопируйте его целиком, без пробелов».**
- **«Calltouch не принял токен API…».** Скопируйте токен заново; если его перевыпускали, нужен новый.
- **«В Calltouch выключена передача данных по API…».** Включите её в разделе API личного кабинета.
- **«У пользователя Calltouch, которому принадлежит токен, нет доступа к сайту …».** Возьмите токен пользователя с доступом к этому сайту.
- **«Calltouch не знает сайт с ID …».** Проверьте ID в разделе API.
- **«Исчерпан часовой лимит баллов API Calltouch по этому сайту…», «Calltouch: лимит запросов…» или «Calltouch временно недоступен…».** Подождите и повторите — лимит обновляется в начале каждого часа.
- **«Период первичной загрузки — не больше трёх лет».** Сдвиньте «Данные с».
- **«Загрузка этого источника уже идёт — дождитесь окончания».** Второй запуск не нужен.
- **«Токен Calltouch не сохранён — укажите его в настройках источника».**
- **«Нет связи с сервером. Проверьте список источников перед повтором — загрузка могла запуститься.»** Обновите страницу и посмотрите на карточку, прежде чем подключать снова.
- **«Выгрузка даёт … строк — больше лимита вашего тарифа…».** Выберите «Сводку по дням и каналам» или смените тариф.

## Связанные

- [Как обновляется источник: перезапись, добавление и окно перезабора](https://marfor.pro/docs/data/sources/refresh)
- [Настройки источника и автозагрузка: все поля](https://marfor.pro/docs/data/sources/settings)
- [Настроить маппинг источника: дата, метрики и разрезы](https://marfor.pro/docs/data/mapping/roles)
- [Какие данные нужны: таблица для MARFOR](https://marfor.pro/docs/data/requirements)