Шаг 1
Общие доступы
Как получить данные:
- Убедитесь, что форма создана от лица организации.
- Перейдите на oauth.yandex.ru и войдите под аккаунтом, у которого есть доступ к форме.
- В разделе Ваши приложения нажмите Создать.
- Выберите Для доступа к API или отладки.
- Введите название приложения, например Интеграция с Битрикс24.
- Укажите почту для связи.
- В блоке доступа к данным добавьте право forms:read.
- Нажмите Создать приложение.
- Откройте созданное приложение и скопируйте Client ID.
- Перейдите по ссылке:
https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID - Подтвердите доступ и скопируйте выданный токен.
- ID организации возьмите в Яндекс Трекер → Администрирование → Организации → Идентификатор.
Шаг 2
Список CRM-форм
Как это работает
Каждая CRM-форма — это отдельная настройка. Для каждой формы будет своя ссылка, которую потом нужно вставить в Яндекс Формы.
Шаг 3
Основа CRM-формы
Сначала добавьте CRM-форму на предыдущем шаге.
Что здесь делаем
Выберите форму, укажите что нужно создавать в Битрикс24 и задайте сценарий: только сущность, сущность с контактом, компанией или сразу с обоими.
Шаг 4
Сопоставление полей
Что здесь делаем
Сопоставьте ответы из формы с полями Битрикс24. Если названия похожи, приложение уже предложит вариант автоматически, но его всегда можно изменить вручную.
Поля сущности
Поля контакта
Проверка дублей контакта
Поля компании
Проверка дублей компании
Статичные поля
Проверка на повторный лид
Статичные поля контакта
Статичные поля компании
Шаг 5
Готовая ссылка
Ссылка для Яндекс Форм
Сохраните CRM-форму, чтобы получить ссылку.
Куда вставлять ссылку:
- В настройках Яндекс Формы откройте раздел Интеграции.
- Нажмите + Добавить группу действий.
- Выберите API → Запрос выбранным методом.
- Вставьте ссылку в поле URL.
- Метод запроса: POST.
- В тело запроса вставьте только переменную Ответы на вопросы в виде JSON.
- В настройках переменной выберите все вопросы формы.