REST API Битрикс24

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

При помощи REST можно перемещать лид или сделку по воронке на нужную стадию.

Откроем раздел «Автоматизировать продажи» в инструменте Разработчикам. Мы видим готовые сценарии для лида и для сделки. В рамках урока выберем «Продвинуть сделку по воронке». Скачиваем готовый пример и загружаем его на сервер так же, как мы это делали ранее в уроке «Локальные интеграции».

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

Посмотрим на код примера.

В нем используется лишь метод обновления сделки. В качестве параметров нужно указать идентификатор той сделки, которую мы хотим передвинуть, а также идентификатор нужной нам стадии. В примере используется предопределенный идентификатор WON, который позволяет перевести сделку в статус успешно закрытой.

Вернемся в интерфейс Битрикс24. И выберем какую-то из сделок в нашем канбане. Если открыть карточку этой сделки, то в адресной строке мы сможем подсмотреть идентификатор сделки.

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

Однако остается вопрос, а как узнать идентификаторы нужных нам стадий, если это не системные стадии, а пользовательские?

Нам снова пригодится раздел Разработчикам, поскольку мы прямо там сможем получить нужную нам информацию.

Воспользуемся генератором запросов.

Выберем метод crm.status.list, а в качестве параметра укажем фильтр, который позволит нам получить именно статусы сделок. Для этого зададим параметр filter по полю ENTITY_ID равным значению DEAL_STAGE.

Выполним запрос прямо в генераторе запросов. Для нашего удобства Битрикс24 показывает результат в двух видах: в json-строке «как есть» и в виде дешифрованного массива данных.

В нем мы видим всю полученную информацию о стадиях сделок, включая нужные нам идентификаторы.

Например, если нам нужно автоматически переводить сделки в стадию «Счет на предоплату», то нам потребуется указывать идентификатор стадии 105 при вызове метода crm.deal.update.