外部システムからメールディーラーの画面を開くための設定を行います。
外部システムをご利用の際、ワンクリックでメールディーラー上の顧客情報や、
顧客情報に紐づくメール応対の履歴を参照することができます。
対象画面
外部システム側で呼び出し設定を行うことでメールディーラーの
下記情報を表示することが可能です。
・メール一覧呼び出し
・顧客情報参照
・新規メール作成
メール一覧画面呼び出し
パラメータで指定したメールアドレスに紐づくメールを一覧で表示します。
呼び出しイメージ
・複数メールアドレスをカンマ区切り指定し、1テーブル上に表示することができます
※メールディーラー上の関連付けは反映されません。
・メール一覧だけをシンプルに表示することができます（埋め込み型の設置にも適しています）
・各項目の表示／非表示を細やかにパラメータ指定することができます設定情報
【接続先URL】
https://【ご利用のメールディーラーのドメイン】/wapi.php
【リクエストメソッド】
GET/POST
【必要権限】
メール一覧閲覧/顧客情報の閲覧 /メール閲覧
【パラメータ】
| パラメータ | 任意/必須 | 設定値/定義 |
| md_mode | 必須 | maillist （メールディーラーを「メール一覧」で起動） |
| md_box | 必須 | 利用中メールディーラーのメールボックス番号 |
| md_crmmail | 任意 | 絞り込みを行う顧客のメールアドレスです 半角カンマ区切りで複数のメールアドレスを指定できます |
| md_status | 任意 | 指定した状態のメールを絞り込んで表示できます （「新着」メールのみ表示など） |
| md_limit | 任意 | 一覧に表示するメール件数を指定できます |
| md_title | 任意 | 表示しているメールボックスや、顧客メールアドレスを表 示するタイトルバーを非表示にします |
※その他設定可能なパラメーターは【リクエストパラメータ一覧】をご参照ください。
顧客情報画面呼び出し
パラメータで指定したメールアドレスの「顧客情報画面」を表示します。
呼び出しイメージ
・「メールディーラー上で関連付けた複数のアドレス」をまとめて表示できます
※複数のメールアドレスを指定することはできません。
・メールの新規作成や電話応対の入力など、メールディーラー上の操作が簡単に行えます
設定情報
【接続先URL】
https://【ご利用のメールディーラーのドメイン】/wapi.php
【リクエストメソッド】
GET/POST
【必要権限】
顧客情報の閲覧 /メール閲覧
【パラメータ】
| パラメータ | 任意/必須 | 設定値/定義 |
| md_mode | 必須 | crminfo （メールディーラーを「顧客情報参照」で起動） |
| md_box | 必須 | 利用中メールディーラーのメールボックス番号 |
| md_crmmail | 任意 | 絞り込みを行う顧客のメールアドレスです 半角カンマ区切りで複数のメールアドレスを指定できます |
メール作成画面呼び出し
パラメータで指定した項目をあらかじめ入力した状態でメールディーラーの
新規メール作成画面を表示します。
呼び出しイメージ
・外部システムにある顧客情報を参照して新規メールを作成することができます
設定情報
【接続先URL】
https://【ご利用のメールディーラーのドメイン】/rfe.php
【リクエストメソッド】
GET/POST
【URLエンコード形式】
UTF-8
【必要権限】
新規メール作成
【パラメータ】
| パラメータ | 任意/必須 | 項目名 | 属性 |
|
mailbox_id |
必須 |
メールボックス番号 |
整数 |
|
to_address |
任意 |
メールアドレス(To) |
メールアドレス |
|
cc_address |
任意 |
メールアドレス(Cc) |
メールアドレス |
|
bcc_address |
任意 |
メールアドレス(Bcc) |
メールアドレス |
|
subject |
任意 |
件名 |
文字列 |
|
category_id |
任意 |
To/From設定ID |
整数 |
|
group_signature_id |
任意 |
グループ署名ID |
整数 |
|
template_id |
任意 |
テンプレートID |
整数 |
|
p【任意の数字】 |
任意 |
テンプレートの置き換え文字用パラメータ |
文字列 |
|
s【任意の数字】 |
任意 |
グループ署名の置き換え文字用パラメータ |
文字列 |
・メールアドレス(To)、メールアドレス(Cc)、メールアドレス(Bcc)
指定したメールアドレスは新規メール作成画面に入力されます。
複数のアドレスを入力したいときは、カンマ区切りで指定してください。
例）https://【メールディーラーのドメイン】/rfe.php?
mailbox_id=1&to_address=test1@example.com,test2@example.com
以下の複数の設定でアドレスを指定している場合は、各設定で指定したアドレスが
すべて新規メール作成画面に入力されます。
・外部システムで指定したパラメータ
・管理設定 > 詳細設定 > メールボックスの詳細設定 > 基本設定 > Cc/Bcc/Reply-to
・テンプレート
・To/From設定
・件名
指定した件名は新規メール作成画面に入力されます。
複数の設定で件名を指定している場合は、以下の優先順位で件名が決定されます。
1.外部システムで指定したパラメータ
2.テンプレート
3.管理設定＞詳細設定＞メールボックスの詳細設定＞基本設定＞件名の初期値
・To/From設定ID、グループ署名ID、テンプレートID
指定したTo/From設定、グループ署名、テンプレートは、
新規メール作成画面前の選択画面で選択された状態になります。
それぞれのIDは下記の画面で確認できます。
・To/From設定：管理設定 > 基本設定 > To/Fromの設定
・グループ署名：管理設定 > 基本設定 > グループ署名の設定
・テンプレート：テンプレート一覧
※テンプレートは「新規メール」で利用可能に設定されている必要があります
・テンプレートの置き換え文字用パラメータ
テンプレート内の外部システム用置き換え文字
「##_p【任意の数字】_##」を指定した文字に置き換えます。
例）https://【メールディーラーのドメイン】/rfe.php?mailbox_id=1&p1=株式会社〇〇&p2=山田
テンプレート内の##_p1_##は「株式会社〇〇」に置き換わり、
テンプレート内の##_p2_##は「山田」に置き換わります。
※テンプレート内に該当する置き換え文字が存在しない場合、
外部システムで指定した文字は反映されません。
・グループ署名の置き換え文字用パラメータ
グループ署名内の外部システム用置き換え文字
「##_s【任意の数字】_##」を指定した文字に置き換えます。
例）https://【メールディーラーのドメイン】/rfe.php?mailbox_id=1&s1=株式会社〇〇&s2=山田
署名内の##_s1_##は「株式会社〇〇」に置き換わり、
署名内の##_s2_##は「山田」に置き換わります。
※署名内に該当する置き換え文字が存在しない場合、外部システムで
指定した文字は反映されません。