Уведомления из Битрикс24 в Telegram: лиды, сделки и задачи

Уведомления из Битрикс24 в Telegram в nana800 собираются без кода: исходящий вебхук Битрикс24 сообщает схеме о новом лиде или сделке, блок «Bitrix24» получает полную запись по ID, а бот присылает её в Telegram. Нужны бот от @BotFather и два вебхука Битрикс24, свой сервер не нужен. Одно уведомление - это два запуска по цене базового блока и запрос в Битрикс24, который вдвое дороже.

Собрать в конструкторе

Что можно автоматизировать

  • Присылать в рабочую группу каждый новый лид: название, имя, телефон и сумму
  • Сообщать о новых сделках с суммой и стадией, а кнопкой под сообщением открывать карточку сделки в Битрикс24
  • Получать в Telegram новые задачи: событие создания задачи и операция get_task блока «Bitrix24»
  • Следить за сделками по стадии: бесплатный блок «condition» пропускает только нужную стадию, например WON
  • Отсекать чужие запросы: блок «condition» сверяет код авторизации, который Битрикс24 присылает с каждым событием

Как настроить

  1. 1

    Создайте входящий вебхук для чтения записей

    Входящий вебхук - это секретный адрес, через который nana800 читает данные портала. В Битрикс24 откройте «Разработчикам», «Другое», «Входящий вебхук». Отметьте права на CRM (и на Задачи, если нужны задачи), сохраните и скопируйте адрес. По нему блок «Bitrix24» читает лид или сделку. Адрес секретный, nana800 скрывает его в логах и экспорте схемы.

  2. 2

    Добавьте в схему триггер «webhook»

    Создайте схему, добавьте триггер «webhook» с методом POST и путём, например /b24. Включите схему: выключенная отвечает на вебхуки ошибкой. Нажмите кнопку «API» в конструкторе и скопируйте адрес вебхука.

  3. 3

    Создайте исходящий вебхук

    В Битрикс24 там же, в «Разработчикам» и «Другое», выберите «Исходящий вебхук». Вставьте адрес из nana800 как адрес обработчика и выберите событие, например создание лида или сделки. Сохраните код авторизации из настроек вебхука: Битрикс24 присылает его с каждым событием.

  4. 4

    Прочитайте запись блоком «Bitrix24»

    Битрикс24 присылает только событие и ID записи: у лидов и сделок это event и data.FIELDS.ID в body триггера. Добавьте блок «Bitrix24», операцию get_lead (для сделок get_deal), адрес входящего вебхука и ID из триггера. Запись придёт в record: название TITLE, имя NAME, телефоны PHONE, сумма OPPORTUNITY.

  5. 5

    Отправьте сообщение в Telegram

    Добавьте блок «Telegram message send»: токен бота, ID чата из @getmyid_bot или ID группы, куда добавлен бот. Подставьте в текст поля записи и выберите оформление plain_text. Кнопка со ссылкой из адреса портала (auth.domain в триггере), /crm/lead/details/ и ID откроет лид в Битрикс24.

  6. 6

    Проверьте на тестовом лиде

    Создайте тестовый лид и откройте историю запусков схемы: там видно, что прислал Битрикс24 и что вернул каждый блок. Оставьте схему включённой, иначе события не обработаются. Пока она включена, она стоит 0,42 ₽ в час.

Сколько стоит

Запуск блоков Битрикс24 стоит 0,20 ₽, блоков Telegram - 0,10 ₽. Каждый месяц баланс бесплатно пополняется до 350 ₽, включённая схема стоит 0,42 ₽ в час.

Сервисы в связке

  • Битрикс24

    Интеграция с Битрикс24 без кода: заявки с сайта становятся лидами и сделками, задачи ставятся сотрудникам сами. Бесплатный баланс каждый месяц, карта не нужна.

  • Telegram

    Соберите Telegram-бота без кода: ответы на сообщения, кнопки, заявки и уведомления в личку, группу или канал. Бесплатный баланс каждый месяц, карта не нужна.

Частые вопросы

Одно уведомление - это запуск триггера «webhook» и отправка в Telegram по цене базового блока (100 ₽ за 1 000 запусков) и запрос блока «Bitrix24», который вдвое дороже. Блок «condition» бесплатный. Схема с вебхуком включена всё время, а это 0,42 ₽ в час. Баланс каждый месяц бесплатно пополняется до 350 ₽, и большая часть этой суммы уходит на часы работы схемы.

Исходящий вебхук сам сообщает nana800 о событии, но присылает только ID записи. Входящий вебхук нужен блоку «Bitrix24», чтобы по этому ID прочитать сам лид или сделку. Если хватает короткого сообщения вида «создан лид 123», можно обойтись без блока и входящего вебхука.

Выберите в исходящем вебхуке событие изменения сделки: оно приходит при любом изменении. Прочитайте сделку операцией get_deal и сравните её STAGE_ID блоком «condition», например с WON. В других воронках у стадий есть приставка, например C1:WON. Если сделку в этой стадии изменят ещё раз, сообщение придёт снова.

С каждым событием Битрикс24 присылает код авторизации исходящего вебхука, в данных триггера это auth.application_token. Поставьте после триггера бесплатный блок «condition» и сравните его с кодом из настроек вебхука: запрос с другим кодом не дойдёт до отправки в Telegram.

Проверьте, что схема включена, а в триггере выбран метод POST. Если запуск в истории есть, откройте результат блока «Bitrix24»: ошибка insufficient_scope значит, что у входящего вебхука нет прав на CRM или Задачи. Результат блока Telegram покажет ошибку Telegram, например если бот не добавлен в группу.

Соберите первую схему бесплатно

Регистрация бесплатная, карта не нужна. Каждый месяц баланс бесплатно пополняется до 350 ₽, этого хватает примерно на 3 500 запусков простых блоков.

Собрать в конструкторе