Документация
/ Документация
Руководство по интеграции

Уведомления, заявки и мессенджеры

Выберите канал по задаче: уведомить сотрудника, передать заявку в CRM или отвечать покупателю в мессенджере. Это разные подключения; сохранение Telegram-токена в уведомлениях не включает покупательского бота и не создаёт рабочее место оператора.

На этой странице

Подготовьте Получателей

Выберите сайт и определите, кто получает новые обращения. Подготовьте рабочую почту, бота и Chat ID для Telegram либо доступный HTTPS-адрес своей принимающей системы. Токены и адреса с секретами не публикуйте в инструкциях, скриншотах и переписке с покупателем. Заранее согласуйте, кто отвечает на контакт и когда: система уведомления не устанавливает срок реакции вашей команды.

Задача Раздел кабинета Результат
Сообщить сотруднику о событии Консультант → Уведомления Email, Telegram или вебхук
Передать собранный контакт Интеграции (/lk/integrations) Заявка во внешней системе
Отвечать покупателю вне сайта Мессенджеры (/lk/messengers) Подключённый разговорный канал
Проверить текст и контакт Диалоги / Заявки История разговора и карточка заявки

Включите Уведомления О Событиях

Откройте Консультант → Уведомления (/lk/consultant). Отметьте «О новом диалоге», «О новой заявке» или оба события. Затем включите хотя бы один канал и нажмите «Сохранить изменения». Флажок события без включённого получателя не является полной настройкой доставки.

Для Email укажите адрес в поле «Почта (по умолчанию — ваша)». Для Telegram создайте бота через @BotFather, добавьте его в нужный чат и заполните Bot token и Chat ID. Убедитесь, что бот имеет право писать в этот чат. Для «Вебхук (любой мессенджер/система)» требуется настоящий принимающий endpoint: ссылка на страницу CRM или приглашение в чат не заменяют обработчик.

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

Передавайте Заявки В CRM

В Интеграциях — доставка заявок используйте форму «Новое назначение». Доступные пресеты зависят от языка интерфейса: в английском варианте предлагается «Свой»; в других вариантах могут отображаться Bitrix24 и amoCRM. Не считайте отсутствие пресета неисправностью консультанта.

Для Bitrix24 нужен URL входящего вебхука с методом crm.lead.add.json. Для amoCRM нужны URL API /api/v4/leads и «Долгоживущий токен» Bearer. «Свой» отправляет JSON на POST-вебхук. После «Добавить» проверьте отметку «активно» и получение новой заявки на стороне назначения. Не обещайте, что создание назначения переносит старую историю или настраивает все бизнес-процессы CRM.

В Заявках (/lk/leads) доступны поиск по имени, телефону, email и тексту, а также состояния «Новая», «В работе», «Закрыта» (new, in_progress, done). Это состояния обработки контакта, не статусы заказа. Прочитайте сводку и следующий шаг, назначьте ответственного внутри своей команды и переводите заявку по мере работы.

Подключайте Покупательские Каналы Отдельно

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

Telegram требует токен бота; VK требует ключ сообщества с правом сообщений, строку подтверждения и настройку Callback API вручную. Скопируйте выданный адрес, укажите подтверждение и при необходимости секрет vk_secret. Avito требует client_id, client_secret и права messenger:read, messenger:write. Каналам нужен защищённый HTTPS-адрес сервиса. После подключения отправьте сообщение от настоящего покупательского аккаунта и проверьте ответ и «Последнюю ошибку».

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

Разбирайте Доставку По Этапам

Симптом Вероятная причина Действие
Диалог есть, уведомления нет Выключено событие или канал Проверить оба флажка и получателя
Заявка есть, CRM пуста Назначение выключено, URL или права неверны Проверить «активно», endpoint и доступ CRM
Telegram уведомляет, но не отвечает клиентам Настроены только уведомления Подключить канал в «Мессенджерах»
VK не получает сообщения Не настроен Callback API Проверить адрес, подтверждение и секрет
Канал сохранён, но выключен Провайдер отклонил подключение Прочитать последнюю ошибку, исправить доступ

Для приёмки используйте проверку запуска; качество ответа исправляйте в базе знаний, а не в настройках доставки.