Для чего нужна интеграция
- Лиды без ручного переноса. Заявки из лид-форм VK Рекламы, чаты и звонки Авито Объявлений становятся сделками в выбранном направлении и на выбранной стадии.
- Без дублей. Контакт ищется по номеру телефона; повторное обращение клиента попадает комментарием в его открытую сделку.
- Быстрая реакция. Ответственный менеджер и дело «Связаться с клиентом» со сроком от 5 минут до 2 часов.
- Переписка с покупателем Авито прямо в Битрикс24. С приложением АдСкоуп чаты Авито приходят в «Открытые линии»: переписка — в окне чата сделки, ответ уходит покупателю в Авито. Без приложения — комментарием с «!».
- Источник в каждой сделке. АдСкоуп заполняет UTM-поля сделки — по ним видно площадку, кабинет, форму или объявление.
- Сквозная аналитика. Расход кабинетов клиента сопоставляется со сделками: сколько заявок дошло до каждой стадии и до продажи, выручка, цена продажи, причины провала — по площадкам и кампаниям.
Что понадобится
- Аккаунт АдСкоуп — вход по адресу электронной почты на странице входа.
- Облачный Битрикс24 на платном тарифе (или с включённым пробным периодом) — на бесплатном тарифе Битрикс24 закрывает доступ к API, и вебхук не создаётся.
- Пользователь Битрикс24 с правом создавать вебхуки (обычно администратор). Сделки будут создаваться от его имени.
- Для пересылки заявок — подключённый в АдСкоуп кабинет VK Рекламы и/или профиль Авито Объявлений.
Создайте входящий вебхук в Битрикс24
В Битрикс24: меню слева → «Разработчикам» → вкладка «Другое» → «Входящий вебхук».
В блоке «Настройка прав» нажмите «+ выбрать» и отметьте:
- CRM (crm) — обязательно: воронки, сделки, контакты, дела;
- Пользователи (user) — чтобы в маршруте можно было выбрать ответственного. Без этого права всё работает, ответственным будет создатель вебхука.
Поля «Метод» и «Генератор запросов» не трогайте — они только для проверки.
Нажмите «Сохранить» и скопируйте адрес из поля «Вебхук для вызова rest api» — видаhttps://ваш-портал.bitrix24.ru/rest/1/код/.
Подключение в АдСкоуп
В личном кабинете АдСкоуп — «Интеграции», вкладка Битрикс24. Для одного клиента агентства — откройте клиента и его вкладку «Интеграции».
Вставьте скопированный адрес и нажмите «Подключить». АдСкоуп проверит, что у вебхука есть право CRM, и прочитает направления и стадии.
У портала появится отметка «подключено». Новый вебхук того же портала (после «Перегенерировать» или с другими правами) подключается так же — существующее подключение обновится, маршруты и аналитика сохранятся.
Маршруты заявок
Маршрут — правило «откуда и что пересылать → куда в Битрикс24». Нажмите «Новый маршрут»:
Кабинет и события: лиды из лид-форм (VK Реклама), чаты и звонки (Авито Объявления).
Направление (воронка) и стадия — предлагаются только рабочие стадии, не «Успешно» и не «Провал»; ответственный.
- Повторное обращение — в открытую сделку контакта в этом направлении или всегда новая сделка;
- метки через запятую — в Битрикс24 нет тегов, поэтому метки пишутся в поле сделки «Описание источника»;
- дело «Связаться с клиентом» ответственному со сроком 5, 15, 30, 60 или 120 минут.
После сохранения нажмите «Тест» — в Битрикс24 появится тестовая сделка, а в «Журнале» маршрута — запись о доставке.
Как создаются сделки
| Источник | Название сделки | UTM-поля сделки |
|---|---|---|
| Лид-форма VK | «VK лид: название формы» | UTM_SOURCE=vk_ads, UTM_MEDIUM=lead_form, UTM_CONTENT — форма |
| Чат Авито | «Авито: название объявления» | UTM_SOURCE=avito, UTM_MEDIUM=chat, UTM_CONTENT — ID объявления |
| Звонок Авито | «Звонок с Авито: …» | UTM_SOURCE=avito, UTM_MEDIUM=call, UTM_CONTENT — ID объявления |
- Контакт — с именем и телефоном из заявки; если контакт с таким телефоном есть — используется он.
- Ответы лид-формы и подробности обращения — комментарием в таймлайне сделки.
- Новые сообщения того же чата Авито — комментариями в ту же сделку. Если сделку удалили — создаётся новая.
- Ответ покупателю Авито из Битрикс24: добавьте в сделку чата комментарий, начинающийся с
!— текст после знака уйдёт покупателю в чат Авито, а в сделке появится «✓ Отправлено клиенту в чат Авито» или причина ошибки. Работает для чатов с активностью за последние 30 дней.
Чаты Авито в окне чата Битрикс24
Вебхук не умеет подключать мессенджеры к Битрикс24 — это делает только приложение. Приложение АдСкоуп добавляет в контакт-центр канал «Авито · АдСкоуп», как WhatsApp или Telegram:
- сообщение покупателя приходит в чат открытой линии «Авито · АдСкоуп», CRM-трекер линии создаёт сделку;
- АдСкоуп переносит сделку в воронку и стадию маршрута, ставит ответственного, UTM и описание источника, добавляет карточку объявления;
- менеджер отвечает в окне чата сделки — ответ уходит покупателю в Авито, у сообщения появляется отметка «доставлено»;
- сделки из линии считаются в сквозной аналитике так же, как обычные заявки (Авито Объявления, кабинет профиля).
Установка. Приложение АдСкоуп ставится из Маркета Битрикс24 (сейчас — на подготовке к публикации; до неё подключение — по заявке в поддержку АдСкоуп). Права приложения — CRM, Открытые линии, Коннекторы для мессенджеров, Чат и уведомления. После установки АдСкоуп сам создаёт линию «Авито · АдСкоуп» со сделками и включает на ней канал; подключить канал к другой линии можно в контакт-центре. Вебхук для заявок и аналитики остаётся как есть.
Если приложение не установлено или линия не создала сделку (например, трекер настроен на лиды), чат приходит обычной сделкой с комментариями, а ответ — комментарием с «!».
Сквозная аналитика
Настройка — у клиента в разделе «Сквозная аналитика»:
- Объедините рекламные кабинеты заказчика в клиента.
- Выберите подключение Битрикс24 и направления, которые относятся к клиенту.
- Поле суммы продажи — «Сумма» сделки или своё поле типа «Число» / «Деньги». Суммы в другой валюте пересчитываются в базовую валюту портала по курсам из настроек Битрикс24.
- Дата продажи: по созданию сделки (окупаемость рекламы периода) или по закрытию (выручка за месяц).
- Для сделок без UTM — поле-список или стандартное поле «Источник»: АдСкоуп отнесёт сделку к площадке по его значению.
- Продажа — сделка на стадии «Успешно»; отказ — на стадии провала. Причина отказа — название провальной стадии: заведите в направлении несколько стадий провала («Дорого», «Не дозвонились»…), чтобы видеть причины.
- Дошли до стадии считается по истории смены стадий: сделка, проваленная после встречи, всё равно учитывается во встречах.
- Сделки обновляются раз в 10 минут, при первом подключении — за последние 180 дней. Удалённые в Битрикс24 сделки исчезают из отчёта в течение 6 часов. Кнопка «Сверить с CRM» сравнивает число сделок в отчёте и в портале.
Какой доступ получает АдСкоуп и какие данные хранит
| Действие | Что именно |
|---|---|
| Читает | направления и стадии, пользователей (для выбора ответственного), сделки и их поля, историю смены стадий, справочник источников |
| Создаёт | контакты, сделки, комментарии и дела — только по вашим маршрутам; читает комментарии сделок чатов Авито (ответы покупателям) |
| Не делает | не удаляет и не изменяет сделки и контакты, не меняет настройки портала |
- Адрес вебхука хранится в зашифрованном виде.
- Данные заявки (имя, телефон, текст) хранятся только до доставки и затем удаляются из очереди.
- Для аналитики — обезличенные сведения о сделках: номер, направление и стадии, сумма, UTM, даты. Имена, телефоны и текстовые поля не сохраняются.
Подробнее — в Политике конфиденциальности.
Отключение
- В АдСкоуп: «Интеграции» → Битрикс24 → «Отключить». Маршруты и аналитические данные удаляются, сделки в Битрикс24 остаются.
- В Битрикс24: «Разработчикам» → «Интеграции» → удалите вебхук. Пересылка остановится, в АдСкоуп появится отметка «нет доступа».
Частые вопросы
Битрикс24 просит купить подписку при создании вебхука
На бесплатном тарифе Битрикс24 доступ к API закрыт. Нужен платный тариф; для проверки можно включить пробный период в «Мой тариф».
Не вижу ответственных в маршруте
Добавьте вебхуку право «Пользователи (user)», сохраните и подключите портал в АдСкоуп заново — маршруты сохранятся.
Заявка не пришла — что проверить?
«Журнал» маршрута показывает, была ли заявка, и ответ Битрикс24. Проверьте, что маршрут включён, а портал в статусе «подключено».
Куда писать, если что-то не работает?
На treiddens@gmail.com или в Telegram @gibbsonone.