AirFocusとSalesforceを統合する

Salesforce インテグレーションの使用利点

当社のSalesforceインテグレーションでは、Salesforceのケースや機会から直接フィードバックを集めることができます。 Salesforceからの入力を簡単にインポート・集中管理し、空に集中して製品発見に役立てられます。

• Salesforceのケースや機会をアイテムとしてシームレスにインポートし、製品発見や優先順位付けのためのインサイトを作成してください。
• 多くのSalesforceシステムフィールドをエアフォーカス分野に柔軟にマッピングできる能力。

要件

Salesforce インテグレーションを利用するためには、ユーザー自身が以下の要件を満たす必要があります:

空中フォーカスについて

• ユーザーはワークスペースに対して「フル」アクセス権限を持つ必要があります。
• airfocus チームは「エンタープライズ」プランに加入する必要があります。

Salesforceについて

インテグレーションを設定するために使うユーザーは、以下を満たすプロファイルに割り当てる必要があります:

• 少なくともインテグレーションで同期すべきすべてのオブジェクトや情報の読み込み権限は必要です
• 「API有効」と「接続されたアプリの管理」設定がオンになっていました。システム管理者は、設定>管理設定>ユーザー管理>プロファイルを通じて、設定済みプロファイルについてこれを確認できます
• Salesforceでアプリを作成する際のデフォルトでは、「Required Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows(Supported Authorization Flows))」が有効になっています。この旗は 無効化しなければなりません。

「ケース」同期に関する追加情報:

• Salesforce組織はSalesforce Service Cloudに加入し、現在「Professional」(追加料金)、「エンタープライズ」、「Unlimited」エディションで利用可能な「Web Services API」にアクセスできる必要があります。
  

「機会」を同期するための追加情報:

• Salesforce組織はSalesforce Sales Cloudに登録し、「Web Services API」へのアクセスが必要です。これは現在「Professional」(追加料金)、 「エンタープライズ」、 「Unlimited」エディションで利用可能です。
  

インテグレーションの設立

インテグレーションのセットアップは簡単で、数分で終わるはずです。 方法は以下の通りです:

エアフォーカスにログイン

まず 、 AirFocusに登録するか、既存のアカウント にログイン してください。AirFocusで新しいワークスペースを作成するか、Salesforceと統合したいワークスペースを選択します。

エアフォーカスにSalesforce インテグレーションを追加してください

インテグレーションは常に特定のAirFocusワークスペースに接続されていることを覚えておいてください。 特定のワークスペースに複数のSalesforceインテグレーションを追加できます。

インテグレーションを設定するには、拡張機能の「管理インテグレーション」からSalesforceに接続してください。

次の画面では、ドロップダウン メニューから [新しい Salesforce インスタンスに接続] を選択する必要があります。 以前にチーム内の Salesforce インスタンスに接続したことがある場合は、利用可能なすべての Salesforce インスタンスがこのドロップダウンに表示されます。単一の Salesforce インスタンスに対して、必要なだけ Salesforce 統合を作成できます。

次に、新しいSalesforceインスタンス接続に名前を付ける必要があります(後にairfocusに表示されます)。以下に、Salesforce Connected AppのConsumer key(Client ID)とConsumer secret(Client secret)を挿入すると、Salesforceに接続できます。

Salesforceで接続アプリをセットアップします

1. あなたのSalesforce組織にログインしてください。
2. 接続されたアプリの設定ページを開きます:
   • Salesforce Classic を使用している場合は、 [設定] > [アプリケーション設定] > [作成] > [アプリケーション] から設定できます。
     
   • Salesforce Lightningを使っている場合は、Setup > Platform Tools > Apps > App Managerを使ってください。
     
     
3. 新しい接続アプリを作成します。
   • Salesforce Classicを使っている場合は :接続済みアプリセクションで「新」をクリックしてください。
     
   • Salesforce Lightning を使用している場合: 「Lightning Experience App Manger」の横にある「新しい接続アプリケーション」をクリックします。
     
4. 基本情報欄に記入してください:
   • 接続アプリ名:例えば「airfocus」など。
   • API名:例えば「airfocus」などです。
   • お問い合わせ メールアドレス:あなたのメールアドレス。
     
5. API(OAuth設定を有効にする)セクションでは:
   • 「 OAuth 設定を有効にする」というボックスにチェックを入れてください
   • Airfocus サーバーに応じて (以下の注記を参照)、次のコールバック URL をコピーします。
     • ヨーロッパサーバー : https://app.airfocus.com/api/integration-providers/salesforce/callbackそして「Callback URL」フィールドに貼り付けます。
     • USサーバー:https://app.airfocus.com/api/integration-providers/salesforce/callbackそして「Callback URL」フィールドに貼り付けます。
     • 新しい米国サーバー (米国またはAPAC地域にお住まいで、2025年9月以降にアカウントが作成されている場合): https://app.airfocus.app/api/integration-providers/salesforce/callbackそして「Callback URL」フィールドに貼り付けます。
   • 選択されたOAuthスコープでは、以下のスコープを追加します:
     • API(API)を通じてユーザーデータを管理します。
     • いつでもリクエストを実行します (refresh_token、offline_access)。
       
     • 注意:airfocusサーバーの場所を見つけるには、airfocusのURLを確認してください。us.airfocusが含まれている場合は米国内、そうでなければヨーロッパにあります。例えば:teamname.us.airfocus.com の代わりに teamname.airfocus.com
     • ご注意ください。米国またはAPAC地域にお住まいで、2025年9月以降に作成されたアカウントはURLが teamname.airfocus.app
6. 「保存」をクリックします。次の画面には、変更が適用されるまで最大 10 分ほどかかる可能性があることが表示されます。「続行」をクリックします。10分お待ちください。
   

注意:接続されたアプリの管理ページにリダイレクトされるため、4を直接進めることができます。このガイドの次のセクションで。

AirFocusとSalesforceを接続

1. あなたのSalesforce組織にログインしてください。
2. 接続されたアプリの設定ページを開きます:
   • Salesforce Classic を使用している場合は、 [設定] > [アプリケーション設定] > [作成] > [アプリケーション] から設定できます。
     
   • Salesforce Lightningを使っている場合は、Setup > Platform Tools > Apps > App Managerを使ってください。
     
3. Connectedアプリの概要を開く:
   • Salesforce Classicの 「Connected Apps」セクションで、AirFocus用の接続アプリ名をクリックしてください。
     
   • Salesforce Lightningのテーブルでプレイしている場合は、アプリのドロップダウン矢印をクリックして「ビュー」をクリックしてください。
     
4. 「API(OAuth 設定を有効にする)」セクションで「消費者詳細の管理」をクリックします。
   
5. Salesforce で本人確認を行う必要がある場合があります。
6. 「Consumer Key」と「Consumer Secret」をコピーして、airfocus Salesforce インテグレーションセットアップの対応するフィールドに貼り付けます。
   
   
7. airfocusの「Connect」をクリックしてください。
8. Salesforceの確認画面にリダイレクトされます。「許可」をクリックしてください。
   

インテグレーションの設定をしてください

インテグレーションの名前は、Salesforceの設定ページ上部にある「Name」欄に名前を入力することでできます。 この名前はインテグレーションの概要や拡張機能のポップオーバーにも表示され、簡単に識別できます。

フィルター

AirFocusにインポート・同期したいSalesforceオブジェクトタイプを選択してください。The インテグレーションは現在サポート Salesforce ケース and オポチュニティです。 両方のオブジェクトタイプを同期したい場合は、それぞれに1つのインテグレーションを設定する必要があります(両方とも同じSalesforceインスタンス経由で接続できるので、各オブジェクトタイプごとに接続アプリを作成する必要はありません)。

「Import Created After Objects」フィールドの日付ピッカーで日付を選択し、選択した日付以降に作成されたオブジェクトのみをインポートしてください。ここで日付を指定していない場合、インテグレーションは選択したタイプの すべての Salesforceオブジェクトをインポートします。

Salesforceのクエリ言語(SOQL)のWHERE条件を入力することで、どのオブジェクトを同期すべきかさらにフィルターを絞ることができます。 複数の条件をANDまたはORと組み合わせて使います。上記の欄でスタート日を選択すると、それはWHERE節に暗記的に追加されます。 ここで参照されているすべてのフィールドは、下記の「フィールドマッピング」セクションで定義されたマッピングが必要です。詳しくはこちらをご覧ください。

フィールドマッピング

マッピングを使って、Salesforceの情報をAirFocusにどのようにマッピングすべきかを定義します。新しいインテグレーションを設定する際には、アイテム名や説明は常にデフォルトでマッピングされ、必要に応じて削除や修正も可能です。

新しいフィールドマッピングの追加方法

ドロップダウンでフィールドを選択すると、エアフォーカス側のドロップダウンにはフィールドタイプに一致するフィールドのみが表示されます。当社のインテグレーションでは、上記のメインオブジェクトタイプのフィールドだけでなく、直接接続されたオブジェクトのフィールドをマッピングできます。

以下の例では、ユーザーがインポート/同期するSalesforceオブジェクトタイプとして「Case」を選択しています。「Priority」フィールド(赤で示された)は「Case」オブジェクトのシステムフィールドです。「Case ID」フィールド(緑で示された)は「MasterRecord」オブジェクトのシステムフィールドで、「Case」に直接接続されたオブジェクトです。

簡単に言うと、 Salesforceで同期したオブジェクトから最大1クリックの距離にあるフィールドがあれば、それをairfocusアイテムにマッピングできます(この記事で説明した条件が適用されます)。

インテグレーションは現在、SalesforceからAirFocusへの情報「一方通行」しか同期できません。

マッピングしたい2つのフィールドを選択した後、フィールドオプションとマッピング方法を選択できます。また、複数のSalesforceフィールドオプションを単一のエアフォーカスフィールドにマッピングすることも可能です。

マッピングに使用できるフィールドタイプ

統合では現在、Salesforce から airfocus へのシステム フィールドの「一方向」の同期のみが可能です。 以下は設定可能なフィールドマッピングの一覧です:

Salesforceフィールドのフィールドタイプを決める方法

Salesforceのオブジェクトタイプ(「ケース」や「機会」など)で利用可能な・設定済みのすべてのフィールドのリストは、Salesforceの設定で見つけることができます。

1. 接続しているSalesforce組織にログインしてAirFocusにアクセスしてください。
2. メインのSalesforceダッシュボードで、プロフィールアバターの横にある設定ホイールをクリックし、「セットアップ」をクリックしてください。
   
3. セットアップサイドバーで「Platform Tools > Objects and Fields」>「Object Manager」をクリックしてください。
   
4. フィールドタイプを表示したいオブジェクトタイプを探し、そのオブジェクトの「label」をクリックします。
   
5. オブジェクトタイプ(例「Case」)サイドバーで「Fields & 関連」をクリックし、テーブルの「Data Type」列を確認して、このオブジェクトタイプで設定したフィールドのフィールドタイプを確認してください。
   
6. フィールドがカスタムフィールドかシステムフィールドかは、テーブルの「フィールド名」列を確認することで判断できます。フィールド名が「__c」で終わる場合、それはカスタムフィールドです。
   

追加設定

「archive unknown items」 を有効にすると、以前にインポートしたアイテムはSalesforceに存在しなくなったり、インテグレーションのフィルターセットに含まれていない場合、airfocusのアーカイブとなります。

「自動同期」を有効にすると、インテグレーションは10分ごとと、そしてワークスペースにアクセスするたびに自動的に同期されます。

「ビュー logs」をクリックすると、Salesforce インテグレーションアクティビティのログをビューで確認でき、最後の同期前にどんな変更があったか確認できます。

設定を保存してアイテムをAirFocusにインポートするには、「更新と同期」を選んでください。

重要な注記

インテグレーションの設定に使われるSalesforceユーザーアカウントは、必ずしもインテグレーションを使うために使う必要はありません。 airfocusユーザーが有効なConsumer KeysとSecretsを持っている限り、その接続されたSalesforceに好きなだけインテグレーションを設定できます。

インテグレーションは現在、最大同期に限定されています。 2000個のSalesforceオブジェクト。

接続されたアプリはSalesforceによって「非SDFCアプリケーション」と見なされます。 Non-SDFCアプリケーションおよびインテグレーションサービス利用に関するポリシーを確認したい場合は、Salesforceの メインサービス契約 書をお読みください。

この記事へのフィードバックをお寄せください