【AWS】【Salesforce】コンタクト属性をSalesforce内のCCP上に表示する

# 1.はじめに
どうも、ARIの名古屋支社に勤務している愛知県民です♪
(/・ω・)/

**CTI Adapterの機能の一つであるAttributesを使用し、
CCP上にコンタクト属性を表示することができたので、その方法をまとめました。**

CTI Adapterについて勉強中の方の参考になれば幸いです。
[前回の記事](https://qiita.com/Aichi_Lover/items/6eeb9acdb7893a24e8e8)もCTI Adapterについて書いたので、もしよろしければご確認ください。

最後に、この記事が面白いと思った方はLGTM、ストックしていただけると励みになります♪
(*^^)v

# 2.用語の説明
## 2.1.CTI Adapterとは
AmazonConnectとSalesforceを連携させる際に使用するクラウドサービスのことです。
（厳密にはAWSのサービスです。）

CTI Adapterを使用することで、Salesforceのコンソールからソフトフォンを開いたり、
着信時にSalesforceの取引先責任者をポップアップしたりすることができます。

## 2.2.Attributesとは
AttributesとはCTI Adapterの機能の1つで、
CCP上にコンタクト属性やURLを表示することができます。

ちなみに、他のCTI Adapterの機能としては以下の3種類があります。

* CTI Flows
* Presence Sync Rules
* Features

# 3.前提条件
以下に前提条件を示します。

* AmazonConnectにてインバウンドフローが作成済であること
* CTI Adapterのインストールが完了していること

※本記事におけるCTI Adapterのバージョンは5.17です

# 4.概要
今回は例としてAmazonConnectにて「queueName」というコンタクト属性を設定し、
そのコンタクト属性をSalesforce上のCCPで確認できるようにします。

# 5.AmazonConnectの設定
AmazonConnectのインバウンドフローにて「コンタクト属性の設定」ブロックを追加し、以下の通り設定します。
**コンタクト属性名はAttributesの設定でも使用するため、覚えておいてください。**

|項目|設定内容|
|---|---|
|宛先タイプ | ユーザー定義 |
|宛先属性 |任意（例では「queueName」としました。）|
|テキストの使用 | チェックなし |
|属性を使用する | チェックあり |
|タイプ | システム |
|属性 | キュー名 |


|![コンタクト属性の設定.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1372071/ced9b32a-640f-1bc3-5246-aa020d5339ab.png)|
|:--|

#6.Salesforceの設定
SalesforceではCTI AdapterのAttributesを設定します。

6.1.CTI Adapterの管理画面から「Attributes」を選択し、「新規」を選択します。
※CTI Adapterの管理画面を開く方法は[こちらの記事](https://qiita.com/Aichi_Lover/items/6eeb9acdb7893a24e8e8)を参考にしてください。

|![Attributesを新規作成.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1372071/f901711e-4e81-5caa-5e12-53cb669eab5a.png)|
|:--|

6.2.以下のように設定し、「保存」を選択します。

|項目|設定内容|
|---|---|
|CTIアダプタ | インストールしたCTI Adapter名 |
|属性 | 任意（CTI Adapter上に表示される名前です） |
|ラベル |任意（CCP上に表示される名前です）|
|表示 | Key-Value |
|タイプ | Text |
|スタイル | (ブランク) |
|形式 | {{(コンタクト属性名)}} |
|アクティブ | チェックあり |
|デフォルト値 | 任意 |

|![Attributesを新規作成_詳細_2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1372071/8102f5a2-2b60-d4a9-c141-539623e3efc3.png)|
|:--|

# 7.動作確認
最後に、動作確認をしていきます。

7.1.Salesforceの管理画面にて左下の「Phone」を選択し、CCPを開きます。

|![Phoneを選択.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1372071/6d8cd8e8-2faa-70c7-6298-01e34769afd1.png)|
|:--|

7.2.着信前の状態です。
右にある「<」を選択し、「Attributes」タブを確認すると何も表示されていません。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1372071/5637f967-2414-95f5-8d23-6773956a77bf.png"> 　　　<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1372071/e58bf012-e9d8-6a58-085c-0b8dfa09bca3.png">

7.3.携帯電話等から架電します。
例では「BasicQueue」というキュー名で着信させます。

7.4.着信時の状態です。（応答前に確認できます。）
同様に右にある「<」を選択し、「Attributes」タブを確認すると
**Name列には6.2.で設定した「ラベル」の値が、Value列には6.2.の「形式」で設定したコンタクト属性の値が表示されています。**
また、Actions列のアイコンを押すと、Value列の値をコピーすることができます。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1372071/07de3d70-2d08-4ab3-a7a3-690a6e56b7ad.png"> 　　　<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1372071/a1ac86e3-5ed2-1bd5-69b3-fe62b834a4f1.png">

# 8.おわりに
ここまで読んで下さり、ありがとうございます！！！
(^^)

今回の機能を試してみて、コンタクト属性の値を応答前に確認できるのが面白い点だと思いました♪
引き続きCTI Adapterについては投稿する予定なので、次回をお楽しみに～
(:3_ヽ)_