Heroku AppLink

この記事の英語版に更新があります。ご覧の翻訳には含まれていない変更点があるかもしれません。

最終更新日 2025年08月28日(木)

Heroku AppLink​ (旧称 Heroku Integration) は、Heroku アプリを Salesforce の API サービスとして公開するアドオンです。Heroku 開発者は Salesforce システム管理者と開発者が Salesforce Flow​、Apex​、Data Cloud​、Agentforce​ でアクションを実行するために使用できる API を Heroku にビルドできます。アドオンでは複数ユーザーのインタラクションモードをサポートしており、データを操作したり Heroku SDK を使用したりするときに Salesforce のユーザー権限とルールを適用します。

Heroku AppLink には以下の機能があります。

  • Heroku、Salesforce、Data Cloud、Agentforce 間のインテグレーション: Heroku アプリを接続して公開し、Salesforce、Data Cloud、Agentforce と簡単かつ安全にやり取りできます。
  • *アクションの作成: *​アプリの API から外部サービス​アクションと Agentforce エージェントアクションを​自動的に生成し、Salesforce で呼び出します。
  • Flow と Apex ベースの呼び出し: Salesforce Flow と Apex を使用して、公開した Heroku アプリを同期または非同期で呼び出します。
  • 管理されたセキュリティ: Salesforce データで操作を実行するときに、Salesforce 内でのユーザーの権限を設定します。これはアプリの 3 つのユーザーインタラクションモードから選択できます。
  • SDK API: Heroku アプリで SDK API を使用して、AppLink 対応の Salesforce 組織と Data Cloud 組織で Data Manipulation Language (DML) 操作​を実行します。

Heroku を初めてご利用になる場合は、アカウントに新規登録し​、以下のリソースを参照して Heroku の詳細を確認してください。

ユースケース

Heroku AppLink でできることの例をいくつか示します。

  • PDF の生成: Salesforce から PDF を生成する Puppeteer​ ベースのマイクロサービスを Heroku にデプロイします。Salesforce データをクエリするときに、ユーザーコンテキストを維持することもできます。
  • 一括ジョブの実行: Salesforce データを Heroku のコンピューティングサービスに渡すことで、複雑な計算を追加したり、API コールを行ってより多くのデータを取得したりするなどのデータ変換を実行します。結果は Salesforce または Data Cloud のデータレークオブジェクト (DLO) ​に保存されます。
  • カスタム Agentforce アクションのデプロイ: Agentforce エージェント用に、任意の言語で記述されたカスタムアクションを Heroku 上で開発します。カスタムアクションを使用してユーザーからの自然言語のリクエストを解釈し、データに対して動的な計算を実行します。
  • *カスタム MCP サーバーの公開: *​Heroku でカスタム MCP サーバー​をビルドしてデプロイし、Salesforce で MCP サーバーを公開します。

Heroku AppLink は API アクセスがある Salesforce のエディション​でしか使用できません。一部の Salesforce エディションにはデフォルトで API アクセスがなく、Heroku AppLink と互換性がありません。

Heroku AppLink は、パイロット版の Heroku Integration アドオンとは別のアドオンです。パイロットに参加した場合は、Heroku AppLink​ アドオンをプロビジョニングし、Heroku アプリを再公開する必要があります。

Heroku AppLink は、CLI プラグイン、API、サービスメッシュなどの複数のコンポーネントで構成されています。Heroku AppLink の使用を開始するには、SDK、リファレンスアプリ、ファーストステップガイドを使うなど、さまざまな方法があります。

Heroku AppLink CLI プラグインを使用すると、コマンドラインインターフェースから Heroku AppLink アドオンを設定して管理できます。Heroku アプリを Salesforce 組織に接続する前に、プラグインをインストールする必要があります。詳細は、「Heroku AppLink CLI プラグイン​」を参照してください。

Heroku AppLink API を使用すると、Salesforce 組織および Data Cloud 組織と AppLink 対応アプリ間の関係を設定および管理できます。詳細は、Heroku AppLink API ​を参照してください。

Heroku AppLink Service Mesh 用の Heroku buildpack​ では、アプリの認証と承認を処理するための Heroku AppLink Service Mesh がインストールされます。サービスメッシュはアプリの前に位置するプロキシで、検証と機能に関する受信リクエストをインターセプトします。buildpack は以下を実行します。

  • アプリを起動します。
  • 既知のクライアントからのアプリへの受信リクエストのみを検証します。接続されている組織からの公開アプリのみがアプリを呼び出すことができます。
  • アプリのスコープトークンを提供します。承認トークンにより、SDK を使用して実行される DML が Salesforce で定義された権限に準拠するようになります。管理者および開発者は定義済みの権限セットを追加して、アプリがアクセスできるデータを決定できます。

Salesforce SDK を使用して、Salesforce 組織および Data Cloud 組織とやり取りする Heroku AppLink マネージドアプリを開発します。Heroku AppLink リファレンスアプリは、SDK を使用して API を呼び出すサンプルコードを生成することで、開発をスピードアップします。

SDK リファレンスアプリ
Salesforce 向け Node.js AppLink SDK​ Heroku AppLink Node.js リファレンスアプリ​
Salesforce 向け Python AppLink SDK​ Heroku AppLink Python リファレンスアプリ​

ファーストステップガイド

さまざまなユースケースで Heroku AppLink を使用する方法については、ファーストステップガイドをご覧ください。

アドオンのプロビジョニング

1 つのアプリで AppLink アドオンをプロビジョニングし、複数のアプリ間で共有できます。Heroku AppLink をプロビジョニングする方法の詳細は、「Heroku AppLink の使用​」を参照してください。

ユーザー権限

Heroku AppLink で操作を実行するには、Heroku または Salesforce でユーザー権限を割り当てる必要があります。必要な権限については、「Heroku AppLink の使用​」を参照してください。

アプリ上の接続

アプリのコード内で接続を使用してデータをクエリすることはできません。代わりに、承認​を作成する必要があります。

接続を作成すると、Heroku AppLink は Salesforce 組織または Data Cloud 組織と AppLink アドオンインスタンスの間に信頼できる接続が確立されます。Salesforce に接続すると、外部サービスとしてアプリを公開​し、Salesforce で API アクションを生成できます。Data Cloud 組織に接続すると、Data Cloud API を呼び出すためのData Cloud アクセストークン​が作成されます。

AppLink 対応のアプリとやり取りする組織ごとに接続を作成する必要があります。本番環境、サンドボックス環境、スクラッチ組織環境で、アプリを Salesforce 組織と Data Cloud 組織に接続できます。複数の組織を 1 つのアプリに接続することもできます。ベストプラクティスとして、環境タイプを混在させないことをお勧めします。たとえば、サンドボックス組織をステージングアプリに接続し、本番組織を本番アプリに接続します。AppLink アドオンを複数のアプリにアタッチ​すると、アプリ間で接続を共有できます。

接続を作成、表示、削除する方法の詳細は、「Heroku AppLink の使用​」を参照してください。

アプリ上の承認

承認を使用してアプリを Salesforce に公開することはできません。代わりに、接続​を作成する必要があります。

承認を作成すると、Heroku AppLink は、Salesforce 組織または Data Cloud 組織に接続するときにログインするユーザーのセキュリティトークン​を保存します。アプリのコードで承認を使用して、Salesforce API を呼び出し、API ユーザーなどの特定の承認済みユーザーとして Salesforce および Data Cloud で DML 操作を実行します。

本番環境、サンドボックス環境、スクラッチ組織環境でユーザーを承認できます。1 つのアプリに対して複数の組織のユーザーを承認することもできます。AppLink アドオンを複数のアプリにアタッチ​すると、アプリ間で認証を共有できます。

承認の作成、表示、使用、削除の方法の詳細は、「Heroku AppLink の使用​」を参照してください。

アプリを公開する

Heroku アプリを Salesforce に公開すると、AppLink によって外部サービス​が作成され、アプリの API が API カタログ​に追加され、Agentforce でエージェントアクション​が生成されます。これらのアクションを使用して、Salesforce Flow、Apex、Data Cloud、Agentforce でアプリを呼び出す​ことができます。公開したアプリを呼び出すことができるのは、接続されている Salesforce 組織と Data Cloud 組織のみです。

アプリを公開する方法の詳細は、「Heroku AppLink の使用​」を参照してください。

OpenAPI 仕様の設定

OpenAPI 仕様ファイルを構成して、Agentforce アクションなどの特定のアクションを有効にし、呼び出し元のユーザーの権限セットを定義できます。Heroku は OpenAPI 3.0​ をサポートしています。詳細は、「Heroku AppLink 用の OpenAPI 仕様の設定​」を参照してください。

公開したアプリを呼び出す

アプリを公開したら、以下を使用して Salesforce でアプリのアクションを呼び出すことができます。

アプリの呼び出し方法の詳細は、「Heroku AppLink アプリの呼び出し​」を参照してください。

Heroku AppLink には、接続、承認、アプリの公開を表示するための独自のダッシュボードがあります。詳細は、「Heroku AppLink ダッシュボード​」を参照してください。

ログ記録

Heroku の標準の tail ログ​で、heroku logs​ コマンドを使用して AppLink ログを表示できます。詳細情報と一般的な AppLink エラーについては、「Heroku AppLink のログ記録と一般的なエラー​」を参照してください。

セキュリティ

Heroku AppLink はすべての Common Runtime および Private Space のリージョン​でサポートされていますが、AppLink サービスは現在 virginia​ リージョンで実行されています。CLI とアプリの呼び出しレイテンシーは、virginia​ からのアプリのリージョンの距離に基づいています。

Heroku AppLink では、サービスメッシュを使用してアプリケーションと Salesforce 間のリクエストを認証および承認します。サービスメッシュはアプリの前に位置するプロキシで、検証と機能に関する受信リクエストをインターセプトします。

ユーザーモード

SDK を使用するときに Salesforce 組織で定義された権限とロールを適用するユーザーモードオプションは user​、user-plus​、authorized-user​ の 3 つです。ユーザーモードに応じて、Heroku アプリがアクセスできる Salesforce データを管理できます。詳細は、「Heroku AppLink のユーザーモードオプション​」を参照してください。

考慮事項と制限

制限と詳細のリストは、「Heroku AppLink の制限​」を参照してください。

サポート

Heroku AppLink のサポートとランタイムの問題はすべて、いずれかの Heroku サポートチャネル​経由で送信してください。

その他の資料