Salesforce ​

Salesforceは、営業、マーケティング、カスタマーサービスチーム全体でリード、取引先責任者、商談を管理するためのクラウドベースのCRMプラットフォームです。 Force.comプラットフォーム上に構築されており、幅広いサードパーティマーケットプレイスアプリやその他のSalesforce製品で拡張できます。

ユースケース ​

Salesforceコネクターは、Salesforceを他のビジネスアプリに接続する複数アプリのワークフローをサポートしています。 例:

• Workbot for Slackを使用して、SlackでSalesforceアカウントの詳細を表示します。
• Marketoで新しいリードアクティビティが検出されたときに、Salesforceタスクを作成し、Snowflake行を追加して、リードを追跡するワークフローを設定します。
• MySQLからSalesforceへデータを転送するバッチ同期ソリューションを試してください。
• SalesforceからSnowflakeへ取引先責任者を同期する前に、電話番号が検証されていることを確認します。

その他の例については、レシピのユースケースを参照してください。

APIバージョン ​

SalesforceコネクターはSalesforce REST APIバージョン65.0を使用します。

サポートされているエディションとバージョン ​

Salesforceコネクターは、Professional、Enterprise、Unlimited、Developerなど、すべてのSalesforceエディションに加えて、次のSalesforce製品でも機能します:

• Salesforce Sales Cloud
• Salesforce Service Cloud
• Salesforce Partner Community
  • サインインするには、詳細設定でコミュニティカスタムドメインを指定します。
• Salesforce Consumer Goods Cloud
• Salesforce Marketing Cloud
  • SFMCには別のコネクターがあります
• Salesforce Data Cloud
  • Workatoが構築およびサポートするコミュニティコネクターとして利用可能

Force.comアプリケーションでも機能します。 その他のエディションについては、Workato担当者にお問い合わせください。

コネクションの設定 ​

Salesforceコネクターは、次の認証タイプをサポートしています:

• OAuth 2.0（認可コードグラント）

• JWTベアラー

前提となる権限については、必要なロールと権限を参照してください。

OAuth 2.0（認可コードグラント） ​

Salesforceに接続するには、OAuth 2.0（認可コードグラント）を使用してサインインし、Salesforceの認可フローを通じてアクセスを許可します。 この方法は、プロダクションとサンドボックスの両方のEnvironmentをサポートしています。

最小スコープとデフォルトスコープ ​

Workatoは、OAuth 2.0コネクションに対して常に次の最小スコープを要求します:

• basic info
• manage data
• make requests at any time

詳細設定の要求された権限フィールドを空白のままにすると、Workatoはデフォルトでfull（すべての権限）になります。

OAuth 2.0（認可コードグラント）を使用してSalesforceに接続する ​

WorkatoでSalesforceへのOAuth 2.0（認可コードグラント）コネクションを設定するには、次の手順を実行します:

OAuthの制限 ​

Salesforceは、2025年9月上旬にOAuth Salesforce Connected Appsに制限を適用します。 これらの制限は、Workatoで作成された新しいSalesforceコネクションにのみ影響します。 既存のコネクションとレシピは引き続き実行されます。 詳細については、Salesforceの公式発表を参照してください。

• WorkatoでSalesforceコネクションをすでに作成している場合: 組織には、Connected Apps OAuth利用状況にWorkato connectorがすでに表示されています。 既存のコネクションは引き続き機能します。 アプリにInstallが表示される場合、Salesforce管理者はアプリをインストールし、新しいコネクションを作成するときのエラーを回避するためにOAuthポリシーを設定する必要があります。 アプリにUninstallが表示される場合、アプリはすでにインストールされており、追加のアクションは不要です。

• Workatoで初めてSalesforceコネクションを作成する場合: Salesforce管理者がWorkatoでコネクションを作成するまで、組織にはWorkato connectorが表示されません。 その後、アプリはConnected Apps OAuth利用状況に表示され、管理者がインストールできるようになります。

代替手段として、管理者はインストールなしでOAuthを許可するSalesforce権限を割り当てることができます。 このオプションは、管理者や開発者など、信頼された連携ユーザーにのみ推奨されます。 これには以下が含まれます:

• Approve Uninstalled Connected Apps: 信頼されたユーザーが未インストールのアプリを自己承認できるようにします。 API Access Controlが有効になっていない場合に利用できます。
• Use Any API Client: API Access Controlが有効な場合に機能する、より広範なバイパス権限です。

詳細については、Salesforceのドキュメントを参照してください。

トークンの有効期限 ​

OAuthトークンは、Salesforceでの設定によって、一定期間後に期限切れになる場合があります。 必要に応じて、予期しない切断を防ぐために、SalesforceのRefresh Token PolicyをRefresh token is valid until revokedに設定し、WorkatoにPerform requests at any timeスコープを付与できます。

Workatoは、OAuth 2.0コネクションに対してPerform requests at any timeスコープを自動的に要求します。 Salesforceで設定を構成する場合、Full accessにはこのスコープは含まれません。 Perform requests at any timeは個別に設定する必要があります。

追加のトークン有効期限オプションと設定手順については、Salesforceの接続アプリのOAuthアクセスポリシーの管理およびOAuthトークンとスコープを参照してください。

JWTベアラー ​

ユーザーのサインインを必要とせずにサーバー間認証を行うには、JWTベアラーを使用します。 スケジュールで実行されるバックエンドインテグレーションなど、対話型サインインを完了できない自動コネクションには、この方法を選択します。

仕組み ​

JWTベアラー認証は、JWTリクエストに署名するデジタル証明書を使用して接続します。 WorkatoはSalesforce OAuthトークンエンドポイントにJWTを送信します。SalesforceはJWTを処理し、SalesforceでのWorkatoの事前承認に基づいてアクセストークンを発行します。

JWTベアラーでは対話型サインインがスキップされますが、Salesforceは引き続き、すべてのリクエストをコネクションで指定されたユーザーの権限に照らして評価し、変更をそのユーザーに帰属させます。 個人アカウントではなく、専用の連携ユーザーを使用してください。

接続ユーザーに必要なSalesforce権限については、必要なロールと権限を参照してください。

秘密鍵と証明書の生成 ​

JWTベアラー認証には秘密鍵と証明書が必要です。 次のコマンドは、OpenSSLを使用してその両方を生成します。 -subjの値を独自の値に置き換えます:

openssl req -x509 -sha256 -nodes -newkey rsa:2048 \
  -keyout server.key \
  -out server.crt \
  -days 365 \
  -subj "/CN=Your App Name/O=Your Organization/C=US"

これにより、次の2つのファイルが生成されます:

詳細については、Salesforceのドキュメントを参照してください:

• サーバー間連携用OAuth 2.0 JWTベアラーフロー: Salesforceがこの証明書を使用してJWTに署名し検証する方法の詳細。
• 秘密鍵と自己署名デジタル証明書を作成: 秘密鍵と証明書を生成するその他の方法。

JWTベアラー用の外部クライアントアプリの作成 ​

JWTベアラー認証には、Salesforceに登録された外部クライアントアプリも必要です。 Workatoでコネクションを作成する前に、次の手順を実行します。 詳細については、Salesforceの外部クライアントアプリの作成ドキュメントを参照してください。

JWTベアラーを使用したSalesforceへの接続 ​

JWTベアラー認証を使用してSalesforceに接続するには、次の手順を実行します。

必要なロールと権限 ​

専用のSalesforce連携ユーザーをプロビジョニングして割り当てることをお勧めします。 WorkatoのSalesforceコネクションは、認証に使用されたアカウントの権限を継承します。これには、項目およびオブジェクトへのアクセスが含まれます。

ユーザーの権限とアクセス設定は、Salesforce組織でユーザーが実行できる操作を制御します:

• 権限: オブジェクトレコードの編集、Setupメニューへのアクセス、ごみ箱からの項目の完全削除、別のユーザーのパスワードのリセットなど、ユーザーが実行できるアクションを定義します。

• アクセス設定: アプリの表示、Apexクラスへのアクセスなど、より広範な機能を制御します。

プロファイルおよび権限セットを使用して、ユーザー権限とアクセス設定を定義できます。 各ユーザーには1つのプロファイルが割り当てられますが、複数の権限セットを持つことができます。 特定のユーザーグループに必要最小限の権限を割り当てるには、プロファイルを使用します。 その後、必要に応じて権限セットを使用して追加の権限を付与します。

API Enabled権限 ​

コネクションを作成するには、SalesforceでAPI Enabled権限が必要です。 Salesforceを開き、Setup > Profilesに移動してこの権限を設定します。 API Enabled権限 - プロファイル設定

標準およびカスタムオブジェクト権限 ​

接続ユーザーのアカウントには、Salesforce組織内の標準オブジェクトとカスタムオブジェクトに対するread、create、edit、delete、view all、modify all権限を付与することをお勧めします。

標準オブジェクト権限とView allおよびModify all権限の違いの詳細については、Salesforceのオブジェクト権限を参照してください。

Salesforce標準オブジェクトプロファイル権限設定

Salesforceカスタムオブジェクトプロファイル権限設定

オブジェクトレベルセキュリティは、データアクセスを制御する最も広範な方法です。 リードや商談など、特定のオブジェクトタイプのレコードをユーザーが表示、作成、編集、削除できるかどうかを制御し、オブジェクトとそのタブをユーザーから完全に非表示にすることもできます。

プラットフォームイベント権限 ​

プラットフォームイベントのトリガーとアクションには、Salesforce組織でプラットフォームイベントが有効になっている必要があります。 さらに、接続されたSalesforceアカウントには、プラットフォームイベントに対するreadおよびcreate権限が必要です。

Salesforceプラットフォームイベント権限 - プロファイル設定

リアルタイムトリガーの権限 ​

リアルタイムトリガーを使用するには、Salesforce組織でWorkflowルールが設定されている必要があります。 接続ユーザーは、これらのルールを作成するユーザーである必要はありません。

ワークフロールールを作成するには、Customize Application権限が必要です。 Salesforceを開き、Setup > Permission setsに移動してこの権限を設定します。

Customize application権限 - プロファイル設定

一括/バッチアクション権限 ​

一括アクションには、接続されたSalesforceアカウントでManage Data Integrations、View Setup and Configuration、API Enabled権限が必要です。 詳細については、Salesforceの一括データロードジョブの管理を参照してください。

項目レベルセキュリティ ​

項目レベルセキュリティは、関連リスト、リストビュー、レポート、検索結果を含むSalesforce内の項目の表示可否を制御し、ユーザーが個々の項目値を表示または編集できるかどうかを制御します。 これにより、オブジェクト全体を非表示にせずに機密データを保護できます。

権限セットとプロファイルを使用して、項目レベルセキュリティを設定できます。

その他の考慮事項 ​

単一レシピ内の複数のSalesforceアカウント ​

Salesforce Secondaryコネクターを使用すると、単一のレシピで2つのSalesforceアカウントに接続できます。 詳細については、セカンダリコネクターを参照してください。

Salesforceサンドボックス ​

WorkatoとSalesforceの使用を開始するときは、サンドボックスアカウントを使用するか、重要でないデータでテストします。 これによりデータ損失を防止できます。Workatoを通じて実行されたアクションは元に戻せないためです。

Salesforceサンドボックスはプロダクション組織から分離されているため、一方でのアクションがもう一方に影響することはありません。 サンドボックスはプロダクション組織とほぼ同一です。 相違点の一覧については、Salesforceのサンドボックス設定のヒントと考慮事項を参照してください。