¶ Интеграция с Битрикс24
Интеграция передаёт доноров и пожертвования из GIVR в CRM Битрикс24. Компании она не создаёт. Если сделки нужно привязывать к компании сбора, такую компанию следует заранее создать в Битрикс24.
Коды
UF_CRM_..., стадии и ID списков уникальны для каждого портала. Значения со скриншотов копировать нельзя.
¶ Что создаётся в Битрикс24
- Контакт — донор.
- Сделка — отдельное пожертвование.
- Компания — необязательная, заранее созданная карточка сбора, к которой GIVR может привязать сделку по ID.
После изменения статуса платежа GIVR обновляет стадию соответствующей сделки.
¶ Что подготовить
- входящий вебхук Битрикс24 с доступом к CRM;
- категорию сделок для пожертвований и три стадии: попытка, оплата, ошибка;
- поля контакта и сделки;
- значения полей типа «Список»;
- при необходимости привязки — компанию Битрикс24 для соответствующего сбора.
URL вебхука содержит данные доступа. Не публикуйте его и не отправляйте в поддержку.
¶ Подготовка Битрикс24
В Битрикс24 создайте входящий вебхук, категорию сделок и недостающие поля. Для настройки понадобятся системные значения:
| Объект | Что указывать в GIVR |
|---|---|
| Стандартное поле | NAME, LAST_NAME, EMAIL, PHONE, COMMENTS, OPPORTUNITY, BEGINDATE, SOURCE_ID |
| Пользовательское поле | Код вида UF_CRM_... |
| Категория сделок | Числовой CATEGORY_ID |
| Стадия | Системный код стадии выбранной категории |
| Значение списка | ID элемента списка, а не его название |
| Компания | Числовой ID заранее созданной компании |
Тип поля должен соответствовать данным: даты — «Дата/время», суммы — число или деньги, фиксированные варианты — «Список».
¶ Как найти коды в Битрикс24
- Стандартные поля используйте по системному коду: например,
NAME,PHONEилиOPPORTUNITY. - Для пользовательского поля возьмите его код
UF_CRM_...из настроек поля контакта или сделки. - Для поля типа «Список» отдельно нужны код самого поля и ID каждого используемого значения.
CATEGORY_IDи коды стадий берите из одной и той же категории сделок.
Если код не отображается в интерфейсе, откройте HTML точного блока карточки контакта или сделки и найдите в нём нужный системный код или ID значения списка. Скриншота с масками UF_CRM_xxx и xxxxx для точной настройки недостаточно.
¶ Подключение в GIVR
- Откройте Фонд → Настройки → Битрикс24.
- В блоке Интеграция с Битрикс24 вставьте полный URL вебхука.
- Заполните блоки Данные донора и Данные сделки.
- При необходимости привяжите сборы к компаниям Битрикс24.
- Только после этого включите интеграцию и нажмите Сохранить.
| Настройка GIVR | Что указать |
|---|---|
| URL вебхука | Полный URL входящего вебхука Битрикс24 |
| Использовать интеграцию с Битрикс24 | Включить после заполнения всех сопоставлений |
¶ Поля донора
В блоке Данные донора указываются системные коды полей контакта Битрикс24.
| Поле GIVR | Что указать в Битрикс24 |
|---|---|
| ИД контактов благотворителей | ID значения типа контакта в TYPE_ID, используемого для благотворителей |
| Имя | NAME |
| Фамилия | LAST_NAME |
EMAIL |
|
| Телефон | PHONE |
| Дата первого платежа | Код поля контакта типа «Дата/время» |
| Дата последнего платежа | Код поля контакта типа «Дата/время» |
| Сумма максимального платежа | Код числового или денежного поля контакта |
| Сумма последнего платежа | Код числового или денежного поля контакта |
| Общее количество платежей | Код числового поля контакта |
| Общая сумма платежей | Код числового или денежного поля контакта |
| Средний чек | Код числового или денежного поля контакта |
| Рекуррентная подписка | Код поля контакта типа «Список» |
| Яндекс ClientId | Код строкового поля контакта |
| Google ClientId | Код строкового поля контакта |
| UTM тег campaign | Код отдельного строкового поля контакта для utm_campaign |
| UTM тег medium | Код отдельного строкового поля контакта для utm_medium |
| UTM тег source | Код отдельного строкового поля контакта для utm_source; не SOURCE_ID |
| UTM тег term | Код отдельного строкового поля контакта для utm_term |
| UTM тег content | Код отдельного строкового поля контакта для utm_content |
| Источник | Обычно SOURCE_ID |
¶ Значения списков донора
| Поле-список | Значение GIVR | Что указать в Битрикс24 |
|---|---|---|
| Рекуррентная подписка | Есть хотя бы одна активная подписка | ID соответствующего элемента списка |
| Рекуррентная подписка | Нет ни одной активной подписки | ID соответствующего элемента списка |
| Рекуррентная подписка | Не было ни одной подписки | ID соответствующего элемента списка |
| Источник | GIVR | ID значения GIVR в списке источников |
¶ Поля сделки
В блоке Данные сделки указываются системные коды полей сделки Битрикс24.
| Поле GIVR | Что указать в Битрикс24 |
|---|---|
| Категория "Пожертвование" | Числовой CATEGORY_ID категории сделок для пожертвований |
| Комментарий | COMMENTS |
| Компания | Код дополнительного поля сделки, в которое записывается ID компании сбора |
| Программа | Код строкового поля сделки для названия программы или сбора |
| Сумма | OPPORTUNITY |
| Итоговая сумма | Код числового или денежного поля сделки |
| Дата начала | BEGINDATE |
| Тип пожертвования | Код поля сделки типа «Список» |
| Платежный оператор | Код поля сделки типа «Список» |
| Способ платежа | Код поля сделки типа «Список» |
| Признак плательщика | Код поля сделки типа «Список» |
| Местонахождение плательщика | Код строкового поля сделки |
| Название шлюза | Код строкового поля сделки |
| Имя держателя карты | Код строкового поля сделки |
| Номер карты | Код строкового поля сделки для маскированного номера карты |
| Срок действия карты | Код строкового поля сделки |
| Эмитент | Код строкового поля сделки |
| Страна эмитента карты | Код строкового поля сделки |
| Номер транзакции эквайринга | Код строкового поля сделки |
| Код операции | Код строкового поля сделки |
| Описание кода операции | Код строкового или многострочного поля сделки |
| ID подписки эквайринга | Код строкового поля сделки |
| ID подписки сайта | Код строкового поля сделки |
| Яндекс ClientId | Код строкового поля сделки |
| Google ClientId | Код строкового поля сделки |
| UTM тег campaign | Код отдельного строкового поля сделки для utm_campaign |
| UTM тег medium | Код отдельного строкового поля сделки для utm_medium |
| UTM тег source | Код отдельного строкового поля сделки для utm_source; не SOURCE_ID |
| UTM тег term | Код отдельного строкового поля сделки для utm_term |
| UTM тег content | Код отдельного строкового поля сделки для utm_content |
| Ссылка страницы платежа | Код строкового поля сделки для URL |
| Источник | Обычно SOURCE_ID |
| Источник онлайн платежа детальный | Код отдельного строкового поля сделки |
Поле Компания не заменяет привязку сбора: если она настроена, GIVR также заполняет стандартный COMPANY_ID значением из карточки сбора.
¶ Стадии и списки
Для стадий указываются системные коды выбранной категории. Для остальных строк — ID элементов соответствующих списков Битрикс24.
| Группа | Значение GIVR | Что указать в Битрикс24 |
|---|---|---|
| Стадия платежа | Оплачено | Системный код успешной стадии выбранной категории |
| Стадия платежа | Платеж завершен с ошибкой | Системный код стадии ошибки выбранной категории |
| Стадия платежа | Попытка пожертвовать | Системный код начальной стадии выбранной категории |
| Тип пожертвования | Инитное | ID соответствующего элемента списка |
| Тип пожертвования | Корректировочное | ID соответствующего элемента списка |
| Тип пожертвования | Разовое | ID соответствующего элемента списка |
| Тип пожертвования | Ребилл | ID соответствующего элемента списка |
| Платежный оператор | CloudPayments | ID соответствующего элемента списка |
| Платежный оператор | ЮКасса | ID соответствующего элемента списка |
| Платежный оператор | MixPlat | ID соответствующего элемента списка |
| Способ платежа | Карты — первая строка | ID соответствующего элемента списка |
| Способ платежа | Карты — вторая строка | ID соответствующего элемента списка |
| Способ платежа | ЮMoney | ID соответствующего элемента списка |
| Способ платежа | WebMoney | ID соответствующего элемента списка |
| Способ платежа | SberPay — первая строка | ID соответствующего элемента списка |
| Способ платежа | Alfa Pay | ID соответствующего элемента списка |
| Способ платежа | Умный платёж | ID соответствующего элемента списка |
| Способ платежа | Yandex Pay — первая строка | ID соответствующего элемента списка |
| Способ платежа | СБП — первая строка | ID соответствующего элемента списка |
| Способ платежа | Мобильный платеж | ID соответствующего элемента списка |
| Способ платежа | SMS | ID соответствующего элемента списка |
| Способ платежа | Yandex Pay — вторая строка | ID соответствующего элемента списка |
| Способ платежа | T-Pay | ID соответствующего элемента списка |
| Способ платежа | MIR Pay | ID соответствующего элемента списка |
| Способ платежа | СБП — вторая строка | ID соответствующего элемента списка |
| Способ платежа | SberPay — вторая строка | ID соответствующего элемента списка |
| Признак плательщика | Физическое лицо | ID соответствующего элемента списка |
| Источник | GIVR | ID значения GIVR в списке источников сделки |
¶ Привязка сбора
Привязка сбора к компании Битрикс24 необязательна. Она нужна, если сделки по пожертвованиям требуется объединять по конкретным сборам.
Привязку удобно использовать, когда:
- одновременно работают несколько сборов и их сделки нужно разделять в CRM;
- в карточке компании необходимо видеть связанные пожертвования по конкретному сбору;
- отчёты или внутренние процессы Битрикс24 строятся с учётом компании сбора.
Если привязка не нужна, поле Связь с Битрикс24 можно оставить пустым. Контакт донора и сделка по пожертвованию продолжат передаваться, но сделка не будет связана с компанией.
Чтобы настроить привязку:
- Создайте в Битрикс24 отдельную компанию для сбора.
- Откройте сбор в GIVR на редактирование.
- Перейдите на вкладку Интеграции.
- В поле Связь с Битрикс24 укажите ID компании.
- Нажмите Сохранить и продолжить.
ID компании виден в адресе её карточки: в /crm/company/details/123/ идентификатор — 123.
Поля MixPlat, внешней страницы и переключатели API на этом экране к Битрикс24 не относятся.
¶ Проверка
Проведите тестовый платёж и проверьте:
- контакт донора создан или обновлён;
- сделка появилась в нужной категории и на правильной стадии;
- если используется привязка, в сделке указана нужная компания сбора;
- сумма, дата и источник переданы корректно.
¶ Если данные не передаются
Проверьте URL и права вебхука, CATEGORY_ID, коды стадий и ID элементов списков. Если используется привязка, также проверьте поле Связь с Битрикс24 в карточке сбора. Если проблема остаётся, передайте поддержке время платежа, название сбора и ID пожертвования — без URL вебхука.