Интеграция с Google Forms

Чтобы настроить создание карточек из google forms воспользуемся механизмом вебхуков - если вы пока не знакомы с ним, пожалуйста, прочитайте эту статью.

1) В настройках пространства, на котором будут размещаться карточки из формы, создайте новый вебхук. В меню "Формат" выберите "Google Forms". Скопируйте полученный webhook url.

2) Перейдите в google forms и установите дополнение Email Notifications add-on, после чего вызовите его через иконку "Дополнения".

В открывшемся меню выберите пункт Webhooks for Google Forms.

3) Нажмите на кнопку Create Webhook в появившемся окне. Заполните следующие поля:

• Webhook name: к одной форме можно подключить несколько вебхуков, поэтому выберите имя, позволяющее точно идентифицировать куда отправляет данные конкретный вебхук.

• Method: POST

• Request URL: вставьте сюда webhook-url, полученный для вашего пространства

  

4) Перейдите на вкладку "Request Body". Укажите:

• Content Type: application/json

Ниже в таблице указаны какие данные могут быть получены из вашей формы: предлагаемые к заполнению поля, а также техническая информация. Для того чтобы создать карточку на основании полученного ответа вам необходимо указать одно обязательное поле - title - оно станет заголовком вашей карточки. Вы можете выбрать для этого любое поле из предложенных - просто переименуйте ключ в левой колонке. Или добавьте новое: в свободной строке внизу таблицы введите title и укажите значение (можно воспользоваться переменными указанными в двойных фигурных скобках, например "Ответ #{{Response Number}} из {{Form Name}}").

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

Настройка вебхука в google forms

Карточка в Kaiten на основании полученного ответа

5) С помощью кнопки Test вы можете отправить тестовый запрос, чтобы убедиться, что карточка создается с нужной вам информацией. Обратите внимание, если вы настраиваете вебхук для новой формы и в поле "title" будет записываться информация, которую указывает пользователь - при тестировании это поле будет пустым, и вы получите ошибку "Field title is required". В таком случае, протестируйте вебхук, сохранив его и отправив ответ непосредственно из формы.

6) Ваш вебхук готов к работе, теперь вся информация будет у вас под рукой в вашем рабочем пространстве.