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

Марквиз и Sendsay

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

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

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

  1. Авторизуйтесь в личном кабинете Марквиз и создайте новый квиз.

  2. Добавьте в форму поля, которые хотите передавать в Sendsay — например, Email, Имя, Фамилия и Отчество.

    Form fields
    Важно

    Если вы идёте чётко по инструкции и хотите передавать эти 4 поля, следует использовать именно такой порядок полей в начале формы — так система корректно сопоставит поля между Марквиз и Sendsay.

    О том, как передавать другие поля или в другом порядке, читайте здесь.

  3. Перейдите в раздел Интеграции, проскролльте страницу вниз и нажмите на интеграцию Webhook:

Webhooks

  1. В открывшимся окне нажмите «Добавить хук» и вставьте следующую ссылку:

    https://be.sendsay.ru/backend/api/<API-ключ>/member.set/email/-/member.email,set.copy,answers[0].a/base.firstName,set.copy,answers[1].a/base.lastName,set.copy,answers[2].a/base.middleName,set.copy,answers[3].a

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

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

    Эта ссылка обеспечит передачу полей email-адреса, имени, фамилии и отчества, когда пользователь заполнит форму.

  2. Нажмите «Готово», затем нажмите «Опубликовать» в квизе.

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

Если нужно передавать другие поля​

URL-адрес ссылки содержит однотипные команды, разделённые слешем /:

  • member.email,set.copy,answers[0].a
  • base.firstName,set.copy,answers[1].a
  • base.lastName,set.copy,answers[2].a
  • base.middleName,set.copy,answers[3].a

Каждая команда указывает, в какие поля базы данных Sendsay поместить данные из формы Марквиз. Общий формат каждой команды такой:

<КОД ПОЛЯ В SENDSAY>,set.copy,answers[<НОМЕР ПОЛЯ В ФОРМЕ МАРКВИЗ>].a

где <КОД ПОЛЯ В SENDSAY> — это уникальный идентификатор поля в анкетах Sendsay. Например, поле Имя имеет код base.firstName:

Code

<НОМЕР ПОЛЯ В ФОРМЕ МАРКВИЗ> — это порядковый номер вопроса в форме Марквиз. В формах Марквиз нумерация полей начинается с 0. Значит, поле email имеет номер [0], а остальные, по порядку — [1], [2] и [3] соответственно. Важно сохранять этот порядок, иначе данные заполненных полей в Марквиз могут некорректно записаться в Sendsay.

Если вы хотите добавить в форму ещё поле, вам необходимо дополнить webhook-ссылку. Рассмотрим на примере поля Город.

В базовой анкете в Sendsay уже есть поле base.city, а в форме Марквиз вопрос стоит на пятом месте. Поскольку нумерация идёт с 0, номер поля будет равен [4]. В результате команда для передачи поля Город будет выглядеть как base.city,set.copy,answers[4].a. Вся ссылка с 5 полями полностью:

https://be.sendsay.ru/backend/api/<API-ключ>/member.set/email/-/member.email,set.copy,answers[0].a/base.firstName,set.copy,answers[1].a/base.lastName,set.copy,answers[2].a/base.middleName,set.copy,answers[3].a/base.city,set.copy,answers[4].a    ```

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

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

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