Для чего
Когда в Bitrix24 изменяется сделка, Vakas-tools автоматически создаёт заказ в GetCourse с нужным предложением, суммой и статусом. Если в Bitrix24 назначен ответственный, в заказе GetCourse можно указать менеджера. После создания заказа данные (номер заказа, ссылка на оплату) записываются обратно в поля сделки Bitrix24.
Настройка выполняется в разделе «Связки» через мастер «Bitrix24 → GetCourse».
Что нужно для настройки
- Подключённый Bitrix24 в разделе «Сервисы и доступы» (авторизация через OAuth)
- Подключённый GetCourse в разделе «Сервисы и доступы» (API-ключ)
- Созданная База в Vakas-tools (инструкция)
- В GetCourse: созданное предложение (offer) с кодом, который будет подставляться в заказ
- В Bitrix24: пользовательское поле сделки (UF_CRM_*), в которое записан код предложения GetCourse
Создание связки
Откройте мастер создания связки
1 Перейдите в «Базы»
В левом меню выберите «Базы».
2 Откройте ссылки нужной базы
Найдите базу, в которую будут записываться события, и нажмите вкладку «Ссылки» на карточке базы.
3 Перейдите на вкладку «Связки CRM»
На странице «Ссылки для приёма данных» выберите вкладку «Связки CRM».
4 Нажмите «+ Создать связку»
Откроется страница выбора сценария.
5 Выберите «Bitrix24 → GetCourse»
Нажмите на карточку «Bitrix24 → GetCourse» с описанием «Создать заказ при изменении сделки». Откроется мастер настройки.
Настройте подключения
1 Укажите название связки
По умолчанию «Заказ из Bitrix24 в GetCourse». Можно изменить на своё.
2 Выберите Базу
В выпадающем списке выберите базу, в которую будет записываться событие оплаты при создании заказа.
3 Выберите аккаунт Bitrix24
Выберите подключённый аккаунт Bitrix24, из которого будут приходить данные о сделках.
4 Выберите аккаунт GetCourse
Выберите подключённый аккаунт GetCourse, в котором будет создаваться заказ.
При смене аккаунта Bitrix24 или GetCourse страница перезагружается, чтобы подтянуть поля сделки и данные выбранного аккаунта.
Укажите данные заказа
В разделе «Откуда брать данные о заказе» укажите, какие поля сделки Bitrix24 использовать для создания заказа в GetCourse. Список пользовательских полей сделки (UF_CRM_*) подгружается автоматически из выбранного аккаунта Bitrix24.
1 Код предложения в GetCourse
Выберите поле сделки Bitrix24, в котором хранится код предложения (offer) GetCourse. Это обязательное поле: по нему GetCourse определяет, какой именно заказ создать.
2 Стоимость
Выберите, откуда брать сумму заказа: «Сумма сделки» (стандартное поле бюджета) или конкретное пользовательское поле сделки.
3 Валюта
Выберите валюту заказа: RUB, USD, EUR, KZT, BYN или UAH.
4 Статус заказа в GetCourse
Выберите статус, с которым будет создан заказ: В работе, Новый, Оплачен, Отменён или Не подтверждён. Дополнительно можно поставить галочку «Помечать как оплаченный».
Если в Bitrix24 нет пользовательского поля для кода предложения, создайте его в настройках сделки Bitrix24. Название может быть любым (например «Код предложения ГК»), тип: строка.
Менеджер заказа
Необязательный раздел. Если нужно, чтобы в заказе GetCourse был указан менеджер, заполните таблицу соответствия: слева выберите ответственного сделки в Bitrix24, справа укажите email менеджера в GetCourse (его логин в GetCourse).
- Email менеджера в GetCourse может отличаться от его почты в Bitrix24
- Можно добавить несколько строк соответствия (кнопка «+ Строка»)
- Если ответственный сделки не найден в таблице, заказ будет создан без менеджера
Обратная запись в Bitrix24
Необязательный раздел. После создания заказа Vakas-tools может записать результат обратно в поля сделки Bitrix24. Для каждого значения выберите пользовательское поле сделки, куда его записать, или оставьте «не записывать».
| Значение | Описание |
|---|---|
| № заказа ГК | Номер созданного заказа в GetCourse |
| Ссылка на заказ ГК | Прямая ссылка на заказ в панели GetCourse |
| Ссылка на оплату | Ссылка для оплаты заказа (можно отправить клиенту) |
| ID пользователя ГК | ID пользователя в GetCourse |
| Ссылка на пользователя ГК | Ссылка на карточку пользователя в GetCourse |
Обратная запись удобна для менеджеров: прямо в сделке Bitrix24 видны номер заказа и ссылка на оплату, не нужно переключаться в GetCourse.
Дополнительные поля
Необязательный раздел. Можно передать дополнительные данные из Bitrix24 в поля заказа или пользователя в GetCourse. Для этого заполните таблицы соответствия:
- Доп. поля заказа в GetCourse: слева выберите поле заказа GetCourse, справа укажите поле Bitrix24, из которого брать значение
- Доп. поля пользователя в GetCourse: аналогично, но для полей пользователя (фамилия, город, страна и пользовательские поля GetCourse)
Примечание в сделку Bitrix24
После обработки события к сделке в Bitrix24 добавляется комментарий с результатом. По умолчанию в нём номер заказа, ссылка на оплату и статус. Текст можно изменить или оставить пустым, чтобы комментарий не добавлялся.
Доступные шорткоды для текста примечания:
| Шорткод | Значение |
|---|---|
| {#response_deal_id#} | Номер заказа в GetCourse |
| {#response_deal_link#} | Ссылка на заказ |
| {#response_deal_payment_link#} | Ссылка на оплату |
| {#response_deal_status#} | Статус заказа |
| {#response_user_id#} | ID пользователя в GetCourse |
| {#error_message#} | Текст ошибки (пусто при успехе) |
Сохраните связку
Нажмите «Создать связку». Связка начнёт работать сразу: при изменении сделки в Bitrix24 данные поступят в Vakas-tools и создастся заказ в GetCourse.
Как это работает
Bitrix24 отправляет вебхук в Vakas-tools при каждом изменении сделки. Vakas-tools получает данные сделки и контакта, создаёт заказ в GetCourse через API и записывает результат обратно в поля сделки Bitrix24.
- В Bitrix24 изменяется сделка (например, переводится на нужную стадию)
- Bitrix24 отправляет вебхук в Vakas-tools
- Vakas-tools читает данные сделки и контакта из Bitrix24
- В GetCourse создаётся пользователь (если его ещё нет) и заказ с указанным предложением, суммой и статусом
- Результат (номер заказа, ссылка на оплату) записывается обратно в поля сделки Bitrix24
- В сделку добавляется комментарий с результатом
Вебхук приходит при каждом изменении сделки. Если нужно создавать заказ только при определённом условии (например, при переходе на конкретную стадию воронки), настройте условие в правилах Базы.