İ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:
- 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.
- Your İYS number (
iysCode) and brand code (brandCode), the numbers İYS gave your company and your brand.
Connect İYS
- Install the app from MonoStore.
- Open Settings › İYS.
- Choose the Environment: Test (sandbox) for an İYS test account, Live for your live account.
- Enter the İYS number (iysCode), the Brand code (brandCode), the API username and the API password.
- Choose the Recipients: Individual (BIREYSEL) or Merchant (TACIR). The app registers and checks consents for this recipient type.
- 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.
| Node | What it does | Outputs |
|---|---|---|
| İYS · Register consent | Registers 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 consent | Asks İ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.
İ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.