[Партнерам] Обновление раздела «Уведомления» в YCLIENTS (2023)

В скором времени в YCLIENTS будет обновлен раздел с настройками уведомлений.

Раздел изменится структурно, визуально и функционально.

Изменения, которые затронут партнеров YCLIENTS

В рамках обновления раздела «Уведомления» у пользователей YCLIENTS появится возможность отдельно указывать текст для SMS и WhatsApp, а также подключать эти каналы раздельно друг от друга.

Как будет происходить отправка уведомлений?

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

• Сначала отправится по email и push в приложение YPLACES.
• Если не удастся доставить уведомление в приложение YPLACES, то отправится уведомление ВКонтакте.
• Если уведомление ВК не удастся доставить, то будет попытка отправить его в WhatsApp.
• SMS в данном случае отправлено не будет.

В случае, если партнер осуществляет отправку уведомлений по каналу WhatsApp, то YCLIENTS отправит партнеру запрос на отправку уведомления по стандартному протоколу отправки сообщений с заданным на стороне YCLIENTS текстом уведомления для данного канала.

Канал, по которому необходимо отправить уведомление будет передаваться партнеру в поле channel.

Партнерам нужно будет поддерживать обработку этого поля в том случае, если через партнера отправляются уведомления по нескольким каналам, например WhatsApp и SMS.

Для корректной работы каскадной отправки также необходимо, чтобы партнер передавал в YCLIENTS корректные статусы отправленных уведомлений. Если YCLIENTS не будет получать корректную информацию о доставке/не доставке сообщения, это сделает невозможной отправку каскадных уведомлений.

Собственный текст для каждого канала отправки

При редактировании уведомления пользователи смогу указать различный текст для каждого из доступных им каналов отправки. Например, если у пользователя подключен WhatsApp и SMS, то он сможет указать разный текст одного уведомления для этих каналов.

При отправке уведомления YCLIENTS передаст партнеру необходимый текст для каждого из каналов.

Подключение каналов отправки

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

Также возможно при помощи АПИ метода изменить список активных каналов отправки после подключения приложения. Описание методов будет позже.

При активации канала отправки, пользователь увидит этот канал активным в настройках уведомлений с указанием партнера, который активировал этот канал в филиале.

При активации канала отправки в форме редактирования уведомлений появится поле для указания текста уведомления для этого канала.

Если партнер не передаст никаких значений при подключении интеграции, то по умолчанию для чат-ботов будет активирован канал WhatsApp, а для SMS-агрегаторов канал SMS.

Активация канала, который уже подключен в филиале

Вводные: в филиале подключен SMS-агрегатор и активен канал SMS.

Филиал подключает чат-бота, который активирует ему два канала: SMS и WhatsApp.

Канал WhatsApp будет активирован и сразу после подключения чат-бота, YCLIENTS начнет отправлять через партнера WhatsApp уведомления.

SMS уведомления продолжат отправляться через ранее активного SMS агрегатора. В настройках каналов у канала «SMS» появится выбор, через какого партнера отправлять уведомления. Там пользователь сможет выбрать чат-бота и отправка SMS начнется через него.

Если партнер игнорирует текст, отправляемый YCLIENTS и заменяет его на свой?

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

Вместо поля редактирования текст уведомления будет выводиться текст, сообщающий, что для изменения текста шаблона нужно перейти на сайт партнера (см. Telegram на скрине ниже).

Как партнеру дать YCLIENTS понять, что для настройки текста шаблона нужно вести пользователя к партнеру?

В настройках приложения партнеру необходимо будет отметить/снять соответсвующий флаг: «Редактирование текста шаблонов на стороне YCLIENTS». Если флаг снят, то вместо поля ввода на стороне YCLIENTS будет выводиться заглушка, ведущая на сайт партнера. По умолчанию у всех будет стоять этот флаг.

Что еще изменится в разделе «Уведомления»?

1.  Главной страницей раздела настроек уведомлений станет список с типами уведомлений (вместо страницы «SMS-уведомления»)

2. Будет упразднена страница «SMS-уведомления» (сейчас является главной страницей раздела). На смену ей придет страница «Каналы отправки», где пользователи смогут управлять всеми доступными в YCLIENTS каналами отправки уведомлений. Пользователи смогут подключать нужные им каналы с этой страницы. Например, если пользователь кликнет «Подключить» у канала WhatsApp, то откроется страница Маркетплейса интеграций со списком партнеров, у которых указан канал уведомлений WhatsApp.

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

— Настройки условий отправки и настройка каскадов на табе «Общие настройки»;

— Настройка текстов для каждого канала отправки на табе «Шаблоны уведомлений».

4. В редактировании текста уведомлений появляются новые возможности:

— предпросмотр текста с учетом переменных;

— возможность добавлять эмодзи сразу из интерфейса редактирования;

— переменные шаблонов будут отображаться в виде человеко-читаемых названий и будут добавляться при помощи их выбора из списка;

Когда релиз?

Предполагаемое время завершения работ и начала релиза на ограниченную выборку пользователей — середина августа 2023, а затем будет постепенный релиз на остальных пользователей.