Перейти к основному содержимому
Опубликовано: 

Яндекс Формы и Sendsay

Яндекс Формы — онлайн-конструктор для создания форм, опросов и тестов. Интеграция позволяет автоматически передавать контакты и другие данные о клиентах из заполненных форм в Sendsay — без ручной загрузки файлов.

Чтобы импортировать данные в профиль клиента Sendsay, необходимо создать специальную webhook-ссылку, которая позволит сопоставить данные из JSON-файла с нужными полями анкет.

Важно

В рамках этой интеграции вы можете передать только 3 поля данных — из-за ограничений на длину webhook-ссылки на стороне сервиса Яндекс Формы.

Рассмотрим настройку передачи данных на примере 3 полей — email, имени и фамилии. Следуя инструкции, вы поймёте, как передавать вместо имени или фамилии любое другое поле:

  1. Авторизуйтесь в личном кабинете Яндекс Формы и создайте новую форму.
  2. Добавьте в форму поля Email, Имя и Фамилия.
  3. На странице редактирования формы перейдите во вкладку Интеграции. Проскролльте страницу до конца, нажмите API → Запрос JSON-PRC POST.

Form

  1. В настройках вебхука добавьте параметр: в левом текстовом поле укажите ключ параметра email, в правом поле нажмите + и в выпадающем списке выберите Ответ на вопрос. Затем в настройках перемеменных укажите вопрос Email и нажмите «Сохранить»:

    Webhooks settings

  2. Добавьте ещё 2 параметра для двух других полей, повторяя действия п. 4:

    • для поля Имя задайте ключ firstName,
    • для поля Фамилия задайте ключ lastName.

Form

  1. В поле URL введите следующую ссылку:

    https://be.sendsay.ru/backend/api/<API-КЛЮЧ>/member.set/email/-/member.email,set.copy,params.email/base.firstName,set.copy,params.firstName/base.lastName,set.copy,params.lastName

    где <API-ключ> — ваш API-ключ, полученный в Sendsay.

    Как получить API-ключ

    Обратите внимание на параметры params.firstName и params.lastName, где firstName — это ключ поля Имя, а lastName — ключ поля Фамилия, которые вы ввели для соответствующих ответов формы. Если хотите передать вместо них другие поля, замените firstName и lastName на ключи других параметров.

    Например, если необходимо передавать вместо фамилии поле Город, потребуется создать параметр с ключом city — и выбрать для него соответствующий ответ в форме. В базовой анкете Sendsay уже есть данное поле, значит ссылка для передачи данных будет выглядеть так:

    https://be.sendsay.ru/backend/api/<API-КЛЮЧ>/member.set/email/-/member.email,set.copy,params.email/base.firstName,set.copy,params.firstName/base.city,set.copy,params.city

    Подробнее о том, как создать вебхук-ссылку

  2. Нажмите «Сохранить».

На этом настройка интеграции завершена. После того, как пользователь заполнит форму, в Sendsay появится новый подписчик с указанными данными.

Как протестировать передачу данных​

  1. Опубликуйте и заполните форму.
  2. Перейдите в Sendsay и удостоверьтесь, что новый подписчик с указанными данными появился в базе контактов.