Подключение Bitrix и настройка полей через «Логи»

1. Подключение Bitrix (базово)

1. Откройте админку сервиса и выберите нужный сайт.
2. Нажмите кнопку Добавить Bitrix.
3. Включите переключатель Bitrix включен для сайта.
4. Заполните поля:
   • Адрес портала (например, https://yourcompany.bitrix24.ru)
   • Webhook base URL (например, https://yourcompany.bitrix24.ru/rest/1/xxxxxx/)
5. Убедитесь, что crm.lead.add URL заполнился автоматически.
6. Нажмите Сохранить Bitrix.

После этого лиды начинают отправляться в базовом виде: имя, телефон, комментарий.

2. Зачем нужна кнопка «Логи»

В Tilda, Flexbe и других конструкторах поля могут приходить с разными ключами. Например, имя может прийти как name, your_name или fields[211645][value].

Если взять неверный ключ, в Bitrix может уехать подпись поля вместо значения пользователя (например, Phone вместо имени). Раздел «Логи» показывает реальные ключи и значения, чтобы вы настроили корректный маппинг.

3. Как настроить «Логи» и маппинг без ошибок

1. Откройте сайт в админке и нажмите Логи.
2. Отправьте тестовую заявку на сайте как обычный клиент.
3. Вернитесь в админку и нажмите Обновить.
4. Откройте свежий лог и найдите блок raw.values.
5. Определите ключи:
   • имя (главный приоритет),
   • телефон,
   • ответы на вопросы, которые хотите разложить по отдельным полям.

4. Что такое маппинг полей

Маппинг - это JSON-правило, которое описывает, откуда брать данные и куда отправлять.

• nameKey - ключ, из которого берется имя.
• phoneKey - ключ, из которого берется телефон.
• bitrix[] - соответствие ключей полям Bitrix.
• googleSheets[] - соответствие ключей колонкам Google Sheets.

5. Готовый шаблон маппинга

Вставьте шаблон в поле Маппинг полей в разделе Логи, замените ключи на свои и нажмите Сохранить маппинг.

{
  "nameKey": "fields[211645][value]",
  "phoneKey": "fields[893705][value]",
  "bitrix": [
    { "sourceKey": "fields[211645][value]", "targetField": "NAME" },
    { "sourceKey": "fields[500001][value]", "targetField": "UF_CRM_1710000001" },
    { "sourceKey": "fields[500002][value]", "targetField": "UF_CRM_1710000002" }
  ],
  "googleSheets": [
    { "sourceKey": "fields[211645][value]", "targetField": "client_name" },
    { "sourceKey": "fields[893705][value]", "targetField": "client_phone" },
    { "sourceKey": "fields[500001][value]", "targetField": "q1_answer" },
    { "sourceKey": "fields[500002][value]", "targetField": "q2_answer" }
  ]
}

6. Критичные правила (чтобы не ломалась передача)

1. Для имени чаще нужен ключ с [value], а не с [name].
2. В Bitrix поле NAME стандартное, PHONE отправляется отдельной логикой автоматически.
3. Ответы квиза отправляйте в кастомные поля UF_CRM_....
4. Если нужного UF_CRM_... нет, сначала создайте его в Bitrix.
5. После каждого изменения маппинга делайте тестовую заявку и проверку в логах.

7. Как это работает с Google Sheets

1. Если заполнен блок googleSheets[], значения пойдут по отдельным колонкам.
2. Новые колонки создаются автоматически скриптом Google Sheets.
3. Можно хранить каждый ответ квиза в своей колонке, а не только имя и телефон.

8. Быстрый чек-лист

9. Частые проблемы и решения