Перейти к основному содержимому

İYS Consent Sync

İYS Consent Sync связывает ваше пространство MonoChat с İYS (İleti Yönetim Sistemi), турецкой системой согласий на коммерческие сообщения. С собственной API-учётной записью İYS вашего бренда приложение:

  • регистрирует в İYS согласие или отказ клиента из ваших сценариев,
  • проверяет согласие клиента в İYS перед коммерческим сообщением,
  • каждый час читает изменения согласий в İYS и показывает их в MonoChat.

Прежде чем начать​

Вам понадобятся:

  1. API-учётная запись İYS для вашего бренда. Владелец или администратор учётной записи входит в İYS через e-Devlet и создаёт API-учётную запись. İYS выдаёт имя пользователя и пароль. Создайте и тестовую учётную запись, если хотите сначала попробовать приложение.
  2. Ваш номер İYS (iysCode) и код бренда (brandCode) — номера, которые İYS присвоила вашей компании и бренду.

Подключение İYS​

  1. Установите приложение из MonoStore.
  2. Откройте Настройки › İYS.
  3. Выберите Environment: Test (sandbox) для тестовой учётной записи İYS, Live для рабочей.
  4. Заполните İYS number (iysCode), Brand code (brandCode), API username и API password.
  5. Выберите Recipients: Individual (BIREYSEL) или Merchant (TACIR). Приложение регистрирует и проверяет согласия для этого типа получателей.
  6. Нажмите Save, затем Test connection. Приложение покажет бренды, которые İYS возвращает для вашей учётной записи.

Изменять эти настройки может только владелец или менеджер. Пароль больше не показывается; оставьте поле пустым, чтобы сохранить прежний.

Использование в сценариях​

Добавьте узел Функция в сценарий в разделе Настройки › Автоматизация › Сценарии и выберите один из узлов приложения. См. Сценарии.

УзелЧто делаетВыходы
İYS · Register consentРегистрирует в İYS согласие (ONAY) или отказ (RET) клиента для выбранного типа с выбранным источником согласия.Registered, No contact
İYS · Check consentСпрашивает İYS, дал ли клиент согласие для выбранного типа. Ставьте его перед коммерческим сообщением.Approved, Not approved, No contact
  • Тип согласия: Message (MESAJ), Call (ARAMA) или E-mail (EPOSTA).
  • Для сообщений и звонков узел берёт номер телефона из профиля клиента и отправляет его в İYS с кодом страны (+90…); для e-mail — адрес электронной почты. No contact означает, что в профиле нет ни того, ни другого для этого типа.
  • Если İYS отвечает ошибкой (неверный формат номера, неверный пароль), узел уходит в ветку ошибки.
  • Регистрация статуса, который уже есть в İYS, считается Registered.
WhatsApp

İYS хранит согласия для трёх типов: сообщения, звонки и e-mail. Ни документация API İYS, ни регламент не упоминают WhatsApp. Выберите тип, который нужен вашим коммерческим рассылкам; по умолчанию узлы используют Message (MESAJ).

Изменения из İYS​

Каждый час приложение читает изменения согласий в İYS: те, что клиенты вносят сами в İYS, и те, что ваш бренд регистрирует в İYS из любой системы. Отчёты › İYS consents показывает последний статус каждого номера и адреса e-mail с типом, источником и датой согласия.

  • İYS показывает изменение только через час, поэтому список может отставать до двух часов.
  • Настройки › İYS показывает, когда было последнее чтение, и его ошибку, если оно не удалось.
  • Список принадлежит приложению. Он не меняет профили клиентов в MonoChat, и массовые рассылки сами не пропускают клиентов: поставьте İYS · Check consent перед коммерческим сообщением в сценарии.

Полезно знать​

  • İYS разрешает API-учётной записи не более 10 входов в час с одного адреса, поэтому приложение хранит сессию İYS и входит заново только после её истечения.
  • Приложение регистрирует согласие с текущим временем в качестве даты согласия.