watsonx Orchestrate と Salesforce（開発者用アカウント）を接続する

# はじめに

watsonx Orchestrate（wxO）は、プリビルドスキルの中に Salesforce が含まれており、手軽に連携することができます。
今回は、Salesforce の開発者用アカウント（Developer Edition）を作成し、サンドボックス環境とwxOを接続してみます。

# Salesforce 開発者用アカウントの作成

まず、Salesforceの開発者用アカウントを作成します。手順は、[こちら](https://developer.salesforce.com/jpblogs/2016/04/developer-edition-signup/)のページを参照しました。
アカウントを作成できたら、[ログインページ](https://login.salesforce.com/?_ga=2.144869172.1209928100.1735277991-1025728490.1683599387)を開き、登録したユーザー名とパスワードを使用してログインします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3834204/ab728ddb-b2bc-3781-2b44-9c198a202c48.png)

ログインすると、以下のようなホーム画面が表示されます。右上のアイコンをクリックするとプロフィールを表示できます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3834204/eec78778-099e-6129-fcd4-a4a79a3904a9.png)

プロフィールの名前の下にある「my.salesforce.com」で終わる URL（赤枠部分）をコピーしておきましょう。（後ほど wxO との接続で使用します）

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3834204/a18e6d59-faff-43a5-3b2d-d79ede94ab51.png)

# wxOとの接続

開発者用アカウントが作成できたら、[ログインページ](https://dl.watson-orchestrate.ibm.com/landing/accounts)からwxOにログインします。
ログインしたら、左上のメニューバーを開き、「スキル・カタログ」を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3834204/08918f24-eb6c-21ef-49bf-6b47983215b2.png)

スキル・カタログを開いたら、検索ボックスで「Salesforce」と検索するか、アプリの一覧から Salesforce のタイルを探してクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3834204/baadf2e9-a7ac-1592-c9d7-4ec33c397099.png)

Salesforce の画面を開いたら、右上の「アプリの接続」をクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3834204/d9d06100-45c7-9a50-28dc-8a19740abe31.png)

以下のような画面が表示されるので、先ほど Salesforce のプロフィールからコピーしたURLを入力します。その後、右下の「アプリの接続」をクリックします。

:::note warn
Salesforce にログインしたページのURLでは正しく接続できないため、必ずプロフィールからコピーしたURLを入力してください。
:::

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3834204/4b9ee648-21a5-9556-f65b-277933eeb79d.png)

先ほどと同じ Salesforce のログイン画面が開くので、ユーザー名とパスワードを入力してログインします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3834204/2f3e1279-8f92-254a-0fc8-f4a74af88211.png)

以下のように wxOからのアクセスを許可するかの確認画面が出てくるため、右下の「許可」をクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3834204/dfa6ae10-9ff1-1cc0-06d6-2bacfba3726a.png)

無事に接続されると「App is connected」と表示され、wxOの画面に戻ります。wxOの画面の右上には「接続済み」と表示されているはずです。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3834204/3569665e-3cf3-9913-ec21-7498e6355109.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3834204/105708f6-0884-e279-508b-a7bc92002efb.png)

# プリビルド・スキルの追加

wxOとSalesforce の接続は完了しましたが、プリビルド・スキルを利用できるようになるにはもう1つ手順が必要です。
現状は Salesforce のプリビルド・スキルがグレーアウトされており、クリックすると以下のように表示されます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3834204/41f292b6-913f-a4d3-482a-b00d4ea52628.png)

そこで、次にスキルの構成を行います。左上のメニューバーを開き、「スキル・スタジオ」をクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3834204/e4bce5bf-5dec-3d8d-fa1f-57c6adfac04c.png)

スキル・スタジオで「スキルおよびアプリ」のタブに移動し、右上の「事前構築されたスキルの構成」をクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3834204/f88dd343-6046-a4ef-2f45-3ca2694395c8.png)

スキルを構成する画面が開き、Salesforce が候補として表示されるので、そちらをクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3834204/d1119fbe-4ce1-ee27-d69a-4d039f465fdb.png)

Salesforce のプリビルド・スキルのリストが表示されます。使用したいスキル名を検索してチェックボックスにチェックを入れます。

::: note
Salesforce のプリビルド・スキルの一覧は、「スキル・カタログ」または[製品ドキュメント](https://www.ibm.com/docs/ja/watsonx/watson-orchestrate/current?topic=reference-prebuilt-apps-skills#managing-customers)から確認できます。
:::

:::note warn
何も検索しない状態では、プリビルド・スキルの一部しか表示されない（リストを下にスクロールできない）ため、必ず使用したいスキル名を検索してチェックを入れてください。
:::

最後に右下の「構成」をクリックすると、スキルの構成が完了します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3834204/6cf2ddf6-7efd-b7a4-8e90-dd6fce54faab.png)

例として、「Get all opportunities」というプリビルド・スキルを構成してみます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3834204/8ca75269-fef8-afb2-e873-f055c2fb59e0.png)

構成が完了したら、左上のメニューバーから「スキル・カタログ」に戻り、Salesforce のアプリをクリックします。

検索ボックスで「Opportunities」と検索してみると、Opportunity に関するスキルが表示されますが、「Get all opportunities」のみグレーアウトが外れ、スキルを追加できるようになっていることがわかります。
「スキルの追加」をクリックすると、wxOのチャット画面から呼び出せるようになります。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3834204/ff678275-2a94-25dd-e226-e4287ebb4172.png)

# おわりに

今回は、wxO と Salesforce サンドボックス環境の接続を試してみました。
Salesforce との接続は、他のプリビルド・スキルのアプリとは異なり、スキルの構成という手順が加わります。
接続用のURLも少し工夫が必要なため、接続される際はぜひ注意してお試しください。