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

Typeform и Sendsay

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

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

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

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

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

Form fields

Важно

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

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

  1. Перейдите в раздел Connect → WEBHOOKS и нажмите «Add a webhook»:

    Webhook

  2. В открывшемся модальном окне вставьте следующую ссылку:

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

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

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

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

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

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

Адрес вебхук-ссылки содержит однотипные команды, разделённые слешем /:

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

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

<КОД ПОЛЯ В SENDSAY>,form_response.answers[<НОМЕР ПОЛЯ В ФОРМЕ TYPRFORM>].<ТИП ПОЛЯ>

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

Code

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

<ТИП ПОЛЯ> — тип поля в форме Typeform. Cамые распространённые типы полей в Typeform:

  • text — текстовое поле, а также все стандартные поля Typeform, предполагающие ответ текстом (name, surname и другие),
  • phone_number - номер телефона,
  • email - email-адрес,
  • boolean - вопросы, на которые предполагается ответ да или нет,
  • choice.label - выбор из нескольких вариантов ответа: картинка, выпадающий список, чекбокс и прочие,
  • number - числовое поле, а также все стандартные поля в Typeform, на которые предполагается ответ числом: оценка, рейтинг, NPS-опрос и прочие,
  • date - дата,
  • url - адрес веб-сайта.

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

В базовой анкете в Sendsay уже есть поле base.city, а в форме Typeform вопрос стоит на пятом месте. Поскольку нумерация идёт с 0, номер поля будет равен [4]. Город — это текстовое поле, значит тип поля будет text.

В результате команда для передачи поля Город будет выглядеть как base.city,set.copy,form_response.answers[4].text. Вся ссылка с 5 полями полностью:

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

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

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

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