Skip to main content

İYS Consent Sync

İYS Consent Sync connects your MonoChat workspace to İYS (İleti Yönetim Sistemi), Türkiye's system for commercial message consent. It uses your brand's own İYS API account to:

  • register a customer's consent or refusal in İYS from your flows,
  • check a customer's consent in İYS before a commercial message,
  • read the consent changes in İYS every hour and list them in MonoChat.

Before you start​

You need:

  1. An İYS API account for your brand. The account owner or account manager signs in to İYS with e-Devlet and creates an API account. İYS gives a username and a password. Create a test account too if you want to try the app first.
  2. Your İYS number (iysCode) and brand code (brandCode), the numbers İYS gave your company and your brand.

Connect İYS​

  1. Install the app from MonoStore.
  2. Open Settings › İYS.
  3. Choose the Environment: Test (sandbox) for an İYS test account, Live for your live account.
  4. Enter the İYS number (iysCode), the Brand code (brandCode), the API username and the API password.
  5. Choose the Recipients: Individual (BIREYSEL) or Merchant (TACIR). The app registers and checks consents for this recipient type.
  6. Press Save, then Test connection. The app lists the brands İYS returns for your account.

Only the owner or a manager can change these settings. The password is never shown again; leave it empty to keep the saved one.

Use it in your flows​

Add a Function node to a flow under Settings › Automation › Flows and pick one of the app's nodes. See Flows.

NodeWhat it doesOutputs
İYS · Register consentRegisters the customer's consent (ONAY) or refusal (RET) in İYS for the type you choose, with the consent source you choose.Registered, No contact
İYS · Check consentAsks İYS whether the customer has consent for the type you choose. Put it before a commercial message.Approved, Not approved, No contact
  • Consent type: Message (MESAJ), Call (ARAMA) or E-mail (EPOSTA).
  • For messages and calls the node uses the phone number on the customer's profile, sent to İYS with its country code (+90…); for e-mail, the e-mail address. No contact means the profile has neither for that type.
  • When İYS answers with an error (a wrong number format, a wrong password), the node takes its failed branch.
  • Registering a status İYS already holds counts as Registered.
WhatsApp

İYS keeps consent for three types: messages, calls and e-mail. Neither İYS's API documentation nor the regulation names WhatsApp. Choose the type your commercial sends need; the nodes use Message (MESAJ) unless you change it.

Changes from İYS​

Every hour the app reads the consent changes in İYS: those your customers make in İYS themselves, and those your brand registers in İYS from any system. Reports › İYS consents shows the latest status of each number and e-mail address, with its type, source and consent date.

  • İYS lists a change only after an hour, so the list can be up to two hours behind.
  • Settings › İYS shows when the last read ran and its error, if it failed.
  • The list is the app's own. It does not change customer profiles in MonoChat, and bulk messages do not skip customers on their own: put İYS · Check consent before the commercial message in your flow.

Good to know​

  • İYS gives an API account at most 10 sign-ins an hour from one address, so the app keeps its İYS session and signs in again only when it expires.
  • The app registers the consent with the current time as its consent date.