メインコンテンツまでスキップ

İYS Consent Sync

İYS Consent Syncは、MonoChatのワークスペースをトルコの商用メッセージ同意システムİYS(İleti Yönetim Sistemi)に接続します。ブランド自身のİYS APIアカウントを使って、アプリは次のことを行います。

  • フローから顧客の同意または拒否をİYSに登録する
  • 商用メッセージの前にİYSで顧客の同意を確認する
  • İYSでの同意の変更を1時間ごとに読み取り、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選んだタイプについて、選んだ同意ソースで、顧客の同意(ONAY)または拒否(RET)をİYSに登録します。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はメッセージ、通話、メールの3つのタイプで同意を管理します。İYSのAPIドキュメントにも規則にもWhatsAppの記載はありません。商用送信に必要なタイプを選んでください。変更しない限り、ノードは Message (MESAJ) を使います。

İYSからの変更​

アプリは1時間ごとにİYSでの同意の変更を読み取ります。顧客がİYSで自ら行った変更と、ブランドが任意のシステムからİYSに登録した変更です。レポート › İYS consents には、各番号とメールアドレスの最新ステータスが、タイプ、ソース、同意日とともに表示されます。

  • İYSは変更を1時間後にしか一覧に出さないため、一覧は最大2時間遅れることがあります。
  • 設定 › İYS には、最後に読み取った日時と、失敗した場合はそのエラーが表示されます。
  • この一覧はアプリ独自のものです。MonoChatの顧客プロフィールは変更されず、一斉送信が自動で顧客を除外することもありません。フローで商用メッセージの前に İYS · Check consent を置いてください。

知っておきたいこと​

  • İYSでは1つのAPIアカウントのサインインは同じアドレスから1時間に最大10回までです。そのためアプリはİYSのセッションを保持し、期限が切れたときだけ再度サインインします。
  • アプリは同意日として現在の時刻で同意を登録します。