Скилл Битрикс24 в Aizor: как подключить и автоматизировать CRM и задачи

Вы менеджер по продажам и ведёте сделки в Битрикс24. Каждое утро надо найти просроченные задачи, после звонка завести карточку клиента, к вечеру собрать список того, что горит. Ничего сложного, но уходит на это столько времени, что на самих клиентов остаётся меньше.

Скилл Битрикс24 передаёт эту рутину агенту Aizor: вы пишете обычными словами, а он идёт в ваш портал. Ниже разберём подключение на примере такого менеджера.

Что агент умеет в Битрикс24?

Официальное описание от команды Aizor: скилл подключает агента к Битрикс24 через REST API, автоматизирует CRM, задачи и чаты, обрабатывает события и вебхуки, поддерживает авторизацию по вебхуку и OAuth.

Агент сам переводит ваши слова в запросы к API. Это полезно тому, кто ведёт сделки и задачи и тратит время на рутину: завести карточку, найти просроченное, собрать список. О самом приложении есть отдельная страница.

Что нужно подготовить?

Прежде чем создавать ключ, проверьте три вещи:

• Битрикс24 с доступом к REST API. По документации он доступен на платных тарифах при подписке Маркетплейс. До покупки подписку можно попробовать: в разделе «Мой тариф» нажмите «Включить демо».
• Право создавать вебхуки. Если пункта «Входящий вебхук» в меню нет, обратитесь к администратору: сотрудник без прав администратора сам себе доступ не выдаст.
• Приложение Aizor для macOS или Windows и скилл Битрикс24 из каталога.

Где взять ключ API?

Вам нужен вебхук, и делается он за пять шагов. Для одного портала Битрикс24 документация советует входящий вебхук. Запросы идут с правами сотрудника, который его создал, и только в пределах выбранных скоупов.

1. В левом меню откройте раздел Приложения > Разработчикам.
2. Перейдите на вкладку Готовые сценарии > Другое > Входящий вебхук. Откроется окно с уже готовым кодом вебхука.
3. В блоке Настройка прав отметьте скоупы под задачи агента: crm для CRM, task для задач, im для чата и уведомлений, disk для файлов. Лишнее не отмечайте.
4. Сохраните вебхук. Адрес вида https://ваш-портал.bitrix24.ru/rest/1/секретный-код/ и есть ключ: в нём адрес портала, номер сотрудника и секретный код.
5. Проверьте адрес: откройте в браузере тот же адрес с добавкой profile.json. Метод profile не требует прав и возвращает данные создателя вебхука.

Затем установите скилл Битрикс24 из каталога Aizor и вставьте адрес вебхука в его настройки.

А когда нужен OAuth? Он подходит, если решение работает у разных пользователей или нужны методы, которым требуется контекст приложения (например, placement.bind, часть телефонии и чат-ботов): вебхуку они недоступны. Локальное приложение добавляют там же, в «Разработчикам», его по умолчанию создаёт администратор. Токен access_token живёт один час, refresh_token 180 дней. Для задач «заведи сделку» и «покажи задачи» вебхука хватает. Так что OAuth большинству не понадобится.

Как проверить, что всё работает?

Сначала запросы, которые только читают, а запись оставьте на конец и под подтверждением:

• «Покажи мой профиль в Битрикс24» (только чтение).
• «Выведи 10 последних сделок и их стадии».
• «Найди мои задачи со сроком на этой неделе».
• «Создай задачу: позвонить клиенту завтра в 11:00» (запись: сначала под подтверждением).

Как это выглядит в работе?

Как завести сделку после звонка?

Вы диктуете агенту данные клиента, и он создаёт сделку или контакт в CRM через метод crm.item.add и называет номер. Перед созданием агент показывает, что именно запишет.

Как не забыть про просроченные задачи?

По расписанию агент читает ваши задачи, выбирает просроченные и те, что горят сегодня, и присылает список в чат Aizor или Telegram-бот. Права на запись не нужны. Если задачи у вас ещё и в другом сервисе, смотрите скилл Trello.

Можно ли реагировать на события в портале?

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

Как отправить напоминание в чат?

Агент может отправить сообщение сотруднику или в групповой чат через скоуп im: напомнить о встрече или сообщить, что сделка перешла на новую стадию. Отправку лучше пускать через ручное подтверждение.

Что делать, если Битрикс24 вернул ошибку?

Код ошибки агент покажет сам, а по таблице видно, что поправить.

Что видите	Причина	Что делать
INVALID_CREDENTIALS (401)	Нет активного вебхука с таким номером сотрудника и кодом.	Скопируйте адрес вебхука заново из раздела «Разработчикам».
insufficient_scope (401)	Методу нужен скоуп, которого нет у вебхука.	Добавьте скоуп в настройках вебхука и сохраните.
ACCESS_DENIED (401)	REST API доступен только на коммерческих тарифах.	Перейдите на платный тариф и подключите подписку Маркетплейс.
QUERY_LIMIT_EXCEEDED (503)	Слишком частые запросы. Порог 50 на большинстве тарифов, 250 на Энтерпрайз.	Снизьте частоту, повторите позже.
OPERATION_TIME_LIMIT (429)	Метод слишком долго выполнялся для этого вебхука.	Подождите: блокировка снимается сама. Просите меньше данных за раз.

Как не отдать агенту лишнего?

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

• Давайте вебхуку минимум скоупов. Если агент только читает CRM, оставьте crm и не отмечайте остальное. Внутри отмеченных скоупов агент может всё, что может создатель вебхука.
• Создавайте отдельный вебхук под агента от обычного сотрудника, не от администратора, если задачам хватает его прав.
• Создание и изменение сделок, отправку сообщений и любые удаления пускайте через ручное подтверждение в Aizor.
• Адрес вебхука работает как пароль: не публикуйте его и не пересылайте в чатах. Хранить его нужно только в настройках скилла.
• У вебхука может быть дата окончания: после неё запросы не проходят. Если адрес вебхука попал в чужие руки, замените вебхук в разделе «Разработчикам» и вставьте новый адрес в скилл.

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

Инструкция написана по официальной документации Битрикс24 (apidocs.bitrix24.ru), состояние на октябрь 2026 года. Интерфейс кабинета и условия могут измениться. Автор Aizorlab участвует в партнёрской программе Aizor.