Yandex Forms

Yandex Forms — это сервис, где вы можете создавать опросы, собирать отзывы, принимать заявки, проводить тесты и квизы.

Создайте форму в Yandex Forms с вашими вопросами https://forms.yandex.ru/ и далее следуйте инструкции ниже.

Настройка Yandex

Обязательно! Необходимо настроить предзаполнение скрытого поля с идентификатором клиента.

Скрытые поля формы можно использовать для автоматической передачи в форму служебных или вспомогательных параметров. Это позволяет добавить к ответам пользователей дополнительную информацию для анализа и сбора статистики.

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

Чтобы настроить скрытый параметр, добавьте на форму вопрос типа Короткий текст с названием sb_id.

Для этого вопроса включите опцию Скрытый вопрос.

В поле Идентификатор вопроса укажите sb_id — это будет название GET-параметра.

Получите ссылку на форму и добавьте в конец URL-адреса GET-параметр ?sb_id=#{client_id}

Пример ссылки на форму с GET-параметром:

https://forms.yandex.ru/u/6191b18d99e21b1b45b9c82?sb_id=#{client_id}

Далее отправьте эту ссылку клиенту из бота.

При переходе по ссылке в скрытое поле sb_id автоматически будет подставляться значение из переменной #{client_id}.

sb_id - это обязательное поле, но вы таким же образом можете передавать и свои данные, например, utm_source (предварительно добавив это поле в форму, как и sb_id).

Пример ссылки с передачей данных с помощью поля в форме: https://forms.yandex.ru/u/6191b18d99e21b1b45b9c82?sb_id=#{client_id}&utm_source=telegram

Отправить свой колбек после заполнения формы

По умолчанию после отправки формы клиенту придет колбэк yandex_form_received.

Как настроить колбек со своим текстом, читайте далее. Для этого нужно создать еще одно скрытое поле с названием callback_text, все делаете аналогично как и sb_id.

Есть 2 варианта использования этого поля Замените стандартный колбек yandex_form_received для формы на ваш, для этого нужно указать Значение по умолчанию и не передавать параметр в ссылке (галочка Скрытый вопрос - установлена ), иначе он будет взят из ссылки.

Для отправки уникального колбека передавайте callback_text в ссылке со своим значением так же, как и sb_id, пример: https://forms.yandex.ru/u/6191b18d99e21b1b45b9c82?sb_id=#{client_id}&callback_text=test

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

Обязательно! Настройка вебхука должна производиться только после заполнения формы.

На странице нужной формы, перейдите во вкладку Интеграции

Далее внизу выбираем API -> Запрос JSON-RPC POST

В поле URL указываем ссылку https://chatter.salebot.pro/yandex_form/API_KEY где API_KEY - апи-ключ из настроек проекта в SaleBot

Пример ссылки: https://chatter.salebot.pro/yandex_form/43ad8d427073ea93377544cc4a408f89

В параметрах указываем sb_id и значение выбираем Ответ на вопрос, указываем sb_id

Для callback_text делаем тоже самое.

Так же можно добавить другие параметры, которые будут записаны в отдельные переменные клиента в SaleBot с указанными названиями. Например:

Будьте внимательны с названиями, чтобы не перетереть уже существующие переменные у клиента!

Чтоб сохранить все ответы в одну переменную, можно выбрать пункт Ответы на вопросы и выбрать все или, те, которые нужны, а также указать формат JSON, чтоб с ними легче было работать:

В итоге должна получиться такая настройка (параметры могут отличаться, если добавлены дополнительные):

Все переменные из формы будут записаны в переменные клиента Salebot.

Сохраняем изменения. На этом настройка завершена.

Пример значения переменной answers в диалоге клиента Salebot.

В настройках формы в эту переменную мы объединили ответы на все вопросы формы в формате Json

Для каждого вопроса формы можно указать отдельную переменную в настройках вебхука формы.

Выдать ссылку на форму в боте:

Пример 1

Пример 2

Онлайн-запись Salebot на Яндекс Картах

Яндекс Карты уже приносят компаниям новых клиентов, которые активно записываются онлайн. Каждый месяц через этот канал совершается более 500 тыс. онлайн-записей.

У вас есть возможность установить виджет онлайн-записи в интерфейс Яндекс Карт. При интеграции Яндекс создает свой виджет, основываясь на данных вашего филиала в Salebot.

Клиентам с этим виджетом будет гораздо проще записываться на услуги, потому что не нужно переходить на сайт, в другое приложение или звонить. Они смогут с легкостью создавать записи, при этом в приложении можно сразу проложить маршрут до места.

Подключение онлайн-записи на Яндекс Картах возможно при соблюдении условий:

1. Вид деятельности, указанный в карточке организации на Яндекс Картах, доступен для онлайн-записи через Яндекс Карты. Список таких видов деятельности можно посмотреть по ссылке

2. Страны: Россия и Беларусь.

3. Оплаченная подписка Salebot "Бизнес" и выше.

Подключение интеграции бесплатно.

Карточка вашей организации появится только в случае, если у вас доступна для онлайн-записи хотя бы одна индивидуальная услуга. Услуги для групповых событий не будут отображаться в виджете Яндекс Карт.

Настройка интеграции

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

2. В Salebot перейдите в раздел «CRM» > «Воронки», выберите воронку и нажмите «Редактировать воронку». В открывшихся настройках найдите раздел «Настройка онлайн-записей». Переведите чекбокс «Интеграция Онлайн-записей с Yandex.Maps» в активный статус и заполните поле «Адрес компании».

3. Для отображения кнопки онлайн-записи на Яндекс.Картах необходимо, чтобы информация в Salebot совпадала с информацией из вашей карточки компании в Яндекс Картах. Удостоверьтесь, что название и адрес компании совпадают.

4. Нажмите кнопку «Сохранить», что изменения вступили в силу. После подключения интеграции кнопка «Записаться онлайн» появится в Яндекс Картах в течение 7-10 дней. Если по истечении этого времени кнопка не отображается, обратитесь в техподдержку Яндекса и проверьте правильность введенных данных в настройках филиала в Salebot.

Примечания

• Если у вашей компании появился дубль в Яндекс Картах, то вы можете прямо на Яндекс Картах сообщить о нем. Для этого войдите в профиль организации и в разделе «Обзор» нажмите «Исправить неточность».

• В данный момент функционалы онлайн-оплаты и онлайн-продажи недоступны для виджетов онлайн-записи через Яндекс Карты.

• Яндекс выводит в свой виджет только услуги без предоплаты. Услуги с обязательной и необязательной онлайн-предоплатой в нем не отобразятся.

При онлайн-записи на Яндекс Картах SMS с кодом для подтверждения отправляется от Яндекса.