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

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

Что нужно заранее

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

Шаги

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

Как понять, что получилось

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

Как обновляется

Каждое утро в 06:00 UTC (09:00 по Москве) MARFOR дополняет данные по вчерашний день, а последние дни из «Перезабирать дней» загружает заново. Звонок может стать целевым или получить тег задним числом — перезабор подтягивает такие правки. Зачем это нужно, на примере, — окно перезабора.

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

Если не получилось

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