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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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