База знаний Колтреон

Колтреон — сервис на технологии CallTreckingOne для работы с рекламой, где основным результатом считается входящий звонок клиента, а не сам клик по объявлению.

Сервис связывает рекламный переход, сайт, номер телефона и факт входящего звонка. После фиксации звонка Колтреон определяет длительность разговора, статус обращения и передаёт нужные события в Яндекс.Метрику.

• сайт остаётся с рабочим номером компании;
• входящий звонок отображается в кабинете;
• разговор получает статус по длительности и источнику;
• целевые события передаются в Яндекс.Метрику;
• Директ можно настраивать под звонки вместо кликов.

Обычная аналитика показывает отчёты по источникам, переходам и действиям на сайте. Колтреон использует данные иначе: фиксирует телефонное обращение и помогает передать в рекламную систему именно звонок, а не техническое посещение страницы.

В кабинете доступны статусы звонков, длительность, уникальность и связь с сайтом. Эти данные нужны, чтобы отделять реальные обращения от коротких вызовов, повторов и переходов, которые не привели к разговору.

Целевой звонок — это входящий разговор, который прошёл минимальный порог качества. В базовом варианте используется порог от 30 секунд.

Порог нужен, чтобы не считать одинаково полноценный разговор и короткий вызов на несколько секунд. В разных нишах порог можно менять: где-то 30 секунд достаточно, где-то разумнее использовать 45, 60 или 90 секунд.

1. Домен сайта, на котором размещён номер телефона.
2. Основной номер, на который приходят входящие обращения.
3. Доступ к кабинету Колтреон.
4. Доступ к Яндекс.Метрике или аккаунту Яндекса, где находится счётчик.
5. Понимание, какой звонок считать целевым по длительности.
6. Android-телефон с приложением или PWA-сценарий, если используется ручная фиксация.

Если у бизнеса несколько сайтов, городов, филиалов или направлений, структуру лучше сразу настроить через мультиаккаунт.

1. Зарегистрироваться и добавить сайт.
2. Указать рабочий номер телефона.
3. Подключить Яндекс.Метрику через авторизацию Яндекса.
4. Поставить код Колтреон на сайт.
5. Установить Android-приложение или настроить PWA.
6. Сделать тестовый звонок.
7. Проверить, что звонок появился в кабинете с правильным статусом.
8. После проверки использовать цель звонка в Яндекс.Директе.

В кабинете указывается основной домен сайта: без протокола, страниц, UTM-меток и лишних параметров. Например: site.ru.

Если один бизнес использует разные домены, поддомены, города или отдельные посадочные страницы под разные услуги, их нужно разделять так, чтобы звонки не смешивались между проектами.

• site.ru — основной домен;
• spb.site.ru — отдельный поддомен, если по нему отдельная реклама или номер;
• quiz.site.ru — отдельная посадочная страница, если она ведёт на свой сценарий звонков.

Код Колтреон связывает посещение сайта с последующим звонком. Его нужно ставить на все страницы, где посетитель может увидеть номер или нажать кнопку звонка.

1. Открыть мастер подключения в кабинете.
2. Скопировать индивидуальный код сайта.
3. Вставить его перед закрывающим тегом </body> или в общий блок счётчиков CMS.
4. Очистить кеш сайта, если используется CMS, CDN или плагин оптимизации.
5. Запустить проверку в кабинете.

Если код установлен только на главной странице, звонки со страниц услуг, статей, квиза или мобильной версии могут не связываться с визитом.

Номер телефона на сайте должен быть доступен как обычная ссылка tel:. Это особенно важно для мобильных пользователей.

<a href="tel:+79990000000">+7 999 000-00-00</a>

Если кнопка «Позвонить» сделана через сторонний виджет, сложный JavaScript, popup или нестандартный элемент конструктора, браузер может не передать корректный сигнал о звонке.

• номер в кабинете и номер на сайте должны совпадать;
• на мобильной версии не должно быть другого номера;
• кнопка звонка не должна полностью заменяться сторонним скриптом без tel:;
• после правок сайта нужно снова проверить код и номер.

На CMS и конструкторах код нужно ставить в общий шаблон, а не вручную на одну страницу.

После установки нужно открыть сайт как обычный посетитель, проверить исходный код страницы и запустить проверку из кабинета.

На некоторых сайтах мобильная версия отличается от десктопной: другой шаблон, другая кнопка звонка, другой номер или отдельный popup. В таком случае проверка только с компьютера не гарантирует, что звонки с телефона будут связаны с сайтом.

Проверьте сайт с мобильного устройства:

• номер виден и совпадает с кабинетом;
• кнопка открывает набор номера;
• ссылка начинается с tel:;
• код Колтреон присутствует в мобильной версии;
• после нажатия на номер приложение фиксирует входящий звонок.

Мастер подключения проверяет не «настроили ли вы когда-то», а текущее состояние связки. Поэтому если сайт изменили, включили кеш, поменяли шаблон или номер, статус может измениться.

Если статус меняется после перезагрузки, сначала проверьте кеш, разные шаблоны страниц, редиректы http/https и мобильную версию.

Android-приложение фиксирует реальные входящие звонки на рабочий номер и передаёт их в кабинет Колтреон. Без приложения сервис не сможет надёжно подтвердить, что звонок действительно состоялся на телефоне.

Для корректной работы нужны разрешения на телефонные вызовы, работу в фоне и доступ к сети. На некоторых устройствах также нужно отключить жёсткую экономию батареи для приложения.

iOS не даёт обычному сайту или PWA такой же доступ к истории звонков, как Android. Поэтому для iPhone используется ручной сценарий фиксации или альтернативная схема через телефонию.

PWA удобно установить на главный экран, чтобы быстро открыть кабинет, вручную отправить звонок, получить уведомление или проверить статус. Но PWA не заменяет Android-приложение по автоматическому учёту вызовов.

• Android — основной сценарий автоматической фиксации.
• iPhone/PWA — ручной или вспомогательный сценарий.
• Подменный номер/АТС — вариант, если нужна независимость от устройства клиента.

Звонок получает статус «с сайта», когда система видит связь между визитом, действием на сайте и входящим вызовом. Если такой связи нет, звонок отображается как «вне сайта».

Причины статуса «вне сайта»:

• человек набрал номер вручную;
• звонок был повторным после старого визита;
• код Колтреон не установлен на нужной странице;
• кнопка звонка сделана нестандартно;
• номер на сайте отличается от номера в кабинете;
• посетитель открыл сайт на одном устройстве, а позвонил с другого.

Если связи с визитом нет, корректный статус — «вне сайта». Такой звонок всё равно может быть важным для бизнеса, но его не следует автоматически относить к посещению сайта.

Короткие звонки лучше не использовать как основную цель Директа, если они часто не приводят к разговору с клиентом.

Один человек может позвонить несколько раз: уточнить информацию, перезвонить позже или связаться с другим менеджером. Поэтому в кабинете важно смотреть не только общее количество вызовов, но и уникальность.

Повторный звонок не всегда является новой рекламной заявкой. Часто это продолжение уже начатого контакта.

Если устройство временно без интернета, приложение может сохранить данные и передать их позже при восстановлении связи. Поэтому в кабинете звонок иногда появляется не сразу.

При проблемах с синхронизацией проверьте:

• интернет на устройстве;
• разрешение фоновой передачи данных;
• авторизацию в приложении;
• выбранный активный сайт в мультиаккаунте;
• наличие обновлений приложения.

Метрика подключается через авторизацию Яндекса. Пользователь подтверждает доступ, после чего Колтреон может работать со счётчиком и отправлять события по звонкам.

Если счётчик уже стоит на сайте, нужно выбрать правильный счётчик. Если счётчика нет, сначала его создают в Яндекс.Метрике, затем подключают в Колтреон.

• домен сайта в Метрике должен соответствовать сайту в Колтреон;
• доступ Яндекса должен принадлежать аккаунту, где есть права на счётчик;
• после подключения нужно проверить поступление целей.

Набор целей может отличаться по настройке, но базовая логика такая:

Для Директа чаще используют не все вызовы подряд, а целевые или уникальные целевые звонки. Так рекламная система получает более качественный сигнал для оптимизации.

После проверки передачи целей в Метрику цель звонка можно использовать в Яндекс.Директе. В кампании выбирается стратегия, где оптимизация идёт по целевому действию.

1. Убедиться, что цель звонка появилась в Метрике.
2. Проверить, что тестовый звонок засчитался корректно.
3. Выбрать цель в настройках стратегии Директа.
4. Не менять одновременно много параметров кампании в первые дни.
5. Следить за качеством звонков, а не только за количеством кликов.

Колтреон помогает сделать звонок основным рекламным событием, но качество результата зависит ещё от сайта, объявления, региона, ставок и обработки входящих вызовов.

В начале кампании система набирает статистику: какие запросы дают звонки, какие площадки приводят некачественный трафик, какие регионы дают реальные обращения. Выводы по первым дням могут быть неточными, потому что данных ещё мало.

Рекомендуемый порядок:

1. запустить базовую структуру;
2. собрать первые звонки и отделить нецелевые обращения;
3. скорректировать гео, ставки, площадки и минус-слова;
4. усилить направления, где есть целевые разговоры;
5. после накопления данных переходить к более строгому управлению по звонкам.

После настройки любые изменения сайта, номера, целей или рекламной кампании лучше делать с последующей проверкой. Даже небольшая правка может повлиять на фиксацию звонков.

• не удаляйте код Колтреон из шаблона сайта;
• не меняйте номер на сайте без обновления кабинета;
• не отключайте приложение;
• не удаляйте цели в Метрике;
• не меняйте стратегию Директа без понимания, какая цель используется;
• после любых изменений делайте тестовый звонок.

Главная панель показывает состояние связки и основные данные по звонкам. Её задача — быстро понять, всё ли работает.

• всего входящих звонков;
• целевые звонки по длительности;
• уникальные звонки;
• пропущенные вызовы;
• статус передачи в Метрику;
• состояние сайта, кода и приложения.

Если какой-то показатель резко изменился, сначала проверяют техническую связку, затем рекламу и обработку звонков.

Мастер подключения — пошаговая проверка запуска. Он показывает, какая часть связки уже готова, а какая ещё требует настройки.

Мультиаккаунт нужен, если у бизнеса несколько сайтов, направлений, городов, филиалов или номеров. Он позволяет управлять ими из одного входа, но не смешивать данные.

Примеры использования:

• разные города с разными номерами;
• один бизнес и несколько посадочных страниц;
• несколько услуг с отдельными рекламными кампаниями;
• агентство ведёт несколько клиентов;
• филиалы должны видеть свои звонки отдельно.

В приложении важно выбирать активный сайт, чтобы звонок попал в правильный проект.

PWA — это установка кабинета на главный экран телефона или компьютера. Это не отдельный магазин приложений, а удобный способ быстро открывать сервис.

• быстрый доступ к кабинету;
• уведомления по важным событиям;
• ручная фиксация звонков в сценариях, где автоматизация ограничена;
• удобная работа с телефона без постоянного ввода адреса сайта.

На iPhone PWA не получает полный доступ к звонкам, поэтому его нельзя считать заменой Android-приложению.

Уведомления помогают быстрее видеть важные события: новый звонок, проблемы со связкой, истечение тарифа или необходимость проверки.

Если уведомления не приходят:

• проверьте разрешение уведомлений в браузере;
• убедитесь, что PWA установлена или сайт открыт в поддерживаемом браузере;
• проверьте режим энергосбережения на устройстве;
• обновите подписку на push в кабинете;
• проверьте, что уведомления не отключены в системных настройках.

Тариф выбирается по задаче, объёму настройки и формату сопровождения. Разница между тарифами — в составе работ, глубине запуска и дальнейшей поддержке.

Стоимость и состав работ могут зависеть от сайта, ниши, региона, количества направлений и рекламной задачи.

Пробный период нужен не для накопления большой статистики, а для проверки технической связки: сайт, номер, приложение, Метрика и первый тестовый звонок.

1. Добавить сайт и номер.
2. Подключить Метрику.
3. Поставить код на сайт.
4. Установить приложение или PWA.
5. Сделать тестовый звонок.
6. Убедиться, что событие дошло до кабинета и Метрики.

Если тариф оплачен с автопродлением, следующий период списывается автоматически через сохранённый способ оплаты. Управление автопродлением доступно в кабинете.

В кабинете отображаются:

• активный тариф;
• дата окончания периода;
• статус автопродления;
• способ оплаты, если он сохранён;
• кнопка отключения автопродления или отвязки способа оплаты.

Если способ оплаты отвязан, новый период не продлевается автоматически.

• достаточно ли средств на карте;
• не заблокирована ли операция банком;
• актуален ли сохранённый способ оплаты;
• не истёк ли срок действия карты;
• активен ли тариф после успешного платежа;
• не использован ли другой аккаунт при входе.

Если платёж прошёл, но тариф не активировался, нужно передать в поддержку email аккаунта, дату оплаты и сумму.

Партнёрская программа подходит специалистам по рекламе, сайтам, маркетингу и продажам, которые приводят клиентов в Колтреон.

Клиент закрепляется за партнёром через партнёрскую ссылку или регистрацию, связанную с партнёрским кабинетом. После закрепления партнёр видит клиента и связанные с ним оплаты.

• партнёр получает свою ссылку;
• клиент регистрируется по ссылке;
• оплаты клиента отображаются в кабинете партнёра;
• вознаграждение считается от оплат клиента;
• заявка на вывод создаётся в кабинете.

Кабинет партнёра нужен, чтобы не вести расчёты вручную. В нём должны отображаться клиенты, оплаты, процент партнёра, сумма к выводу и статус заявок.

Партнёр получает процент от оплат клиентов, которые закреплены за ним по правилам партнёрской программы. Стандартная модель начисления — 30% от оплат закреплённого клиента.

В кабинете отображается основание начисления: кто оплатил, когда прошла оплата, какой тариф или услуга оплачены и какая сумма участвует в расчёте.

Если клиент был привлечён партнёром и затем продлил тариф, продление также учитывается по условиям партнёрской программы.

API используется для интеграции Колтреон с телефониями, CRM и внешними системами. Основная задача API — принять данные о звонке, сопоставить их с номером проекта и передать результат в кабинет и связанные сервисы.

Публичная версия API находится в разделе /api_v1. Для описания методов предусмотрен файл /api_v1/openapi.json.

• проверка доступности API;
• универсальный импорт звонка;
• проверка статуса импортированного звонка;
• вебхуки популярных телефоний;
• вебхуки CRM для передачи завершённых звонков.

Публичные методы API используют авторизацию через Bearer Token. Токен передаётся в HTTP-заголовке:

Authorization: Bearer YOUR_API_TOKEN

Токен нельзя вставлять в открытый JavaScript на сайте. Его используют только на сервере, в CRM, телефонии или защищённом backend-сервисе.

Если токен скомпрометирован, его нужно заменить и обновить во всех интеграциях.

Метод:

GET /api_v1/ping.php

Он не требует авторизации и возвращает состояние сервиса, версию API и время сервера.

{
  "ok": true,
  "service": "CallTreckingOne API",
  "version": "1.1.0",
  "time_utc": "2026-07-07T12:00:00+00:00"
}

Метод:

POST /api_v1/calls/import.php
Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN

Минимальный набор данных:

{
  "source": "custom_crm",
  "external_call_id": "CALL-1001",
  "direction": "in",
  "caller_phone": "+79990000000",
  "called_phone": "+74950000000",
  "duration_sec": 64,
  "is_missed": false,
  "event_time": "2026-07-07T15:20:00+03:00",
  "strict_number_match": true
}

external_call_id нужен для защиты от дублей. Если один и тот же звонок придёт повторно, система сможет обновить существующую запись, а не создать новую.

Метод:

GET /api_v1/calls/status.php?external_call_id=CALL-1001&source=custom_crm
Authorization: Bearer YOUR_API_TOKEN

Можно передавать call_id или связку external_call_id и source. В ответе возвращается статус звонка, длительность, номер, признак целевого звонка, связь с визитом и признаки отправки событий в Метрику.

В API предусмотрены отдельные входные точки для популярных телефоний и CRM. Они принимают формат конкретного провайдера и приводят данные к общей структуре звонка.

Для провайдерских вебхуков обычно используется токен в query-параметре. Точный формат зависит от провайдера.

При отладке всегда сохраняйте полный запрос, ответ API, время отправки, внешний ID звонка и номер, на который пришёл вызов.

Файл спецификации находится по адресу:

/api_v1/openapi.json

Его можно открыть в Swagger Editor, Postman, Insomnia или другой системе, которая умеет читать OpenAPI 3.0.

Спецификация полезна разработчику: она показывает доступные методы, обязательные поля, формат авторизации и примеры ответов.

У Android-приложения есть внутренние методы для входа, списка сайтов, передачи звонков, ping-запросов и синхронизации. Они находятся в разделе /api/mobile.

Эти методы предназначены для официального приложения Колтреон. Для внешних CRM и телефоний нужно использовать публичный /api_v1, потому что он стабильнее для интеграций и описан через OpenAPI.

1. Проверьте, что код Колтреон стоит на странице, с которой звонили.
2. Проверьте, что номер на сайте совпадает с номером в кабинете.
3. Откройте сайт с телефона и нажмите именно кнопку звонка.
4. Убедитесь, что ссылка телефона имеет формат tel:+7....
5. Проверьте, что приложение авторизовано и активно.
6. Проверьте, не звонили ли с другого устройства.
7. Проверьте, не прошло ли слишком много времени между визитом и звонком.

Если сайт сделан нестандартно, отдельно проверьте мобильную кнопку «Позвонить»: именно она часто отличается от десктопной версии.

• проверьте, что код добавлен на нужный домен, а не на тестовую копию;
• очистите кеш CMS, CDN и браузера;
• проверьте http/https и www/non-www редиректы;
• откройте исходный код страницы и найдите фрагмент Колтреон;
• убедитесь, что код не удаляется минификатором или оптимизатором;
• проверьте мобильный шаблон отдельно.

1. Проверьте вход в приложение.
2. Проверьте выбранный активный сайт.
3. Разрешите приложению работу в фоне.
4. Отключите жёсткую экономию батареи для приложения.
5. Проверьте разрешения телефона и вызовов.
6. Проверьте интернет на устройстве.
7. Обновите приложение до последней версии.
8. Сделайте тестовый звонок после перезапуска приложения.

• подключён ли правильный счётчик Метрики;
• есть ли права у Яндекс-аккаунта;
• прошёл ли звонок порог целевого события;
• не отключён ли OAuth-доступ;
• не была ли цель удалена или переименована в Метрике;
• прошло ли достаточно времени для отображения события в отчётах.

Сначала смотрите статус звонка в кабинете, затем проверяйте цель в Метрике.

Дубли обычно появляются, когда один и тот же звонок приходит из нескольких источников или внешняя система отправляет повтор без стабильного идентификатора.

Для API-интеграций обязательно передавайте external_call_id. Для мобильного приложения проверьте, что не включены одновременно две схемы фиксации одного и того же звонка без дедупликации.

• один звонок — один внешний ID;
• повторная отправка должна обновлять запись, а не создавать новую;
• не подключайте две телефонии к одному номеру без проверки;
• сравнивайте время, номер клиента и длительность.

После смены номера или домена нужно обновить связку, иначе звонки будут попадать не туда или не будут связываться с сайтом.

1. Обновить номер в кабинете.
2. Проверить номер на всех страницах сайта.
3. Проверить мобильную версию.
4. Проверить код Колтреон на новом домене или поддомене.
5. Обновить настройки Метрики и Директа при необходимости.
6. Сделать тестовый звонок.