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

YCLIENTS и Sendsay

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

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

Важно

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

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

Настройка интеграции проходит в 3 этапа: необходимо создать пользовательские поля клиента, аккаунт разработчика и приложение, а затем подключить приложение в ваш филиал. Как это сделать:

1. Создайте пользовательское поле клиента​

Авторизуйтесь в Yclients. Перейдите в интерфейс управления сетью: в боковом меню перейдите в Настройки → Дополнительные поля → Доп. данные клиента, нажмите «Добавить поле» и заполните поля в открывшемся окне:

  • Название: Фамилия
  • Тип: Текст
  • Ключ-значение для API: lastName

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

YCLIENTS

При необходимости вместо фамилии вы можете создать любое другое поле, которое хотите передавать в Sendsay. В этом случае создайте для него понятный ключ-значение для API — и сохраните его для webhook-ссылки.

2. Создайте приложение​

В боковом меню перейдите в раздел Интеграции → Аккаунт разработчика. Создайте аккаунт разработчика, если у вас его нет. Затем:

  1. Нажмите «Создать приложение»:

    YCLIENTS

  2. В настройках выберите тип «Непубличное» и заполните остальные поля:

    YCLIENTS

  3. Во вкладке Монетизация выберите тип «Бесплатное»:

    YCLIENTS

    Затем нажмите «Добавить приложение». Откроется страница созданного приложения:

    YCLIENTS

  4. Перейдите во вкладку Настройки подключения и укажите в поле Адрес, на который отправлять уведомления ссылку:

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

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

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

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

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

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

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

3. Подключите интеграцию​

Перейдите в раздел Общая информация и скопируйте ссылку в поле Ссылка на приложение. Затем откройте скопированную ссылку в новой вкладке браузера — откроется карточка приложения. Нажмите «Подключить»:

YCLIENTS

На этом настройка интеграции завершена.

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

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