Подключение портала и уведомления в чат

Что умеет интеграция и что для неё нужно — в Битрикс24: что умеет интеграция и с чего начать.

#1. Заведите входящий вебхук на портале

1. Войдите в Битрикс24 сотрудником, от имени которого будет работать интеграция. Лучше служебной учёткой.
2. Откройте Приложения → Разработчикам → Другое → Входящий вебхук.
3. В правах (scope) поставьте галочки:
   • Чат и уведомления (im) — обязательно: без него нет ни уведомлений, ни приёма обращений из чата;
   • Задачи (task) — если нужен обмен задачами;
   • Пользователи (user) — чтобы сопоставить людей команды с сотрудниками портала.
4. Сохраните вебхук и скопируйте его адрес целиком. Он выглядит так: https://ваш-портал.bitrix24.ru/rest/17/abc123def456/.

Адрес вебхука — это ключ к порталу. Не пересылайте его в чатах и почте: вставьте сразу в кабинет.

#2. Подключите портал в кабинете

1. Откройте Ещё → Битрикс24.
2. Вставьте адрес в поле «Адрес вебхука» и нажмите Подключить портал.
3. Кабинет сразу проверит связь и покажет, от чьего имени работает интеграция и какие права выданы. Выданные права отмечены зелёным, невыданные — серым.

Не хватает права — вернитесь к вебхуку на портале, поставьте галочку, сохраните и нажмите Проверить связь.

#3. Выберите, куда писать уведомления

В блоке Куда писать заполните форму:

• Что уведомлять — весь кабинет, отдельный сайт или сервер. Уведомление о сайте уходит в чат этого сайта, а если его нет — в общий чат кабинета. В чат попадает одна копия, без дублей.
• В какой чат — групповые чаты сотрудника вебхука. Нужного чата нет — добавьте этого сотрудника в чат на портале и обновите страницу. Если список не пришёл, впишите номер чата из его адреса, например chat123.
• Что именно писать — всё, только тревожное (по умолчанию) или только критическое.
• Темы — например, только «Сайты» и «Серверы». Ничего не отмечено — все темы.

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

#Как это работает

• Сообщения уходят через очередь, обычно в течение минуты после события.
• Одно событие — одно сообщение: падение сайта, замеченное из шести точек проверки, придёт одним сообщением.
• Каждое сообщение заканчивается подписью «Website Director · …» и ссылкой в кабинет.
• Личные настройки уведомлений (письмом, сводкой) на чат не влияют: чат один на команду, и отбор для него задаётся на привязке.

#Заменить вебхук или отключить портал

• Заменить. Вебхук перевыпустили или сотрудник уволен — на странице Битрикс24 раскройте Заменить адрес вебхука и вставьте новый адрес того же портала. Чаты, задачи и приём обращений сохранятся.
• Отключить. Кнопка Отключить удаляет подключение вместе с привязками чатов, настройками задач и приёмом обращений. Записи в журнале действий остаются.

#Если не работает