跳到主要内容

İYS Consent Sync

İYS Consent Sync 将您的 MonoChat 工作区连接到土耳其商业消息同意系统 İYS(İleti Yönetim Sistemi)。借助您品牌自己的 İYS API 账户,该应用可以:

  • 从您的流程中在 İYS 登记客户的同意或拒绝;
  • 在发送商业消息前在 İYS 核验客户的同意;
  • 每小时读取 İYS 中的同意变更,并在 MonoChat 中列出。

开始之前​

您需要:

  1. 品牌的 İYS API 账户。 账户所有者或账户管理员通过 e-Devlet 登录 İYS 并创建 API 账户,İYS 会提供用户名和密码。如果想先试用该应用,也请创建一个测试账户。
  2. 您的 İYS 编号(iysCode)和品牌代码(brandCode),即 İYS 分配给您公司和品牌的编号。

连接 İYS​

  1. 从 MonoStore 安装应用。
  2. 打开 设置 › İYS。
  3. 选择 Environment:İYS 测试账户选 Test (sandbox),正式账户选 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)。
  • 对于消息和通话,节点使用客户资料中的电话号码,并带国家代码(+90…)发送给 İYS;对于电子邮件,使用电子邮件地址。No contact 表示资料中没有该类型所需的联系方式。
  • 当 İYS 返回错误(号码格式错误、密码错误)时,节点会走失败分支。
  • 登记 İYS 已有的状态会计为 Registered。
WhatsApp

İYS 按三种类型保存同意:消息、通话和电子邮件。İYS 的 API 文档和法规都没有提到 WhatsApp。请选择您的商业发送所需的类型;如不更改,节点使用 Message (MESAJ)。

来自 İYS 的变更​

应用每小时读取 İYS 中的同意变更:包括客户自己在 İYS 中做出的变更,以及您的品牌从任何系统登记到 İYS 的变更。报告 › İYS consents 显示每个号码和电子邮件地址的最新状态,以及其类型、来源和同意日期。

  • İYS 只在一小时后才列出变更,因此列表最多可能滞后两小时。
  • 设置 › İYS 显示上次读取的时间,以及读取失败时的错误。
  • 该列表属于应用本身。它不会更改 MonoChat 中的客户资料,群发消息也不会自动跳过客户:请在流程中把 İYS · Check consent 放在商业消息之前。

须知​

  • İYS 允许一个 API 账户从同一地址每小时最多登录 10 次,因此应用会保留其 İYS 会话,只在会话过期时重新登录。
  • 应用以当前时间作为同意日期登记同意。